保险智能客服系统项目验收单
文档用途：用于项目交付验收、客户现场/远程验收记录、双方签字确认。
项目名称：保险智能客服系统
系统定位：保险行业智能客服、企业微信接入、知识库增强、权限管理与运营统计系统。
一、验收基本信息
二、项目建设目标
本项目旨在为保险业务场景建设一套智能客服系统、知识库、RAG 检索、对话日志、Prompt 管理等基础能力，并在 api/insurance/ 与 frontend/ 中扩展保险行业业务模块，实现以下目标：
- 支持保险业务人员通过 Web/H5 页面进行智能问答、多轮对话、来源引用查看与回答复制。
- 支持企业微信接入，包括企微 OAuth 登录、企微消息回调、企微用户映射等能力。
- 支持保险知识库增强管理，包括文档标签、险种、保司。
- 支持用户、角色、部门、权限、登录日志、操作日志等后台管理能力。
- 支持业务使用统计、趋势分析等运营管理数据展示。
三、交付范围确认
3.1 软件模块交付清单
| 序号 |
模块 |
交付内容 |
验收状态 |
备注 |
| 1 |
基础平台集成 |
BaoDan 平台集成、自研 Blueprint 路由注册、环境变量配置说明 |
□ 通过 □ 不通过 □ 不适用 |
|
| 2 |
用户认证 |
账密登录、企微 OAuth 登录、Token 刷新、退出登录 |
□ 通过 □ 不通过 □ 不适用 |
|
| 3 |
智能问答 |
对话入口、流式问答、多轮会话、会话列表、消息记录、回答复制、推荐追问 |
□ 通过 □ 不通过 □ 不适用 |
|
| 4 |
知识库问答 |
基于 BaoDan 知识库检索、来源引用、命中测试、文档问答 |
□ 通过 □ 不通过 □ 不适用 |
|
| 5 |
企业微信接入 |
企微回调验证、消息接收、企微机器人/应用配置、用户映射 |
□ 通过 □ 不通过 □ 不适用 |
|
| 6 |
用户与权限管理 |
用户 CRUD、角色管理、权限配置、部门管理、批量导入 |
□ 通过 □ 不通过 □ 不适用 |
|
| 7 |
知识库增强管理 |
文档标签、编号、险种、保司、数据源配置、同步日志 |
□ 通过 □ 不通过 □ 不适用 |
|
| 8 |
运营统计 |
概览数据、趋势数据、Token/调用统计 |
□ 通过 □ 不通过 □ 不适用 |
|
| 9 |
日志审计 |
系统操作日志、登录日志、关键操作留痕 |
□ 通过 □ 不通过 □ 不适用 |
|
| 10 |
管理后台页面 |
首页、用户、角色、部门、统计、知识库、数据源、通知、模板、Prompt 等页面 |
□ 通过 □ 不通过 □ 不适用 |
|
| 11 |
部署文档 |
快速启动、服务器部署、宝塔部署、Docker/云部署、企微配置说明 |
□ 通过 □ 不通过 □ 不适用 |
|
| 12 |
API 文档 |
认证、对话、推荐、知识库、权限、日志、统计、企微接口说明 |
□ 通过 □ 不通过 □ 不适用 |
|
| 13 |
测试材料 |
功能测试用例、接口调试示例、上线 Checklist |
□ 通过 □ 不通过 □ 不适用 |
|
3.2 源码交付清单
| 序号 |
路径/文件 |
内容说明 |
验收状态 |
备注 |
| 1 |
api/insurance/ |
保险业务自研后端代码，包含认证、对话、推荐、企微、知识库、权限、统计、日志等模块 |
□ 通过 □ 不通过 □ 不适用 |
|
| 2 |
frontend/ |
Vue 3 + TypeScript + Vite + Element Plus 自研前端代码 |
□ 通过 □ 不通过 □ 不适用 |
|
| 3 |
docs/ |
项目文档、部署文档、API 文档、测试用例、配置指南 |
□ 通过 □ 不通过 □ 不适用 |
|
| 4 |
deploy/ |
部署脚本、SQL 初始化脚本、Nginx 配置等部署资料 |
□ 通过 □ 不通过 □ 不适用 |
|
| 5 |
README.md |
项目整体介绍、架构说明、快速开始说明 |
□ 通过 □ 不通过 □ 不适用 |
|
四、功能验收明细
4.1 登录与认证验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A1-01 |
账号密码登录 |
使用有效账号密码登录系统 |
登录成功，进入对应权限页面 |
□ 通过 □ 不通过 |
| A1-02 |
登录失败提示 |
使用错误密码或不存在账号登录 |
系统提示登录失败，不泄露敏感信息 |
□ 通过 □ 不通过 |
| A1-03 |
Token 刷新 |
登录后长时间使用系统 |
Token 可按设计刷新，用户无需频繁重复登录 |
□ 通过 □ 不通过 |
| A1-04 |
退出登录 |
点击退出登录 |
清理本地登录态，返回登录页 |
□ 通过 □ 不通过 |
| A1-05 |
企微 OAuth 登录 |
在企微环境打开系统并授权 |
获取企微用户身份并完成系统登录 |
□ 通过 □ 不通过 □ 不适用 |
| A1-06 |
未授权访问拦截 |
未登录访问管理页面 |
自动跳转登录页或返回未授权提示 |
□ 通过 □ 不通过 |
4.2 智能问答验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A2-01 |
进入对话页 |
登录后打开对话页面 |
页面正常加载，无明显样式错乱 |
□ 通过 □ 不通过 |
| A2-02 |
发送问题 |
输入保险相关问题并发送 |
系统返回智能回答 |
□ 通过 □ 不通过 |
| A2-03 |
流式输出 |
发送较长问题 |
回答支持逐步输出或等待状态清晰 |
□ 通过 □ 不通过 |
| A2-04 |
多轮上下文 |
连续追问同一主题 |
系统能结合上下文回答 |
□ 通过 □ 不通过 |
| A2-05 |
来源引用 |
提问知识库中存在的问题 |
回答中展示或可查看来源依据 |
□ 通过 □ 不通过 |
| A2-06 |
会话列表 |
进行多次会话后查看列表 |
可查看历史会话并切换 |
□ 通过 □ 不通过 |
| A2-07 |
消息记录 |
打开历史会话 |
展示历史问答内容 |
□ 通过 □ 不通过 |
| A2-08 |
复制回答 |
点击复制按钮 |
回答内容复制成功 |
□ 通过 □ 不通过 |
| A2-09 |
异常提示 |
断网或模型接口异常时提问 |
页面给出友好错误提示 |
□ 通过 □ 不通过 |
4.3 企业微信验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A4-01 |
企微 URL 验证 |
在企业微信后台配置回调地址 |
URL 验证通过 |
□ 通过 □ 不通过 □ 不适用 |
| A4-02 |
企微消息接收 |
在企微发送测试消息 |
系统接收消息并按设计处理 |
□ 通过 □ 不通过 □ 不适用 |
| A4-03 |
企微用户映射 |
企微用户首次登录 |
系统建立企微用户与内部用户映射 |
□ 通过 □ 不通过 □ 不适用 |
| A4-04 |
企微配置文档 |
按文档配置企微应用 |
配置步骤完整，可复现 |
□ 通过 □ 不通过 |
4.5 知识库与数据源验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A5-01 |
知识库文档上传 |
上传保险条款/产品文档 |
文档进入知识库并开始处理 |
□ 通过 □ 不通过 |
| A5-02 |
文档状态查看 |
查看上传文档处理状态 |
状态显示准确 |
□ 通过 □ 不通过 |
| A5-03 |
文档检索问答 |
根据已上传文档提问 |
回答命中相关文档内容 |
□ 通过 □ 不通过 |
| A5-04 |
数据同步 |
触发数据源同步 |
同步任务执行并记录日志 |
□ 通过 □ 不通过 □ 不适用 |
| A5-05 |
同步日志 |
查看数据源同步日志 |
展示同步时间、状态、结果信息 |
□ 通过 □ 不通过 □ 不适用 |
4.6 用户、角色与权限验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A6-01 |
用户列表 |
管理员打开用户管理页面 |
用户列表正常展示 |
□ 通过 □ 不通过 |
| A6-02 |
新增用户 |
创建测试用户 |
用户创建成功，可登录或被分配角色 |
□ 通过 □ 不通过 |
| A6-03 |
编辑用户 |
修改用户信息或状态 |
修改结果保存成功 |
□ 通过 □ 不通过 |
| A6-04 |
禁用用户 |
禁用某个用户后尝试登录 |
禁用用户无法继续登录或访问 |
□ 通过 □ 不通过 |
| A6-05 |
角色管理 |
新增/编辑/删除角色 |
角色配置保存成功 |
□ 通过 □ 不通过 |
| A6-06 |
权限控制 |
使用不同角色访问页面 |
菜单和接口权限符合角色配置 |
□ 通过 □ 不通过 |
| A6-07 |
部门管理 |
新增/编辑部门 |
部门结构保存成功 |
□ 通过 □ 不通过 □ 不适用 |
4.7 统计与日志验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A7-01 |
统计概览 |
打开统计页面 |
展示问答量、用户量、推荐量等概览指标 |
□ 通过 □ 不通过 |
| A7-02 |
趋势图表 |
切换时间范围 |
图表数据随时间范围变化 |
□ 通过 □ 不通过 |
| A7-04 |
Token/调用统计 |
查看调用统计卡片 |
展示模型调用或 Token 使用情况 |
□ 通过 □ 不通过 □ 不适用 |
| A7-05 |
操作日志 |
执行新增/编辑/删除操作后查看日志 |
日志记录操作者、时间、动作、结果 |
□ 通过 □ 不通过 |
| A7-06 |
登录日志 |
用户登录后查看登录日志 |
登录记录完整可查 |
□ 通过 □ 不通过 |
4.8 管理后台与页面体验验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| A8-01 |
页面导航 |
点击各菜单入口 |
页面跳转正常，无 404 或白屏 |
□ 通过 □ 不通过 |
| A8-02 |
响应式适配 |
在常用屏幕尺寸下访问 |
页面布局可用，无核心内容遮挡 |
□ 通过 □ 不通过 |
| A8-03 |
表格查询 |
使用搜索、筛选、分页 |
查询结果正确，分页可用 |
□ 通过 □ 不通过 |
| A8-04 |
表单交互 |
新增/编辑弹窗提交 |
表单校验和保存反馈明确 |
□ 通过 □ 不通过 |
| A8-05 |
错误提示 |
模拟接口失败 |
页面给出可理解的错误提示 |
□ 通过 □ 不通过 |
五、接口验收清单
| 模块 |
接口范围 |
验收标准 |
结果 |
| 认证接口 |
/api/auth/* |
登录、刷新、退出、异常返回符合接口文档 |
□ 通过 □ 不通过 |
| 对话接口 |
/api/chat/*、/api/retrieval/* |
可发送消息、查询会话、提交反馈、检索知识库 |
□ 通过 □ 不通过 |
| 推荐接口 |
/api/recommend/* |
可生成、查询、导出、分享推荐方案 |
□ 通过 □ 不通过 |
| 知识库接口 |
/api/kb/* |
可上传/查询/更新/删除文档，支持数据源能力 |
□ 通过 □ 不通过 |
| 管理接口 |
/api/admin/* |
用户、角色、部门、日志、通知、模板等管理接口可用 |
□ 通过 □ 不通过 |
| 统计接口 |
/api/stats/* |
概览、趋势、知识库健康度等统计数据可返回 |
□ 通过 □ 不通过 |
| 企微接口 |
/api/wecom/* |
回调验证、消息接收、OAuth 流程符合企微要求 |
□ 通过 □ 不通过 □ 不适用 |
六、部署与运行验收
| 编号 |
验收项 |
验收方法 |
预期结果 |
结果 |
| D1 |
后端服务启动 |
按部署文档启动 API 服务 |
服务启动成功，健康检查正常 |
□ 通过 □ 不通过 |
| D2 |
前端服务启动 |
按部署文档启动前端服务 |
页面可访问，资源加载正常 |
□ 通过 □ 不通过 |
| D3 |
数据库连接 |
检查 PostgreSQL 连接与表结构 |
数据库连接正常，自研表存在 |
□ 通过 □ 不通过 |
| D4 |
Redis 连接 |
检查缓存/Token/任务相关能力 |
Redis 连接正常 |
□ 通过 □ 不通过 |
| D5 |
BaoDan 管理后台 |
打开 BaoDan 后台 |
模型、知识库、Prompt、日志等能力可用 |
□ 通过 □ 不通过 |
| D6 |
环境变量 |
核对 .env、企微、模型 API Key 等配置 |
必要配置项完整且不暴露敏感信息 |
□ 通过 □ 不通过 |
| D7 |
Nginx/反向代理 |
通过正式域名或代理访问 |
前后端路由与 API 转发正常 |
□ 通过 □ 不通过 □ 不适用 |
| D8 |
服务重启 |
重启服务后访问系统 |
系统可恢复访问，数据不丢失 |
□ 通过 □ 不通过 |
七、非功能验收
| 类别 |
验收项 |
验收标准 |
结果 |
| 安全性 |
登录鉴权 |
未登录用户不可访问受保护资源 |
□ 通过 □ 不通过 |
| 安全性 |
权限隔离 |
不同角色仅能访问授权功能 |
□ 通过 □ 不通过 |
| 安全性 |
敏感配置 |
API Key、密钥等不在前端明文暴露，不写入公开文档 |
□ 通过 □ 不通过 |
| 可用性 |
交互反馈 |
加载、成功、失败状态提示清晰 |
□ 通过 □ 不通过 |
| 可维护性 |
代码隔离 |
自研后端集中在 api/insurance/，前端集中在 frontend/ |
□ 通过 □ 不通过 |
| 可维护性 |
文档完整 |
README、部署、API、配置、测试等文档可支撑后续维护 |
□ 通过 □ 不通过 |
| 兼容性 |
浏览器访问 |
Chrome/Edge 等主流浏览器可正常访问 |
□ 通过 □ 不通过 |
| 数据可靠性 |
核心数据保存 |
用户、角色、推荐记录、日志等核心数据可持久化 |
□ 通过 □ 不通过 |
| 可审计性 |
操作留痕 |
关键管理操作具备日志记录 |
□ 通过 □ 不通过 |
八、验收测试记录
| 序号 |
测试内容 |
测试人员 |
测试时间 |
测试结果 |
问题描述/备注 |
| 1 |
登录与认证 |
|
|
□ 通过 □ 不通过 |
|
| 2 |
智能问答 |
|
|
□ 通过 □ 不通过 |
|
| 3 |
企业微信接入 |
|
|
□ 通过 □ 不通过 □ 不适用 |
|
| 4 |
知识库管理 |
|
|
□ 通过 □ 不通过 |
|
| 5 |
用户与权限 |
|
|
□ 通过 □ 不通过 |
|
| 6 |
统计与日志 |
|
|
□ 通过 □ 不通过 |
|
| 7 |
部署运行 |
|
|
□ 通过 □ 不通过 |
|
| 8 |
文档资料 |
|
|
□ 通过 □ 不通过 |
|
九、遗留问题与整改记录
| 序号 |
问题描述 |
严重级别 |
责任方 |
计划完成时间 |
实际完成时间 |
状态 |
备注 |
| 1 |
企微登录域名需要与当前企微相同的主体才能对接 |
低 |
甲方 |
|
|
暂缓 |
|
说明：低风险、不影响系统主流程使用的问题，经双方确认后可作为后续优化项，不影响本次验收结论。
十、验收结论
经客户方与交付方共同检查，本项目交付内容与约定建设范围进行核对，验收结论如下：
□ 通过验收：系统功能、部署运行、交付资料满足本次验收要求，同意通过验收。
□ 有条件通过验收：系统主体功能满足要求，存在少量不影响主流程使用的问题，双方确认纳入后续整改。
□ 不通过验收：系统存在影响核心业务使用的问题，需整改后重新组织验收。
验收意见
客户方意见：
交付方说明：
十一、双方签字确认
客户方
| 项目 |
内容 |
| 单位名称 |
|
| 验收代表签字 |
|
| 日期 |
年 月 日 |
| 盖章 |
|
交付方
| 项目 |
内容 |
| 单位名称 |
|
| 项目负责人签字 |
|
| 日期 |
年 月 日 |
| 盖章 |
|
十二、附件清单
| 序号 |
附件名称 |
文件/位置 |
是否提交 |
备注 |
| 1 |
项目 README |
README.md |
□ 是 □ 否 |
|
| 2 |
需求文档 |
docs/保险智能客服系统_需求文档.md |
□ 是 □ 否 |
|
| 3 |
API 接口文档 |
docs/保险智能客服系统_API接口文档.md |
□ 是 □ 否 |
|
| 4 |
测试用例 |
docs/保险智能客服系统_测试用例.md |
□ 是 □ 否 |
|
| 5 |
部署指南 |
docs/部署指南.md、docs/部署文档_完整版.md、docs/宝塔面板部署指南.md |
□ 是 □ 否 |
|
| 6 |
企业微信接入指南 |
docs/企业微信接入指南.md |
□ 是 □ 否 |
|
| 7 |
API 调试示例 |
docs/API_curl示例.md |
□ 是 □ 否 |
|
| 8 |
快速启动指南 |
docs/快速启动指南.md |
□ 是 □ 否 |
|
| 9 |
源码交付包 |
后端、前端、部署脚本、文档 |
□ 是 □ 否 |
|
| 10 |
部署账号/运维交接信息 |
另行线下交接 |
□ 是 □ 否 □ 不适用 |
注意脱敏与权限回收 |
十三、客户验收演示建议流程
建议验收当天按以下顺序演示，便于客户快速确认系统价值：
- 登录系统，展示普通用户与管理员不同入口。
- 打开智能问答页，围绕一个保险产品或理赔场景连续提问，展示多轮问答、来源引用、复制回答。
- 打开产品推荐页，录入客户画像并生成推荐方案，展示方案详情、历史记录、导出/分享能力。
- 打开知识库管理或 BaoDan 知识库后台，展示文档上传、标签维护、检索命中。
- 打开用户、角色、部门页面，展示权限隔离和管理能力。
- 打开统计与日志页面，展示运营数据、登录日志、操作审计。
- 如客户使用企业微信，现场展示企微 OAuth 登录或企微消息回调能力。
- 最后核对部署文档、API 文档、测试用例与交付附件，填写验收结论并签字。
