编号:R-YYYYMMDDHHmmss-NN(需求库/总表)或 REQ-YYMMDD-NN(定稿需求),两套不混用;标题=title;状态=todo/doing/done/blocked 与 待定稿/已定稿/已作废 并存,页面按中文映射展示;优先级=priority(P0–P3);负责人=owner(仅总表有);进度=progress(0–100,仅总表有)。
载入量口径(2026-11-08 补):需求库视图走 req/all 服务端分页(per=20,翻页真取数);总表(requirements)与定稿(req/list)单次只载入 limit=200,页面分页基于已载入集,pager 已分别写出「总量 / 本次载入 / 筛选后」三个数,总量超 200 时会明示「未载入 N 条本页取不到」——不再让 200 冒充全量。三视图状态词表不同:req/all = 待定稿604 / 已作废70 / todo62 / done39 / doing25 / blocked4 / 已定稿1;requirements = todo62 / doing25 / done39 / blocked4 / 已定稿1(共 131);req/list = 定稿 1。|/api/zt/req/all?limit=&offset=&status=&q= · 需求库全量(服务端分页,limit 上限 500,total 805)|/api/zt/requirements · 在册总表(total 131,带 owner/priority/progress/tag/chain)|/api/zt/req/list · 定稿需求(REQ- 编号,带 sub 派卡与 acceptance;落库状态实测为「定稿」,点「已完成」按终态归一看)|/api/zt/req/trace?id=R-xxx · 单条全链(raw/refined/points/delivery/acceptance;只认 R-/C- 类,REQ- 编号 404,故定稿行不做下钻)|/api/zt/ui/version · 版本徽标|/api/zt/time/now · 北京时间
R- 编号由需求库生成(重复导入会重排,旧的 R-001 已被 R-20261025104600 取代);REQ- 编号是定稿需求号,自带 sub 派卡(REQ-…-D/F/B/QA)。track 只认 R-,定稿只认 REQ-,所以本页做成三个视图,不把两套编号塞进同一列。
加载态:每次取数先出骨架屏并至少显示 300ms;空态:搜索或状态筛选 0 命中,给原因 +「看全部」动作;错误态:fetch 失败显示「—」+ 重试,不展示旧缓存假数据。
① 查进度用「总表 R-」,有负责人和百分比;② 查历史稿用「需求库 R-」,按状态筛(待定稿 604 条占多数);③ 查定稿与派卡用「定稿 REQ-」,点行看子任务号。
P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5(本页 5 路 fetch + 服务端分页);P8 details≥6;P9 card≥6;@media 1024/520 两段;tokens?v=1.1.0 且 meta dt-tokens=1.1.0;body 不裁切;字号 11/13/16/20/26 五级;间距 8 倍数;行高 1.6(标题 1.25);每页 20 条。