# 财顾报告Agent MVP 需求分析文档

> 分析依据：
> - 《财顾报告智能化生成产品MVP版本需求文档.md》
> - 《财顾报告Agent-技术架构与选型.md》
> - 《财顾报告生成智能体后端及算法端功能模块描述及其实现思路.md》

---

## 1. 背景与目标

### 1.1 建设背景
本项目拟建设财务顾问报告智能生成系统，以MVP（最小可行产品）方式优先验证核心链路可行性。系统服务于财务顾问主服务报告的智能化撰写支持，覆盖**项目融资、资产管理、并购重组**三类报告类型。

### 1.2 本期目标
1. **验证报告智能生成主链路可跑通**：从任务发起到结果输出的最短业务闭环
2. **验证结构化生成方式有效性**：采用"大纲生成→数据准备→报告生成"三阶段执行机制
3. **验证知识单元驱动设计**：以知识单元作为最小执行对象，支撑大纲决策、数据准备和段落生成
4. **形成可演示原型**：页面可操作、流程可执行、结果可展示

---

## 2. 用户角色与关键场景

### 2.1 用户角色（本期简化）
本期MVP阶段用户按**单一业务角色**设计，不区分客户经理、审批支持人员、运维人员等：

| 角色 | 职责描述 |
|------|----------|
| 业务人员 | 发起任务、录入信息、大纲确认、数据补录、结果查看与导出 |

### 2.2 关键场景

#### 场景1：任务发起
- 选择报告类型（项目融资/资产管理/并购重组）
- 录入客户及项目基础信息
- 上传辅助材料（Excel模板，RAG召回使用）

#### 场景2：大纲生成与确认（核心控制环节）
- 系统生成一级章节结构及知识单元数量分配
- 逐章生成末级知识单元清单
- 业务人员在树状结构中进行勾选/取消勾选/顺序调整
- **受控生成**：不允许自由新增未配置内容

#### 场景3：数据准备与补录
- 系统按知识单元调用数据处理逻辑
- 展示自动获取结果（API接口/指标平台/RAG召回）
- 业务人员进行文本补录
- 确认数据准备完成

#### 场景4：报告生成与导出
- 系统逐知识单元生成段落内容
- 按大纲顺序拼接完整报告
- 在线查看与导出DOCX/PDF

---

## 3. 需求清单（P0/P1/P2）

### 3.1 P0需求（本期必须交付）

| 模块 | 需求项 | 优先级 | 验收标准 |
|------|--------|--------|----------|
| 任务管理 | 创建报告任务 | P0 | 支持三类报告类型选择，必填字段校验通过 |
| 任务管理 | 保存任务输入信息 | P0 | 结构化保存客户、项目、业务要素信息 |
| 大纲生成 | 一级大纲生成 | P0 | 根据协议金额、企业类型等生成一级章节结构 |
| 大纲生成 | 二级大纲生成 | P0 | 按一级章节逐一生成知识单元清单 |
| 大纲确认 | 树状结构展示 | P0 | 展示模型默认选中状态，支持勾选/取消/排序 |
| 大纲确认 | 受控调整 | P0 | 仅在预置知识体系范围内调整，禁止新增 |
| 数据准备 | 多源数据获取 | P0 | 支持API接口、指标平台、RAG三类数据源 |
| 数据准备 | 按知识单元组织 | P0 | 数据结果与知识单元一对一绑定 |
| 数据确认 | 结果展示 | P0 | 展示自动获取结果，支持文本补录 |
| 报告生成 | 逐段生成 | P0 | 按知识单元逐个调用模型生成段落 |
| 报告生成 | 顺序拼接 | P0 | 按大纲顺序拼接为完整报告 |
| 结果展示 | 在线查看 | P0 | 按章节段落结构展示报告内容 |
| 结果展示 | 文档导出 | P0 | 支持导出标准格式文档（DOCX） |
| 状态管理 | 任务状态流转 | P0 | 9个状态正常流转，状态控制页面行为 |

### 3.2 P1需求（本期酌情开发）

| 模块 | 需求项 | 优先级 | 说明 |
|------|--------|--------|------|
| 大纲确认 | 版本记录 | P1 | 记录确认人、确认时间、与模型草稿差异 |
| 数据确认 | 批量确认 | P1 | 支持知识单元批量确认 |
| 报告生成 | 进度展示 | P1 | 实时展示生成进度 |
| 结果展示 | 章节导航 | P1 | 左侧章节树快速定位 |
| 后台预置 | 知识体系初始化 | P1 | 项目融资类知识体系预置数据 |

### 3.3 P2需求（本期不做，预留扩展）

