🐛 Preserve worker roles in dashboard statistics filters
Some checks failed
web-ci / checks (push) Has been cancelled
web-ci / checks (pull_request) Has been cancelled

This commit is contained in:
d-robotics 2026-10-20 20:00:57 +08:00
parent 86a1d7a360
commit d6fe5e9be3
5 changed files with 126 additions and 2 deletions

View File

@ -0,0 +1,36 @@
# 客户可对账看板
Status: ready-for-agent
## 已确认
2026-10-20 用户选择可对账版。每个 part 为统计单位,使用整段视频时长,双目不重复计时;不改现有按源采集统计的生产进度面板。个人看板和管理员人员产出新增明确的 part 口径。
客户原始需求:[标注员](https://applink.feishu.cn/client/chat/open?openChatId=oc_ff3c7f66ecfd607ffebd120f0113dbca&position=94)、[管理员](https://applink.feishu.cn/client/chat/open?openChatId=oc_ff3c7f66ecfd607ffebd120f0113dbca&position=95)。版式沿用客户示例;不同时重设计左侧导航和平台其他页面。
## 数据口径
- 提交:首次成功送检,按该日期入账;反复保存/返工重提不重复累计。明确重跑或撤销完成证据的规则需沿用正式版本链,不按 revision 大小猜测。
- 质检通过、验收通过:各按有效正式决定实际完成日期入账,重复决定/重试不重复;同一 part 可以在不同日期分别进入各阶段。撤销/打回后的处理保留事件历史及当前状态,明细显示证据,不能直接把当前最新状态当历史结论。
- 返工中:当前状态快照,不是期间返工次数;范围为当前筛选归属、在查询截止时刻仍需返工的 part。日期范围不能把历史已解决返工再次算成当前返工。若要历史截止日快照,必须有可靠状态事件重放;否则仅显示当前时刻并注明。
- 时区:显示当前账号配置的统计时区;按本地日界转 UTC 半开区间,查询与导出一致。
- 可结算参考:本期有效验收通过整段时长,不表示已付款或新增结算凭证;本期去重与跨期不重复结算需将来另立实际结算台账,原型不冒充结算系统。
- 归属:使用提交/被审版本冻结的作者、供应商;不能按当前任务分配人或现任角色重写历史。缺证据显示待核对,并显示已核实/待核对覆盖范围。
## 个人版式
日期筛选/查询/导出;顶部提交、质检通过、最终验收通过、返工中数量及时长和可结算参考;下方我的任务明细:part、整段时长、首次提交时间、质检/验收/当前状态、查看详情。查看详情只读,不自动领取。
## 管理员版式
日期/项目/供应商/标注员筛选及导出;顶部四项时长;供应商产出表展示人员数及对应时长;查看人员后下钻每日与累计数据,再下钻任务证据。每层继承筛选、权限与统计单位,关闭明细保留位置;累计为截至选择结束日的累计,不能把所选期间之和标成历史累计。
## Mongo 补录边界
先读已有证据生成缺口清单。可恢复的字段逐项列来源与冲突,须经用户确认才补录;不能恢复的留空待核对,不为凑齐看板造记录。报表计算、可选内部统计快照与客户交付 JSON 分开。
## 本次交付状态
角色筛选的 role 投影缺陷已修复并完成本地 Mongo/真实 router 回归,待合入和另行发布。本地看板原型仅供版式/交互评审,使用明确标识的合成数据。真实指标接口、完整导出和生产历史覆盖率仍待实现/核实。
原型源码保存在独立 `codex/dashboard-reconciliation-prototype-20261020` 分支,不进入生产代码;入口为 tests/browser/fixtures/dashboard-reconciliation-prototype.html。

View File

@ -0,0 +1,39 @@
# 看板筛选、交付内容与浏览器兼容核对(2026-10-20)
## 本次修复
人员看板选择标注员角色后旧数据消失:`LoadWorkforceStats` 的内存用户副本和 Mongo 字段投影均漏了 `role`。聚合层按角色筛选时,将真实标注员当作空角色排除。两处补读同一字段即可,无需补写用户或统计记录,不修改数据格式、权限、日期或去重口径。
修复前 `TestWorkforceStatsMemory` 和 `TestWorkforceStatsMongoReplicaParity` 均报 `statistics user projection lost role`。修复后本地 27018 的新建合成数据库与内存查询通过;覆盖按天/按人员、角色与非匹配角色、汇总一致、正式记录不变。真实 HTTP router 检查 `/api/dashboard/workforce` 和 `workload-summary` 的管理员/个人角色筛选与既有成员权限;`go test ./internal/api ./internal/workforcestats ./internal/store -run 'TestWorkforce|TestDashboardWorkforce' -count=1` 通过。未连接生产数据库写入;本修复尚未部署。
## 交付文件核对
v3 原生 part 包恰好 `part.json` 和 `review-history.json`,发布端另有完成/归属控制文件;不复制视频、标定、PTS、IMU、姿态帧。不可变批次则为 `delivery_index.json`、每采集 `annotation_manifest.json`、每 part 主 JSON 和独立历史 JSON。原始 meta/媒体为校验或路径引用,不是随包复制。
| 主 JSON 精简内容 | 其他位置 | 是否随 v3 包提供 |
| --- | --- | --- |
| `acceptance.qualityReviews` | `review-history.json`;批次内改名为 `partNNNN.review-history.json`,固定 capture/part/revision | 是,审核任务/修订/决定/审核人/时间 |
| 切片内重复标定引用 | 同一 part 顶层 `calibration[]` | 是,文件本体通过原始目录引用 |
| 动作内部 `status` | 交付改用 `contentKind`;内部状态保留在标注记录 | 原 `status` 不再随包 |
| 空 taskLabel/taskLabelId | 无有意义内容可转存;有效值继续保留 | 空字段省略 |
| 最终验收人 `confirmedByUserId`、舍弃操作者 `discardedByUserId` | 生成前验收摘要/物化修订与平台内部记录仍是来源 | 不在新交付其他 JSON 中自动补存 |
| 质检意见正文、旧描述、完整编辑/返修轨迹 | 平台正式审核/标注历史;交付历史仅为白名单摘要 | 不在交付 JSON 中;不能称为已随包保存 |
| 姿态帧、PTS/IMU、原始 meta/标定内容 | 固定修订/原始数据引用 | 文件本体不随纯索引包复制 |
因此不能承诺“从总 JSON 去掉的所有字段都在另一个交付 JSON 里”。如客户需要完整审计导出,应另行确定内部独立 JSON 的字段/权限/版本,保持主交付格式不变,不静默扩大客户包。v3 package 镜像/工作流开关尚未切换;API 代码上线不代表线上包已改为 v3。真实多 part 客户验收按本次指示暂缓。
## Edge
已有只读调查证明目标左右视频为 HEVC/hev1,Range/CORS 正常,本机 macOS Edge 原生路径可显示首帧。客户反馈故障电脑 Chrome 可播放、最新版 Edge 不可播。当前平台为 movi-player 0.4.1 的 native→WASM 组合;此前强制 WASM 受 1MiB 读取预算中止,不能作为兼容成功或失败证据。线上 HTTP 页探测 `VideoDecoder` 不可用,也不能假设 WASM 能完整弥补原生解码失败。
微软文档确认 Windows Edge 的 HEVC 依赖有效扩展与系统解码链,可能出现 Chrome 可播、Edge 失败;故障客户端尚缺系统信息与 media-internals 错误。结论是解码/回退链待定位,不能认定 movi 不兼容或升级浏览器即可解决。
来源:[Microsoft Edge video playback](https://learn.microsoft.com/en-us/troubleshoot/microsoft-edge/development/video-playback-issues)、[WebCodecs secure context contract](https://www.w3.org/TR/webcodecs/)。诊断时仅需解码器名称/错误码,不需要客户视频正文或凭证。
## 看板方案与 Mongo
用户已选择可对账版,业务设计见 [规格](../../../.scratch/customer-dashboard-20261020/spec.md)。先本地原型评审;新统计指标/API、导出和历史覆盖率尚未实现,不能将角色筛选修复视为完整看板交付。
Mongo 是权威业务记录,报表应由任务、成功提交、版本与正式审核证据计算;无需把易变化的看板卡片值复制进每个标注/交付 JSON。可选内部统计快照可独立保存,必须绑定单位、时区、范围、版本和证据来源,当前不写。
已有 `annotationWorklogEvents` 的提交身份/类型/视频秒数,以及版本、切片范围、正式 `reviewOperations` 和 `annotationReviews`,可用于重建可靠的 part、时间、归属与决定。实际覆盖率还需限定范围只读盘点。可补候选仅限:由已冻结修订确定的整段时长;由成功事件确定的提交时间/身份;由正式决定确定的审核时间/结论与当时归属。缺失历史不得用当前领取人、更新时间或统一15分钟猜测;缺少证据则待核对。任何生产补录在逐字段候选报告经用户确认后执行。本次未补写 Mongo,未发布 BOS。

View File

@ -46,6 +46,31 @@ func TestWorkforceReportsAgreeAndDetailsRespectMemberScope(t *testing.T) {
if workload.Totals.FirstSubmittedTasks != 1 || workload.Totals.QualityReturns.DecisionCount != 21 || workload.Totals.QualityReturns.TaskCount != 1 {
t.Fatalf("report %+v", workload.Totals)
}
// The report query and response must retain role information end to end.
for _, user := range []domain.UserRecord{f.annotator, f.admin} {
for _, endpoint := range []string{"/api/dashboard/workforce", "/api/plugins/annotation-qa/workload-summary"} {
for _, group := range []string{"member", "day"} {
for _, role := range []string{"annotator", "quality_reviewer"} {
filtered := f.request("GET", endpoint+"?projectId="+f.task.ProjectID+"&groupBy="+group+"&role="+role, user, nil)
var body struct {
Items []domain.DashboardWorkforceMetric `json:"items"`
Totals domain.DashboardWorkforceMetric `json:"totals"`
}
check(json.Unmarshal(filtered.Body.Bytes(), &body))
if filtered.Code != 200 {
t.Fatalf("role report %d %s", filtered.Code, filtered.Body.String())
}
if role == "annotator" {
if len(body.Items) != 1 || body.Items[0].Role != role || body.Totals.FirstSubmittedTasks != 1 {
t.Fatalf("role filter dropped author output %s/%s: %s", endpoint, group, filtered.Body.String())
}
} else if len(body.Items) != 0 || body.Totals.FirstSubmittedTasks != 0 {
t.Fatalf("role filter leaked output: %s", filtered.Body.String())
}
}
}
}
}
for _, user := range []domain.UserRecord{f.annotator, f.admin} {
r = f.request("GET", "/api/workforce-returns?userId="+f.annotator.ID+"&limit=20", user, nil)
var page struct {

View File

@ -112,7 +112,7 @@ func (s *MemoryStore) LoadWorkforceStats(_ context.Context, org string, q workfo
}
for _, u := range s.users {
if organizationMatches(u.OrganizationID, org) {
d.Users = append(d.Users, domain.UserRecord{ID: u.ID, Name: u.Name, SupplierID: u.SupplierID})
d.Users = append(d.Users, domain.UserRecord{ID: u.ID, Name: u.Name, SupplierID: u.SupplierID, Role: u.Role})
}
}
for _, v := range s.suppliers {
@ -502,7 +502,7 @@ func (s *MongoStore) LoadWorkforceStats(ctx context.Context, org string, q workf
}
}
}
if err := read(s.users, organizationScopedFilter(org, bson.M{}), fields("id", "name", "supplierId"), &d.Users); err != nil {
if err := read(s.users, organizationScopedFilter(org, bson.M{}), fields("id", "name", "supplierId", "role"), &d.Users); err != nil {
return d, err
}
if err := read(s.suppliers, organizationScopedFilter(org, bson.M{}), fields("id", "name"), &d.Suppliers); err != nil {

View File

@ -64,6 +64,30 @@ func checkWorkforceStats(t *testing.T, s Store) workforcestats.Report {
t.Fatal(err)
}
r := workforcestats.Build(d, q)
// Role-filtered reads must preserve the same records and aggregate values.
if len(d.Users) != 1 || d.Users[0].Role != domain.UserRoleAnnotator {
t.Fatalf("statistics user projection lost role: %+v", d.Users)
}
for _, group := range []string{"member", "day"} {
for _, role := range []string{"", string(domain.UserRoleAnnotator), string(domain.UserRoleQualityReviewer)} {
filteredQuery := q
filteredQuery.GroupBy, filteredQuery.Role = group, role
filteredData, err := s.LoadWorkforceStats(t.Context(), "workforce-test", filteredQuery)
if err != nil {
t.Fatal(err)
}
filtered := workforcestats.Build(filteredData, filteredQuery)
if role == string(domain.UserRoleQualityReviewer) {
if len(filtered.Items) != 0 || filtered.Totals.FirstSubmittedTasks != 0 {
t.Fatalf("role filter leaked annotator output: %+v", filtered)
}
} else {
if len(filtered.Items) != 1 || filtered.Items[0].Role != string(domain.UserRoleAnnotator) || !reflect.DeepEqual(filtered.Totals, r.Totals) {
t.Fatalf("role filter dropped output (%s/%s): %+v", group, role, filtered)
}
}
}
}
if r.Totals.FirstSubmittedTasks != 1 || r.Totals.ReworkSubmissionCount != 0 || r.Totals.FirstVideoSeconds != 79 || r.Totals.QualityReturns.DecisionCount != 1 || r.Totals.QualityReturns.ProblemCount != 1 || r.Totals.QualityReturns.VideoSeconds != 10 {
t.Fatalf("incorrect report %+v", r.Totals)
}