Files
knowledge-governance/internal/workflows/release/sidecar_publisher_test.go
T
zheromiku dcdc8d1ddd feat: 知识治理平台(含已验证发布/回滚契约)
全栈知识治理平台首次入库(P1-P10 + 发布链路模拟验证闭环):

- 治理核心:源目录/变更集/人工审核/发布批次/发布执行(fail-closed 闸口)
- 测试通道:WeKnora 测试 KB 上传/轮询/验收;poll 完成时写入
  parser_generation/index_generation,修复 manual/seed 路径发布闸口永久拦截
- 发布适配器 v071(本地 source=测试角色 / 云端 target=生产角色 模拟验证通过):
  * ES 导出/导入 mapping 自适应(.keyword 子字段、可选 tenant_id)
  * OSS locator 支持嵌套 scheme;chunks.seq_id 由目标序列分配
  * bundle 归档同身份重试原子替换;verifier 按 bundle chunk_type 计数
  * 回滚 job payload 支持 prior_execution_id(strict 解码)
- 三通道发布+回滚演练实测:publish 4/4 verified,检索命中,
  rollback 4/4 rolled_back,目标端 PG is_enabled=false、ES is_enabled=false
- 前端 A·Data-console 风格全站统一,120 用例通过
- 门禁:go vet / go test 全包通过,gofmt 干净
2026-09-30 10:54:06 +08:00

218 lines
9.2 KiB
Go

