# 邦拓客户管理智能体系统需求文档

## 1. 文档目的

本文档用于说明邦拓客户管理智能体当前原型的整体业务范围、页面功能、数据关系、状态规则和交互约束，作为开发实现、接口设计、数据库设计、测试验收和 AI 辅助开发的统一依据。

演示数据仅用于验证原型交互。正式开发时，浏览器本地状态应替换为服务端接口、权限校验和数据库持久化。

## 2. 系统目标

系统面向销售业务全流程，统一管理客户、需求、跟进、待办、方案和知识资料，并通过 AI 对话和 AI 识别提高资料整理、客户分析、方案推荐和业务跟进效率。

系统需要形成以下闭环：

`CRM 客户进入客户池` → `客户跟进` → `沟通资料识别` → `人工确认` → `客户/需求/待办同步` → `产品匹配` → `方案生成与审核` → `发送客户` → `反馈与成交统计`

## 3. 用户角色与权限

| 角色 | 主要权限 |
| --- | --- |
| 销售 | 查看权限范围内客户；编辑客户；新增需求；新增跟进；处理待办；生成方案 |
| 销售经理 | 查看团队客户和需求；审核团队方案；查看团队经营数据 |
| 项目经理 | 查看协作客户和需求；处理项目交付和跟进 |
| 产品管理员 | 维护产品库、话术库、政策库和方案模板 |
| CEO | 查看全量客户、需求、方案和经营统计 |
| 系统管理员 | 管理账号、角色、权限和系统配置 |

权限必须同时控制：

- 数据查看范围。
- 页面入口和菜单。
- 新增、编辑、删除、审核、作废、发送等按钮。
- 方案和知识库内容的操作权限。

## 4. 开发开放范围与模块状态

为了支持“部分模块先进入开发、部分模块继续评审调整”，需求文档和原型交付给开发时必须按模块标注开发状态。

| 模块 | 当前状态 | 开发口径 |
| --- | --- | --- |
| 工作台 | 可进入开发 | 按当前需求文档和原型实现统计、环比、时间查询和跳转交互。 |
| 需求管理 | 可进入开发 | 按当前需求文档和原型实现新增、编辑、详情、删除、批量跟进和列表选择。 |
| 跟进 | 可进入开发 | 按当前需求文档和原型实现新增跟进、AI 识别、附件上传、详情、预览和下载。 |
| 待办事项 | 可进入开发 | 按当前需求文档和原型实现列表、日历视图、筛选、时间区间查询和新增编辑。 |
| 知识库 | 可进入开发 | 按当前需求文档和原型实现产品库、产品对比、话术库、政策库和更新记录。 |
| AI 对话 | 可进入开发 | 按当前需求文档和原型实现对话列表、发送、暂停、图片粘贴、预览、删除和二次确认。 |
| 角色权限、登录状态、流程闭环、开发说明 | 可进入开发 | 按当前需求文档和原型实现展示、边界说明和开发阅读入口。 |
| 客户管理 | 调整中 | 当前原型仅作为业务上下文参考，不作为最终开发基线；待字段、详情布局和编辑规则确认后再进入开发。 |
| 方案管理 | 调整中 | 当前原型仅作为业务上下文参考，不作为最终开发基线；待方案预览、模板、提示词调整和推荐机制确认后再进入开发。 |

开发协作规则：

- 可进入开发的模块可以拆分任务、设计接口、建表和进入编码。
- 调整中的模块只允许开发阅读上下文、评估影响和提出问题，不应进入正式编码。
- 如果某个可开发模块依赖客户管理或方案管理字段，先使用需求文档中已确认的稳定 ID 和字段，不扩展未确认字段。
- 后续客户管理或方案管理确认后，需要将模块状态从“调整中”改为“可进入开发”，并记录确认时间和确认人。

## 5. 页面与功能需求

## 5.1 工作台

工作台展示：

- 客户情况。
- 需求情况。
- 今日待跟进。
- 逾期未跟进。
- 需求转化率。
- 成交产品排行榜。
- 客户来源城市。

统计卡片规则：

- `待跟进、已跟进次数、逾期未跟进、短期客户、中期客户、长期客户、已面谈客户、无效客户` 展示数字。
- `需求数量、已发方案、已申请优惠、已发合同` 展示数字。
- `需求转化率` 展示百分比。
- 指标数值下方直接展示环比比例和箭头。
- `环比`文字使用比统计项名称更浅的中性字体颜色；方向箭头和环比数值使用颜色区分，上升为绿色、下降为红色，持平保持浅灰。
- 环比不显示正号或负号，例如：`环比 ↑ 12.5%`、`环比 ↓ 8.2%`。
- 工作台保留时间查询控件，支持今日、本周、本月和自定义日期区间；查询条件用于统计口径，卡片不重复展示周期描述。
- 无可比数据时显示 `环比 --`。
- 不在统计卡片中展示“日、周、月、本期、当前周期”等辅助描述。

