Files
knowledge-governance/internal/governance/auto_review.go
T
姚章浩 acf053faf3 feat(release): 建批时冻结 + 验收通过自动批准 —— 把"每份文档 8 步"砍掉两步并去掉两次卡死
背景:发布管理把"逐条核验"的仪式强加给每一份文档。实测一份文档要 9~11 次交互,
且有两处顺序陷阱(冻结后批准 → 建批 422;生成即固化 → 批准被永久钉住)。

P0-1 建批时冻结:
- CreateReleaseBatch 在未指定版本时,自己把当前实时计划冻结成一份**已确认**版本并绑定
  (同一事务;同摘要复用最近版本,planned 或 confirmed 都可复用,因此同一份计划不堆版本)。
- 语义不变:批一旦建立,清单/摘要/验收轮次/目标库绑定全部不可变、回滚按它走;变的只是
  "谁在什么时候按固化键"——从操作员的手动两步变成建批这一下。
- 效果:去掉「生成新版本」「确认冻结」两步;消灭"批准晚于冻结 → 422"这类顺序陷阱;
  前端不再传版本 id,也不再有"所选知识不在冻结清单里"的阻断。
- 计划→清单项的映射抽成 ChangeSetItemsFromPlan 供两处共用,否则两处算出的摘要不同,
  "同一计划复用同一版本"永远不命中。

P0-2 验收通过自动批准:
- 验收三项结论达发布门槛(knowledge_exists/chunks_present=passed,retrieval_hit 与门槛同
  口径)时,由 worker 写入 reviewer_ref='system:auto' 的批准记录,替代"每份文档点一次批准"。
- 策略 TEST_AUTO_REVIEW_POLICY = off | internal(默认,仅对内)| all;值不认识拒绝启动。
  只影响审核这一步:生产授权、双闸与发布前快照门禁不受影响。界面上只读展示当前策略。
- 安全边界(写死在审核 SQL 里):系统只允许写"第一条"审核——人工一旦表过态,机器不得用一条
  更晚的 approved 把人工结论翻回去;人工随时可再审。集成测试去掉该约束即 FAIL(已实测)。
- 自动批准自身的任何失败都不影响验收结论,只上报。

顺带(P1-1 前半,已被 P0-1 取代的部分已删除):
- 写操作失败把服务端 {"error": ...} 的原因带出来,并对已知原因给出下一步(不再只给 HTTP 状态码)。
- 当前的"不在已冻结清单里"标注与就地修复按钮随 P0-1 一起移除(该失败模式已不存在)。

测试:bind_time_freeze_integration_test.go(绑定已确认版本/同计划复用/冻结后不可变/
动作不符仍 NotEligible)、auto_review_integration_test.go(系统只写第一条、人工可再审)、
validate_test.go(对内自动/对外不自动/策略关闭/验收未过不批/自身失败不影响验收)、
auto_review_test.go、config_test 及前端能力解析测试。
实测耗时:本机 Go 全量 26 包通过、前端 178 条通过。
2026-10-10 15:05:20 +08:00

67 lines
2.2 KiB
Go

package governance
import (
"errors"
"strings"
)
// AutoReviewPolicy 决定「验收通过的知识是否由系统自动写入审核批准」。
//
// 目的:把运维从「每份文档都点一次批准」里解放出来。它只影响审核这一步,
// 生产发布的人工授权、双闸(请求门禁 + 备份验证门禁)与发布前快照门禁都不受影响。
type AutoReviewPolicy string
const (
// AutoReviewOff:不做自动批准,全部人工。
AutoReviewOff AutoReviewPolicy = "off"
// AutoReviewInternal:仅「对内」自动批准,「对外」(客户可见)仍需人工。
AutoReviewInternal AutoReviewPolicy = "internal"
// AutoReviewAll:对内对外都自动批准。
AutoReviewAll AutoReviewPolicy = "all"
)
// ErrInvalidAutoReviewPolicy:策略值不认识。配置异常要拒绝启动,而不是悄悄降级成某个默认值。
var ErrInvalidAutoReviewPolicy = errors.New("invalid auto review policy")
// ParseAutoReviewPolicy 解析策略:空值取默认「仅对内」,未知值报错。
func ParseAutoReviewPolicy(value string) (AutoReviewPolicy, error) {
switch strings.ToLower(strings.TrimSpace(value)) {
case "":
return AutoReviewInternal, nil
case string(AutoReviewOff):
return AutoReviewOff, nil
case string(AutoReviewInternal):
return AutoReviewInternal, nil
case string(AutoReviewAll):
return AutoReviewAll, nil
default:
return "", ErrInvalidAutoReviewPolicy
}
}
// Allows 判断某个目标范围的知识是否允许自动批准。范围值不认识时一律不允许(fail-closed)。
func (policy AutoReviewPolicy) Allows(targetScope string) bool {
switch policy {
case AutoReviewInternal:
return targetScope == string(VisibilityInternal)
case AutoReviewAll:
return targetScope == string(VisibilityInternal) || targetScope == string(VisibilityExternal)
default:
return false
}
}
// Describe 给界面/运维看的一句话说明。
func (policy AutoReviewPolicy) Describe() string {
switch policy {
case AutoReviewOff:
return "全部人工审核"
case AutoReviewAll:
return "对内对外都自动批准(验收通过即批准)"
case AutoReviewInternal:
return "对内自动批准,对外仍需人工"
default:
return string(policy)
}
}