98294b9583
build / build (push) Failing after 24s
why:审计 19 项(12 P1 / 7 P2)来自同一批根因,逐点试错会把协议撕成十几份:
· 意图与执行混为一谈(F01/F15):`library.sync:<scope>:<快照>` 是终身幂等键,
A→B→A 的第三次发布拿到第一次的历史成功作业,什么都不做;
· 版本行既是实体又是事件(F02/F09):主键只由 (kind,scope,快照) 决定、写入是
upsert,第二个作业覆盖 `source_job_id`/`evidence`/`created_at`;
· 接管没有代次(F13):两个 worker 都能认领同一 pending 作业,失租的旧执行还能
写业务状态、释放别人的维护锁;
· 早退与终态没有统一政策(F03/F04/F05/F06):半写窗口的前置检查失败会重新开门、
服务起不来也照样开入口、journal 终态后收尾不可重建、恢复成功不回写 current;
· 数据身份与准入各写一套(F07/F08/F14/F17):接管丢了复用语义、全库搬运不改
location_hash、通用入口可造 library.* 作业、目标模型从没被问过;
· 存储/容量/UI/CI 判据各自为政(F10/F11/F12/F16/F18/F19)。
what:按批准的一套协议集中实施(详见 handoffs/release-consolidated-implementation/
current-contract.md):
· operation(一次明确意图)/ attempt(epoch 代次)/ 不可变版本事件 / current 指针;
治理库迁移 76,只动治理库,不碰 WeKnora Schema/源码/镜像;
· 所有业务状态、阶段、版本事件、维护锁写入带 epoch 守卫(失租代次写不进去);
心跳失租立刻取消 handler;
· 半写窗口早退保持关闭;服务未全部健康绝不开入口;journal 终态可从持久事实重建
收尾;恢复成功登记 recovery 事件并推进 current;
· worker 在动维护前核对业务行/kind/scope/队列关联;通用入口拒绝 library.*;
· 全库搬运重算 location_hash 并与文档级导入共用实现;接管消费写集合的复用决定;
发布前核目标实时模型契约、容量门禁前置;
· 存储保护闭包改为全量依赖、类型只认显式登记、保护未知则不出可删候选;
· 页面核 HTTP 状态与结构、恢复纳入轮询、Wiki 差异覆盖标题/摘要/父级。
how:`make verify` rc=0(16 项必需检查全绿,含 go test 全量与前端 485 例);
`go vet ./...` rc=0;`npx tsc -p tsconfig.json --noEmit` rc=0;逐项负例见各包测试
(F03/F04/F08/F12/F13/F14/F16/F18/F19 都有先红后绿记录)。
未执行:治理库迁移到任何已有库、真实 PG/ES/S3/WeKnora 集成、故障注入、部署。
52 lines
2.5 KiB
Go
52 lines
2.5 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
|
|
"knowledge-governance/internal/governance"
|
|
"knowledge-governance/internal/jobs"
|
|
postgresstore "knowledge-governance/internal/platform/postgres"
|
|
)
|
|
|
|
// 准入:worker 在动维护/目标之前,必须自己证明"这个队列作业确实是这条业务作业"。
|
|
//
|
|
// 为什么不能只靠"通用入口拒绝 library.*":那只堵住了一个入口。队列里仍可能因为历史
|
|
// 残留、手工 SQL、别的服务投递而出现畸形作业;而 worker 拿到没有业务行的作业时会照常
|
|
// 取维护锁、停写入者、开备份窗口(F14 的真实现场)。所以准入必须在**副作用之前**,
|
|
// 并且同时核三件事:业务行存在、kind/scope 与载荷一致、队列关联不可伪造。
|
|
func admitLibraryJob(ctx context.Context, store *postgresstore.Store, queueJob jobs.Job,
|
|
libraryJobID, scope string, kind governance.LibraryJobKind, requireQueueMatch bool) (governance.LibraryJob, error) {
|
|
if libraryJobID == "" {
|
|
return governance.LibraryJob{}, errors.New("载荷缺少业务作业号:拒绝执行")
|
|
}
|
|
if scope != "internal" && scope != "external" {
|
|
return governance.LibraryJob{}, fmt.Errorf("载荷 scope 非法(%q):拒绝执行", scope)
|
|
}
|
|
business, err := store.LibraryJob(ctx, libraryJobID)
|
|
if err != nil {
|
|
// 没有业务行 ⇒ 这次执行没有准入依据(闸口/授权/维护归属都无从核对)。
|
|
return governance.LibraryJob{}, fmt.Errorf("队列作业 %s 没有对应的业务作业 %s:拒绝在任何维护动作前继续",
|
|
queueJob.ID, libraryJobID)
|
|
}
|
|
if business.Scope != scope {
|
|
return governance.LibraryJob{}, fmt.Errorf("业务作业 %s 属于 scope=%s,载荷声称 %s:拒绝", libraryJobID, business.Scope, scope)
|
|
}
|
|
if kind != "" && business.Kind != kind {
|
|
return governance.LibraryJob{}, fmt.Errorf("业务作业 %s 的 kind=%s,与执行器 %s 不一致:拒绝", libraryJobID, business.Kind, kind)
|
|
}
|
|
if requireQueueMatch {
|
|
// 队列关联由 API 在建作业后写入;为空说明投递没有落定,不匹配说明这个队列作业
|
|
// 不是为它准备的。两种情况都不能执行。
|
|
if business.QueueJobID == "" {
|
|
return governance.LibraryJob{}, fmt.Errorf("业务作业 %s 没有队列关联:拒绝执行未落定的投递", libraryJobID)
|
|
}
|
|
if business.QueueJobID != queueJob.ID {
|
|
return governance.LibraryJob{}, fmt.Errorf("队列作业 %s 不是业务作业 %s 的关联作业(%s):拒绝",
|
|
queueJob.ID, libraryJobID, business.QueueJobID)
|
|
}
|
|
}
|
|
return business, nil
|
|
}
|