统计时间口径：

- 客户和需求按创建时间统计。
- 跟进按跟进创建时间统计。
- 待办按截止日期统计。
- 方案和状态统计按对应业务记录的创建时间或状态发生时间统计。
- 当前数据范围必须按登录角色过滤。

## 5.2 客户管理

客户列表支持：

- 关键词搜索和高级筛选。
- 客户池筛选。
- 客户状态、客户周期、年龄、行业、画像、城市等筛选。
- 列自定义。
- 客户列表单选和全选。
- 批量跟进。
- 列表分页和数据区滚动。
- 客户姓名、操作列固定；其他列允许按场景调整。

交互要求：

- 全选框与列表单选框大小、位置和样式一致。
- 表头使用统一背景色。
- 长文本使用省略号时，鼠标移入显示完整内容。
- 联系方式不做脱敏。
- 点击客户进入客户详情。
- 客户详情中的操作名称使用“编辑”。
- 列表上方不展示多余的跟进按钮。

## 5.3 客户编辑

编辑页支持编辑：

- 客户姓名和联系方式。
- 负责人、协助人。
- 客户状态、客户周期。
- 下次联系日期时间。
- 办理预算和可投资资产。
- 客户标签。
- KYC 相关信息。
- 性别、年龄、家庭资产、行业、画像、常驻国家城市等字段。

字段规则：

- 办理预算、可投资资产没有明确选项值时使用输入框，不强制使用下拉框。
- 客户标签支持多个值，可通过分隔符录入和编辑。
- 客户池字段不在客户编辑页展示，但必须在客户详情查看中展示。
- 保存后客户列表、客户详情、关联需求、AI 识别结果和跟进记录使用最新数据。
- 保存后刷新页面不能恢复旧数据。

## 5.4 客户详情

客户详情包含：

- 基础信息紧凑布局。
- 联系方式小卡片，展示手机号、微信号、邮箱和 WhatsApp 号。
- 客户标签。
- 客户池。
- 客户全部需求卡片。
- 跟进记录。
- 方案历史。
- KYC。
- 推荐产品。

推荐产品必须展示：

- 产品名称。
- 匹配度。
- 推荐原因。
- 匹配依据或命中的需求信息。

客户详情的 AI 摘要不展示没有明确计算规则的“弱意向”“中高意向”等意向状态。

推荐产品的开发规则：

1. 触发时机：新增方案、编辑方案、客户详情查看推荐产品、AI 生成方案前均调用同一推荐服务；同一客户同一需求再次生成时记录规则版本和输入快照。
2. 推荐范围：读取客户当前有效需求，按产品库一级大类、末级分类、产品名称、标签、适用客群和关键词生成候选产品；已下架、已停用或明确不满足必要条件的产品不得进入主推结果。
3. 字段来源：客户字段包括家庭资产、可投资资产、行业、画像、常驻国家/城市、第二身份；需求字段包括产品类型、产品名称、办理预算和办理周期；产品库字段包括分类、适用客群、资产门槛、报价区间、办理周期、必要条件、排序值和产品状态。
4. 总分 100 分，维度为：需求/产品类型 35 分、资产规模 20 分、办理预算 15 分、办理周期 15 分、客户画像 15 分。每项只按系统字段和产品配置计算，缺失字段标记“待人工确认”，不得猜测。
5. 需求/产品类型完全命中产品名称或末级分类得 35 分；命中同一一级分类或关键词得 20 分；仅备注命中得 10 分；无命中得 0 分。
6. 资产规模达到产品门槛得 20 分；低于门槛但处于相邻档位得 10 分；明显低于门槛得 0 分；产品未维护门槛则待确认。
7. 办理预算覆盖产品报价区间得 15 分；低于报价但允许拆分服务得 8 分；未知得 5 分并待确认；明显不足得 0 分。
8. 办理周期覆盖产品交付周期得 15 分；略短但有评估/咨询等先行服务得 8 分；周期冲突得 0 分。
9. 行业、画像、出国情况、常驻地区或第二身份命中产品适用客群 2 项及以上得 15 分，命中 1 项得 8 分，无命中得 0 分。
10. 必要条件单独校验，例如资格、身份、地区、材料和合规要求；必要条件明确不满足时排除，资料缺失时最高只能进入备选并标记需人工确认。
11. 总分 70 至 100 分为主推，50 至 69 分为备选，低于 50 分不默认展示；存在必要条件待确认时最高只能进入备选。
12. 推荐结果需返回产品 ID、名称、推荐层级、总分、各维度得分、命中字段和值、未命中原因、待确认项、推荐原因文案和规则版本号，供方案预览展示推荐原因及匹配度。
13. 排序先按主推/备选，再按总分降序；同分依次按需求/产品类型、预算、办理周期得分降序，最后按产品库排序值稳定排序。
14. 人工调整推荐结果时保留系统原始评分，并记录调整人、调整时间、调整前后结果和调整原因。

