143 lines
12 KiB
Markdown
143 lines
12 KiB
Markdown
# 兴邦智审 v2 用户需求文档
|
||
|
||
## 1. 文档控制
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| 编号 | URD-XB-V2-0.2 |
|
||
| 日期 / 状态 | 2026-09-29 / 用户确认产品方向，规格待评审 |
|
||
| 需求来源 | 用户本次会话：聚焦 AI 预审、历史评审经验、可切换专项模型（Jev / 本地开源模型）和数据开放展示 |
|
||
| 产品 owner | 项目负责人；业务评审 owner 为兴邦指定评审专家，待指派 |
|
||
| 维护位置 | docs/v2/URD.md |
|
||
|
||
变更记录：0.1 首次整理；0.2 补齐用户确认的三模块闭环、人工卡片和本地专项判断。用户确认不等于兴邦已签署或工程门禁通过。
|
||
|
||
## 2. 目的与范围
|
||
|
||
帮助客户经理在项目早期获得有依据的推进建议、主要障碍、最小补件路径；帮助评审人员将历史项目中的调查方法沉淀为可审核、可复用、可撤回的经验。
|
||
|
||
P0 范围：纯模拟数据的受控演示、项目事实与证据、历史案例过程与经验卡、主审综合预审、可选专项核查（Jev 官方服务 / 本地开源模型 / 关闭）、情景模拟、对照验证。先演示并验证经验链，再争取一批脱敏历史案例。
|
||
|
||
不在 P0：自动正式审批、自动放款、未经校准的通过概率、默认访问兴邦生产库、个人评审员通过倾向预测、用真实材料直接训练外部模型。这些能力或不属于本产品职责，或依赖另行确认的数据和验证条件。
|
||
|
||
成功条件：在明确标注的演示材料上，用户能追溯判断依据，理解新增材料为何改变或没有改变结论；脱敏试点效果经客户持有的保留样本验证后单独报告。
|
||
|
||
## 3. 参考
|
||
|
||
- [项目流程](../project-process/README.md)及 [URD 模板](../project-process/templates/URD-Template.md)。
|
||
- [当前技术路径](../兴邦金租对公智能评审平台技术路径与AgentLoop说明-v1.0.md)。
|
||
- [新版需求规格](01-requirements.md)、[架构](02-architecture.md)、[决策记录](09-decisions.md)。
|
||
|
||
## 4. 术语与角色
|
||
|
||
| 术语 | 用户语言定义 |
|
||
|---|---|
|
||
| 主审 Agent | 组织核查、比较证据并形成 AI 预审意见的助手 |
|
||
| 预审意见 | 建议推进、补充后再判断、暂不建议推进、信息不足；均非正式审批 |
|
||
| 经验卡 | 某类争议如何调查、哪些证据改变判断、适用与例外条件的记录 |
|
||
| 判断节点 | 一项具体争议及其核查、证据和当时意见 |
|
||
| 情景模拟 | 在假设动作完成的条件下重新评估，尚未改变真实项目事实 |
|
||
| 审批概率 | 指定审批阶段和时间口径下的获批估计，须独立历史校准 |
|
||
| 盲测 | 系统先锁定结果，再与保留的专家意见和结果对照 |
|
||
|
||
| 角色 | 任务 | 成功表现 |
|
||
|---|---|---|
|
||
| 客户经理 | 提供材料、理解障碍、补件 | 知道下一步优先做什么及依据 |
|
||
| 评审员 | 核实经验、复核争议 | 看得懂证据链，能纠正和说明分歧 |
|
||
| 经验发布人 | 审核适用范围、发布和撤回经验 | 候选经验不会未经审核直接生效 |
|
||
| 数据/系统管理员 | 管理数据范围、模型出口和版本 | 每次运行有明确数据范围和访问记录 |
|
||
| 项目负责人/只读访客 | 观看演示、比较效果 | 分清模拟能力和实测效果 |
|
||
|
||
发布人独立资格与真实身份接入方式见 OQ-02；P0 演示用明示的模拟角色，不当作生产鉴权。
|
||
|
||
## 5. 核心体验
|
||
|
||
三个核心模块：①历史经验加工中心：历史档案→时间线→Skills/Rules候选→专家审核；②AI预审工作台：数据卡+Skills卡+Rules卡装配方案→受控核查→补件与沙盘；③轨迹复盘中心：运行轨迹→会议结果对照→改进候选→验证和审核发布。
|
||
|
||
终局目标是让高预测通过概率的项目在公司项目评审会上具有较高实际通过比例，同时报告覆盖率和校准；不是预测违约，也不是自动审批。介入点为最初收集材料时；不值得继续推进的项目由客户经理据建议作决定。详见 [闭环设计](14-experience-loop.md)。
|
||
|
||
页面入口拟整合到项目工作台：预审总览、历史经验、证据详情、推进沙盘、验证看板。保持当前项目上下文；不新增一批与现有工作台重叠的孤立旧页面。
|
||
|
||
交付面为中文 Web；保留现有 Next.js + FastAPI 技术基线。桌面应用、移动专用端暂不纳入。
|
||
|
||
## 6. 功能模块需求
|
||
|
||
| 模块 | 功能编号 | 用户任务 / 主流程 | 异常与用户行为 | 验收 |
|
||
|---|---|---|---|---|
|
||
| MOD-01 项目事实 | FR-FACT-01 | 上传材料→查看提取候选→确认事实与来源 | EX-FACT-01 解析失败：保留原件，允许人工录入并标注来源 | AC-U01 |
|
||
| MOD-02 历史过程 | FR-HIST-01 | 导入案例→整理争议、补件、证据、决定的时间线 | EX-HIST-01 时间或来源缺失：显示未知，禁止补造 | AC-U02 |
|
||
| MOD-03 经验治理 | FR-EXP-01 | 提炼候选→专家修改→审核发布→必要时撤回 | EX-EXP-01 无审核资格/过期：不进入有效经验集 | AC-U03 |
|
||
| MOD-04 主审预审 | FR-REV-01 | 发起预审→查看核查过程→获得意见与补件清单 | EX-REV-01 关键材料不足/工具失败：显示信息不足或部分结果 | AC-U04 |
|
||
| MOD-05 专项核查 | FR-JEV-01 | 查看具体材料是否支持结论及核查状态 | EX-JEV-01 未配置/超时：显示未执行，不伪造返回值 | AC-U05 |
|
||
| MOD-05 专项核查 | FR-JUD-01 | 管理员配置可用模型，用户在授权配置中选择后发起新预审；同一套业务问题可由 Jev 或本地开源模型执行 | EX-JUD-01 配置/能力不满足：显示原因，不自动改用外部服务 | AC-U09 |
|
||
| MOD-06 推进沙盘 | FR-SIM-01 | 选择假设动作→比较问题变化→返回真实结果 | EX-SIM-01 假设冲突/无证据：提示限制，禁止当作正式改善 | AC-U06 |
|
||
| MOD-07 效果验证 | FR-EVAL-01 | 锁定样本与版本→运行→揭示参考结果→专家复盘 | EX-EVAL-01 参考答案提前泄露：样本作废，不计盲测 | AC-U07 |
|
||
| MOD-08 数据试点 | FR-PILOT-01 | 查看数据用途→选择受控案例范围→审核导入 | EX-PILOT-01 数据出口未批准：阻止外部发送 | AC-U08 |
|
||
|
||
各功能前置条件均为项目/案例访问范围有效；真实数据须有授权范围。详见规格的权限、错误和状态定义。上述模块归入三个核心模块；P0只实现模拟流程，FR-PILOT-01的真实接入属于P1；FR-JEV-01 保留历史编号，专项模块的实现不绑定 Jev 品牌。各模块按实施计划分批实现，不能一批全上。
|
||
|
||
## 7. 数据与内容
|
||
|
||
优先需要同一历史项目的初始材料、问询、补件、方案版本、批复条件与制度版本。正式决定与投放后表现分开记录。案例间通过受控假名关联，同一项目不能拆进开发集与保留集。
|
||
|
||
每条经验保留原文定位、发生时间、记录时间、适用条件、例外、审核人与版本。缺失事项用未知表示。示例案例和代码内置模式只用于演示，不作为真实兴邦经验或频次。
|
||
|
||
## 8. 非功能需求
|
||
|
||
| 编号 | 要求与验收口径 |
|
||
|---|---|
|
||
| NFR-01 可追溯 | 每条正式展示的实质判断须有证据引用或明确的缺证状态；引用解析失败不得静默忽略 |
|
||
| NFR-02 稳定性 | 相同请求幂等键及载荷不产生重复运行；修改载荷复用键返回冲突 |
|
||
| NFR-03 降级 | 所选专项模型不可用时展示缺失核查；不得把超时转换成通过 |
|
||
| NFR-04 可访问性 | 键盘可完成核心流程；状态同时有文字；支持减少动效，实施时测试对比度 |
|
||
| NFR-05 可观测性 | 每次运行记录数据/组件/模型/经验版本和工具结果状态，不记录凭据 |
|
||
| NFR-06 性能 | 首版先记录端到端耗时、模型耗时与调用成本；验收阈值在 OQ-04 关闭后确定，当前无速度承诺 |
|
||
|
||
## 9. 权限与信任
|
||
|
||
SEC-01 项目、团队和演示/生产数据域隔离；SEC-02 材料正文仅作数据，不能成为工具指令；SEC-03 外部模型出口必须属于当前数据域的已批准策略；SEC-04 经验发布与撤回有资格校验和审计；SEC-05 真实身份确认前不开放生产数据。
|
||
|
||
查看为 L0，提炼草稿和模拟为 L1，经验发布/对外发送为 L2 受权限与明确策略约束；放款、改写审批结果等 L3 金融动作不在 P0。模型不能自行授予权限。
|
||
|
||
## 10. 版本规划
|
||
|
||
P0：演示经验链、主审核查、专项复核、沙盘和验证框架；P1：脱敏试点、真实流程映射与经验覆盖扩展；P2：足量历史结果上的审批概率校准。投放风险预测另立需求，不与审批通过混为一谈。
|
||
|
||
每批必须有可运行的端到端结果和对应 AC；未完成事项保留待办，不以展示页面替代后端能力。
|
||
|
||
## 11. 产品验收
|
||
|
||
| 编号 | Given / When / Then |
|
||
|---|---|
|
||
| AC-U01 | Given 上传材料，When 确认候选事实，Then 能定位原文并保留原版本 |
|
||
| AC-U02 | Given 含问询和补件的案例，When 查看过程，Then 可看到关键判断变化，缺日期显示未知 |
|
||
| AC-U03 | Given 未审核或已撤回经验，When 发起新预审，Then 不得作为有效经验应用 |
|
||
| AC-U04 | Given 有矛盾的新项目，When 预审完成，Then 指出冲突与补查路径，不绕过硬性规则 |
|
||
| AC-U05 | Given 专项模块关闭或所选服务未配置，When 查看结果，Then 明确未执行且不展示伪造概率 |
|
||
| AC-U06 | Given 模拟完成一个动作，When 比较结果，Then 真实快照保持不变且模拟标识持续可见 |
|
||
| AC-U07 | Given 客户保留样本，When 系统锁定结果后揭示标签，Then 可复盘分歧且记录无答案泄漏 |
|
||
| AC-U08 | Given 未批准外发的数据域，When 请求外部模型，Then 阻断请求且保留不含原文的审计 |
|
||
| AC-U09 | Given 没有 Jev Key 但已配置可用本地模型，When 选择本地并预审，Then 相同问题与证据完成专项核查且不访问 Jev；切换后留新运行，不覆盖旧结果 |
|
||
|
||
核心效果指标：重大问题漏检、无依据结论、误报、有效补件、专家分歧、耗时与成本。目标值由试点双方在开测前确定；不预先承诺准确率。
|
||
|
||
## 12. 假设与未决项
|
||
|
||
当前假设：中文 Web、无真实历史库、先用标注演示数据、主审负责综合意见。首批行业、专家发布权限、模型数据出口、验收阈值和会议结果代码/观察窗口映射均见 [OQ 清单](09-decisions.md)，有 owner 与 needed-by。真实试点前必须关闭对应阻塞项。
|
||
|
||
附录：原有 FR/EX 索引在第 6 节，新增功能与验收映射在第13节；演示脚本见 [数据试点与展示](08-data-pilot-and-demo.md)。本版从既有综合平台聚焦经验驱动预审，保留旧能力供迁移，不声称重写完成。
|
||
|
||
## 13. 本次确认的功能增量
|
||
|
||
| 功能编号 | 用户任务 | 规格验收 |
|
||
|---|---|---|
|
||
| FR-FACT-02 | 选择文件集合，查看逐文件解析与来源冲突，确认后生成数据卡 | AC-23/24 |
|
||
| FR-EXP-02 | 用自然语言干预提炼，人工新增Skills/Rules，保留来源并审核 | AC-25/26/27/43 |
|
||
| FR-PLAN-01 | 装配数据/Skill/Rule，生成随方案变化的核查维度，不开放Tools卡 | AC-28/29/44 |
|
||
| FR-SIM-02 | 查看明确标注的概率状态及依据，勾选后比较完整情景 | AC-30/31 |
|
||
| FR-TRACE-01 | 回放AI轨迹、查看会议记录，区分材料版本和未知经过 | AC-22/32/33 |
|
||
| FR-LEARN-01 | 从偏差提出改进，固定对照、审核后发布，继续观察效果 | AC-34/36/37/41 |
|
||
| FR-DEMO-01 | 用可复现的多结果模拟案例演示完整闭环 | AC-35 |
|
||
|
||
以上AC均引用需求规格的稳定编号，不新增重复AC-U口径。P0验收结构与交互；真实预测效果须P1/P2单独验证。历史提炼和人工维护的卡片颜色/图标/文字区别清晰，来源和发布状态分开呈现（AC-42）。
|