327 lines
17 KiB
Markdown
327 lines
17 KiB
Markdown
# 保险智能客服系统项目验收单
|
||
|
||
> 文档用途：用于项目交付验收、客户现场/远程验收记录、双方签字确认。
|
||
> 项目名称：保险智能客服系统
|
||
> 系统定位：保险行业智能客服、企业微信接入、知识库增强、权限管理与运营统计系统。
|
||
|
||
---
|
||
|
||
## 一、验收基本信息
|
||
|
||
| 项目 | 内容 |
|
||
|---|---|
|
||
| 项目名称 | 保险智能客服系统 |
|
||
| 建设单位/客户方 | |
|
||
| 承建单位/交付方 | |
|
||
| 验收日期 | 年 月 日 |
|
||
| 验收地点/方式 | 现场验收 / 远程验收 / 其他： |
|
||
| 系统版本 | |
|
||
| 部署环境 | 测试环境 / 生产环境 / 私有化服务器 / 其他： |
|
||
| 访问地址 | 前端：https://gll-group.com/<br>后端 API：https://gll-group.com/apps<br>BaoDan 管理后台：http://150.5.135.143:3000/apps |
|
||
| 验收负责人（客户方） | |
|
||
| 验收负责人（交付方） | |
|
||
|
||
---
|
||
|
||
|
||
|
||
## 二、项目建设目标
|
||
|
||
本项目旨在为保险业务场景建设一套智能客服系统、知识库、RAG 检索、对话日志、Prompt 管理等基础能力，并在 `api/insurance/` 与 `frontend/` 中扩展保险行业业务模块，实现以下目标：
|
||
|
||
1. 支持保险业务人员通过 Web/H5 页面进行智能问答、多轮对话、来源引用查看与回答复制。
|
||
3. 支持企业微信接入，包括企微 OAuth 登录、企微消息回调、企微用户映射等能力。
|
||
4. 支持保险知识库增强管理，包括文档标签、险种、保司。
|
||
5. 支持用户、角色、部门、权限、登录日志、操作日志等后台管理能力。
|
||
6. 支持业务使用统计、趋势分析等运营管理数据展示。
|
||
|
||
---
|
||
|
||
|
||
|
||
## 三、交付范围确认
|
||
|
||
|
||
|
||
### 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 | 部署账号/运维交接信息 | 另行线下交接 | □ 是 □ 否 □ 不适用 | 注意脱敏与权限回收 |
|
||
|
||
---
|
||
|
||
## 十三、客户验收演示建议流程
|
||
|
||
建议验收当天按以下顺序演示，便于客户快速确认系统价值：
|
||
|
||
1. 登录系统，展示普通用户与管理员不同入口。
|
||
2. 打开智能问答页，围绕一个保险产品或理赔场景连续提问，展示多轮问答、来源引用、复制回答。
|
||
3. 打开产品推荐页，录入客户画像并生成推荐方案，展示方案详情、历史记录、导出/分享能力。
|
||
4. 打开知识库管理或 BaoDan 知识库后台，展示文档上传、标签维护、检索命中。
|
||
5. 打开用户、角色、部门页面，展示权限隔离和管理能力。
|
||
6. 打开统计与日志页面，展示运营数据、登录日志、操作审计。
|
||
7. 如客户使用企业微信，现场展示企微 OAuth 登录或企微消息回调能力。
|
||
8. 最后核对部署文档、API 文档、测试用例与交付附件，填写验收结论并签字。
|