acf053faf3
背景:发布管理把"逐条核验"的仪式强加给每一份文档。实测一份文档要 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 条通过。
67 lines
2.2 KiB
Go
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)
|
|
}
|
|
}
|