编号=需求主键(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 条,页码在底部。
P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5;P8 details≥6;P9 card≥6;@media 1024/520 两段;tokens?v=1.1.0;body 不裁切(无 overflow 隐藏);行内下钻可回上一级。