《MMO 服务器开发》1.2 本书范围与站内分工

// file: internal/overview/scope.go
// tier: L1
// verify: go test ./internal/overview/
// Package overview also encodes this book's boundary against the game-server
// content already on the site. The tables in section 1.2 are for humans; this
// file is the machine-readable version, so "stay in your lane" becomes an
// assertion a test can fail on instead of a slogan nobody re-reads.
package overview

import "strings"

// Owner says who is responsible for a topic: an existing section of the site,
// or this book (the "from scratch, with numbers" half).
type Owner struct {
	// Kind is either "practice" (existing site content) or "this-book".
	Kind string
	// Path is the absolute site path the reader should go to.
	Path string
}

// Owners for the content this book deliberately does not rewrite.
var (
	// PracticeServer is the 170-article architecture-only practice section.
	PracticeServer = Owner{Kind: "practice", Path: "/posts/game/server/practice/"}
	// PracticeSkynet is the Skynet (Lua framework) usage section.
	PracticeSkynet = Owner{Kind: "practice", Path: "/posts/game/server/skynet/"}
	// PracticePitaya is the Pitaya framework section.
	PracticePitaya = Owner{Kind: "practice", Path: "/posts/game/server/pitaya/"}
	// ExistingBook is the half-finished《游戏服务端编程实践》.
	ExistingBook = Owner{Kind: "practice", Path: "/posts/books/游戏服务端编程实践/"}
	// ThisBook is where the from-scratch implementation lives.
	ThisBook = Owner{Kind: "this-book", Path: "/posts/books/网络与并发内核/"}
)

// Rule maps a topic keyword to its owner. First match wins.
type Rule struct {
	Keyword string
	Owner   Owner
}

// scopeRules is the 1.2 boundary table, in code. Order is priority.
var scopeRules = []Rule{
	{"架构方案", PracticeServer},
	{"选型对比", PracticeServer},
	{"Skynet", PracticeSkynet},
	{"Pitaya", PracticePitaya},
	{"SLG 项目", ExistingBook},
	{"从零实现", ThisBook},
	{"端到端压测", ThisBook},
}

// Route returns the owner of a topic. A topic that matches no rule defaults to
// this book: the book's job is exactly "what nobody else wrote from scratch",
// so the fallback must point at us, never away.
func Route(topic string) Owner {
	for _, r := range scopeRules {
		if strings.Contains(topic, r.Keyword) {
			return r.Owner
		}
	}
	return ThisBook
}

// ExternalPaths returns every distinct site path this book defers to. Callers
// use it to assert that each one is a real, absolute section path.
func ExternalPaths() []string {
	seen := map[string]bool{}
	var out []string
	for _, r := range scopeRules {
		if r.Owner.Kind == "practice" && !seen[r.Owner.Path] {
			seen[r.Owner.Path] = true
			out = append(out, r.Owner.Path)
		}
	}
	return out
}

// file: internal/overview/scope_test.go
// tier: L1
// verify: go test ./internal/overview/
package overview

import (
	"strings"
	"testing"
)

func TestRouteToPractice(t *testing.T) {
	cases := map[string]Owner{
		"网关分层的架构方案":   PracticeServer,
		"引擎选型对比":      PracticeServer,
		"Skynet 服务模型": PracticeSkynet,
		"Pitaya 集群":   PracticePitaya,
		"SLG 项目实战":    ExistingBook,
	}
	for topic, want := range cases {
		if got := Route(topic); got != want {
			t.Errorf("Route(%q) = %+v, want %+v", topic, got, want)
		}
	}
}

func TestRouteToThisBook(t *testing.T) {
	for _, topic := range []string{"从零实现 KCP", "端到端压测与承载数字", "一个没人写过的话题"} {
		if got := Route(topic); got != ThisBook {
			t.Errorf("Route(%q) = %+v, want this-book", topic, got)
		}
	}
}

func TestExternalPathsAreAbsoluteSectionPaths(t *testing.T) {
	paths := ExternalPaths()
	if len(paths) == 0 {
		t.Fatal("expected at least one external path")
	}
	for _, p := range paths {
		// Section pages live under /posts/; a bare single-segment path would
		// be a dead link, because articles are flattened to /<slug>/.
		if !strings.HasPrefix(p, "/posts/") {
			t.Errorf("external path %q is not under /posts/", p)
		}
		if !strings.HasSuffix(p, "/") {
			t.Errorf("external path %q must be a section path ending in /", p)
		}
	}
}

func TestRouteFallbackIsNeverExternal(t *testing.T) {
	if got := Route("完全未知的话题 xyz"); got.Kind != "this-book" {
		t.Fatalf("fallback owner = %+v, want this-book", got)
	}
}

--- PASS: TestRouteToPractice (0.00s)
--- PASS: TestRouteToThisBook (0.00s)
--- PASS: TestExternalPathsAreAbsoluteSectionPaths (0.00s)
--- PASS: TestRouteFallbackIsNeverExternal (0.00s)
PASS
ok  	aegis/internal/overview	0.324s