需求总表DIANTONG CENTER
--:--:-- —

真实需求来自 /api/zt/req/all(服务端分页) · 拆点来自 /api/zt/req/points · 双区来自 /api/zt/req/trace

需求总表

一张表回答:有哪些需求、谁在办、卡在哪。行可点进详情:左「原话区」逐字只读、右「精炼区」可拆子点、勾选完成回填进度、确认动作留痕。

需求总数—req/all total
待处理—todo
进行中—doing
已完成—done
—
需求台账
需求号标题状态优先级标签拆点进度登记时间

状态枚举 · 中英映射

单一来源,未知状态显式标注

    下钻 · 字段口径与操作手册

    点击展开,每项都是可下钻说明
    字段口径 · 一列一义

    需求号:/api/zt/req/all 的 id(形如 R-20261025104600),详情页 trace 接受 feed 的 id(实测 R- 与 C- 前缀均可用)。

    状态:单一来源 = 接口原值;英文枚举与中文按钮经映射表统一,未知状态显式标注「未分类」。

    优先级:接口原值展示(P0/P1/P2…),不做二次加工。

    拆点进度:按 /api/zt/req/points 实时计算 done/total;勾选完成写本机留痕并回填总表。

    接口清单 · 调用方式

    /api/zt/req/all?limit=500&offset=N · 需求总表数据源(GET,服务端分页;limit 上限 500、offset 有效;status 按原值精确匹配(中文须 URL 编码,见下方口径)、q 支持)

    口径(2026-11-08 实测修订):req/all total=805,status 精确命中 待定稿 604 / 已作废 70 / todo 62 / done 39 / doing 25 / blocked 4 / 已定稿 1;limit=500 回 500 条 + offset=500 回 305 条 = 全量 805 可取完。
    /api/zt/req/feed 仍是旧接口:total 恒为全库 805、单次上限 200、不认 status 与 offset(实测 status=todo、status=已作废 都返回同一批已作废记录,offset=200 返回同首批),只能当「最近 200 条」用。
    status 传参实测(2026-11-08 二次复核):英文枚举直接可用(todo→62 / doing→25 / done→39 / blocked→4,返回项 first_status 全命中);中文必须 URL 编码——裸传中文 → HTTP 400、响应 0 B;编码后正常过滤(已作废→70 / 待定稿→604 / 已定稿→1,first_status 全命中);无法识别的值不报错、返回 total=0。判据:带 status 却仍拿到 total=805,说明参数根本没送达服务端(常见于二次编码或拼接错误),不是「中文被支持」。

    /api/zt/req/trace?reqId=R-xxx · 详情双区:原话 raw + 精炼 refined + 拆点 points(GET)

    /api/zt/req/points?no=R-xxx · 拆点实时列表(GET)

    /api/zt/req/points/add · 新增子点,body {no,text},落库刷新不丢(POST)

    /api/zt/req/points/confirm · 确认需求留痕,body {no}(POST)

    /api/zt/time/now · 北京时间(页面时钟) | /api/zt/ui/version · 需求绑定(右上 chip)

    状态枚举 · 中英对照(含未知处理)

    todo=待处理 · doing=进行中 · done=已完成 · blocked=阻塞 · 已定稿=已定稿 · 已确认=已确认

    未知值不强行映射成「正常」:保留原值并标注 未分类,符合对接数据解析规范。

    三态触发 · 何时出现

    加载态:仅接口请求期间显示骨架(>300ms),数据到达即替换为真实内容。

    空态:接口正常返回但筛选无结果 / 无拆点时显示「这个筛选下没有需求」+ 动作提示。

    错误态:接口异常时显示「台账没读上来 / 详情没读上来」+ 重试按钮;正常态 DOM 不残留演示块。

    操作手册 · 三步走

    ① 总表行点击需求号 → 进详情(URL ?id=R-xxx 或 ?id=C-xxx 均可直达)。

    ② 左「原话区」逐字只读(含来源+md5);右「精炼区」输入子点回车即落库。

    ③ 子点勾选完成 → 进度回填总表;「确认需求 · 留痕」→ 状态写需求库并由值守本体广播。

    验收口径 · 三卡 DoD

    T-FE-REQLEDGER-STATE-01:正常态 DOM 无「没有匹配需求 / req/all 异常」字样;三态可人工触发;映射表落文档。

    T-REQ-UI-DUAL-01:原话区/精炼区并存不可覆盖;确认动作写台账;原话只读。

    T-REQ-POINT-LIVE-01:拆点可增删改;勾选即落库刷新不丢;进度回填总表。

    门禁 P1–P9:core / ≥5 接口 / ui-version / @media / tokens?v / 下钻 details / 无 body overflow:hidden。

    首页交流区需求总表需求确认页面清单文档中心接口文档
    实时数据读取中… 源 /api/zt/req/all?limit=1
    需求流水(实时) 读取中…
    读取中…
    数据源 /api/zt/req/feed?limit=100(历史接口示例,非当前取数路径;主列表取数走 /api/zt/req/all 服务端分页)