package release
import (
"context"
"errors"
"reflect"
"strings"
"testing"
"time"
"knowledge-governance/internal/releasebundle"
)
func TestSidecarPublisherPublishesWithContractAndVerification(t *testing.T) {
calls := []string{}
manifest, err := releasebundle.Seal(testManifest())
if err != nil {
t.Fatal(err)
}
exporter := &fakeExporter{manifest: manifest, calls: &calls}
target := &fakeSidecarTarget{contract: testTargetContract(), calls: &calls, prepared: PreparedChange{PreviousRevision: "prod-v0", ProductionRevision: "prod-v1"}}
publisher, err := NewSidecarPublisher(exporter, target)
if err != nil {
t.Fatal(err)
}
result, err := publisher.Publish(context.Background(), testPlanItem())
if err != nil {
t.Fatal(err)
}
if result.BundleSHA256 != manifest.BundleSHA256 || result.PreviousProductionRevision != "prod-v0" || result.ProductionRevision != "prod-v1" {
t.Fatalf("result=%#v", result)
}
want := []string{"export", "contract", "prepare", "activate", "verify"}
if !reflect.DeepEqual(calls, want) {
t.Fatalf("calls=%v want=%v", calls, want)
}
}
func TestSidecarPublisherRollsBackFailedVerificationWithoutLeakingCause(t *testing.T) {
calls := []string{}
manifest, err := releasebundle.Seal(testManifest())
if err != nil {
t.Fatal(err)
}
target := &fakeSidecarTarget{contract: testTargetContract(), calls: &calls, prepared: PreparedChange{PreviousRevision: "prod-v0", ProductionRevision: "prod-v1"}, verifyErr: errors.New("signed-url-secret-should-not-leak")}
publisher, err := NewSidecarPublisher(&fakeExporter{manifest: manifest, calls: &calls}, target)
if err != nil {
t.Fatal(err)
}
_, err = publisher.Publish(context.Background(), testPlanItem())
var itemErr *ItemError
if !errors.As(err, &itemErr) || itemErr.Code != ErrorCodeVerificationFailed || itemErr.Retryable {
t.Fatalf("error=%#v", err)
}
if strings.Contains(err.Error(), "signed-url") {
t.Fatalf("error leaked cause: %v", err)
}
want := []string{"export", "contract", "prepare", "activate", "verify", "compensate"}
if !reflect.DeepEqual(calls, want) {
t.Fatalf("calls=%v want=%v", calls, want)
}
}
func TestSidecarPublisherRejectsContractDriftBeforeTargetMutation(t *testing.T) {
calls := []string{}
manifest, err := releasebundle.Seal(testManifest())
if err != nil {
t.Fatal(err)
}
contract := testTargetContract()
contract.EmbeddingDimension = 768
publisher, err := NewSidecarPublisher(&fakeExporter{manifest: manifest, calls: &calls}, &fakeSidecarTarget{contract: contract, calls: &calls})
if err != nil {
t.Fatal(err)
}
_, err = publisher.Publish(context.Background(), testPlanItem())
var itemErr *ItemError
if !errors.As(err, &itemErr) || itemErr.Code != ErrorCodeContractMismatch {
t.Fatalf("error=%#v", err)
}
if !reflect.DeepEqual(calls, []string{"export", "contract"}) {
t.Fatalf("calls=%v", calls)
}
}
func TestSidecarPublisherRejectsRevisionMismatchBeforeTargetMutation(t *testing.T) {
calls := []string{}
manifest, err := releasebundle.Seal(testManifest())
if err != nil {
t.Fatal(err)
}
item := testPlanItem()
item.ParseRevision = "other-parser/index"
publisher, err := NewSidecarPublisher(&fakeExporter{manifest: manifest, calls: &calls}, &fakeSidecarTarget{contract: testTargetContract(), calls: &calls})
if err != nil {
t.Fatal(err)
}
_, err = publisher.Publish(context.Background(), item)
var itemErr *ItemError
if !errors.As(err, &itemErr) || itemErr.Code != ErrorCodeContractMismatch {
t.Fatalf("error=%#v", err)
}
if !reflect.DeepEqual(calls, []string{"export"}) {
t.Fatalf("calls=%v", calls)
}
}
func TestSidecarPublisherDeletesOnlyAfterArchivingAndVerifiesAbsent(t *testing.T) {
calls := []string{}
manifest, err := releasebundle.Seal(testManifest())
if err != nil {
t.Fatal(err)
}
target := &fakeSidecarTarget{contract: testTargetContract(), calls: &calls, prepared: PreparedChange{PreviousRevision: "prod-v0", ProductionRevision: "release-v1"}, expectedRestoreRevision: "absent", restoredRevision: "absent"}
publisher, err := NewSidecarPublisher(&fakeExporter{manifest: manifest, calls: &calls}, target)
if err != nil {
t.Fatal(err)
}
result, err := publisher.Delete(context.Background(), testPlanItem())
if err != nil {
t.Fatal(err)
}
if result.BundleSHA256 != manifest.BundleSHA256 || result.PreviousProductionRevision != "prod-v0" || result.ProductionRevision != "absent" {
t.Fatalf("result=%#v", result)
}
if want := []string{"export", "contract", "prepare", "restore", "verify-restored"}; !reflect.DeepEqual(calls, want) {
t.Fatalf("calls=%v want=%v", calls, want)
}
}
func TestSidecarPublisherRestoresArchivedRevision(t *testing.T) {
calls := []string{}
target := &fakeSidecarTarget{calls: &calls, restoredRevision: "prod-v0"}
publisher, err := NewSidecarPublisher(&fakeExporter{}, target)
if err != nil {
t.Fatal(err)
}
result, err := publisher.Rollback(context.Background(), testPlanItem())
if err != nil {
t.Fatal(err)
}
if result.ProductionRevision != "prod-v0" || !reflect.DeepEqual(calls, []string{"restore", "verify-restored"}) {
t.Fatalf("result=%#v calls=%v", result, calls)
}
}
type fakeExporter struct {
manifest releasebundle.Manifest
calls *[]string
err error
}
func (f *fakeExporter) Export(context.Context, PlanItem) (ExportedBundle, error) {
if f.calls != nil {
*f.calls = append(*f.calls, "export")
}
return fakeExportedBundle{manifest: f.manifest}, f.err
}
type fakeExportedBundle struct{ manifest releasebundle.Manifest }
func (bundle fakeExportedBundle) ReleaseManifest() releasebundle.Manifest { return bundle.manifest }
type fakeSidecarTarget struct {
contract releasebundle.TargetContract
calls *[]string
prepared PreparedChange
prepareErr, activateErr, verifyErr, compensateErr, restoreErr, verifyRestoredErr error
restoredRevision string
expectedRestoreRevision string
}
func (f *fakeSidecarTarget) Contract(context.Context, PlanItem) (releasebundle.TargetContract, error) {
*f.calls = append(*f.calls, "contract")
return f.contract, nil
}
func (f *fakeSidecarTarget) Prepare(context.Context, PlanItem, ExportedBundle) (PreparedChange, error) {
*f.calls = append(*f.calls, "prepare")
return f.prepared, f.prepareErr
}
func (f *fakeSidecarTarget) Activate(context.Context, PlanItem, PreparedChange) error {
*f.calls = append(*f.calls, "activate")
return f.activateErr
}
func (f *fakeSidecarTarget) Verify(context.Context, PlanItem, PreparedChange) error {
*f.calls = append(*f.calls, "verify")
return f.verifyErr
}
func (f *fakeSidecarTarget) Compensate(context.Context, PlanItem, PreparedChange) error {
*f.calls = append(*f.calls, "compensate")
return f.compensateErr
}
func (f *fakeSidecarTarget) Restore(_ context.Context, _ PlanItem, revision string) (string, error) {
*f.calls = append(*f.calls, "restore")
expected := f.expectedRestoreRevision
if expected == "" {
expected = "prod-v0"
}
if revision != expected {
return "", errors.New("wrong revision")
}
return f.restoredRevision, f.restoreErr
}
func (f *fakeSidecarTarget) VerifyRestored(context.Context, PlanItem, string) error {
*f.calls = append(*f.calls, "verify-restored")
return f.verifyRestoredErr
}
func testPlanItem() PlanItem {
return PlanItem{ReleaseExecutionID: "rx-safe", PublicationID: "tp-safe", SourceItemVersionID: "sv-safe", SourceRevision: "source-v1", ParseRevision: "parser-v1@index-v1", ReleaseRevision: "release-v1", TestKnowledgeBaseID: "kb-safe", KnowledgeID: "knowledge-safe", DecidedVisibility: "internal", PreviousProductionRevision: "prod-v0"}
}
func testManifest() releasebundle.Manifest {
return releasebundle.Manifest{FormatVersion: releasebundle.FormatVersionV1, ExecutionID: "rx-safe", PublicationID: "tp-safe", SourceItemVersionID: "sv-safe", SourceRevision: "source-v1", ParseRevision: "parser-v1@index-v1", ReleaseRevision: "release-v1", CreatedAt: time.Date(2026, 9, 6, 8, 0, 0, 0, time.UTC), Contract: releasebundle.Contract{WeKnoraVersion: releasebundle.WeKnoraVersionV071, MigrationVersion: releasebundle.WeKnoraMigrationV071, TenantID: 10000, KnowledgeBaseID: "kb-safe", KnowledgeID: "knowledge-safe", RetrieverEngine: "elasticsearch_v8", EmbeddingModel: "bge-m3", EmbeddingDimension: releasebundle.EmbeddingDimensionV071, ElasticsearchMappingSHA256: strings.Repeat("a", 64)}, Tables: []releasebundle.TableDigest{{Name: "knowledges", RowCount: 1, SHA256: strings.Repeat("b", 64)}, {Name: "chunks", RowCount: 1, SHA256: strings.Repeat("c", 64)}}, Search: releasebundle.SearchDigest{DocumentCount: 1, SHA256: strings.Repeat("d", 64)}, Assets: releasebundle.AssetDigest{SHA256: strings.Repeat("e", 64)}}
}
func testTargetContract() releasebundle.TargetContract {
return releasebundle.TargetContract{WeKnoraVersion: releasebundle.WeKnoraVersionV071, MigrationVersion: releasebundle.WeKnoraMigrationV071, TenantID: 10000, KnowledgeBaseID: "kb-safe", RetrieverEngine: "elasticsearch_v8", EmbeddingModel: "bge-m3", EmbeddingDimension: releasebundle.EmbeddingDimensionV071, ElasticsearchMappingSHA256: strings.Repeat("a", 64)}
}