Files
mini-openclaw-v2/docs/project-process/templates/URD-Template.html
T
qiaoqichaoandClaude Code d56c699ce6 chore(v2): 从兴邦预审v2白名单抽取独立可运行基座
按 docs/v2/05-implementation-plan.md §1 候选迁移表与 claude_use/T00 白名单,
从 55e2cdb 抽取 224 个文件(2.48 MB)到独立目录 F:/mini-OpenClaw-v2。

- 排除:凭据(.env/server-deploy.conf/旧DELIVERY.md)、运行数据(xingbang_data 等
  4 个 SQLite)、依赖(venv/node_modules 符号链接)、归档(_backup*/test-evidence/
  ori_file)、Office 临时文件
- 目标目录独立 git 仓库,初始恢复点;Gitea 远程与分支待 OQ-06 Q2 定案
- 未部署、未启动服务、未调用模型

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-29 12:58:26 +08:00

253 lines
34 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN"><head><meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>URD 模板 · 产品需求文档模板 · 看板</title>
<link rel="icon" href="data:,">
<style>
:root{--bg:#f4f6fa;--panel:#ffffff;--ink:#1d2433;--sub:#5b6472;--line:#e3e8f0;--acc:#2f6fed;--acc2:#0ea5a4;--warn:#b45309;--code:#eef2f8;--chip:#e9effc;--h1:#111a2c;--h2:#1d3a8a;--h3:#25477e;--h4:#374151}
*{box-sizing:border-box}html{scroll-behavior:smooth}
body{margin:0;font-family:"Segoe UI","PingFang SC","Microsoft YaHei",system-ui,sans-serif;background:var(--bg);color:var(--ink);font-size:15px;line-height:1.7}
.layout{display:flex;min-height:100vh}
.toc{width:300px;min-width:300px;background:var(--panel);border-right:1px solid var(--line);padding:20px 14px 60px;position:sticky;top:0;height:100vh;overflow-y:auto}
.toc .brand{font-weight:700;font-size:16px;color:var(--h1);padding:6px 10px 12px;border-bottom:1px solid var(--line);margin-bottom:12px;display:flex;align-items:center;gap:8px}
.toc .brand .dot{width:10px;height:10px;border-radius:50%;background:linear-gradient(135deg,var(--acc),var(--acc2))}
.toc ul{list-style:none;margin:0;padding:0}
.toc .toc-l1>li{margin:2px 0}
.toc a{display:block;color:var(--ink);text-decoration:none;padding:4px 8px;border-radius:7px;font-size:13.5px;border-left:3px solid transparent}
.toc a:hover{background:#f0f4ff;color:var(--acc)}
.toc .toc-l1>li>a{font-weight:600;font-size:13.8px}
.toc .toc-l2{padding-left:14px}
.toc .toc-l3{padding-left:14px;font-size:12.8px;color:var(--sub)}
.toc .toc-l1>li>a:not([href^="#sec-1"]):not(:has(.toc-title)){}
.content{flex:1;max-width:1080px;padding:34px 52px 120px}
.doc-h1{font-size:28px;color:var(--h1);border-bottom:3px solid var(--acc);padding-bottom:12px;margin:8px 0 26px}
.doc-h1:first-of-type{border-bottom:none;padding-bottom:6px}
.doc-h1 .title-sub{display:block;font-size:14px;font-weight:400;color:var(--sub);margin-top:6px}
.doc-h2{font-size:21px;color:var(--h2);margin:40px 0 14px;padding-left:12px;border-left:5px solid var(--acc);line-height:1.4}
.doc-h3{font-size:17px;color:var(--h3);margin:28px 0 10px}
.doc-h4{font-size:15px;color:var(--h4);margin:20px 0 8px}
p{margin:8px 0}
blockquote{margin:14px 0;padding:10px 16px;background:#f2f7ff;border-left:4px solid var(--acc);border-radius:0 10px 10px 0;color:#2c3a5c}
blockquote p{margin:4px 0}
hr{border:none;border-top:1px dashed var(--line);margin:28px 0}
code{background:var(--code);padding:2px 7px;border-radius:6px;font-family:"Cascadia Code",Consolas,monospace;font-size:13px;color:#0f3a7a}
pre{background:#0f1b33;color:#dbe7ff;padding:16px 18px;border-radius:12px;overflow-x:auto;font-size:13px;line-height:1.6}
pre code{background:none;color:inherit;padding:0}
.tbl-wrap{margin:14px 0;overflow-x:auto;border:1px solid var(--line);border-radius:12px;background:var(--panel)}
table{border-collapse:collapse;width:100%;font-size:13.5px;min-width:520px}
th{background:#f0f4fb;color:#33415c;font-weight:600;text-align:left;padding:9px 12px;border-bottom:2px solid var(--acc);white-space:nowrap}
td{padding:8px 12px;border-bottom:1px solid #edf1f7;vertical-align:top}
tr:last-child td{border-bottom:none}
tr:hover td{background:#f7faff}
td.row-id{color:var(--acc);font-weight:600;white-space:nowrap;font-family:Consolas,monospace;font-size:13px}
.tbl-wrap.narrow table{min-width:0}
.tbl-wrap.wide td{font-size:13px}
ul,ol{margin:8px 0;padding-left:26px}
li{margin:3px 0}
.cb{display:flex;gap:10px;align-items:flex-start;margin:5px 0}
.cb input{margin-top:5px;accent-color:var(--acc)}
.cb.on span{color:var(--sub)}
.cb.on span::after{content:" ✓";color:#16a34a;font-weight:700}
a{color:var(--acc)}
strong{color:#16233c}
@media print{.toc{display:none}.content{max-width:100%;padding:10px}}
@media (max-width:900px){.layout{flex-direction:column}.toc{position:static;width:100%;height:auto;max-height:40vh}}
</style></head>
<body><div class="layout">
<nav class="toc">
<div class="brand"><span class="dot"></span>URD 模板 · 产品需求文档模板</div>
<ul class="toc-l1"><li><a href="#sec-1-urd-模板-user-requirements-document-"><span class="toc-title">URD 模板(User Requirements Document)</span></a><ul class="toc-l2"><li><a href="#sec-2-0-使用说明与编号规则-写文档前先读-成稿后可删-"><span class="toc-title">0. 使用说明与编号规则(写文档前先读;成稿后可删)</span></a><ul class="toc-l3"><li><a href="#sec-3-0-1-文档关系"><span class="toc-title">0.1 文档关系</span></a></li><li><a href="#sec-3-0-2-编号规则-只追加-不重排-弃用标记-withdrawn-"><span class="toc-title">0.2 编号规则(只追加、不重排、弃用标记 withdrawn)</span></a></li><li><a href="#sec-3-0-3-书写纪律-继承仓库阶段-规则-"><span class="toc-title">0.3 书写纪律(继承仓库阶段①规则)</span></a></li></ul></li><li><a href="#sec-2-1-文档控制"><span class="toc-title">1. 文档控制</span></a><ul class="toc-l3"><li><a href="#sec-3-1-1-文档信息"><span class="toc-title">1.1 文档信息</span></a></li><li><a href="#sec-3-1-2-历史记录"><span class="toc-title">1.2 历史记录</span></a></li><li><a href="#sec-3-1-3-评审与分发"><span class="toc-title">1.3 评审与分发</span></a></li></ul></li><li><a href="#sec-2-2-目的与范围"><span class="toc-title">2. 目的与范围</span></a><ul class="toc-l3"><li><a href="#sec-3-2-1-文档目的"><span class="toc-title">2.1 文档目的</span></a></li><li><a href="#sec-3-2-2-产品定义"><span class="toc-title">2.2 产品定义</span></a></li><li><a href="#sec-3-2-3-目标范围-in-scope-"><span class="toc-title">2.3 目标范围(In Scope)</span></a></li><li><a href="#sec-3-2-4-非目标-out-of-scope-与范围同等重要-逐条写明排除理由"><span class="toc-title">2.4 非目标(Out of Scope)——与范围同等重要,逐条写明排除理由</span></a></li><li><a href="#sec-3-2-5-成功标准-产品级-一句话可判-"><span class="toc-title">2.5 成功标准(产品级,一句话可判)</span></a></li></ul></li><li><a href="#sec-2-3-参考文献"><span class="toc-title">3. 参考文献</span></a></li><li><a href="#sec-2-4-术语-角色与成功标准"><span class="toc-title">4. 术语、角色与成功标准</span></a><ul class="toc-l3"><li><a href="#sec-3-4-1-术语表"><span class="toc-title">4.1 术语表</span></a></li><li><a href="#sec-3-4-2-用户角色"><span class="toc-title">4.2 用户角色</span></a></li><li><a href="#sec-3-4-3-角色-模块-关注矩阵-可选-"><span class="toc-title">4.3 角色 × 模块 关注矩阵(可选)</span></a></li></ul></li><li><a href="#sec-2-5-产品概览与核心体验"><span class="toc-title">5. 产品概览与核心体验</span></a><ul class="toc-l3"><li><a href="#sec-3-5-1-产品背景与目标"><span class="toc-title">5.1 产品背景与目标</span></a></li><li><a href="#sec-3-5-2-信息架构与模块关系"><span class="toc-title">5.2 信息架构与模块关系</span></a></li><li><a href="#sec-3-5-3-核心用户流程-端到端-"><span class="toc-title">5.3 核心用户流程(端到端)</span></a></li><li><a href="#sec-3-5-4-体验原则"><span class="toc-title">5.4 体验原则</span></a></li><li><a href="#sec-3-5-5-交付面与平台约束"><span class="toc-title">5.5 交付面与平台约束</span></a></li></ul></li><li><a href="#sec-2-6-功能模块需求-本文档主体-"><span class="toc-title">6. 功能模块需求(本文档主体)</span></a><ul class="toc-l3"><li><a href="#sec-3-6-1-模块清单与划分说明"><span class="toc-title">6.1 模块清单与划分说明</span></a></li><li><a href="#sec-3-6-2-各模块详细需求"><span class="toc-title">6.2 各模块详细需求</span></a><ul class="toc-l3"><li><a href="#sec-4-mod-01-"><span class="toc-title">MOD-01 ``</span></a></li></ul></li></ul></li><li><a href="#sec-2-7-数据与内容需求-若产品以数据-面板-内容为核心-"><span class="toc-title">7. 数据与内容需求(若产品以数据/面板/内容为核心)</span></a><ul class="toc-l3"><li><a href="#sec-3-7-1-数据类型与口径"><span class="toc-title">7.1 数据类型与口径</span></a></li><li><a href="#sec-3-7-2-内容-数据生成规则"><span class="toc-title">7.2 内容/数据生成规则</span></a></li><li><a href="#sec-3-7-3-展示与交互要求-数据面-"><span class="toc-title">7.3 展示与交互要求(数据面)</span></a></li></ul></li><li><a href="#sec-2-8-非功能需求"><span class="toc-title">8. 非功能需求</span></a></li><li><a href="#sec-2-9-安全-权限与信任"><span class="toc-title">9. 安全、权限与信任</span></a><ul class="toc-l3"><li><a href="#sec-3-9-1-用户可理解的动作等级"><span class="toc-title">9.1 用户可理解的动作等级</span></a></li><li><a href="#sec-3-9-2-必须由产品层提供的能力-按产品改写-"><span class="toc-title">9.2 必须由产品层提供的能力(按产品改写)</span></a></li><li><a href="#sec-3-9-3-信任界面要求"><span class="toc-title">9.3 信任界面要求</span></a></li></ul></li><li><a href="#sec-2-10-mvp-范围与版本规划"><span class="toc-title">10. MVP 范围与版本规划</span></a><ul class="toc-l3"><li><a href="#sec-3-10-1-mvp-目标与样板场景"><span class="toc-title">10.1 MVP 目标与样板场景</span></a></li><li><a href="#sec-3-10-2-p0-p1-p2-范围表"><span class="toc-title">10.2 P0 / P1 / P2 范围表</span></a></li><li><a href="#sec-3-10-3-推荐交付阶段"><span class="toc-title">10.3 推荐交付阶段</span></a></li></ul></li><li><a href="#sec-2-11-验收标准与产品指标"><span class="toc-title">11. 验收标准与产品指标</span></a><ul class="toc-l3"><li><a href="#sec-3-11-1-端到端验收"><span class="toc-title">11.1 端到端验收</span></a></li><li><a href="#sec-3-11-2-核心产品指标"><span class="toc-title">11.2 核心产品指标</span></a></li></ul></li><li><a href="#sec-2-12-假设与待决策事项"><span class="toc-title">12. 假设与待决策事项</span></a></li><li><a href="#sec-2-附录"><span class="toc-title">附录</span></a><ul class="toc-l3"><li><a href="#sec-3-a-功能点索引-全部-fr-ex-编号-模块位置-自动核对用-"><span class="toc-title">A. 功能点索引(全部 FR / EX 编号 → 模块位置,自动核对用)</span></a></li><li><a href="#sec-3-b-产品话术与演示脚本-可选-"><span class="toc-title">B. 产品话术与演示脚本(可选)</span></a></li><li><a href="#sec-3-c-变更对照-本版相对上一版的增删-"><span class="toc-title">C. 变更对照(本版相对上一版的增删)</span></a></li></ul></li></ul></li></ul>
</nav>
<main class="content">
<h1 id="sec-1-urd-模板-user-requirements-document-" class="doc-h1">URD 模板(User Requirements Document)</h1>
<blockquote><strong>定位</strong>:URD(用户需求文档,与 PRD 等价)是<strong>产品级</strong>需求描述——定义"产品是什么、为谁服务、用户要完成哪些任务、每个功能如何被用户感知和使用"。它是软件项目<strong>一切后续文档的输入</strong>:阶段 ① 需求规格(BR/E/AC)、② 架构、③ 详细设计、④ UI Spec、测试用例,都必须能追溯到本文档的功能条目。</blockquote>
<blockquote><strong>适用</strong>:本模板用于兴邦金租 AI 评审平台及新版 AI 预审的用户需求撰写;正文按业务人员语言描述,区分演示、真实数据试点与正式审批。</blockquote>
<blockquote><strong>用法</strong>:复制本文件为 <code><产品名>-URD-<版本>-<日期>.md</code>,按占位符 <code><...></code> 填写;删除不适用章节并记录删除理由;编号规则见第 0 节,不得破坏。</blockquote>
<hr>
<h2 id="sec-2-0-使用说明与编号规则-写文档前先读-成稿后可删-" class="doc-h2">0. 使用说明与编号规则(写文档前先读;成稿后可删)</h2>
<h3 id="sec-3-0-1-文档关系" class="doc-h3">0.1 文档关系</h3>
<pre><code>
商业/产品设想(PRD 草稿、口头想法)
│ 提炼、确认边界
▼
本 URD —— 用户可感知的功能需求(本文档)
│ 拆解为可实现的单点需求
▼
阶段①规格(BR/E/AC)→ ② 架构 → ③ 详细设计 → ④ UI Spec → 实现 → 测试
</code></pre>
<li>URD 回答 <strong>"用户要什么、为什么、长什么样、做到什么程度算好"</strong>;
</li>
<li>阶段 ① 规格回答 <strong>"这一版改动具体怎么实现、怎么验收"</strong>;
</li>
<li>URD 讲用户语言,不写内部实现(不写表结构、类名、内部工具调用);确有底层约束须写"约束与假设"。
</li>
<h3 id="sec-3-0-2-编号规则-只追加-不重排-弃用标记-withdrawn-" class="doc-h3">0.2 编号规则(只追加、不重排、弃用标记 withdrawn)</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="前缀">前缀</th><th data-c="含义">含义</th><th data-c="示例">示例</th></tr></thead><tr><td><code>MOD-xx</code></td><td>模块编号</td><td><code>MOD-03</code></td></tr><tr><td><code>FR-<模块简码>-<nn></code></td><td>功能点编号(模块简码见 6.1 清单)</td><td><code>FR-STU-04</code></td></tr><tr><td><code>EX-<模块简码>-<nn></code></td><td>功能点的异常/边界场景</td><td><code>EX-DASH-02</code></td></tr><tr><td><code>NFR-xx</code></td><td>非功能需求</td><td><code>NFR-07</code></td></tr><tr><td><code>SEC-xx</code></td><td>安全/权限需求</td><td><code>SEC-03</code></td></tr><tr><td><code>AC-xx</code></td><td>端到端验收标准</td><td><code>AC-10</code></td></tr><tr><td><code>OQ-xx</code></td><td>待决策/开放问题</td><td><code>OQ-04</code></td></tr></table></div>
<h3 id="sec-3-0-3-书写纪律-继承仓库阶段-规则-" class="doc-h3">0.3 书写纪律(继承仓库阶段①规则)</h3>
<li>每条功能点 = <strong>一个用户可感知的行为</strong>,写成"用户可验证"的描述;散文式一段话超过 5 行 → 拆成行为列表。
</li>
<li>每个功能点必须写 <strong>主流程</strong>(happy path)与 <strong>异常/边界</strong>(用户会遇到的不顺路径),禁止只写 happy path。
</li>
<li>写不动的先 <code>TBD</code> / <code>OQ-xx</code>(带 owner 与期限),禁止编造。
</li>
<li>优先级统一 <code>P0</code>(MVP 必做)/ <code>P1</code>(近期待做)/ <code>P2</code>(远期)。
</li>
<li>所有状态、权限、阈值是可配置项时写明"默认值 + 可配置范围",不写死。
</li>
<hr>
<h2 id="sec-2-1-文档控制" class="doc-h2">1. 文档控制</h2>
<h3 id="sec-3-1-1-文档信息" class="doc-h3">1.1 文档信息</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="项">项</th><th data-c="内容">内容</th></tr></thead><tr><td>文档名称</td><td><code><产品名> 用户需求文档(URD)</code></td></tr><tr><td>文档编号</td><td><code>URD-<产品简称>-<版本></code></td></tr><tr><td>版本 / 日期</td><td><code>V<0.x> · <yyyy-mm-dd></code></td></tr><tr><td>产品名称 / 版本</td><td><code><对外名称> V<目标版本></code></td></tr><tr><td>文档状态</td><td>草稿 / 评审中 / 已确认 / 已发布</td></tr><tr><td>作者 / 评审人</td><td><code><姓名或角色></code></td></tr><tr><td>维护位置</td><td><code><仓库路径></code></td></tr></table></div>
<h3 id="sec-3-1-2-历史记录" class="doc-h3">1.2 历史记录</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="日期">日期</th><th data-c="版本">版本</th><th data-c="作者">作者</th><th data-c="变更记录">变更记录</th></tr></thead><tr><td class="row-id">yyyy-mm-dd</td><td>V0.1</td><td>xxx</td><td>首次创建;<列出范围,如"第 1–3 章 + MOD-01" ></td></tr></table></div>
<h3 id="sec-3-1-3-评审与分发" class="doc-h3">1.3 评审与分发</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="角色">角色</th><th data-c="评审关注点">评审关注点</th></tr></thead><tr><td>产品负责人</td><td>范围、优先级、验收标准是否符合商业意图</td></tr><tr><td>设计(UI/UX)</td><td>功能点的用户流程与界面要求是否可实现</td></tr><tr><td>研发负责人</td><td>是否存在未定义边界或不可实现的约束</td></tr><tr><td>测试负责人</td><td>每条功能点是否可验证、异常是否齐全</td></tr><tr><td>市场/实施</td><td>话术与演示脚本是否与功能一致</td></tr></table></div>
<hr>
<h2 id="sec-2-2-目的与范围" class="doc-h2">2. 目的与范围</h2>
<h3 id="sec-3-2-1-文档目的" class="doc-h3">2.1 文档目的</h3>
<blockquote>一句话:本文档定义 <code><产品名></code> 的用户需求——<code><它解决谁的什么问题,交付什么结果></code>。</blockquote>
<p>说明:本文档的读者(产品/设计/研发/测试/市场)、文档如何被使用(培训材料?需求基线?)。</p>
<h3 id="sec-3-2-2-产品定义" class="doc-h3">2.2 产品定义</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="项">项</th><th data-c="内容">内容</th></tr></thead><tr><td>一句话结论</td><td><code><产品做什么、为谁做、交付物></code></td></tr><tr><td>核心价值</td><td><code><用户购买/使用它的理由,1–3 条></code></td></tr><tr><td>交付结果</td><td><code><安装包/服务/平台等></code></td></tr></table></div>
<h3 id="sec-3-2-3-目标范围-in-scope-" class="doc-h3">2.3 目标范围(In Scope)</h3>
<li><code><范围一:……></code>
</li>
<li><code><范围二:……></code>
</li>
<h3 id="sec-3-2-4-非目标-out-of-scope-与范围同等重要-逐条写明排除理由" class="doc-h3">2.4 非目标(Out of Scope)——与范围同等重要,逐条写明排除理由</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="排除项">排除项</th><th data-c="理由">理由</th><th data-c="可能时机">可能时机</th></tr></thead><tr><td><code><明确不做的事></code></td><td><code><为什么本期不做></code></td><td>后续版本 / 永不</td></tr><tr><td><code><例如:开放第三方市场></code></td><td><code><例如:首版只支持受控模板></code></td><td>V2+</td></tr></table></div>
<h3 id="sec-3-2-5-成功标准-产品级-一句话可判-" class="doc-h3">2.5 成功标准(产品级,一句话可判)</h3>
<li><code><首个版本成功的硬性标志,如:客户经理可完成一次带证据引用和补件清单的项目预审></code>
</li>
<hr>
<h2 id="sec-2-3-参考文献" class="doc-h2">3. 参考文献</h2>
<div class="tbl-wrap"><table><thead><tr><th data-c="文档/来源">文档/来源</th><th data-c="版本/日期">版本/日期</th><th data-c="与本文档的关系">与本文档的关系</th></tr></thead><tr><td><code><产品定义 PRD></code></td><td>V0.1</td><td>本文档的功能蓝本</td></tr><tr><td><code><代码功能事实:codewiki / docs 架构文档></code></td><td>生成日期</td><td>现状能力基线</td></tr><tr><td><code><竞品/标准/协议></code></td><td></td><td>约束来源</td></tr><tr><td><code><阶段①规格草稿></code></td><td></td><td>已确认决策的回写来源</td></tr></table></div>
<hr>
<h2 id="sec-2-4-术语-角色与成功标准" class="doc-h2">4. 术语、角色与成功标准</h2>
<h3 id="sec-3-4-1-术语表" class="doc-h3">4.1 术语表</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="术语">术语</th><th data-c="定义(用户语言,可配图)">定义(用户语言,可配图)</th></tr></thead><tr><td><code><领域词,如 Agent / 面板 / Scope></code></td><td><code><一句话说清></code></td></tr></table></div>
<h3 id="sec-3-4-2-用户角色" class="doc-h3">4.2 用户角色</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="角色">角色</th><th data-c="画像">画像</th><th data-c="主要任务">主要任务</th><th data-c="成功标准">成功标准</th><th data-c="常用模块">常用模块</th></tr></thead><tr><td><code><角色></code></td><td><code><谁,技术背景></code></td><td><code><日常要完成什么></code></td><td><code><做到什么算好></code></td><td>MOD-xx</td></tr><tr><td>例:客户经理</td><td>熟悉融资租赁业务</td><td>提交材料并理解预审意见</td><td>明确项目障碍与下一步</td><td>MOD-02/05</td></tr></table></div>
<h3 id="sec-3-4-3-角色-模块-关注矩阵-可选-" class="doc-h3">4.3 角色 × 模块 关注矩阵(可选)</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c=""></th><th data-c="MOD-01">MOD-01</th><th data-c="MOD-02">MOD-02</th><th data-c="MOD-03">MOD-03</th><th data-c="…">…</th></tr></thead><tr><td>角色 A</td><td>使用</td><td>使用</td><td>–</td><td></td></tr><tr><td>角色 B</td><td>–</td><td>审核</td><td>使用</td><td></td></tr></table></div>
<hr>
<h2 id="sec-2-5-产品概览与核心体验" class="doc-h2">5. 产品概览与核心体验</h2>
<h3 id="sec-3-5-1-产品背景与目标" class="doc-h3">5.1 产品背景与目标</h3>
<p><code><为什么做这个产品;本版本要证明什么(如:证明某类用户能独立完成某闭环)。></code></p>
<h3 id="sec-3-5-2-信息架构与模块关系" class="doc-h3">5.2 信息架构与模块关系</h3>
<pre><code>
一级入口/模块树(文字树或图)
├── &lt;模块一>
│ ├── &lt;子功能>
└── ...
</code></pre>
<p><code><模块之间的依赖与数据走向一句话说明。></code></p>
<h3 id="sec-3-5-3-核心用户流程-端到端-" class="doc-h3">5.3 核心用户流程(端到端)</h3>
<p><code><步骤表:用户从进入到完成一次价值闭环的全过程></code>(例:选择项目 → 确认材料 → 发起预审 → 查看证据 → 补件复核)</p>
<h3 id="sec-3-5-4-体验原则" class="doc-h3">5.4 体验原则</h3>
<li><code><先给结果,再邀请对话></code>(示例原则,按产品改写)
</li>
<li><code><每个结论可解释></code>
</li>
<li><code><异常与关键选择集中呈现,普通状态不打扰></code>
</li>
<li><code><任何能力可见、可停用、可替换></code>
</li>
<li>...
</li>
<h3 id="sec-3-5-5-交付面与平台约束" class="doc-h3">5.5 交付面与平台约束</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="交付面">交付面</th><th data-c="说明">说明</th><th data-c="优先级">优先级</th></tr></thead><tr><td><code><客户经理工作台 / 评审工作台 / 管理配置></code></td><td><code><项目权限、材料来源、运行状态、异常恢复></code></td><td>P0/P1</td></tr></table></div>
<hr>
<h2 id="sec-2-6-功能模块需求-本文档主体-" class="doc-h2">6. 功能模块需求(本文档主体)</h2>
<h3 id="sec-3-6-1-模块清单与划分说明" class="doc-h3">6.1 模块清单与划分说明</h3>
<blockquote>划分原则:按<strong>用户任务闭环</strong>划分模块(不是按技术层);模块间尽量低耦合、每个模块有明确负责人与验收场景。</blockquote>
<div class="tbl-wrap"><table><thead><tr><th data-c="模块">模块</th><th data-c="模块名">模块名</th><th data-c="一句话职责">一句话职责</th><th data-c="主要角色">主要角色</th><th data-c="简码">简码</th><th data-c="优先级">优先级</th></tr></thead><tr><td class="row-id">MOD-01</td><td><code><名称></code></td><td><code><为谁解决什么></code></td><td></td><td><code><STU/DASH…></code></td><td>P0</td></tr><tr><td class="row-id">MOD-02</td><td>...</td><td></td><td></td><td></td><td></td></tr></table></div>
<blockquote>模块依赖图(可选):<code>MOD-02 依赖 MOD-01 的发布产物</code> 等。</blockquote>
<h3 id="sec-3-6-2-各模块详细需求" class="doc-h3">6.2 各模块详细需求</h3>
<blockquote>每模块复制下面一节;模板中 MOD-xx 以 MOD-01 为例。</blockquote>
<h4 id="sec-4-mod-01-" class="doc-h4">MOD-01 <code><模块名></code></h4>
<p><strong>模块概述</strong></p>
<div class="tbl-wrap"><table><thead><tr><th data-c="项">项</th><th data-c="内容">内容</th></tr></thead><tr><td>目的</td><td><code><该模块在用户任务闭环中的位置与作用></code></td></tr><tr><td>用户</td><td><code><角色></code></td></tr><tr><td>入口</td><td><code><从哪个一级入口/页面进入></code></td></tr><tr><td>依赖</td><td><code><依赖哪些其他模块或外部系统></code></td></tr><tr><td>核心对象</td><td><code><用户在该模块操作的对象:如 Agent、面板、版本></code></td></tr></table></div>
<p><strong>功能点总览</strong></p>
<div class="tbl-wrap"><table><thead><tr><th data-c="编号">编号</th><th data-c="功能名称">功能名称</th><th data-c="用户可完成的任务">用户可完成的任务</th><th data-c="优先级">优先级</th></tr></thead><tr><td class="row-id">FR-XXX-01</td><td><code><名称></code></td><td><code><一句话用户价值></code></td><td>P0</td></tr><tr><td class="row-id">FR-XXX-02</td><td>...</td><td></td><td>P1</td></tr></table></div>
<p><strong>功能点详述</strong></p>
<h4 id="sec-5-fr-xxx-01-p0-" class="doc-h4">FR-XXX-01 <code><功能名称></code>(P0)</h4>
<li><strong>功能描述</strong>:<code><该功能是什么;用户可用它完成什么;关键行为逐条列出,如:></code>
</li>
<li><code><行为一></code>
</li>
<li><code><行为二></code>
</li>
<li><strong>前置条件</strong>:<code><进入该功能前必须满足的条件,如已登录、已有数据源授权></code>(无则写"无")
</li>
<li><strong>主流程</strong>:
</li>
<div class="tbl-wrap narrow"><table><thead><tr><th data-c="步骤">步骤</th><th data-c="用户操作">用户操作</th><th data-c="系统响应">系统响应</th></tr></thead><tr><td class="row-id">1</td><td><code><操作></code></td><td><code><响应/界面变化></code></td></tr><tr><td class="row-id">2</td><td>...</td><td></td></tr></table></div>
<li><strong>行为规则与边界</strong>:
</li>
<li><code><规则/边界一:如"默认展示最近 7 天,可配置 1–90 天"></code>
</li>
<li><strong>异常与边界场景</strong>:
</li>
<div class="tbl-wrap"><table><thead><tr><th data-c="编号">编号</th><th data-c="场景">场景</th><th data-c="用户可见行为">用户可见行为</th><th data-c="后备方案">后备方案</th></tr></thead><tr><td class="row-id">EX-XXX-01</td><td><code><如:数据源超时></code></td><td><code><提示什么></code></td><td><code><重试/降级显示陈旧数据并标注></code></td></tr></table></div>
<li><strong>UI 与交互要求</strong>:<code><布局要点、状态(空/加载/错误/正常)、交互手势、可访问性></code>(详见阶段 ④ UI Spec)
</li>
<li><strong>权限与安全</strong>:<code><该功能涉及的权限等级(见第 9 章 L0–L3)、确认点、审计></code>(无则写"无额外要求")
</li>
<li><strong>验收要点</strong>:<code><该功能可验证的 3–6 条要点,对应第 11 章 AC></code>:
</li>
<li>[ ] 要点一
</li>
<li>[ ] 要点二
</li>
<li><strong>关联与备注</strong>:<code><关联功能点/引用文献/开放问题 OQ-xx></code>(无则写"—")
</li>
<h4 id="sec-5-fr-xxx-02-复制上面小节-" class="doc-h4">FR-XXX-02 …(复制上面小节)</h4>
<hr>
<h2 id="sec-2-7-数据与内容需求-若产品以数据-面板-内容为核心-" class="doc-h2">7. 数据与内容需求(若产品以数据/面板/内容为核心)</h2>
<h3 id="sec-3-7-1-数据类型与口径" class="doc-h3">7.1 数据类型与口径</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="内容">内容</th><th data-c="用户要定义什么">用户要定义什么</th><th data-c="系统如何使用">系统如何使用</th></tr></thead></table></div>
<h3 id="sec-3-7-2-内容-数据生成规则" class="doc-h3">7.2 内容/数据生成规则</h3>
<h3 id="sec-3-7-3-展示与交互要求-数据面-" class="doc-h3">7.3 展示与交互要求(数据面)</h3>
<hr>
<h2 id="sec-2-8-非功能需求" class="doc-h2">8. 非功能需求</h2>
<div class="tbl-wrap"><table><thead><tr><th data-c="编号">编号</th><th data-c="类别">类别</th><th data-c="需求">需求</th><th data-c="目标/阈值">目标/阈值</th></tr></thead><tr><td class="row-id">NFR-01</td><td>性能</td><td><code><首屏/操作响应></code></td><td><code><如 ≤2s></code></td></tr><tr><td class="row-id">NFR-02</td><td>可用性</td><td><code><新用户无培训完成核心任务></code></td><td><code><如 ≤60 分钟></code></td></tr><tr><td class="row-id">NFR-03</td><td>可靠性与离线</td><td><code><数据源/服务不可用时的降级></code></td><td></td></tr><tr><td class="row-id">NFR-04</td><td>兼容性</td><td><code><OS/浏览器/分辨率></code></td><td></td></tr><tr><td class="row-id">NFR-05</td><td>可访问性</td><td><code><键盘/读屏/对比度></code></td><td></td></tr><tr><td class="row-id">NFR-06</td><td>国际化与本地化</td><td><code><语言/时区/货币/格式></code></td><td></td></tr><tr><td class="row-id">NFR-07</td><td>数据与隐私</td><td><code><数据保留/删除/导出></code></td><td></td></tr><tr><td class="row-id">NFR-08</td><td>可观测性</td><td><code><日志/审计/用量统计></code></td><td></td></tr><tr><td class="row-id">NFR-09</td><td>安装升级</td><td><code><安装包、升级与回滚></code></td><td></td></tr></table></div>
<blockquote>每行写清"可度量阈值",无阈值 = 不可验收。</blockquote>
<hr>
<h2 id="sec-2-9-安全-权限与信任" class="doc-h2">9. 安全、权限与信任</h2>
<h3 id="sec-3-9-1-用户可理解的动作等级" class="doc-h3">9.1 用户可理解的动作等级</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="等级">等级</th><th data-c="含义">含义</th><th data-c="产品行为">产品行为</th><th data-c="示例">示例</th></tr></thead><tr><td class="row-id">L0 查看</td><td>只读取和展示</td><td>授权后自动运行,留读取记录</td><td></td></tr><tr><td class="row-id">L1 准备</td><td>生成草稿不对外提交</td><td>可自动完成,用户可编辑</td><td></td></tr><tr><td class="row-id">L2 确认后执行</td><td>改变外部系统/通知他人</td><td>必须展示详情由用户确认</td><td></td></tr><tr><td class="row-id">L3 强确认</td><td>金钱/敏感/不可逆</td><td>二次确认或强身份验证,默认不批量</td><td></td></tr></table></div>
<h3 id="sec-3-9-2-必须由产品层提供的能力-按产品改写-" class="doc-h3">9.2 必须由产品层提供的能力(按产品改写)</h3>
<li><code>Scope 隔离 / 最小权限 / 凭证托管 / 执行确认 / 可撤销与熔断 / 全链路记录 / 发布前安全测试</code>
</li>
<h3 id="sec-3-9-3-信任界面要求" class="doc-h3">9.3 信任界面要求</h3>
<li><code><每个展示面与动作卡应呈现的信任信息:版本、数据时间、来源、权限等级、失败后果></code>
</li>
<hr>
<h2 id="sec-2-10-mvp-范围与版本规划" class="doc-h2">10. MVP 范围与版本规划</h2>
<h3 id="sec-3-10-1-mvp-目标与样板场景" class="doc-h3">10.1 MVP 目标与样板场景</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="目标">目标</th><th data-c="验证重点">验证重点</th><th data-c="最低闭环">最低闭环</th></tr></thead></table></div>
<h3 id="sec-3-10-2-p0-p1-p2-范围表" class="doc-h3">10.2 P0 / P1 / P2 范围表</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="产品/模块">产品/模块</th><th data-c="P0(MVP)">P0(MVP)</th><th data-c="P1">P1</th><th data-c="P2(明确不做入近期)">P2(明确不做入近期)</th></tr></thead></table></div>
<h3 id="sec-3-10-3-推荐交付阶段" class="doc-h3">10.3 推荐交付阶段</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="阶段">阶段</th><th data-c="产品结果">产品结果</th><th data-c="验收门">验收门</th></tr></thead></table></div>
<hr>
<h2 id="sec-2-11-验收标准与产品指标" class="doc-h2">11. 验收标准与产品指标</h2>
<h3 id="sec-3-11-1-端到端验收" class="doc-h3">11.1 端到端验收</h3>
<div class="tbl-wrap narrow"><table><thead><tr><th data-c="编号">编号</th><th data-c="验收标准(按角色、可执行)">验收标准(按角色、可执行)</th></tr></thead><tr><td class="row-id">AC-01</td><td><code><Given/When/Then 或可执行描述></code></td></tr></table></div>
<h3 id="sec-3-11-2-核心产品指标" class="doc-h3">11.2 核心产品指标</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="指标">指标</th><th data-c="定义">定义</th><th data-c="目标">目标</th></tr></thead><tr><td><code><首次价值时间></code></td><td><code><定义></code></td><td><code><阈值></code></td></tr></table></div>
<hr>
<h2 id="sec-2-12-假设与待决策事项" class="doc-h2">12. 假设与待决策事项</h2>
<div class="tbl-wrap"><table><thead><tr><th data-c="编号">编号</th><th data-c="事项">事项</th><th data-c="V0.x 默认假设">V0.x 默认假设</th><th data-c="需要的产品决策">需要的产品决策</th><th data-c="Owner">Owner</th><th data-c="期限">期限</th></tr></thead><tr><td class="row-id">OQ-01</td><td><code><如:首端平台></code></td><td><code><默认></code></td><td><code><待决问题></code></td><td></td><td></td></tr></table></div>
<blockquote>未决事项不阻止开始原型,但进入正式排期前必须关闭。</blockquote>
<hr>
<h2 id="sec-2-附录" class="doc-h2">附录</h2>
<h3 id="sec-3-a-功能点索引-全部-fr-ex-编号-模块位置-自动核对用-" class="doc-h3">A. 功能点索引(全部 FR / EX 编号 → 模块位置,自动核对用)</h3>
<div class="tbl-wrap"><table><thead><tr><th data-c="编号">编号</th><th data-c="功能">功能</th><th data-c="模块">模块</th><th data-c="优先级">优先级</th><th data-c="状态(草稿/已确认/withdrawn)">状态(草稿/已确认/withdrawn)</th></tr></thead></table></div>
<h3 id="sec-3-b-产品话术与演示脚本-可选-" class="doc-h3">B. 产品话术与演示脚本(可选)</h3>
<h3 id="sec-3-c-变更对照-本版相对上一版的增删-" class="doc-h3">C. 变更对照(本版相对上一版的增删)</h3>
<hr>
<blockquote><strong>模板维护</strong>:本模板本身受仓库 ⑧ 学习与沉淀 约束——使用中发现结构缺陷,更新本文档并记入"变更记录"(放文末)。</blockquote>
<section><h2>兴邦填写约束(XB-1.0 · 2026-09-28)</h2><ul><li>明确主审 Agent、专项判断模型和正式审批职责;Jev 单题不能直接审批。</li><li>历史经验包含争议、核查、证据和判断变化;过程缺失须标未知。</li><li>定义项目权限、数据域、模拟与正式结果、失败与人工复核路径。</li><li>无真实校准时不承诺通过率、准确率或改善幅度;未决项标 owner 与阶段。</li><li>本文为阅读模板,正式编辑与编号以同目录 URD-Template.md 为准。</li></ul></section>
</main></div></body></html>