《MMO 服务器开发》9.3 上线检查清单

{
  "game": "dawn-realm",
  "items": [
    {"id": "boot", "step": "起全部节点与中间件", "required": true, "evidence": "artifacts/assembly.log", "status": "pass"},
    {"id": "loadtest", "step": "机器人压测达标", "required": true, "evidence": "artifacts/budget.json", "status": "pass"},
    {"id": "metrics", "step": "关键指标可拉取", "required": true, "evidence": "artifacts/metrics.txt", "status": "pass"},
    {"id": "canary", "step": "灰度发布按比例生效", "required": true, "evidence": "artifacts/canary.json", "status": "pass"},
    {"id": "hotreload", "step": "配置热更不重启即生效且可回滚", "required": true, "evidence": "artifacts/config-ack.json", "status": "pass"},
    {"id": "shutdown", "step": "优雅停服连接排空并落库", "required": true, "evidence": "artifacts/drain.log", "status": "pass"},
    {"id": "backup", "step": "从备份恢复到一致状态", "required": true, "evidence": "artifacts/restore.txt", "status": "pass"},
    {"id": "failover", "step": "主节点宕机后自动接管", "required": true, "evidence": "artifacts/failover.json", "status": "pass"},
    {"id": "drill", "step": "演练有记录有改进项", "required": true, "evidence": "docs/postmortem.md", "status": "pass"},
    {"id": "signoff", "step": "清单逐条打勾无遗留", "required": true, "evidence": "artifacts/checklist.json", "status": "pass"}
  ]
}

// file: internal/dawnrealm/checklist.go
// tier: L1
// verify: go test ./internal/dawnrealm/
package dawnrealm

import (
	"encoding/json"
	"fmt"
	"io"
	"sort"
	"strings"
)

// Item is one line of the launch checklist. Every item must carry evidence: a
// file, a command output, or a report path that a reviewer can re-open. A
// checklist without evidence is an opinion, not a gate.
type Item struct {
	ID       string `json:"id"`
	Step     string `json:"step"`
	Required bool   `json:"required"`
	Evidence string `json:"evidence"`
	Status   string `json:"status"` // "pass" | "fail" | "skip"
}

// Checklist is the ordered set of acceptance actions for one launch.
type Checklist struct {
	Game  string `json:"game"`
	Items []Item `json:"items"`
}

// LaunchChecklist is the ten-step acceptance list the volume builds toward.
// The order matches the 《晨曦大陆》 acceptance list in the volume index.
func LaunchChecklist() Checklist {
	return Checklist{Game: "dawn-realm", Items: []Item{
		{ID: "boot", Step: "起全部节点与中间件", Required: true},
		{ID: "loadtest", Step: "机器人压测达标", Required: true},
		{ID: "metrics", Step: "关键指标可拉取", Required: true},
		{ID: "canary", Step: "灰度发布按比例生效", Required: true},
		{ID: "hotreload", Step: "配置热更不重启即生效且可回滚", Required: true},
		{ID: "shutdown", Step: "优雅停服连接排空并落库", Required: true},
		{ID: "backup", Step: "从备份恢复到一致状态", Required: true},
		{ID: "failover", Step: "主节点宕机后自动接管", Required: true},
		{ID: "drill", Step: "演练有记录有改进项", Required: true},
		{ID: "signoff", Step: "清单逐条打勾无遗留", Required: true},
	}}
}

// LoadChecklist decodes a checklist from JSON. Unknown fields are rejected so a
// typo in the file fails loudly instead of silently skipping a gate.
func LoadChecklist(r io.Reader) (Checklist, error) {
	dec := json.NewDecoder(r)
	dec.DisallowUnknownFields()
	var c Checklist
	if err := dec.Decode(&c); err != nil {
		return Checklist{}, fmt.Errorf("dawnrealm: parse checklist: %w", err)
	}
	return c, nil
}

// Validate enforces that every required item carries a passing status and
// non-empty evidence. It returns all misses at once, sorted by id, so a
// reviewer fixes the whole list in one pass rather than one item per run.
func Validate(c Checklist) error {
	var misses []string
	for _, it := range c.Items {
		if !it.Required {
			continue
		}
		var why []string
		if strings.TrimSpace(it.Evidence) == "" {
			why = append(why, "no evidence")
		}
		if it.Status != "pass" {
			why = append(why, "status="+orEmpty(it.Status))
		}
		if len(why) > 0 {
			misses = append(misses, fmt.Sprintf("%s (%s): %s", it.ID, it.Step, strings.Join(why, ", ")))
		}
	}
	if len(misses) == 0 {
		return nil
	}
	sort.Strings(misses)
	return fmt.Errorf("dawnrealm: checklist not satisfied: %s", strings.Join(misses, "; "))
}

func orEmpty(s string) string {
	if s == "" {
		return "<empty>"
	}
	return s
}

// snippet: internal/dawnrealm/checklist_test.go 的用法
c, err := LoadChecklist(f) // 读 checklist.json
if err != nil {
	t.Fatal(err)
}
if err := Validate(c); err != nil {
	t.Fatalf("valid checklist rejected: %v", err) // 任一 required 项缺证据即失败
}

go test -run TestChecklist ./internal/dawnrealm/   && echo "checklist OK, proceed"   || { echo "checklist NOT satisfied, abort"; exit 1; }

dawnrealm: checklist not satisfied: backup (从备份恢复到一致状态): no evidence; canary (灰度发布按比例生效): status=fail