📊 客户可对账看板与共享统计快照 #56

Closed
zhanghongming wants to merge 3 commits from codex/customer-dashboard-20261020 into codex/review-authoring-guards-20261020
Collaborator

Summary

在 #55(d6fe5e9b)之上交付客户可对账看板与非阻塞共享统计快照。本 PR 仅含两个提交:65c19de0 客户看板正式实现、962ea6da 共享按需快照。

  • 新增只读接口 GET /api/dashboard/annotation-output:以原始 part 为统计单位、整段源视频只计一次(双目不重复);提交取首次有效送检日期,质检/验收取有效正式决定完成日期,重提与请求重试去重;返工为当前状态快照并返回 asOf;作者/供应商按冻结版本归属,缺证据显示“—”。组织/本人/供应商边界由服务端主体验证,查询参数不能扩大权限。
  • 前端 Dashboard 按已确认版式重做:个人与管理员两套视图,供应商/人员/每日三级下钻,三张表独立分页(默认 5,可 5/10/20/50),全量 CSV 导出(防公式注入、UTF-8 BOM),详情只读并支持 Esc。
  • 共享快照:API 副本、日期、人员、页码复用同一代已解释统计事实;访问触发重建,默认 120 秒刷新、15 分钟陈旧上限、8 范围/16 槽/64 MiB 预算;构建失败保留上一代并退避,过期租约可接管,发布前校验长度/摘要;旧客户端等待同一构建并返回原有 200 结构。
GET /api/dashboard/annotation-output
  → 读取 Mongo 共享快照(同一 snapshotId)
  → 按当前身份/正式项目范围过滤 → 分页/全量导出
无快照、过期或范围变化
  → 访问触发后台重建(最多 2 条并行来源查询,15s maxTime)
  → 校验后原子替换可见代

历史补录未执行;生产历史覆盖与真实规模时延尚未核验,需后续只读抽样另立计划。

Evidence

  • 本机 27018 隔离合成 Mongo 定向测试:权限、冻结归属、跨期、重试/撤销、未完成计划、207 条分页、全量导出、时区/夏令时、CSV 转义、Memory/Mongo 一致性通过。
  • 共享快照:多 Store/Reader 同代、四实例并发冷启动仅 1 次来源重建、失败保留/退避/旧 owner fencing/遗弃租约接管、容量与字节预算、损坏代次拒绝;outputsnapshot/store/workforcestats/api 定向 go test -race 通过。
  • 三角色真实浏览器(管理员/标注员/供应商管理员,真实 router + 合成 Mongo):分页汇总、第 2 页全量导出、页大小重置、详情 Esc、下钻、项目切换、真实 409 后整页恢复;无页面异常、无非认证业务写请求。
  • 合成规模计时(5000 part / 25000 事件 / 4 个 API 实例):首次请求 224 ms,热请求 P50 15 ms / P95 17 ms;已发布版三次读取实测 13.7–14.7 s。合成值不能换算生产加速倍数。
  • 门禁:前端 13 项失败均属 14 项既有基线;Go 70 项失败均属 70 项既有基线,无新增失败,未改基线;TS/Prettier、Web 构建、Go API 构建、生产静态包真实浏览器启动通过。

详见 docs/verification/customer-dashboard-20261020/report.md、docs/verification/dashboard-snapshots-20261020/report.md、.scratch/customer-dashboard-20261020/spec.md、.scratch/dashboard-snapshots-20261020/spec.md。

Deployment

  • Fanyu 已部署 962ea6da(镜像 sha256:5915ff06…,API 与 annotation-processor),发布记录 dashboard-snapshots-20261020-962ea6da 状态为 deployed_pending_acceptance;6 项业务验收证据仍缺失,部署不等于验收。
  • 该接口对业务数据只读,但 GET 会触发内部派生统计写入:新增内部集合 annotationOutputSnapshotState / annotationOutputSnapshotSlots;通用数据库浏览器拒绝这两个集合,避免全组织快照绕过报表权限。

Merge Danger

Door: two-way,无 schema 迁移、无历史补写;不改旧 statistics 接口、工作流、任务状态或交付 JSON。回退到 65c19de0 不依赖这些快照(若回退需在计划中处理内部集合可见性)。

Blast Radius: dashboard 与 annotation-output 只读路径;新增内部快照重建/写入路径(GET 触发)。

