package libraryrelease import ( "encoding/json" "strings" "testing" "time" ) func sampleWriteSet() WriteSet { return WriteSet{Version: WriteSetVersion, JobID: "job-1", Target: "internal", TenantID: 10001, KnowledgeBaseID: "kb", BackupSnapshotID: "backup-1", TargetSnapshotID: "snap-1", CreatedAt: time.Date(2026, 10, 29, 12, 0, 0, 0, time.UTC), Rows: []WriteSetRow{ {Table: "resources", ID: "res-new"}, {Table: "knowledges", ID: "doc-existing", Existing: true, Owner: "10001/kb"}, {Table: "resources", ID: "res-old", Existing: true, Owner: "10001/"}, }, Universe: map[string]TableFingerprint{"resources": {Count: 2, Digest: "abc"}}} } func TestWriteSetSealVerifyRoundTrip(t *testing.T) { set := sampleWriteSet() if err := set.Seal(); err != nil { t.Fatal(err) } if set.Digest == "" { t.Fatal("seal must produce a digest") } if err := set.Verify(); err != nil { t.Fatalf("sealed record must verify: %v", err) } // 行序不影响摘要:换序后重新 Sealed 必须得到同一个值(落盘/读回才可比)。 shuffled := sampleWriteSet() shuffled.Rows[0], shuffled.Rows[2] = shuffled.Rows[2], shuffled.Rows[0] if err := shuffled.Seal(); err != nil { t.Fatal(err) } if shuffled.Digest != set.Digest { t.Fatalf("digest must not depend on row order: %s vs %s", shuffled.Digest, set.Digest) } // 序列化往返(落盘再读回)必须仍然通过校验。 raw, err := json.Marshal(shuffled) if err != nil { t.Fatal(err) } var reloaded WriteSet if err := json.Unmarshal(raw, &reloaded); err != nil { t.Fatal(err) } if err := reloaded.Verify(); err != nil { t.Fatalf("record read back from disk must verify: %v", err) } } func TestWriteSetVerifyRejectsTamperingAndMissingEvidence(t *testing.T) { cases := map[string]func(*WriteSet){ "内容被改": func(set *WriteSet) { set.Rows[0].ID = "res-other" }, "换租户": func(set *WriteSet) { set.TenantID = 20000 }, "整实例证据被清空": func(set *WriteSet) { set.Universe = nil }, "缺预备份绑定": func(set *WriteSet) { set.BackupSnapshotID = "" }, "缺摘要": func(set *WriteSet) { set.Digest = "" }, "版本不认识": func(set *WriteSet) { set.Version = 99 }, } for name, mutate := range cases { set := sampleWriteSet() if err := set.Seal(); err != nil { t.Fatal(err) } mutate(&set) if err := set.Verify(); err == nil { t.Fatalf("%s:必须校验失败", name) } } } func TestWriteSetCreatedIDsOnlyCoversRowsCreatedByThisRelease(t *testing.T) { set := sampleWriteSet() if err := set.Seal(); err != nil { t.Fatal(err) } created := set.CreatedIDs("resources") if len(created) != 1 || created[0] != "res-new" { t.Fatalf("created resources = %v, want [res-new](写前已存在的资源绝不能被当成残渣)", created) } if strings.Join(set.ExistingIDs("resources"), ",") != "res-old" { t.Fatalf("existing resources = %v", set.ExistingIDs("resources")) } if set.UniverseDigest() == "" { t.Fatal("universe digest must be derived from the whole-instance evidence") } } // 复用行是"写前已存在 + 有证据摘要"的一种:既不算本次新建(恢复不许删), // 也不能没有证据摘要,更不能被标成新建。 func TestWriteSetReusedRowsStayOutOfCleanupAndRequireEvidence(t *testing.T) { set := WriteSet{Version: WriteSetVersion, JobID: "job-2", Target: "internal", TenantID: 10001, KnowledgeBaseID: "kb", BackupSnapshotID: "backup-2", TargetSnapshotID: "snap-2", CreatedAt: time.Date(2026, 10, 30, 1, 0, 0, 0, time.UTC), Rows: []WriteSetRow{ {Table: "resources", ID: "res-reused", Existing: true, Owner: "10001/", Reused: true, ReuseEvidence: "digest-1"}, {Table: "resources", ID: "res-new"}, }, Universe: map[string]TableFingerprint{"resources": {Count: 3, Digest: "abc"}}} if err := set.Seal(); err != nil { t.Fatal(err) } if err := set.Verify(); err != nil { t.Fatalf("复用行必须能通过校验: %v", err) } if created := set.CreatedIDs("resources"); len(created) != 1 || created[0] != "res-new" { t.Fatalf("复用行被当成本次新建(恢复会删掉它):%v", created) } if reused := set.ReusedIDs("resources"); len(reused) != 1 || reused[0] != "res-reused" { t.Fatalf("reused resources = %v", reused) } noEvidence := set noEvidence.Rows = append([]WriteSetRow{}, set.Rows...) for index := range noEvidence.Rows { if noEvidence.Rows[index].ID == "res-reused" { noEvidence.Rows[index].ReuseEvidence = "" } } if err := noEvidence.Seal(); err != nil { t.Fatal(err) } if err := noEvidence.Verify(); err == nil { t.Fatal("复用行没有证据摘要时必须校验失败") } notExisting := set notExisting.Rows = append([]WriteSetRow{}, set.Rows...) for index := range notExisting.Rows { if notExisting.Rows[index].ID == "res-reused" { notExisting.Rows[index].Existing = false } } if err := notExisting.Seal(); err != nil { t.Fatal(err) } if err := notExisting.Verify(); err == nil { t.Fatal("复用行必须同时是写前已存在行(否则会被恢复当残渣)") } // 旧记录(没有复用字段)仍然必须能读回:格式演进不能把历史台账判成损坏。 legacy := sampleWriteSet() if err := legacy.Seal(); err != nil { t.Fatal(err) } if err := legacy.Verify(); err != nil { t.Fatalf("历史写集合记录必须继续有效: %v", err) } }