## 5.5 KYC

KYC 页面和下载必须区分移民业务与 CRS 业务模板。

要求：

- KYC 详情使用演示数据填充，不留空白字段。
- 单选字段使用单选样式，多选字段使用多选样式。
- 客户详情中的 KYC 模块名称使用业务对应名称。
- 下载文件类型为 DOCX。
- 下载文件名统一按“客户名称+业务类型+KYC+时间戳.docx”生成，业务类型取当前选中的需求类型。例如：`黄先生海外移民KYC20261001142631.docx`。
- 移民 KYC 严格使用提供的移民源模板。
- CRS KYC 严格使用提供的 CRS 源模板。
- 源模板的版式、标题、顺序、表格、边框、字号和分页不得泛化或重做。
- 演示数据只能写入源模板对应位置，不能改变模板结构。
- 下载成功提示统一为：`下载成功`。
- 下载失败需要显示明确失败提示，不得提示成功但不产生文件。

## 5.6 需求管理

需求列表支持：

- 列表展示客户编号、客户、产品名称/分类、负责人、协助人、最近跟进、创建时间和创建人。
- 首列单选框。
- 表头全选框。
- 新增、编辑、详情、删除。
- 批量跟进。
- 列表数据滚动和分页。
- 删除需求必须二次确认；确认后删除需求记录，清理选择状态并同步客户详情需求快照，不删除客户主档。

新增需求：

- 页面右下角按钮从左到右为：`取消`、`确定`。
- 产品名称下方提供客户池下拉字段。
- 负责人和协助人使用下拉选择。
- 下拉框支持输入关键字模糊匹配和选择。
- 外部合作方下拉框使用已有选项值；没有选项值时允许输入或显示合理空状态。

编辑需求：

- 页面标题必须为“编辑需求”。
- 页面右下角按钮从左到右为：`取消`、`保存`。
- 点击编辑必须打开当前需求数据，不得打开空白新增表单。
- 编辑保存后列表和详情显示最新内容。
- 编辑页不展示跟进功能。

## 5.7 跟进

跟进方式选项固定为：

- 微信文字跟进。
- 电话/微信语音跟进。
- 腾讯会议跟进。
- 参加活动跟进。
- 其它。

新增跟进字段：

- 关联客户。
- 关联需求，可选，不是必填项，默认显示“请选择需求”。
- 跟进方式。
- 面谈状态。
- 合同发送状态。
- 申请优惠状态。
- 跟进内容。
- AI 沟通资料导入。
- 跟进附件上传。

字段规则：

- 删除“需求进展”字段。
- 删除“方案发送状态”字段。
- 删除新增跟进页面的“下次联系”字段。
- 底部按钮右对齐，取消在前，确定/提交在后。
- “导入客户沟通资料”用于 AI 识别客户沟通内容。
- “跟进附件”用于保存其他业务资料，不参与 AI 识别和分析。

附件规则：

- 支持 `DOC/DOCX、XLS/XLSX、PDF、JPG/JPEG/PNG、ZIP/RAR/7Z`。
- 仅作为跟进附件保存，不参与 AI 识别与分析。
- 新增跟进支持上传附件。
- 新增和编辑跟进中的“需求信息确认”“待办生成确认”支持新增、删除条目；每个区域至少保留一条可为空的编辑行，空行确认时不生成需求或待办。
- 跟进详情支持附件预览和下载，但不支持继续上传。
- 跟进记录列表点击整行进入详情，不额外展示“详情”按钮。
- 跟进详情展示跟进人、跟进方式、状态字段、跟进内容和附件。

## 5.8 批量跟进

客户管理批量跟进：

- 选择客户后显示“已选择 X 个客户”。
- 弹出层客户列表展示客户名称、客户状态、成交状态、最近跟进时间。
- 客户列表数据过多时只有列表区域滚动。
- 批量跟进标题、跟进方式、下次联系、跟进内容和底部按钮固定。
- 底部主按钮名称为“确定”。
- 跟进方式使用客户操作栏进入跟进时的跟进方式选项。
- 下次联系使用日期时间插件。

需求批量跟进：

- 支持单选和全选。
- 首列显示单选框和全选框。
- 选择后显示已选择数量。
- 列表展示客户名称、产品名称及分类、最近跟进时间。
- 跟进内容支持销售提供的默认演示文案并可修改。
- 弹层底部按钮不得被遮挡。

## 5.9 待办事项

支持：

- 客户/事项关键词搜索。
- 状态筛选。
- 优先级筛选。
- 截止时间区间筛选。
- 新增、编辑、完成、删除和详情。

时间查询规则：

