Files
knowledge-governance/internal/appconfig/library_role_test.go
T
姚章浩 5e1482e349
build / build (push) Successful in 1m40s
feat(library): 恢复验证成为可页面发起的真实作业
根因:生产可恢复性只有 PRODUCTION_BACKUP_RESTORE_VERIFIED 这个手填 env 开关,
页面没有任何入口去真跑一次恢复;CLI(librarydrill)又不是 worker 能复用的实现,
所以"已验证"既证明不了跑过、也证明不了跑的是当前目标。

改动:
- 共享实现 internal/libraryverify(维护隔离→捕获→基线校验→canary→恢复→复核→关窗口),
  cmd/librarydrill 改为薄封装,CLI 与 worker 只允许一份执行体。
- verify 成为独立业务作业:kind + VerifyStages(capture/verify/canary/restore/finalize),
  与 sync/restore/baseline 共用同一把写互斥;迁移 79 加 kind 约束、重建部分唯一索引、
  新建 library_restore_verifications(按 target_id 绑定,换库/索引/桶旧证据自动失效,
  同 target+scope+job 幂等)。
- worker:admitLibraryJob + runOwnedLibraryAttempt 之后调用共享实现,阶段实时写
  library_job_stages,结束后写真实终态;通过写 passed 证据,失败写 failed+原因(不伪成功);
  中断接管按同一作业 id 收掉维护窗口。
- API:POST/GET /api/v1/library/verifications(管理员;闸口关闭/维护中拒绝;返回完整
  整库目标、最近证据、失败原因),OpenAPI 同步。
- 闸口:同步/恢复/续作的证据判断改为读当前目标证据;历史 env 仅在证据缺失时兜底,
  证据存在时以证据为准。
- 页面:生产保护与恢复面板加「恢复验证」块(完整 KB/索引/桶、状态、最近证据、失败原因、
  管理员按钮、5s 轮询),作业类型补 verify 文案。

测试:make verify 16/16 全绿(go 1387 例 + web 454 例 + 契约/迁移/密钥/依赖锁定);
新增用例覆盖证据四条件、闸口证据优先、页面无证据/失败/通过三种呈现与管理员可见性。
2026-11-03 10:14:08 +08:00

85 lines
3.1 KiB
Go

package appconfig
import "testing"
func TestParseLibraryWorkerRole(t *testing.T) {
cases := []struct {
raw string
want LibraryWorkerRole
release bool
source bool
wantFail bool
}{
{raw: "", want: LibraryWorkerRoleFull, release: true, source: true},
{raw: "full", want: LibraryWorkerRoleFull, release: true, source: true},
{raw: " release-executor ", want: LibraryWorkerRoleReleaseExecutor, release: true, source: false},
{raw: "capture", want: LibraryWorkerRoleCapture, release: false, source: true},
{raw: "release", wantFail: true},
{raw: "worker", wantFail: true},
}
for _, test := range cases {
got, err := parseLibraryWorkerRole(test.raw)
if test.wantFail {
if err == nil {
t.Fatalf("parseLibraryWorkerRole(%q) accepted an unknown role", test.raw)
}
continue
}
if err != nil {
t.Fatalf("parseLibraryWorkerRole(%q) error = %v", test.raw, err)
}
if got != test.want {
t.Fatalf("parseLibraryWorkerRole(%q) = %q, want %q", test.raw, got, test.want)
}
if got.ExecutesRelease() != test.release || got.ExecutesSourceWork() != test.source {
t.Fatalf("role %q release=%t source=%t, want release=%t source=%t",
got, got.ExecutesRelease(), got.ExecutesSourceWork(), test.release, test.source)
}
if got.ExecutesRelease() && got.ExecutesSourceWork() && got != LibraryWorkerRoleFull {
t.Fatalf("role %q claims both domains without being full", got)
}
}
}
// 非法角色必须让进程起不来:静默回到 full 会让两套执行器抢同一批 release 作业。
func TestLoadRejectsUnknownLibraryWorkerRole(t *testing.T) {
env := map[string]string{
"DATABASE_URL": "postgres://user:pass@127.0.0.1:5432/governance?sslmode=disable",
"LIBRARY_WORKER_ROLE": "release",
}
if _, err := Load(func(key string) string { return env[key] }); err == nil {
t.Fatal("Load() accepted LIBRARY_WORKER_ROLE=release")
}
env["LIBRARY_WORKER_ROLE"] = "release-executor"
config, err := Load(func(key string) string { return env[key] })
if err != nil {
t.Fatalf("Load() error = %v", err)
}
if !config.LibraryWorkerRole.ExecutesRelease() || config.LibraryWorkerRole.ExecutesSourceWork() {
t.Fatalf("release-executor role mapping is wrong: %#v", config.LibraryWorkerRole)
}
}
// 每个角色收拾哪些 kind、谁拥有 DDL,都必须互斥且覆盖完整。
func TestLibraryWorkerRoleOwnershipMaps(t *testing.T) {
release := LibraryWorkerRoleReleaseExecutor
if got := release.LibraryJobKinds(); len(got) != 5 || got[0] != "sync" || got[1] != "restore" ||
got[2] != "recover" || got[3] != "baseline" || got[4] != "verify" {
t.Fatalf("release-executor kinds = %v", got)
}
if got := LibraryWorkerRoleCapture.LibraryJobKinds(); len(got) != 1 || got[0] != "seal" {
t.Fatalf("capture kinds = %v", got)
}
if got := LibraryWorkerRoleFull.LibraryJobKinds(); len(got) != 6 {
t.Fatalf("full kinds = %v", got)
}
for _, role := range []LibraryWorkerRole{LibraryWorkerRoleFull, LibraryWorkerRoleCapture} {
if !role.ExecutesMigrations() {
t.Fatalf("role %q must own DDL", role)
}
}
if release.ExecutesMigrations() {
t.Fatal("release-executor must not own governance DDL")
}
}