Files
knowledge-governance/internal/jobs/errors.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

52 lines
1.5 KiB
Go

package jobs
import "errors"
// Error codes persisted with terminal failures (P6 DLQ). The table is closed:
// a handler without an explicit code lands in "handler_error" so the DLQ never
// shows a blank classification.
const (
ErrCodeNoHandler = "no_handler"
ErrCodeArtifactInvalid = "artifact_invalid"
ErrCodeRemotePermanent = "remote_permanent"
ErrCodeUploadIdentity = "upload_identity_ambiguous"
ErrCodeValidationFailed = "validation_failed"
ErrCodeStateConflict = "state_conflict"
ErrCodeHandlerFallback = "handler_error"
)
// PermanentError marks a failure that must not consume the retry budget:
// the job goes straight to the terminal (dead-letter) state.
type PermanentError struct {
Code string
Err error
}
func (e *PermanentError) Error() string { return e.Err.Error() }
func (e *PermanentError) Unwrap() error { return e.Err }
func Permanent(code string, err error) error {
return &PermanentError{Code: safeCode(code), Err: err}
}
// Terminal reports whether an error must fail immediately plus its stable code.
func Terminal(err error) (bool, string) {
var permanent *PermanentError
if errors.As(err, &permanent) {
return true, safeCode(permanent.Code)
}
return false, ErrCodeHandlerFallback
}
func safeCode(code string) string {
if code == "" || len(code) > 64 {
return ErrCodeHandlerFallback
}
for _, r := range code {
if !(r == '_' || r >= 'a' && r <= 'z' || r >= '0' && r <= '9') {
return ErrCodeHandlerFallback
}
}
return code
}