Files
knowledge-governance/internal/governance/review.go
T
姚章浩 70131c6161 feat(release): 批量审核 + 建批即锁定 —— 发布管理单文档交互降到 3~4 次
P0-3:
- 批量审核:新增 POST /api/v1/review-candidates/batch-decision,逐条复用单条审核的写入
  路径(同一套合法性校验与"最新验收轮次"绑定),逐条回报 decided/skipped/skipped_ids;
  不可审核的条目只计入 skipped,不打断整批,其他错误整批回滚(不留半成品)。
  界面新增「全选可批准」「批量批准选中」「批量驳回选中」。
- 建批即锁定:建批请求加 seal 字段,服务端在创建后立即执行既有的密封(仍逐项复核门禁,
  失败整批回滚),草稿态不再单独占一步;界面按钮改为「创建并锁定清单」,流程说明从 8 步改 7 步。
- 判据修正:「可批准」原先把已驳回的算进去(review_state !== 'approved'),改为只含 pending + 门禁通过。

语义边界(写进测试):批量批准按人工身份记录,人工可推翻自己先前的驳回;system:auto 发起的
批量批准对人工驳回过的那条必须跳过(Decided=0/Skipped=1)——机器永远不覆盖人工。

测试:review_batch_integration_test.go(批量决定/跳报/重复 id 拒绝/机器不覆盖人工、
建批即锁定)、review_batch_test.go(幂等键、400/409/500/501 映射、服务端盖操作人)、
reviewRelease.test.ts(批量请求体与逐条回报、建批带 seal)。前端 181 条通过。
2026-10-10 15:29:31 +08:00

88 lines
3.0 KiB
Go

package governance
import "time"
type ReviewGateStatus string
const (
ReviewGateReady ReviewGateStatus = "ready"
ReviewGateBlocked ReviewGateStatus = "blocked"
)
func (status ReviewGateStatus) Valid() bool {
return status == ReviewGateReady || status == ReviewGateBlocked
}
type ReviewCandidate struct {
PublicationID string `json:"publication_id"`
Title string `json:"title"`
SourceType SourceType `json:"source_type"`
CurrentVisibility Visibility `json:"current_visibility"`
AcceptanceRunID string `json:"-"`
KnowledgeExists AcceptanceState `json:"knowledge_exists"`
ChunksPresent AcceptanceState `json:"chunks_present"`
RetrievalHit AcceptanceState `json:"retrieval_hit"`
GateStatus ReviewGateStatus `json:"gate_status"`
GateCode string `json:"gate_code"`
ReviewState ReviewState `json:"review_state"`
DecidedVisibility string `json:"decided_visibility"`
DecisionCode string `json:"decision_code"`
ReviewerRef string `json:"reviewer_ref"`
ReviewedAt *time.Time `json:"reviewed_at"`
PublicationUpdated time.Time `json:"updated_at"`
}
type ReviewCandidateFilter struct {
ReviewState string
Limit int
Offset int
}
type ReviewCandidatePage struct {
Items []ReviewCandidate `json:"items"`
Total int `json:"total"`
Limit int `json:"limit"`
Offset int `json:"offset"`
}
type PublicationReview struct {
ID string `json:"id"`
PublicationID string `json:"publication_id"`
Decision ReviewState `json:"decision"`
DecidedVisibility Visibility `json:"decided_visibility"`
ReviewerRef string `json:"reviewer_ref"`
DecisionCode string `json:"decision_code"`
AcceptanceRunID string `json:"-"`
PublicationUpdated time.Time `json:"-"`
CreatedAt time.Time `json:"created_at"`
}
// ReviewPublicationsBatchRequest 一次对多条候选做同一个审核决定(批量批准/驳回)。
type ReviewPublicationsBatchRequest struct {
PublicationIDs []string
Decision ReviewState
DecidedVisibility Visibility
DecisionCode string
ReviewerRef string
Now time.Time
}
// ReviewPublicationsBatchResult 逐条结果:Decided 是真正写入的,SkippedIDs 是那时不可审核的。
// 跳过的条目绝不静默——界面要能说清"哪几条没批成、为什么"。
type ReviewPublicationsBatchResult struct {
Selected int `json:"selected"`
Decided int `json:"decided"`
Skipped int `json:"skipped"`
SkippedIDs []string `json:"skipped_ids"`
Reviews []PublicationReview `json:"reviews"`
}
type ReviewPublicationRequest struct {
PublicationID string
Decision ReviewState
DecidedVisibility Visibility
ReviewerRef string
DecisionCode string
Now time.Time
}