| 模块 | 需求项 | 优先级 | 说明 |
|------|--------|--------|------|
| 配置端 | 知识体系配置页面 | P2 | 在线新增/修改/删除知识单元 |
| 配置端 | 数据资源配置页面 | P2 | 在线配置接口参数映射 |
| 报告编辑 | 段落级重生成 | P2 | 单段内容重新生成 |
| 报告编辑 | 在线精细编辑 | P2 | 富文本编辑器在线修改 |
| 协同 | 多人协同编辑 | P2 | 多人协作与审核流转 |
| 权限 | 精细角色权限 | P2 | 分角色权限控制体系 |

---

## 4. 验收标准

### 4.1 功能验收

| 验收项 | 验收标准 |
|--------|----------|
| 任务创建 | 必填字段缺失时给出明确提示；创建成功后生成任务ID |
| 大纲生成 | 一级大纲返回JSON结构，包含chapter_results和overall_logic；二级大纲返回完整章节编号树 |
| 大纲确认 | 树状展示响应时间<2s；勾选/取消操作即时生效；确认后生成最终知识单元清单 |
| 数据准备 | 每个知识单元数据获取<10s；失败时给出明确错误提示 |
| 报告生成 | 单段生成<30s；整篇报告生成可接受异步处理 |
| 结果导出 | DOCX导出格式符合行内报告规范 |

### 4.2 业务验收

| 验收项 | 验收标准 |
|--------|----------|
| 生成稳定性 | 10次相同输入的大纲生成，结构一致性>80% |
| 内容可用性 | 生成报告经业务老师评估，可直接使用或少量修改即可使用 |
| 可控性 | 大纲确认、数据确认两个卡点有效降低模型输出风险 |

---

## 5. 范围边界（本期不做）

### 5.1 明确排除范围

1. **完整知识配置端**：不建设在线知识体系维护页面，通过后台预置实现
2. **完整数据资源配置端**：不建设在线接口配置页面，通过代码绑定实现
3. **段落级编辑与重生成**：不支持单段重跑、在线逐段编辑、多版本对比
4. **精细角色权限**：本期统一按"业务人员"处理
5. **复杂协同流程**：不支持多人协同、审批流转、操作留痕追踪

### 5.2 简化实现内容

| 能力 | 简化方式 |
|------|----------|
| 知识体系配置 | 数据库初始化脚本维护 |
| 数据资源绑定 | 代码或配置文件绑定 |
| 大纲调整 | 仅支持勾选/取消/排序，不支持自由新增改写 |
| 数据编辑 | 仅支持查看+文本补录，不支持复杂结构化编辑 |
| 结果处理 | 仅支持查看与导出，不支持富文本在线编辑 |

---

## 6. 风险与待确认

### 6.1 已知风险

| 风险项 | 风险等级 | 应对措施 |
|--------|----------|----------|
| 模型输出不稳定 | 高 | 通过大纲确认、数据确认两个卡点控制；分段生成降低单次调用复杂度 |
| 知识单元配置工作量大 | 中 | MVP阶段聚焦项目融资类报告；采用后台预置方式减少配置端开发 |
| 行内接口集成复杂度 | 中 | 早期识别接口依赖，预留联调时间；准备Mock数据 |
| 生成时间较长 | 中 | 长耗时阶段采用MQ异步化；提供进度反馈 |

### 6.2 待确认事项（TBD）

| 序号 | 待确认项 | 影响范围 | 建议处理 |
|------|----------|----------|----------|
| TBD-1 | 行内SSO对接方式 | 接入层 | 待与行内安全团队确认 |
| TBD-2 | 模型集群访问方式 | 算法端 | 待与模型平台团队确认 |
| TBD-3 | 工商/风险接口具体规格 | 数据准备 | 待与数据提供方确认 |
| TBD-4 | 导出文档格式详细规范 | 结果展示 | 待与业务老师确认 |
| TBD-5 | 租户隔离级别要求 | 整体架构 | 待与运维团队确认 |
| TBD-6 | OSS存储桶命名规范 | 文件存储 | 待与基础设施团队确认 |

---

## 7. 附录：核心术语表

| 术语 | 说明 |
|------|------|
| 知识单元 | 大纲最末级节点，对应一个最终输出段落 |
| 单元呈现型 | 每次执行生成一个固定段落的知识单元类型 |
| 批次处理型 | 针对多个对象重复生成相同结构段落的知识单元类型 |
| 外部获取型 | 通过外部渠道直接获取分析结果的知识单元类型 |
| 四级模板 | 信息陈述型、对象分析型、指标数据描述型、综合判断型 |

---

*文档版本：MVP阶段*
*最后更新：2026-03-31*