- “已超过 XX 天”取待办截止日期计算。
- 计算方式为：当前日期 - 待办截止日期。
- 只要超过截止日期即进入逾期逻辑。
- 时间区间包含开始日期和结束日期。
- 开始日期不能晚于结束日期。
- 日期区间控件不得错位或与重置按钮重叠。

## 5.10 方案管理

方案支持：

- 新增方案。
- 编辑方案。
- 生成方案。
- 提交审核。
- 审核通过。
- 审核拒绝。
- 作废。
- 复制。
- 预览。
- 下载。
- 发送客户。
- 客户反馈。
- 版本留痕。

状态规则：

| 状态 | 可编辑 | 可审核 | 可发送 | 可下载 | 可作废 |
| --- | --- | --- | --- | --- | --- |
| 草稿 | 是 | 否 | 否 | 按权限 | 是 |
| 待审核 | 是 | 是 | 否 | 按权限 | 是 |
| 审核拒绝 | 是 | 否 | 否 | 按权限 | 是 |
| 已生成 | 否 | 否 | 是 | 是 | 是 |
| 已发送 | 否 | 否 | 否或按业务规则 | 是 | 是 |
| 已作废 | 否 | 否 | 否 | 否 | 否 |

方案预览：

- 预览中的编辑按钮编辑当前预览方案。
- 不得跳转到普通新增方案或空白编辑抽屉。
- 普通 HTML 方案在当前预览中编辑。
- 使用图片呈现的标准 CRS 模板必须保持源模板展示；可编辑内容独立保存，不污染源模板。
- 预览、下载和历史方案均使用正确的当前模板。

## 5.11 知识库

### 产品库

- 使用列表布局，不使用大面积卡片统计。
- 产品数量较多时支持列表数据滚动和分页。
- 支持产品对比：只能选择同一产品大类下的产品，允许同一大类下不同国家、地区或子类产品一起对比；不同大类产品不能混选。选择数量不限；选择产品后点击“对比”按钮生成结果，至少选择 2 个产品才允许对比。
- 对比结果使用通用字段：产品类型、产品分类、适用地区/服务范围、适用客户、核心解决问题、产品/服务内容、关键准入条件、所需材料、费用/价格、办理/交付周期、交付成果、服务流程、主要优势、限制条件与风险、补充说明。
- 通用字段优先读取产品库结构化字段，其次读取来源切片中对应的同义字段；缺失内容显示“未维护”，不得自动编造确定结论。
- 分类特有信息作为产品的 `compareFields` 可配置扩展字段维护；同一对比批次中存在同名字段时自动追加为对比行，没有数据的产品显示“未维护”，不将某一业务类型的专属字段固定到所有产品。
- 搜索栏位于列表上一层，不撑开统计和列表布局。
- 分类支持三级悬停联动：
  - 鼠标移入一级展示二级。
  - 鼠标移入二级展示三级。
  - 不要求点击才能展开。
- 最终选中的分类只在搜索框内展示末级分类。
- 产品名称搜索不能被分类控件覆盖。

知识库导航层级：

- 一级：知识库。
- 二级：产品库、产品对比、话术库、政策库、更新记录。
- 产品对比作为独立二级页面，不嵌入产品库列表区域；产品库仅负责产品浏览、筛选和详情查看。

### 话术库

- 使用列表展示话术名称、适用阶段、适用产品、内容摘要和操作。
- 编辑按钮必须打开可编辑表单。
- 关联产品默认显示“请选择”。
- 删除必须执行二次确认。
- 删除动作不能进入详情页。

### 政策库

- 使用列表展示政策名称、受影响产品、来源、录入方式、操作人、创建时间和操作。
- 新增页面按钮使用“新增”，编辑页面使用“保存”。
- 新增和编辑页面不展示录入方式字段。
- 系统抓取数据默认录入方式为“系统抓取”，操作人为“系统”。
- 新增数据默认录入方式为“手动录入”，操作人为实际登录账号。
- 政策新增流程为：
  1. 输入链接。
  2. 点击“解析链接”。
  3. 自动提取标题、来源、原文片段和初步摘要。
  4. 将结果加载到对应字段。
  5. 人工修改和确认。
  6. 点击“确认入库”写入政策库。
- 政策列表操作按钮之间必须保持清晰间距。
- 编辑按钮必须真正进入可编辑状态。
- 更新记录展示系统和实际操作账号产生的多条演示数据，并支持按内容、类型和时间区间筛选。
- 政策删除必须二次确认；确认后删除政策记录并追加删除日志，不影响产品、话术及其他政策记录。

## 5.12 AI 对话

对话输入：

- 无文字、图片或文件时，发送按钮为灰色不可点击。
- 输入文字、粘贴图片或文件后，发送按钮为蓝色可点击。
- 点击发送后进入生成中状态，发送按钮变为可点击暂停。
- AI 回复完成后恢复为无输入灰色状态或有输入蓝色状态。
- 底部不展示选择文件和发送图片的工具按钮。
- 支持在输入框内粘贴多张图片。
- 图片在输入框内部展示正方形缩略图。
- 图片可点击预览和删除。
- 输入框内不展示图片名称。

