V2/需求详情

需求详情 V2 · 原话/精炼/拆点/派卡全链

trace 接口:/api/zt/req/trace?reqId=… · 列表兜底:/api/zt/requirements(R- 全量)
页型 详情需求域 A编号 —状态 —
A1身份区
中台 · V2
A2导航区
← 需求列表 · 本页支持 ?reqId=R-xxx 直达
A3状态区
v— · —
B1五入口
首页交流需求中台结果与证明操作与治理
B2主区 · 左正文/右时间线
加载中…(≥300ms 才显示骨架)
B3辅区
口径需求=需求池,任务=任务库
数据源/api/zt/req/trace
异常显示「—」+重试
C1来源区
数据源 /api/zt/req/trace · —
C2动作条
C3帮助区
trace 需 reqId(R- 编号);无参时展示列表供选择
V2 详情页 · 前端实现岗·FE · 2026-10-30← 回需求列表 · V2 基线状态:待 QA 复核
下钻 · 字段口径与操作手册
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
接口清单 · 调用方式

/api/zt/req/trace?reqId=R-xxx · 详情数据源(raw 原话 / refined 精炼 / points 拆点 / delivery 派卡 / acceptance 验收 / chain 链路),只认 R- 编号(GET)

/api/zt/requirements · 需求全量兜底(R- 编号 131 条,含 status/owner/priority,GET)

/api/zt/req/feed?limit=200 · 总表数据源(GET)

/api/zt/ui/version · 版本绑定(GET) | /api/zt/time/now · 北京时间(GET)

字段口径 · 一列一义

需求号:R- 编号(如 R-20261025104600),trace 只认该编号;REQ- 与 R-NNN 会 404。

原话区:raw.text 逐字展示 + source(来源/auditedAt)+ md5 前 8 位,只读不可编辑。

精炼区:refined 展示引擎/版本;points 拆点带序号与状态徽标(已做/待做)。

验收:acceptance.pm/qa/verdict 三栏;缺失字段统一显示「—」+ 底部黄条提示 missing。

状态枚举 · 展示口径

验收 verdict:PASS=绿 / FAIL=红 / 其他=黄;拆点 done/status=done → 已做(绿),否则待做(黄)。

派卡状态:已交付/已验收=绿,其余=黄。未知值不强行映射,原样展示 + 「—」兜底。

拆点 · 何时出现

无拆点:显示「暂无拆点」空态文案;有拆点:逐条带序号渲染。

missing 字段(refined/delivery/acceptance 缺失):页面正常展示其余部分,缺失项显「—」并黄条提示,不整页报错。

操作手册 · 三步走

① URL ?reqId=R-xxx 直达详情;无参进空态+list 兜底。

② 顶部动作条:拆点视图 / 派卡视图 / 返回需求总表。

③ 空态=图标+原因+动作;错误态=「—」+重试;加载骨架≥300ms。

验收口径 · 本卡 DoD

T-V2-FE-DETAIL-01 验收五条:独立 URL ✓ / 接 trace(R-编号)+任务告警接口 ✓ / 空态错误态齐 ✓ / 门禁 P1–P9 ✓ / 三件证据(URL+截图+需求编号)✓。

门禁要点:core / ≥5 接口 / UI 版本 / @media / tokens?v=1.1.0 / details/card≥6 / 无 body overflow:hidden。