Files
knowledge-governance/internal/governance/release_execution.go
T
zheromiku dcdc8d1ddd feat: 知识治理平台(含已验证发布/回滚契约)
全栈知识治理平台首次入库(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 干净
2026-09-30 10:54:06 +08:00

116 lines
4.0 KiB
Go

package governance
import "time"
type ReleaseOperation string
const (
ReleaseOperationPublish ReleaseOperation = "publish"
ReleaseOperationRollback ReleaseOperation = "rollback"
)
func (operation ReleaseOperation) Valid() bool {
return operation == ReleaseOperationPublish || operation == ReleaseOperationRollback
}
type ReleaseExecutionState string
const (
ReleaseExecutionPending ReleaseExecutionState = "pending"
ReleaseExecutionRunning ReleaseExecutionState = "running"
// R4: a rollback execution compensates in rolling_back and terminates in
// rolled_back (all compensated) or rollback_failed (manual action needed).
ReleaseExecutionRollingBack ReleaseExecutionState = "rolling_back"
ReleaseExecutionRolledBack ReleaseExecutionState = "rolled_back"
ReleaseExecutionRollbackFailed ReleaseExecutionState = "rollback_failed"
ReleaseExecutionCompleted ReleaseExecutionState = "completed"
ReleaseExecutionFailed ReleaseExecutionState = "failed"
)
func (state ReleaseExecutionState) Valid() bool {
switch state {
case ReleaseExecutionPending, ReleaseExecutionRunning, ReleaseExecutionRollingBack,
ReleaseExecutionRolledBack, ReleaseExecutionRollbackFailed,
ReleaseExecutionCompleted, ReleaseExecutionFailed:
return true
default:
return false
}
}
type ReleaseExecution struct {
ID string `json:"id"`
ReleaseBatchID string `json:"release_batch_id"`
Operation ReleaseOperation `json:"operation"`
PriorExecutionID string `json:"prior_execution_id"`
State ReleaseExecutionState `json:"state"`
FailureLevel string `json:"failure_level"`
RestoreTrigger string `json:"restore_trigger"`
ReleaseChangeSetID string `json:"release_change_set_id"`
TargetEnvironment string `json:"target_environment"`
AuthorizedBy string `json:"authorized_by"`
AuthorizationCode string `json:"authorization_code"`
JobID string `json:"job_id"`
ManifestSHA256 string `json:"manifest_sha256"`
ItemCount int `json:"item_count"`
BatchSize int `json:"batch_size"`
CurrentBatch int `json:"current_batch"`
TotalBatches int `json:"total_batches"`
CompletedItemCount int `json:"completed_item_count"`
FailedItemCount int `json:"failed_item_count"`
ErrorCode string `json:"error_code"`
CreatedAt time.Time `json:"created_at"`
StartedAt *time.Time `json:"started_at"`
CompletedAt *time.Time `json:"completed_at"`
}
type AuthorizeReleaseBatchRequest struct {
BatchID string
AuthorizedBy string
AuthorizationCode string
Now time.Time
}
type AuthorizeReleaseRollbackRequest struct {
PriorExecutionID string
AuthorizedBy string
AuthorizationCode string
Now time.Time
}
type RetryReleaseExecutionRequest struct {
ExecutionID string
Now time.Time
}
type ReleaseExecutionFilter struct {
Operation string
State string
Limit int
Offset int
}
type ReleaseExecutionPage struct {
Items []ReleaseExecution
Total int
Limit int
Offset int
}
type ReleaseItemExecutionView struct {
PublicationID string `json:"publication_id"`
Title string `json:"title"`
Action string `json:"action"`
State string `json:"state"`
PreviousProductionRevision string `json:"previous_production_revision"`
ProductionRevision string `json:"production_revision"`
ErrorCode string `json:"error_code"`
CreatedAt time.Time `json:"created_at"`
CompletedAt *time.Time `json:"completed_at"`
}
type ReleaseExecutionDetail struct {
ReleaseExecution
Items []ReleaseItemExecutionView `json:"items"`
}