V2/任务列表

任务列表 V2 · 任务库全量

数据源 /api/data/tasks(全量任务,含 owner/状态/期限)· 行内下钻 /app/v2/task-detail/?taskId=T-xxx
页型 列表任务域 B总量 —在办 —时间 —
A1身份区
中台 · V2 · 任务域
A3版本区
tokens v1.1.0 · API —
B1筛选区
B2列表主区
卡号任务名状态负责人期限
加载骨架 · 拉取 /api/data/tasks(全量约 900KB)
B3统计区
—在办(进行中/返工/待开始/被叫停)
—已交付
—已验收
—库内全量
当前筛选—
显示条数—
已作废 / 已完成—
C1来源区
/api/data/tasks · —
C2下钻区
行 → 任务详情(全字段/进度/流转/时间线)|详情页支持 ?taskId=T-xxx 直达
C3帮助区
空态=图标+原因+动作;错误态=「—」+重试;加载骨架≥300ms
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
字段口径 · 一列一义

卡号=任务主键(T-/ONB-/R- 等多种前缀,原样透出);任务名=title 或 name;状态=已替换/已交付/已验收/进行中/返工/待开始/被叫停 等原值;负责人=owner;期限=deadline(缺值显示「—」,不臆造)。

接口清单 · 调用方式

/api/data/tasks · 任务库全量(total + items,GET,约 900KB 首次加载)|/api/data/tasks/detail · 单卡详情(GET)|/api/zt/task/ack · 回执(POST)|/api/zt/ui/version · 版本(GET)|/api/zt/time/now · 北京时间(GET)

状态枚举 · 中英对照

进行中=doing|返工=rework|待开始=todo|被叫停=stopped|已交付=delivered(等 QA)|已验收=accepted(QA PASS)|已替换=replaced(历史卡被新卡覆盖)|已作废=void|已完成=completed(业务侧归档完成)。

三态触发 · 何时出现

加载态:全量接口未返回(约 1s 级)或不足 300ms;空态:筛选后 0 条;错误态:fetch 失败,显示「—」+重试,不清空已有缓存。

操作手册 · 三步走

① 默认「在办」只看活卡(进行中/返工/待开始/被叫停);② 需要全量历史切「全量」并按卡号/任务名/负责人搜索;单状态可切「已作废」「已完成」直接看(此前只能在全量里翻页找);③ 点任务名进详情,详情可返回本列表;每页 20 条。

验收口径 · 本页 DoD

P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5;P8 details≥6;P9 card≥6;@media 1024/520 两段;tokens?v=1.1.0;body 不裁切(无 overflow 隐藏);行内下钻可回上一级。

数据 /api/data/tasks下钻 /app/v2/task-detail/← 返回 V2 总览—