客户历史补录、结算台账、生产多节点压测、Edge/HEVC 播放器升级不在本 PR 范围。

## Summary 在 #55(`d6fe5e9b`)之上交付客户可对账看板与非阻塞共享统计快照。本 PR 仅含两个提交:`65c19de0` 客户看板正式实现、`962ea6da` 共享按需快照。 - 新增只读接口 `GET /api/dashboard/annotation-output`:以原始 part 为统计单位、整段源视频只计一次(双目不重复);提交取首次有效送检日期,质检/验收取有效正式决定完成日期,重提与请求重试去重;返工为当前状态快照并返回 `asOf`;作者/供应商按冻结版本归属,缺证据显示“—”。组织/本人/供应商边界由服务端主体验证,查询参数不能扩大权限。 - 前端 `Dashboard` 按已确认版式重做:个人与管理员两套视图,供应商/人员/每日三级下钻,三张表独立分页(默认 5,可 5/10/20/50),全量 CSV 导出(防公式注入、UTF-8 BOM),详情只读并支持 Esc。 - 共享快照:API 副本、日期、人员、页码复用同一代已解释统计事实;访问触发重建,默认 120 秒刷新、15 分钟陈旧上限、8 范围/16 槽/64 MiB 预算;构建失败保留上一代并退避,过期租约可接管,发布前校验长度/摘要;旧客户端等待同一构建并返回原有 200 结构。 ```text GET /api/dashboard/annotation-output → 读取 Mongo 共享快照(同一 snapshotId) → 按当前身份/正式项目范围过滤 → 分页/全量导出 无快照、过期或范围变化 → 访问触发后台重建(最多 2 条并行来源查询,15s maxTime) → 校验后原子替换可见代 ``` 历史补录未执行;生产历史覆盖与真实规模时延尚未核验,需后续只读抽样另立计划。 ## Evidence - 本机 27018 隔离合成 Mongo 定向测试:权限、冻结归属、跨期、重试/撤销、未完成计划、207 条分页、全量导出、时区/夏令时、CSV 转义、Memory/Mongo 一致性通过。 - 共享快照:多 Store/Reader 同代、四实例并发冷启动仅 1 次来源重建、失败保留/退避/旧 owner fencing/遗弃租约接管、容量与字节预算、损坏代次拒绝;outputsnapshot/store/workforcestats/api 定向 `go test -race` 通过。 - 三角色真实浏览器(管理员/标注员/供应商管理员,真实 router + 合成 Mongo):分页汇总、第 2 页全量导出、页大小重置、详情 Esc、下钻、项目切换、真实 409 后整页恢复;无页面异常、无非认证业务写请求。 - 合成规模计时(5000 part / 25000 事件 / 4 个 API 实例):首次请求 224 ms,热请求 P50 15 ms / P95 17 ms;已发布版三次读取实测 13.7–14.7 s。合成值不能换算生产加速倍数。 - 门禁:前端 13 项失败均属 14 项既有基线;Go 70 项失败均属 70 项既有基线,无新增失败,未改基线;TS/Prettier、Web 构建、Go API 构建、生产静态包真实浏览器启动通过。 详见 `docs/verification/customer-dashboard-20261020/report.md`、`docs/verification/dashboard-snapshots-20261020/report.md`、`.scratch/customer-dashboard-20261020/spec.md`、`.scratch/dashboard-snapshots-20261020/spec.md`。 ## Deployment - Fanyu 已部署 `962ea6da`(镜像 `sha256:5915ff06…`,API 与 annotation-processor),发布记录 `dashboard-snapshots-20261020-962ea6da` 状态为 `deployed_pending_acceptance`;6 项业务验收证据仍缺失,**部署不等于验收**。 - 该接口对业务数据只读,但 GET 会触发内部派生统计写入:新增内部集合 `annotationOutputSnapshotState` / `annotationOutputSnapshotSlots`;通用数据库浏览器拒绝这两个集合,避免全组织快照绕过报表权限。 ## Merge Danger **Door:** two-way,无 schema 迁移、无历史补写;不改旧 statistics 接口、工作流、任务状态或交付 JSON。回退到 `65c19de0` 不依赖这些快照(若回退需在计划中处理内部集合可见性)。 **Blast Radius:** dashboard 与 annotation-output 只读路径;新增内部快照重建/写入路径(GET 触发)。 客户历史补录、结算台账、生产多节点压测、Edge/HEVC 播放器升级不在本 PR 范围。
zhanghongming added 2 commits 2026-10-21 00:05:04 +08:00
⚡ Share bounded dashboard snapshots across API instances
Some checks failed
web-ci / checks (push) Waiting to run
web-ci / checks (pull_request) Has been cancelled
962ea6da3d
zhanghongming added 1 commit 2026-10-21 00:13:24 +08:00
📝 Record dashboard snapshot deployment status and acceptance gaps
Some checks failed
web-ci / checks (pull_request) Has been cancelled
web-ci / checks (push) Has been cancelled
bc00467d24
Owner

