Files
knowledge-governance/internal/httpapi/library_deadletters.go
T
姚章浩 c2402947a9
build / build (push) Successful in 1m26s
feat(library): 死信按精确指纹解除,保留上游记录
上游 task_dead_letters 没有解决标记,purge/DELETE 会销毁"失败过"的唯一证据。
治理侧新增解除记录(迁移 073):绑定实时行逐字节指纹、重放引用、源侧观测摘要与
操作人;行被改过、重放后又出现新死信、源侧未结清都不命中,封存照旧阻断。
指纹先压紧空白再摘要,避免 PG to_jsonb::text 与 json.Marshal 的空白差异。

试过:go test ./internal/{librarydeadletter,libraryagent,httpapi,releaseadapter/v071,
platform/postgres},make verify 15 项全绿。
2026-10-29 06:55:13 +08:00

105 lines
4.1 KiB
Go

package httpapi
import (
"context"
"encoding/json"
"net/http"
"strings"
"time"
"knowledge-governance/internal/governance"
"knowledge-governance/internal/librarydeadletter"
)
// 死信解除:上游 task_dead_letters 没有"已解决"标记。这里只写治理库的审计记录,
// 永不删除上游行;解绑的是精确指纹,行一变就不再命中,封存照旧阻断。
type deadLetterReleaseStore interface {
RecordDeadLetterRelease(context.Context, governance.LibraryDeadLetterRelease) (governance.LibraryDeadLetterRelease, bool, error)
DeadLetterReleases(context.Context, string, int) ([]governance.LibraryDeadLetterRelease, error)
}
type deadLetterReleaseRequest struct {
DeadLetterID int64 `json:"dead_letter_id"`
Replay librarydeadletter.Replay `json:"replay"`
Note string `json:"note"`
Observation json.RawMessage `json:"observation"`
ObservationDigest string `json:"observation_digest"`
}
func deadLetterReleaseHandlers(w http.ResponseWriter, r *http.Request, config Config) {
identity, ok := requireSessionIdentity(w, r)
if !ok {
return
}
store, ok := config.Store.(deadLetterReleaseStore)
if !ok {
writeJSON(w, http.StatusServiceUnavailable, map[string]string{"error": "死信解除存储不可用"})
return
}
instance := strings.TrimSpace(config.LibraryTargetInstance)
if instance == "" {
writeJSON(w, http.StatusServiceUnavailable, map[string]any{
"code": "dead_letter_release_unwired", "reason": "未接线:没有配置来源实例身份,无法绑定解除记录",
})
return
}
if r.Method == http.MethodGet {
releases, err := store.DeadLetterReleases(r.Context(), instance, 100)
if err != nil {
writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "读取死信解除记录失败"})
return
}
writeJSON(w, http.StatusOK, map[string]any{"instance": instance, "releases": releases})
return
}
// 写操作需要工程师及以上,并要求显式意图头:避免普通点击意外解除。
if roleRank(identity.Role) < roleRank(roleEngineer) {
writeJSON(w, http.StatusForbidden, map[string]string{"error": "forbidden"})
return
}
if r.Header.Get("X-Governance-Action") != "dead-letter-release" {
writeJSON(w, http.StatusForbidden, map[string]string{"error": "write intent required"})
return
}
var request deadLetterReleaseRequest
if err := json.NewDecoder(http.MaxBytesReader(w, r.Body, 1<<20)).Decode(&request); err != nil {
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid request body"})
return
}
now := time.Now().UTC()
release, err := librarydeadletter.Verify(librarydeadletter.Request{
Project: instance, DeadLetterID: request.DeadLetterID, Replay: request.Replay,
Note: request.Note, Observation: request.Observation, Digest: request.ObservationDigest,
}, instance, now)
if err != nil {
writeJSON(w, http.StatusConflict, map[string]any{"code": "dead_letter_release_rejected", "error": err.Error()})
return
}
stored, reused, err := store.RecordDeadLetterRelease(r.Context(), governance.LibraryDeadLetterRelease{
ID: governance.LibraryDeadLetterReleaseID(instance, release.Fingerprint),
Instance: instance,
TenantID: release.TenantID,
KnowledgeBaseID: release.KnowledgeBaseID,
DeadLetterID: release.DeadLetterID,
Fingerprint: release.Fingerprint,
TaskType: release.TaskType,
Scope: release.Scope,
ScopeID: release.ScopeID,
RelatedID: release.RelatedID,
ReplayQueue: release.Replay.Queue,
ReplayTaskID: release.Replay.TaskID,
ReplayedAt: release.Replay.At,
ReplayEvidence: release.Replay.Evidence,
ObservationDigest: release.Digest,
Observation: release.Observation,
Note: release.Note,
Actor: identity.Username,
CreatedAt: now,
})
if err != nil {
writeJSON(w, http.StatusConflict, map[string]any{"code": "dead_letter_release_conflict", "error": err.Error()})
return
}
writeJSON(w, http.StatusOK, map[string]any{"release": stored, "reused": reused})
}