Files
knowledge-governance/cmd/worker/library_wiring.go
T
姚章浩 0a7c9f8510 feat(worker): 接线恢复派发台账并按激活登记启用
为什么:派发协议只在 worker 里装配却没人接,就等于只写了 store
mock。同步失败的自动 rollback 与维护恢复都必须拿到同一份台账;
baseline 只读装配永远不传,避免建基线顺带获得恢复写许可。

开关 LIBRARY_RESTORE_DISPATCH_V2 默认关闭,且只是"允许装配":
治理库没有该目标的未撤销激活登记时,Prepare/Acquire 直接 fail closed。

验证:cmd/worker 单测覆盖默认关闭/显式开启/无台账三态;
v071 真 ES 用例里自动 rollback 与手动恢复走的是同一个 Restore。
2026-11-02 16:28:01 +08:00

48 lines
2.4 KiB
Go

package main
import (
"context"
"knowledge-governance/internal/appconfig"
"knowledge-governance/internal/librarymaintenance"
"knowledge-governance/internal/libraryrelease"
"knowledge-governance/internal/librarystack"
postgresstore "knowledge-governance/internal/platform/postgres"
v071 "knowledge-governance/internal/releaseadapter/v071"
)
// 目标整库读写栈的装配只有一份实现(internal/librarystack):worker 的同步/恢复/
// 基线与主机侧恢复演练共用它,避免"目标是谁、用哪份契约"随调用路径漂移。
// openLibraryMaintenance 按部署注入的配置装配实例级维护目标。
// 未接线时返回明确原因:只锁治理库 scope 不算维护,宁可拒绝写也不冒充。
func openLibraryMaintenance(config appconfig.Config) (*librarymaintenance.Manager, error) {
return librarystack.OpenMaintenance(config)
}
// restoreDispatchGate 只在部署显式开启时才把治理台账交给目标。
//
// 为什么不能只信配置:配置为 true 只说明"允许装配",不证明旧 writer 已退出;
// 真正的发放许可还要求治理库里对该目标存在未撤销的激活登记(见迁移 78)。
func restoreDispatchGate(config appconfig.Config, store *postgresstore.Store) libraryrelease.RestoreMarkerGate {
// 只判断"是否允许装配":目标身份与独占证明由治理台账的激活登记回答,
// 这里再用一个空配置也能算出来的摘要去当门槛只会制造虚假的严格。
if !config.LibraryRestoreDispatchEnabled || store == nil {
return nil
}
return store
}
// buildLibraryProductionStack 用"要同步的这份快照"做契约装配目标与预备份存储。
func buildLibraryProductionStack(ctx context.Context, config appconfig.Config, gate libraryrelease.RestoreMarkerGate,
scope, snapshotID, knownMapping string) (*v071.ProductionLibraryTarget, *v071.ProductionBackupStore, error) {
return librarystack.OpenProductionStack(ctx, config, scope, snapshotID, knownMapping, gate)
}
// buildLibraryBaselineStack 装配"给目标自己建基线"所需的目标与捕获器(契约取目标当前映射)。
// 基线不参与发布/恢复派发,永远不传派发台账:只读/建基线不得获得恢复写许可。
func buildLibraryBaselineStack(ctx context.Context, config appconfig.Config, scope string) (
*v071.ProductionLibraryTarget, *v071.ProductionBackupStore, error) {
return librarystack.OpenBaselineStack(ctx, config, scope)
}