9.2 KiB
兴邦智审 v2 用户需求文档
1. 文档控制
| 项 | 内容 |
|---|---|
| 编号 | URD-XB-V2-0.1 |
| 日期 / 状态 | 2026-09-28 / 草稿待评审 |
| 需求来源 | 用户本次会话：聚焦 AI 预审、历史评审经验、Jev 辅助判断和数据开放展示 |
| 产品 owner | 项目负责人；业务评审 owner 为兴邦指定评审专家，待指派 |
| 维护位置 | docs/v2/URD.md |
变更记录：0.1 首次整理；本文为后续规格输入，不代表客户已确认。
2. 目的与范围
帮助客户经理在项目早期获得有依据的推进建议、主要障碍、最小补件路径；帮助评审人员将历史项目中的调查方法沉淀为可审核、可复用、可撤回的经验。
P0 范围：受控演示、项目事实与证据、历史案例过程与经验卡、主审综合预审、Jev 可选专项核查、情景模拟、对照验证。先演示并验证经验链，再争取一批脱敏历史案例。
不在 P0：自动正式审批、自动放款、未经校准的通过概率、默认访问兴邦生产库、个人评审员通过倾向预测、用真实材料直接训练外部模型。这些能力或不属于本产品职责，或依赖另行确认的数据和验证条件。
成功条件：在明确标注的演示材料上，用户能追溯判断依据，理解新增材料为何改变或没有改变结论；脱敏试点效果经客户持有的保留样本验证后单独报告。
3. 参考
4. 术语与角色
| 术语 | 用户语言定义 |
|---|---|
| 主审 Agent | 组织核查、比较证据并形成 AI 预审意见的助手 |
| 预审意见 | 建议推进、补充后再判断、暂不建议推进、信息不足；均非正式审批 |
| 经验卡 | 某类争议如何调查、哪些证据改变判断、适用与例外条件的记录 |
| 判断节点 | 一项具体争议及其核查、证据和当时意见 |
| 情景模拟 | 在假设动作完成的条件下重新评估，尚未改变真实项目事实 |
| 审批概率 | 指定审批阶段和时间口径下的获批估计，须独立历史校准 |
| 盲测 | 系统先锁定结果，再与保留的专家意见和结果对照 |
| 角色 | 任务 | 成功表现 |
|---|---|---|
| 客户经理 | 提供材料、理解障碍、补件 | 知道下一步优先做什么及依据 |
| 评审员 | 核实经验、复核争议 | 看得懂证据链，能纠正和说明分歧 |
| 经验发布人 | 审核适用范围、发布和撤回经验 | 候选经验不会未经审核直接生效 |
| 数据/系统管理员 | 管理数据范围、模型出口和版本 | 每次运行有明确数据范围和访问记录 |
| 项目负责人/只读访客 | 观看演示、比较效果 | 分清模拟能力和实测效果 |
发布人独立资格与真实身份接入方式见 OQ-02；P0 演示用明示的模拟角色，不当作生产鉴权。
5. 核心体验
历史档案 → 争议时间线 → 专家确认经验 → 新项目核查 → 补充证据与模拟 → 复核与对照验证。
页面入口拟整合到项目工作台：预审总览、历史经验、证据详情、推进沙盘、验证看板。保持当前项目上下文；不新增一批与现有工作台重叠的孤立旧页面。
交付面为中文 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-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 |
各功能前置条件均为项目/案例访问范围有效；真实数据须有授权范围。详见规格的权限、错误和状态定义。上述 8 项均为 P0 范围，但按实施计划分批实现，不能一批全上。
7. 数据与内容
优先需要同一历史项目的初始材料、问询、补件、方案版本、批复条件与制度版本。正式决定与投放后表现分开记录。案例间通过受控假名关联，同一项目不能拆进开发集与保留集。
每条经验保留原文定位、发生时间、记录时间、适用条件、例外、审核人与版本。缺失事项用未知表示。示例案例和代码内置模式只用于演示，不作为真实兴邦经验或频次。
8. 非功能需求
| 编号 | 要求与验收口径 |
|---|---|
| NFR-01 可追溯 | 每条正式展示的实质判断须有证据引用或明确的缺证状态；引用解析失败不得静默忽略 |
| NFR-02 稳定性 | 相同请求幂等键及载荷不产生重复运行；修改载荷复用键返回冲突 |
| NFR-03 降级 | Jev 不可用时展示缺失核查；不得把超时转换成通过 |
| 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 Jev 未接入，When 查看结果，Then 明确未执行且不展示伪造概率 |
| AC-U06 | Given 模拟完成一个动作，When 比较结果，Then 真实快照保持不变且模拟标识持续可见 |
| AC-U07 | Given 客户保留样本，When 系统锁定结果后揭示标签，Then 可复盘分歧且记录无答案泄漏 |
| AC-U08 | Given 未批准外发的数据域，When 请求外部模型，Then 阻断请求且保留不含原文的审计 |
核心效果指标：重大问题漏检、无依据结论、误报、有效补件、专家分歧、耗时与成本。目标值由试点双方在开测前确定；不预先承诺准确率。
12. 假设与未决项
当前假设：中文 Web、无真实历史库、先用标注演示数据、主审负责综合意见。首批行业、专家发布权限、模型数据出口、验收阈值和“通过”的阶段定义均见 OQ 清单，有 owner 与 needed-by。真实试点前必须关闭对应阻塞项。
附录：全部 FR/EX 索引在第 6 节；演示脚本见 数据试点与展示。本版从既有综合平台聚焦经验驱动预审，保留旧能力供迁移，不声称重写完成。