消息展示：

- 图片和文字一起发送时，图片在上、文字在下。
- 图片没有背景色或额外背景框。
- 文字单独使用消息气泡。
- 已完成的 AI 回复不可编辑。
- 发送后暂停的用户问题可以编辑并再次发送。
- 发送图片和文字的消息块必须保持稳定上下对齐，不能因图片数量或文字长度产生错位。

对话列表：

- 列表只展示对话名称和必要状态。
- 新建对话位于列表顶部，最近对话位于下方。
- 默认展示未读状态。
- 鼠标移入未读对话时，“...”位于原未读状态位置。
- 点击“...”后在对话列表外侧展示“删除”按钮。
- 点击“删除”后弹出二次确认。
- 删除按钮不占用对话名称宽度。
- 列表过多时只滚动左侧列表，右侧对话区域高度保持一致。

## 5.13 开发说明入口

系统内提供“开发说明”页面，并同步维护外部 Markdown 文档。

开发说明至少包含：

- 开发说明。
- 规则说明。
- 模块约束。
- 系统范围。
- 角色权限。
- 数据关系。
- 状态流转。
- 文件命名和模板约束。
- AI 辅助开发限制。

## 6. 通用交互规范

- 页面标题、搜索区、筛选区、表头和操作区按现有系统规范固定，只有数据区滚动。
- 表单底部操作按钮右对齐。
- 取消按钮在前，确定、保存等主要操作在后。
- 查看、编辑、删除、审核和作废必须是独立且正确的动作。
- 删除和作废需要二次确认。
- 所有成功和失败动作显示明确提示。
- 列表长文本截断时，鼠标移入显示完整内容。
- 按钮、输入框和下拉框的文字不得溢出或遮挡。
- 不得增加与业务无关的提示描述。

## 7. 持久化与接口要求

正式开发需要提供以下接口能力：

- 客户列表、详情、编辑和保存。
- 客户标签、联系方式、客户池和负责人维护。
- 需求新增、编辑、详情、删除和批量选择。
- 跟进新增、详情、附件上传、附件预览和下载。
- 待办筛选、区间查询、完成和删除。
- 方案新增、编辑、生成、审核、作废、复制、预览、下载、发送和反馈。
- 产品、话术、政策列表、新增、编辑、删除和更新记录。
- AI 对话列表、新建、发送、暂停、编辑、删除和消息附件。
- 工作台统计及环比数据。

所有保存接口应返回：

- 是否成功。
- 最新记录数据。
- 操作人。
- 操作时间。
- 失败原因。

## 8. 验收标准

- 所有新增和编辑表单可以实际输入、保存，并在列表和详情中显示最新结果。
- 刷新页面后已保存数据不恢复为旧数据。
- 客户、需求、跟进、方案和知识库之间关联数据一致。
- KYC 下载文件为 DOCX，文件名符合业务规则，模板结构与源文件一致，并有演示数据。
- 方案预览编辑留在当前方案预览上下文。
- AI 图片和文字发送后位置稳定，图片可预览、删除和多张发送。
- 工作台数量类指标显示数字，环比箭头颜色和方向正确。
- 政策手动录入的操作人为实际账号，系统抓取的操作人为“系统”。
- 跟进附件只保存，不参与 AI 识别与分析。
- 列表数据量增加后，数据区域仍可通过滚动条完整查看。
- 删除、作废和关键确认动作均有二次确认或明确提示。

# 邦拓客户管理智能体系统需求与开发说明

本文档是整个系统的统一实现口径，供产品、开发和 AI 辅助开发阅读。页面原型中的演示数据只用于验证交互，不代表正式生产数据。

## 一、系统范围

- 系统面向销售、销售经理、项目经理、产品管理员和管理层，覆盖客户管理、需求管理、跟进、待办、方案管理、知识库、AI 对话、工作台和角色权限。
- 客户是主数据，需求、跟进、待办、方案、KYC 和推荐结果均通过客户 ID 关联；列表、详情、编辑和弹窗必须保持同一份数据状态。
- 系统支持 CRM 客户同步、人工录入、资料识别、需求推进、方案生成审核、客户发送反馈和成交后统计的完整业务闭环。
- 所有新增、编辑、删除、审核、作废、发送和确认动作必须有明确的成功/失败反馈，并在刷新后保留已保存状态。

## 二、角色与权限

- 销售：查看权限范围内客户，新增和编辑需求，新增跟进，生成方案，查看本人及协作数据。
- 销售经理：查看团队数据，审核团队方案，参与客户和需求协作。
- 项目经理：查看协作客户和需求，处理项目交付和跟进。
- 产品管理员：维护产品库、话术库、政策库和方案模板。
- CEO：查看全量经营数据、客户、需求、方案和统计结果。
- 系统管理员：维护角色、账号、权限和系统配置。
- 页面按钮、数据范围和可编辑状态必须同时受角色权限与业务状态控制。

