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 }