中台/需求全量表

需求全量表 R- 与 REQ- 双编号 · 真分页

数据源 /api/zt/req/all(R- 需求库全量,服务端分页)+ /api/zt/requirements(R- 在册总表)+ /api/zt/req/list(REQ- 定稿需求)· 行内下钻 /app/v2/req-detail/?reqId=R-xxx(仅 R- / C- 类;REQ- 编号 trace 接口不认,故定稿视图行不做跳转)
页型 列表需求库 —总表 —定稿 —时间 —
A1身份区
中台 · 需求域(FE 域维护)
A3版本区
tokens v1.1.0 · API —
B1筛选区
两套编号分栏:R- 走 req/all 与 requirements;REQ- 走 req/list,禁止混读。
B2列表主区
加载骨架 · 拉取 /api/zt/req/all
B3统计区
—需求库 R- 全量
—在册总表 R-
—定稿 REQ-
—阻塞 blocked
当前视图需求库
当前筛选全部
显示条数—
C1来源区
/api/zt/req/all?limit=20&offset= · —
C2下钻区
R- 行 → /app/v2/req-detail/?reqId=R-xxx(原话/精炼/拆点/派卡/验收全链)|REQ- 行 → 定稿正文与派卡子列
C3帮助区
需求库含待定稿历史稿;总表才是带负责人/进度的在册口径,比数不要混用
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
字段口径 · 一列一义

编号: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-」,点行看子任务号。

验收口径 · 本页 DoD

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 条。

数据 /api/zt/req/all + requirements + req/list下钻 /app/v2/req-detail/← 返回 中台首页—