## 三、数据与持久化

- 客户、需求、跟进、待办、方案、产品、话术、政策、AI 对话和消息通知使用稳定 ID 关联。
- 编辑客户姓名、联系方式、标签、KYC 和需求后，列表、详情、AI 提取确认页和关联记录应立即同步。
- 页面刷新不能恢复旧数据；演示原型使用浏览器本地持久化，正式系统应替换为服务端接口和数据库。
- 删除和作废必须二次确认；删除后不得在普通列表中继续展示，作废数据保留历史记录但按状态限制下载、编辑和发送。

## 四、开发开放范围与模块状态

当前项目允许按模块分批进入开发，开发人员应以模块状态作为是否可以编码的判断依据。

| 模块 | 当前状态 | 开发口径 |
| --- | --- | --- |
| 工作台 | 可进入开发 | 按当前需求文档和原型实现统计、环比、时间查询和跳转交互。 |
| 需求管理 | 可进入开发 | 按当前需求文档和原型实现新增、编辑、详情、删除、批量跟进和列表选择。 |
| 跟进 | 可进入开发 | 按当前需求文档和原型实现新增跟进、AI 识别、附件上传、详情、预览和下载。 |
| 待办事项 | 可进入开发 | 按当前需求文档和原型实现列表、日历视图、筛选、时间区间查询和新增编辑。 |
| 知识库 | 可进入开发 | 按当前需求文档和原型实现产品库、产品对比、话术库、政策库和更新记录。 |
| AI 对话 | 可进入开发 | 按当前需求文档和原型实现对话列表、发送、暂停、图片粘贴、预览、删除和二次确认。 |
| 角色权限、登录状态、流程闭环、开发说明 | 可进入开发 | 按当前需求文档和原型实现展示、边界说明和开发阅读入口。 |
| 客户管理 | 调整中 | 当前原型仅作为业务上下文参考，不作为最终开发基线；待字段、详情布局和编辑规则确认后再进入开发。 |
| 方案管理 | 调整中 | 当前原型仅作为业务上下文参考，不作为最终开发基线；待方案预览、模板、提示词调整和推荐机制确认后再进入开发。 |

执行要求：

- 可进入开发的模块可以拆分任务、设计接口、建表和进入编码。
- 调整中的模块只允许开发阅读上下文、评估影响和提出问题，不应进入正式编码。
- 如果某个可开发模块依赖客户管理或方案管理字段，先使用需求文档中已确认的稳定 ID 和字段，不扩展未确认字段。
- 后续客户管理或方案管理确认后，需要将模块状态从“调整中”改为“可进入开发”，并记录确认时间和确认人。

## 五、模块实现口径

### 5.1 工作台

- 展示客户情况、需求情况、待办、需求转化率、成交产品和客户来源等经营信息。
- 可统计指标直接在指标数值下方展示“环比 + 方向箭头 + 比例”，例如“环比 ↓ 0.99%”或“环比 ↑ 12.50%”；不展示正负号，也不在指标区展示日、周、月等周期文字。
- 工作台保留统计时间查询控件，支持今日、本周、本月和自定义日期区间；时间查询控件不替代卡片中的环比展示。
- 环比按当前统计窗口与上一等长窗口计算；没有可比上期数据时显示“环比 --”，不得编造数据。
- 客户、需求、跟进、方案统计必须按当前登录角色的数据范围过滤。

### 5.2 客户管理与客户详情

- 客户列表支持搜索、筛选、列自定义、固定操作列、单选、全选、批量跟进和列表滚动。
- 客户姓名、联系方式等长文本截断时，鼠标移入展示完整内容；客户联系方式不做脱敏。
- 编辑页包含负责人、协助人、下次联系、KYC 和客户标签等可编辑字段；客户池只在客户详情查看中展示。
- 客户详情展示基础信息、独立联系方式区、客户标签、需求卡片、跟进记录、方案历史、推荐产品及推荐原因/匹配度。
- KYC 详情使用演示数据填充，单选和多选按字段类型展示；下载必须使用提供的标准 DOCX 源模板，文件名按“客户名称+业务类型+KYC+时间戳.docx”生成，业务类型取当前选中的需求类型。

### 5.3 需求管理

- 列表支持单选、全选、新增、编辑、删除、批量跟进和详情抽屉。
- 新增页右下角按钮顺序为“取消、确定”；编辑页右下角按钮顺序为“取消、保存”。
- 负责人和协助人使用可输入关键字的模糊匹配下拉框；新增及编辑页面不提供跟进功能。
- 需求阶段、产品名称、分类、客户池和协作信息必须写回需求记录，并同步客户详情。
- 删除需求必须先弹出二次确认；确认后按需求 ID 删除，并同步清理列表选择状态、客户详情中的需求快照和相关统计，不删除客户主档。

