📝 Consolidate production dashboard design and preview findings
This commit is contained in:
parent
51b9aab9e7
commit
5f2d796d92
84
.scratch/project-production-dashboard/design.md
Normal file
84
.scratch/project-production-dashboard/design.md
Normal file
@ -0,0 +1,84 @@
|
||||
# 项目与供应商生产统计:整合设计
|
||||
|
||||
Status: awaiting-final-design-confirmation
|
||||
|
||||
Q1–Q20 的业务回答已确认;本稿将其整合为页面与验证方案,等待用户确认整体理解。当前不实施产品功能,不授权 PR、推送、部署或线上数据改动。
|
||||
|
||||
## 页面层次
|
||||
|
||||
在平台管理员的现有仪表盘顶部增加生产统计区;原有服务状态、工作量记录、运行记录等内容保留在下方。沿用平台配色、字体、表格和控件风格。
|
||||
|
||||
1. 顶部筛选:项目、供应商、项目状态(全部含归档 / 仅进行中),显示当前统计范围,提供返回全部。
|
||||
2. 两种统计视图:默认“当前进度”,可切“期间产出”。项目和供应商筛选作用于整个新统计区,不出现顶部全局、表格局部却没有标识的混用。
|
||||
3. 当前进度摘要:项目源数据量、当前已交付、异常/待核对。阶段分布在下一行,避免把所有细状态做成常驻卡片。已交付与异常均是总量中的子集,不是额外数据量。
|
||||
4. 阶段分布:接入与自动处理、标注、质检、终审、交付处理、已交付、已结束未交付。待核对有数据时单列。异常以所属阶段内的醒目数字提示,不再作为可相加的独立主阶段。
|
||||
5. 一张汇总表:切换按项目 / 按供应商。点击名称进入对应的另一维度;点击数值打开右侧明细。
|
||||
6. 明细保留范围与原表位置,显示源采集、项目、生产供应商、主阶段/细状态及关联任务,支持搜索、分页和只读查看。关闭不重置筛选,不自动领取、启动或改动业务。
|
||||
|
||||
桌面保留右侧明细;较窄内容区允许表格横向滚动、控件换行,避免把数字挤成不可读的小字。布局示意中的数据全部为模拟值。
|
||||
|
||||
## 数据范围与单位
|
||||
|
||||
- 仅当前管理员有权管理、且明确纳入生产统计的项目。纳入范围由管理员在管理设置维护;既有项目先核对清单,新项目确认后才计入。
|
||||
- 内部测试不出现在统计数、明细、项目筛选或供应商产出中。不得按名称包含 test、供应商默认状态或客户字段为空猜测。
|
||||
- 已归档生产项目默认计入,可选仅进行中项目。未配置统计范围时显示待配置,不用 0 冒充客户没有数据。
|
||||
- 单位仅为源数据份数,不展示或统计视频小时数。本需求不删除业务视频时长、不改动其他页面的既有数据字段。
|
||||
- 同项目、同一来源目录的 Capture 只计一份;多个工作流、重试、重跑、切片、动作及左右镜头不增加源数据份数。存储命名空间不同不能只因目录尾名相同而合并。
|
||||
- 同源用于两个项目,各项目各计一份,总览计两份;不做跨项目内容去重,也不读取视频做内容比对。
|
||||
- 已发现登记即计入,包括文件未齐、待处理和失败。未被平台发现的存储文件不计入。
|
||||
|
||||
## 当前进度
|
||||
|
||||
- 以最新一轮正式处理的权威记录归并,不以列表中“最近更新的一条 HumanItem”猜测;调试运行不影响生产进度。
|
||||
- 同轮多任务按最早尚未完成环节归并,所有应完成任务完成后才视作该源完成;按现有流程的必要阶段处理,不强制给未要求终审的任务补终审步骤。
|
||||
- 已交付后正式重跑回标注,当前只在标注计一份;既有交付证据留在历史/期间记录中。
|
||||
- 切片生成和送检尚未实际完成交接时,不提前算进入质检;领取、处理中、返工等是主阶段内的细状态。
|
||||
- 失败、待核对、已结束未交付与仍需处理的在途任务明确区分;全舍弃、取消等终结原因在明细中解释,不混同“已交付”。
|
||||
- 所有已知主阶段加待核对等于范围内项目源数据量。阶段条和项目行共享同一统计口径,不从有分页上限的列表求和。
|
||||
|
||||
## 供应商维度
|
||||
|
||||
- 当前进度按生产任务供应商归属;未领取公共源任务单列未分配,不复制给所有获授权供应商。
|
||||
- 匿名终审项即使 supplierId 为空,也追溯原生产任务;不会因为审核人属于另一供应商而改变生产归属。
|
||||
- 撤销授权、停用人员不删除历史贡献或既有任务统计。
|
||||
- 缺失/冲突导致无法可靠确定归属时列待核对,禁止猜测分配或重复加总。
|
||||
|
||||
## 期间产出
|
||||
|
||||
- 默认近7个北京时间自然日,含今天;提供今日、近7日、近30日、自定义。自定义结束日包含整天,查询边界使用次日零点,避免重复包含相邻窗口边界。
|
||||
- 日期只影响期间产出,不声称可还原某历史时刻的完整在途快照。
|
||||
- 新增源数据、成功送检、质检通过、终审通过、成功交付分别按期间内发生的可靠事件统计,每个指标内按项目源数据去重;同源在本周送检三次仍计一份。
|
||||
- 退回单列次数;不同指标不能相加当作新增数据量。一个源跨天重复完成时,每天可各有记录,但整个周范围仍应去重,不能简单累加日去重数。
|
||||
- 供应商按事件当时生产归属计期间参与产出。历史同源由两家供应商先后完成同一环节,各家各计一份,总览仍去重一份;只有存在交叉时提示供应商小计不可直接相加。
|
||||
- 来源不明的历史事件不倒推给当前人员或供应商;新增源数据尚无生产供应商时不能补算给之后领取者。
|
||||
- 缺少可靠历史事件则标明记录不完整,已知明细可查看;不估算为零、不复用现有语义混杂的 workforce 时长/产出字段冒充完整事实。
|
||||
|
||||
## 建议采用的常规交互默认值(待最终整体确认)
|
||||
|
||||
- 默认表格按源数据总量降序,支持名称搜索和数字列排序;不新增绩效排名或评分。
|
||||
- 范围内暂无数据的项目可显示零;未分配与待核对为明确特殊行。有历史数据的供应商即使授权撤销仍可查看,不列入仅与测试项目有关的供应商。
|
||||
- 前台可见时约30秒刷新,支持手动刷新并显示统计截至时间;具体频率以聚合成本验证为准。
|
||||
- 查询失败保留最后成功结果,标记更新失败/数据时间;初次加载失败显示不可用,不把请求失败绘制成全零。
|
||||
- 一个页面各分项尽量来自同一统计时点;切换条件后不让旧条件的慢响应覆盖新视图。
|
||||
- 控制说明密度:口径集中在简短帮助或明确的异常提示,不在每个卡片上重复长段文字。
|
||||
|
||||
## 兼容与验证边界
|
||||
|
||||
- 本功能主要是只读查询与统计范围配置,不重写任务、供应商归属、工作流、切片、审核和交付数据。
|
||||
- 服务端执行管理员权限及组织隔离,不能依赖前端隐藏;供应商管理员现有仪表盘权限保持原状。
|
||||
- 新聚合不复用 Capture automation 最近200条统计,不改变既有接口含义以免破坏调用方;具体索引和接口方案在实施阶段审查。
|
||||
- 验证覆盖:大于200源数据全量聚合、双目/切片/重跑去重、同名不同源、跨项目累计、公共池未分配、匿名终审溯源、撤销授权保留、同源多任务归并、重跑后的当前状态、时区边界及期间重复事件、跨供应商重叠、缺失证据、测试排除、归档筛选、空范围/零数据、请求失败与筛选竞态。
|
||||
- 本地可使用隔离合成数据验证;公司集群只读默认仍有效。设计确认不等于线上范围配置或其他写入操作授权。
|
||||
|
||||
## 关联材料
|
||||
|
||||
- [确认记录](./map.md)
|
||||
- [现有代码事实与限制](./facts.md)
|
||||
- 领域词汇以根目录 `CONTEXT.md` 为准。
|
||||
|
||||
## 布局示意核验
|
||||
|
||||
- 使用模拟数据演示项目/供应商交叉筛选、期间产出、数字下钻、明细搜索分页;未请求生产 API。
|
||||
- 本地浏览器检查覆盖约1024、736、320像素内容宽度及深色显示;主筛选联动、项目切换供应商维度、明细搜索与任务摘要、期间跨供应商重叠提示无脚本错误。
|
||||
- 这仅证明设计示意可交互,不代表真实统计接口、历史数据归并、查询性能或产品验收已完成。
|
||||
- 核验材料保存在未跟踪目录 `local-data/verification/production-dashboard-design/`。
|
||||
@ -36,6 +36,9 @@ Status: discussing
|
||||
- Q15 已确认:点击数值打开右侧明细,继承项目/供应商/阶段/日期,支持搜索分页及任务查看页跳转;关闭保留筛选和表格位置,不自动领取或修改。
|
||||
- Q16 已确认:同源最新正式轮次有多任务时,按最早尚未完成环节归类;需完成的任务全部完成才算整份完成,各任务状态可展开。
|
||||
- Q17 已确认:展示可靠已知数据,阶段/供应商无法判定的列待核对;期间缺历史证据明确提示记录不完整,不当作零、不假装全量。
|
||||
- Q18 已确认:期间按事件当时生产供应商归属,各家分别计参与产出,总览仍去重;出现交叉处理时提示供应商小计不可直接相加。
|
||||
- Q19 已确认:项目/供应商筛选联动顶部总览、阶段分布及明细,明确显示当前范围,可一键返回全部。
|
||||
- Q20 已确认:项目内按同一来源目录的 Capture 去重,不因跨工作流重复处理增加;同名不同来源目录分别计数,不做视频内容比对去重。
|
||||
|
||||
## Design tree
|
||||
|
||||
@ -58,9 +61,10 @@ Status: discussing
|
||||
|
||||
## Fog
|
||||
|
||||
- Q1–Q17 已确认(Q6 取消时长,Q8 取消测试显示);Q18–Q20 待答。
|
||||
- 只读代码研究已完成,见 [facts.md](./facts.md);下一轮确认跨供应商期间归属、筛选作用范围、项目内源身份。
|
||||
- 随后整理布局示意和完整方案,最终共同理解尚待用户确认;实施未获批准。时长相关规则不再属于本需求。
|
||||
- Q1–Q20 已确认(Q6 取消时长,Q8 取消测试显示)。核心业务问题已收敛。
|
||||
- 只读代码研究已完成,见 [facts.md](./facts.md)。整合设计见 [design.md](./design.md)。
|
||||
- 当前提交模拟布局供最终确认;实施未获批准,不创建 PR、不推送、不部署。时长相关规则不再属于本需求。
|
||||
- 设计稿中刷新频率、默认排序、宽度适配等常规交互是最终确认时一并审阅的建议,不冒充新的用户回答。
|
||||
|
||||
## 第一轮(Q1–Q4 已确认)
|
||||
|
||||
@ -91,10 +95,10 @@ Status: discussing
|
||||
- Q16 已确认:同一源最新一轮多任务按最早未完成环节归并,全部应完成任务结束后才算整源完成。
|
||||
- Q17 已确认:已知总量照常展示,无法判定阶段/供应商列待核对,期间缺证据明确记录不完整;不估算、不假装为零或全量。
|
||||
|
||||
## 第五轮(Q18–Q20,待答)
|
||||
## 第五轮(Q18–Q20 已确认,均选 A)
|
||||
|
||||
- Q18:同源同期间先后由两家供应商完成同一环节时,推荐按事件当时生产归属分别计各家涉及完成份数,总览仍去重为1;出现重叠时明确供应商小计不可直接相加。备选:该期间只归最后一次成功操作的供应商以保持小计相加等于总览。当前进度始终按当前正式轮次归属,不与期间产出混用。
|
||||
- Q19:推荐项目/供应商筛选同时影响顶部总览、阶段分布和明细,范围标签明确,可一键返回全部。备选:顶部始终全局,只有明细表随筛选。
|
||||
- Q20:推荐项目内同一来源目录的 Capture 去重,不同工作流重复处理不增加;名字相同但来源目录不同则分别计数,不做视频内容去重。备选:按视频内容去重复制来源,需额外比对。
|
||||
- Q18 已确认:同源同期间先后由两家供应商完成同一环节时,按事件当时生产归属分别计各家涉及完成份数,总览仍去重为1;出现重叠时明确供应商小计不可直接相加。当前进度始终按当前正式轮次归属,不与期间产出混用。
|
||||
- Q19 已确认:项目/供应商筛选同时影响顶部总览、阶段分布和明细,范围标签明确,可一键返回全部。
|
||||
- Q20 已确认:项目内同一来源目录的 Capture 去重,不同工作流重复处理不增加;名字相同但来源目录不同则分别计数,不做视频内容去重。
|
||||
|
||||
除明确标注已确认的回答外,其余均为建议,未收到回答前不作为已确认规则。
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
|
||||
**Capture(源采集)**:一次源采集所关联的双目视频、时间戳与传感器数据,是本流程组织人工处理和审核的对象。
|
||||
|
||||
**项目源数据量**:每个项目内已发现并登记、按源 Capture 去重后的份数;同源用于两个项目时各计一份,总览为项目之和。同项目内双目不翻倍,后续切片、动作划分或重跑不增加源数据量。
|
||||
**项目源数据量**:每个项目内已发现并登记、按同一来源目录的 Capture 去重后的份数;同源用于两个项目时各计一份,总览为项目之和。同项目内双目、跨工作流重复处理、切片、动作划分或重跑不增加源数据量;同名但不同来源目录分别计数,不按视频内容去重。
|
||||
_Avoid_:全局唯一源文件数、累计提交次数、切片数量(均不等于项目源数据量)
|
||||
|
||||
**当前生产进度**:项目源数据在最新一轮正式处理中的当前主阶段,每份数据只占一个主阶段;同轮存在多条任务时按最早尚未完成的环节归类。正式重跑可使当前阶段回退,旧交付结果保留为历史;调试运行不改变当前生产进度。
|
||||
@ -14,6 +14,8 @@ _Avoid_:全局唯一源文件数、累计提交次数、切片数量(均不
|
||||
**期间阶段完成量**:在所选期间内发生过指定阶段成功完成事件的项目源数据份数,同一项目的同一源数据在该指标中只计一次。新增、送检、质检通过、终审通过与交付分别计算,退回另计发生次数。
|
||||
_Avoid_:操作次数(同一份数据可以重复操作,但期间完成份数不因此重复累计)
|
||||
|
||||
**供应商期间参与产出量**:供应商在所选期间内参与完成某环节的项目源数据份数,按事件当时的生产归属统计。同一份数据在期间内可先后由多家供应商处理,各家可分别计入,总览仍按项目源数据去重;存在交叉时供应商小计不能直接相加。
|
||||
|
||||
**切片**:标注员在源采集的统一有效帧范围内划定的连续区间。全部切片完整覆盖该范围,互不重叠;一个切片可以包含多个动作区间。
|
||||
_Avoid_:动作描述区间(两者不是同一层级)
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user