dcdc8d1ddd
全栈知识治理平台首次入库(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 干净
218 lines
9.2 KiB
Go
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)}
|
|
}
|