### 5.4 跟进

- 跟进方式选项为：微信文字跟进、电话/微信语音跟进、腾讯会议跟进、参加活动跟进、其它。
- 新增跟进支持关联需求、下次联系日期时间、跟进内容、AI 识别资料和独立跟进附件。
- 新增和编辑跟进中的“需求信息确认”“待办生成确认”支持新增、删除条目；每个区域至少保留一条可为空的编辑行，空行确认时不生成需求或待办。
- “导入客户沟通资料”用于 AI 识别；“跟进附件”用于保存其他业务资料，两者不能混用。
- 跟进附件支持 DOC/DOCX、XLS/XLSX、PDF、JPG/JPEG/PNG、ZIP/RAR/7Z 等格式，仅作为跟进附件保存，不参与 AI 识别与分析。
- 跟进详情展示跟进人、跟进方式、面谈状态、方案发送状态、合同发送状态、申请优惠状态、跟进内容和附件；支持附件预览和下载，不支持在详情页上传。
- 跟进列表点击整行进入详情，删除多余的“详情”按钮。

### 5.5 待办

- 支持客户/标题搜索、状态、优先级和截止时间区间筛选。
- “已超过 XX 天”按待办截止日期与当前日期计算；区间查询包含开始日期和结束日期。
- 当开始日期晚于结束日期时，阻止查询并提示“截止时间区间的开始日期不能晚于结束日期”；修正任一日期后才恢复查询。
- 页面顶部和搜索条件固定，只有列表数据区域滚动；日期控件使用标准日期/时间插件。

### 5.6 方案管理

- 方案支持新增、编辑、生成、提交审核、审核通过、审核拒绝、作废、复制、预览、下载、发送和反馈留痕。
- 草稿、待审核、审核拒绝允许编辑；已生成、已发送和已作废按状态限制编辑。
- 预览页的“编辑”必须在当前方案预览上下文中编辑当前方案，不能跳转到普通新增/编辑抽屉。
- 方案预览和下载严格读取对应标准源模板；历史数据也必须迁移到当前模板规则。
- 推荐结果需展示匹配度和推荐原因，评分维度和计算依据应由后端规则配置，不能仅展示无法解释的分数。
- 方案复制只创建一条新的草稿记录，必须保留 `sourcePlanId`、新旧版本关系、复制人和复制时间；复制不能代替原方案的版本历史、差异内容、审核记录、发送记录和客户反馈留痕。

#### 方案产品推荐落地规则

1. 触发时机：新增方案、编辑方案、客户详情查看推荐产品、AI 生成方案前均调用同一推荐服务；同一客户同一需求再次生成时保存规则版本、输入快照和输出结果。
2. 推荐范围：读取客户当前有效需求，按产品库一级大类、末级分类、产品名称、标签、适用客群和关键词生成候选产品；已下架、已停用或不满足必要条件的产品不进入主推结果。
3. 字段来源：客户基础资料提供家庭资产、可投资资产、行业、画像、常驻国家/城市、第二身份等字段；需求提供产品类型、产品名称、办理预算和办理周期；产品库提供产品分类、适用客群、资产门槛、报价区间、办理周期、必要条件、排序值和产品状态。
4. 评分总分为 100 分，单项取值范围为 0 至该维度满分，缺失字段不猜测，标记为“待人工确认”：

| 评分维度 | 分值 | 计算规则 |
| --- | ---: | --- |
| 需求/产品类型 | 35 | 需求产品名称与产品名称或末级分类完全命中得 35 分；命中同一一级分类或明确关键词得 20 分；仅备注出现相关词得 10 分；无命中得 0 分。 |
| 资产规模 | 20 | 家庭资产或可投资资产达到产品门槛得 20 分；低于门槛但处于相邻资产档位得 10 分；明显低于门槛得 0 分；产品未配置门槛则标记待确认。 |
| 办理预算 | 15 | 办理预算覆盖产品报价区间得 15 分；低于报价但产品允许拆分服务得 8 分；预算未知得 5 分并标记待确认；明显不足得 0 分。 |
| 办理周期 | 15 | 客户期望周期覆盖产品办理周期得 15 分；周期略短但存在咨询/评估等先行服务得 8 分；周期冲突得 0 分。 |
| 客户画像 | 15 | 行业、画像、出国情况、常驻地区或第二身份等字段与产品适用客群命中 2 项及以上得 15 分；命中 1 项得 8 分；无命中得 0 分。 |