@zhanghongming 10月22日审查固定 head=bc00467d,base=d6fe5e9b。结论:1项P2需求缺口,建议修复后合并。

Standards

组织/供应商/本人隔离、冻结归属、共享快照scope与租约发布路径未发现确定性权限阻断。outputsnapshot、workforcestats定向Go测试通过。

Spec

[P2] src/components/AnnotationOutputDashboard.tsx:229-230 的 exportRows 异常分支仅显示错误。快照超过15分钟或被回收后,CSV返回409 snapshot_expired,但页面保留旧 result.snapshot.id;用户再次导出仍请求同一失效ID,直到手工刷新。违反 .scratch/dashboard-snapshots-20261020/spec.md:15 的“过期或被回收的token明确返回冲突,整页切到新版本”。
已提取本PR真实 exportRows 在隔离Node执行:连续两次409均使用 expired-id,没有清pin或刷新看板。后端冲突行为本身已有测试覆盖。请复用分页GET的失效恢复:清除snapshot pin、整页刷新新代后再允许导出,不只重算CSV,补过期及回收两种真实导出回归。
此问题在 #57 的 src/features/annotation-output/useAnnotationOutputData.ts:113-114 仍存在。当前不合并 #56/#57;#55及以前已通过 #52 合入dev,未进行部署或业务数据写入。

@zhanghongming 10月22日审查固定 head=bc00467d,base=d6fe5e9b。结论:1项P2需求缺口,建议修复后合并。 ## Standards 组织/供应商/本人隔离、冻结归属、共享快照scope与租约发布路径未发现确定性权限阻断。outputsnapshot、workforcestats定向Go测试通过。 ## Spec [P2] src/components/AnnotationOutputDashboard.tsx:229-230 的 exportRows 异常分支仅显示错误。快照超过15分钟或被回收后,CSV返回409 snapshot_expired,但页面保留旧 result.snapshot.id;用户再次导出仍请求同一失效ID,直到手工刷新。违反 .scratch/dashboard-snapshots-20261020/spec.md:15 的“过期或被回收的token明确返回冲突,整页切到新版本”。 已提取本PR真实 exportRows 在隔离Node执行:连续两次409均使用 expired-id,没有清pin或刷新看板。后端冲突行为本身已有测试覆盖。请复用分页GET的失效恢复:清除snapshot pin、整页刷新新代后再允许导出,不只重算CSV,补过期及回收两种真实导出回归。 此问题在 #57 的 src/features/annotation-output/useAnnotationOutputData.ts:113-114 仍存在。当前不合并 #56/#57;#55及以前已通过 #52 合入dev,未进行部署或业务数据写入。
Owner

@zhanghongming 11月5日核对:本 PR 的完整 head 已是当前 dev=867d406c 的祖先(git merge-base --is-ancestor 已验证),代码实际上已进入主线。本次按“已由主线整合覆盖”补充说明并关闭重复 PR,不重复合并,不删除源分支,不执行部署。此项为包含关系及PR状态收尾,不冒充重新完成全部功能验收。

@zhanghongming 11月5日核对:本 PR 的完整 head 已是当前 dev=867d406c 的祖先(git merge-base --is-ancestor 已验证),代码实际上已进入主线。本次按“已由主线整合覆盖”补充说明并关闭重复 PR,不重复合并,不删除源分支,不执行部署。此项为包含关系及PR状态收尾,不冒充重新完成全部功能验收。
longtao.wu closed this pull request 2026-11-05 13:59:34 +08:00
Some checks failed
web-ci / checks (pull_request) Has been cancelled
web-ci / checks (push) Has been cancelled

Pull request closed

Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: longtao.wu/droboticflow#56
No description provided.