droboticflow/docs/verification/source-validation-admission.md

3.9 KiB
Raw Blame History

源校验准入本地验证

基线:origin/dev 的 5d1135a0。任务分支 codex/source-gate-pool-search。仅本地内存、临时媒体及独立命名 Mongo 测试库;未修改生产数据。

可复现缺陷

新增 TestSourceValidationFailureBlocksRandomClaimWithoutLosingDraft 与 TestPendingSourceValidationIsNotAssigned,经真实随机领取 HTTP handler 复现:失败或等待校验的 random-item-0 被分配。修复前两项均失败,修复后通过。

功能与恢复

  • 校验失败/等待不领取、不计入可领取数量;已有草稿、版本、归属保留。
  • 管理员确认修复后可重校验,其他角色拒绝;重校验完成前继续阻断。
  • 已过期校验器、迟到的读取失败不能覆盖新的校验代次。
  • 未要求重验的旧任务实际发现非法 IMU 后会保存异常;无旧记录的失败插入不能覆盖并发新校验。旧任务修复、payload-only 源索引记录补证均经过真实校验器恢复;草稿与归属不变,跨组织读取和非管理员重验拒绝。
  • 直接领取的存储边界加固:同版本内源作业变更时,陈旧快照不能覆盖当前缺证、失败或有效的新作业。内存与 Mongo 使用同一回归;这不是已观察到的线上生产竞态。
  • 已完成时间轴仍受当前源证书失败约束;新源索引 outbox 缺证书拒绝,旧物理 outbox 不强制新增协议。
  • 原指纹 A 失败,修复 B 成功,仅替代 A;之后 C 缺证书/失败继续阻断。内存和真实 Mongo 覆盖等价。
  • 真实合成双目视频/IMU:末行 gyro 改成 gyr,真实解析拒绝;恢复文件并调用管理员重校验,真实后台校验器建立当前指纹证书,旧失败作业与已保存内容不变。
  • 原来校验成功的文件再次损坏,工作台检测后撤销准入并给出可执行重校验入口。取消或超时的读取请求不会把有效源数据误标为异常;新增取消请求回归先复现误标,再通过。
  • 现有随机领取、源索引、时间轴与源校验等待回归通过。委托只读对象存储用真实校验器完成验证后,左右时间轴正常读取,全程仅 HEAD/GET;未校验时明确返回等待状态。

可复跑:

GOCACHE=/tmp/droboticflow-dashboard-go-cache go test ./internal/api -run 'Test(SourceIndex|Annotation.*Timeline|Annotation.*Source|HardwareIMU|SourceValidationWait|RandomClaim|SourceFailureDetected|SourceRepair|RequiredSource|SourceValidation|PendingSourceValidation|CurrentPreparedSourceFailure)' -count=1
SOURCE_ADMISSION_LOCAL_MONGO=1 GOCACHE=/tmp/droboticflow-dashboard-go-cache go test ./internal/store -run '^TestSourceAdmission(Memory|Mongo)' -count=1 -v
POOL_LOCAL_MONGO_URI=mongodb://127.0.0.1:27018 GOCACHE=/tmp/droboticflow-dashboard-go-cache go test ./internal/store -run '^TestClaimCountMongoSparseBacklogPlan$' -count=1 -v

查询对照

同一本地 Mongo、1,200 条全部可用任务、每条 64 KiB subject(共 75 MiB),连续三轮:

指标 第 1 轮 第 2 轮 第 3 轮
原计数逻辑(不做源校验准入) 7.43 ms 6.17 ms 4.24 ms
加准入过滤后的计数 143.78 ms 133.14 ms 139.71 ms
准入候选列表 134.21 ms 139.77 ms 144.18 ms

每轮候选 JSON 均为 508,801 字节,任务数未减少。1200 条保留历史仅 1 条候选的稀疏场景,计数约 3–10 ms,关键读计划最大扫描量为 1。

计数的额外关联开销真实存在。一次条件关联改写在 Mongo 8 上反而变为约 750 ms,已撤回,保留实测更快的 ID 等值关联与必要字段投影。没有通过放宽准入或减少可见任务改善数字。

上述是本地单请求查询对照,不代表 120 人完整作业、生产媒体/数据库/网络负载或长期运行已达标。浏览器和全量门禁由本次整体验证记录汇总。