5. 必要条件：产品库标记为必要的条件（例如资格、身份、地区、材料或合规要求）必须单独判断。必要条件明确不满足时不进入主推；资料缺失时只能进入“需人工确认”，不能用总分掩盖风险。
6. 结果分层：总分 70 至 100 分为“主推”，50 至 69 分为“备选”，0 至 49 分不默认展示；存在必要条件待确认时最高只能进入“备选”。
7. 输出字段：每个结果至少返回产品 ID、产品名称、推荐层级、总分、各维度得分、命中的字段和值、未命中原因、待确认项、推荐原因文案和规则版本号，前端据此展示“推荐原因及匹配度”。
8. 排序规则：先按主推/备选分层，再按总分降序；同分时依次按需求/产品类型、预算、办理周期得分降序，最后按产品库排序值稳定排序。
9. 人工调整：销售可将结果移入或移出推荐清单、调整排序或填写推荐原因；必须记录调整人、调整时间、调整前后结果和调整原因，且不能覆盖系统原始评分。

### 5.7 知识库

- 导航采用一级“知识库”下挂二级功能：产品库、产品对比、话术库、政策库、更新记录。
- 产品库、话术库和政策库使用列表布局，支持搜索、分页、滚动、查看详情、编辑和删除。
- 产品分类支持三级悬停联动：鼠标移入一级展示二级，移入二级展示三级，最终只在搜索框内展示选中的末级分类。
- 产品对比只允许同一产品大类内选择产品，允许同一大类下不同国家、地区或子类产品一起对比；不同大类产品不能混选。选择数量不设上限，前端选择时即时校验大类；选择产品后点击“对比”按钮生成对比表，至少选择 2 个产品才允许对比。
- 产品对比采用通用字段：产品类型、产品分类、适用地区/服务范围、适用客户、核心解决问题、产品/服务内容、关键准入条件、所需材料、费用/价格、办理/交付周期、交付成果、服务流程、主要优势、限制条件与风险、补充说明。开发时优先读取产品库结构化字段，再按字段映射读取来源切片；字段缺失返回“未维护”，不得自动编造确定结论。
- 分类特有字段放入产品的 `compareFields` 扩展对象，由产品管理员按分类维护字段名称、数据类型和是否参与对比；同一对比批次中存在同名字段时自动追加为对比行，扩展字段没有数据时显示“未维护”，不展示业务结论。
- 政策新增默认录入方式为手动录入；系统抓取记录的操作人为“系统”，手动录入记录当前实际操作人账号。
- 政策链接录入流程为：输入链接、点击解析、加载提取字段、人工修改、确认入库。
- 更新记录至少保存操作人、操作时间和变更内容，并展示系统与实际账号产生的多条演示记录；列表支持按内容、类型和时间区间筛选。
- 政策删除必须先二次确认；确认后按政策记录删除，并追加删除日志，不能误删产品、话术或其他政策记录。

### 5.8 AI 对话

- 无文字、图片或文件时发送按钮为灰色不可用；有内容时为蓝色可发送；生成中按钮变为可点击暂停。
- 暂停后允许编辑原问题并重新发送；已完成回复不可编辑。
- 对话列表只展示对话名称和状态；未读状态默认展示，鼠标移入时在原状态位置展示“...”，点击“...”后在列表外侧展示“删除”，再次点击删除弹出二次确认。
- 输入框支持粘贴多张图片；图片在输入框内部以正方形缩略图展示，可预览和删除，不显示图片名称。
- 发送图片与文字时，图片在上、文字在下；图片区域无背景色，文字单独使用消息样式。
- 无网络或响应较慢时展示连接状态、分析中/生成中状态和暂停操作，不伪造已完成回复。

## 六、通用交互与技术约束

- 列表页的页面标题、搜索区、筛选区、表头和操作区固定，只有数据区域滚动；滚动条不能遮挡内容。
- 所有表单按钮按业务重要性从左到右排列，取消在前，确定/保存等主操作在后。
- 所有编辑入口必须真正进入可编辑状态；查看、编辑、删除、审核和作废不能复用错误动作。
- 文本过长时使用省略号，但必须提供鼠标移入完整内容的可访问提示。
- 文件下载失败必须给出明确错误提示；成功时提示“下载成功”，并使用正确扩展名和业务命名规则。
- AI 提取结果必须允许人工确认和修改，确认后才写回客户、需求、跟进和待办数据。

## 七、审查口径说明

### 7.1 负责人、协助人模糊搜索

需求新增/编辑页的负责人、协助人不是普通只读文本，而是可搜索选择控件。用户可在控件内输入姓名或账号关键字，系统按包含匹配过滤候选项，再选择一个值保存；未选择时显示“请选择”，不能把协助人做成页面上的独立操作按钮。

### 7.2 方案复制与版本历史

复制方案的含义是以当前方案内容生成一条新的草稿，供销售另行修改，不会改变原方案。版本历史则是同一方案或方案链路的审计记录，必须记录版本号、来源方案 ID、操作人、时间、字段差异、审核意见、发送和反馈记录。因此“复制”只能作为创建新草稿的快捷动作，不能替代版本历史和差异留痕。