V2/需求总表

需求总表 V2 · R- 编号全量

数据源 /api/zt/requirements(R- 编号,服务端去重)· 行内下钻 /app/v2/req-detail/?reqId=R-xxx
页型 列表需求域 A总量 —每页 20时间 —
A1身份区
中台 · V2 · 需求域
A3版本区
tokens v1.1.0 · API —
B1筛选区
B2列表主区
编号标题状态负责人/优先级进度
加载骨架 · 拉取 /api/zt/requirements
B3统计区
—待办 todo
—进行中 doing
—已完成 done
—阻塞 blocked
当前筛选—
显示条数—
C1来源区
/api/zt/requirements + /api/zt/req/list · —
C2下钻区
行 → 需求详情(原话/精炼/拆点/派卡/验收)|详情页支持 ?reqId=R-xxx 直达
C3帮助区
空态=图标+原因+动作;错误态=「—」+重试;加载骨架≥300ms
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
字段口径 · 一列一义

编号=需求主键(R- 前缀,服务端按 id 去重,排除 T- 任务卡);标题=精炼标题(≤60 字);状态=todo/doing/done/blocked 四态;负责人/优先级=归属 Agent 与原话优先级;进度=该需求完成百分比(0–100)。

接口清单 · 调用方式

/api/zt/requirements · 需求总表(total + count 四态计数 + items,GET)|/api/zt/req/list · REQ- 编码区需求(GET)|/api/zt/req/trace?reqId=R-xxx · 单条全链(GET)|/api/zt/ui/version · 版本绑定(GET)|/api/zt/time/now · 北京时间(GET)

状态枚举 · 中英对照

todo=待办(未开工)|doing=进行中(有人认领且未交付)|done=已完成(已交付或已验收)|blocked=阻塞(等外部输入)|未知值统一显示「—」并按原值透出,不静默丢弃。

三态触发 · 何时出现

加载态:首屏 fetch 未返回或不足 300ms;空态:接口 200 但 items=[] 或筛选后 0 条;错误态:fetch 失败或 ok=false,显示「—」并提供重试。

操作手册 · 三步走

① 选状态筛选(默认全部);② 搜索框支持编号/标题/项目/模块子串;③ 点行标题进入详情,详情页顶部可返回本表;翻页每页 20 条,页码在底部。

验收口径 · 本页 DoD

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

数据 /api/zt/requirements下钻 /app/v2/req-detail/← 返回 V2 总览—