Simon
facc04aa65
本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交 （5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。 一、docs 结构整改（整改 #14） 根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入， 随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录 树并存于 docs/，共 791 文件、双分类体系冲突。 修复动作： - b2 同名异主题文件改名迁移保全 9 个 - C 类 39 个孤立文件按主题正确归类 - A/B1 类 222 个重复文件删除（新结构已有内容副本） - 9 个旧独有空目录删除 - 270 处内部引用按 verified 映射改写 - 整改记录 #14 登记于 04-运维文档/部署运维 结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。 残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。 二、compose 双目录对齐（消除踩坑 A） - docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist 改为 src/frontend-*/dist（h5 / agent / admin / terminal） - docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/ - 效果：本地 docker compose up 不再把根目录 stale dist 挂回， 与线上一致，分叉隐患消除（已 docker compose config 校验通过） 防复发铁律： - 重构须提交；仓库修复须 git stash -u 或先 commit - 新结构须 git add 并提交，避免再次 untracked 复活 - H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
141 lines
4.4 KiB
Markdown
141 lines
4.4 KiB
Markdown
# 会话存档功能 - 测试用例
|
|
|
|
> **版本**: v1.0 | **日期**: 2026-07-15 | **状态**: 已完成
|
|
|
|
---
|
|
|
|
## 1. 测试范围
|
|
|
|
| 模块 | 测试类型 | 优先级 |
|
|
|------|----------|--------|
|
|
| 数据模型 | 单元测试 | P0 |
|
|
| 归档脚本 | 单元测试 | P0 |
|
|
| 管理后台 API | 接口测试 | P0 |
|
|
| 坐席端显示 | 集成测试 | P1 |
|
|
| 管理后台 UI | UI 测试 | P1 |
|
|
|
|
---
|
|
|
|
## 2. 数据模型测试
|
|
|
|
### 2.1 Conversation 字段测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| MODEL-01 | 创建会话时 is_archived 默认值为 false | 默认为 false | P0 |
|
|
| MODEL-02 | 创建会话时 archived_at 默认值为 null | 默认为 null | P0 |
|
|
| MODEL-03 | 归档会话后 is_archived 更新为 true | 值为 true | P0 |
|
|
| MODEL-04 | 归档会话后 archived_at 记录归档时间 | 值为归档时间 | P0 |
|
|
|
|
---
|
|
|
|
## 3. 归档脚本测试
|
|
|
|
### 3.1 自动归档测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| SCRIPT-01 | 已结单超过90天的会话 | 自动标记为已归档 | P0 |
|
|
| SCRIPT-02 | 已结单不足90天的会话 | 不标记为已归档 | P0 |
|
|
| SCRIPT-03 | 未结单的会话 | 不标记为已归档 | P0 |
|
|
| SCRIPT-04 | 已归档的会话再次执行 | 跳过已归档会话 | P0 |
|
|
| SCRIPT-05 | 无需归档的会话执行 | 输出"没有需要归档的会话" | P0 |
|
|
|
|
### 3.2 归档数据准确性测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| SCRIPT-06 | 归档时记录正确的归档时间 | archived_at 与当前时间误差 < 1秒 | P0 |
|
|
| SCRIPT-07 | 批量归档多条会话 | 所有会话正确标记 | P0 |
|
|
|
|
### 3.3 日志测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| SCRIPT-08 | 归档执行成功 | 输出归档数量统计 | P1 |
|
|
| SCRIPT-09 | 归档执行失败 | 输出错误信息 | P1 |
|
|
|
|
---
|
|
|
|
## 4. 管理后台 API 测试
|
|
|
|
### 4.1 会话列表接口
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| API-01 | 不传 is_archived 参数 | 返回全部会话 | P0 |
|
|
| API-02 | 传 is_archived=true | 仅返回已归档会话 | P0 |
|
|
| API-03 | 传 is_archived=false | 仅返回未归档会话 | P0 |
|
|
| API-04 | 组合筛选 status + is_archived | 正确筛选 | P0 |
|
|
| API-05 | 分页参数测试 | 分页数据正确 | P1 |
|
|
|
|
### 4.2 响应数据结构
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| API-06 | 获取会话列表 | 包含 is_archived 和 archived_at 字段 | P0 |
|
|
| API-07 | 会话详情 | 归档信息正确 | P0 |
|
|
|
|
---
|
|
|
|
## 5. 坐席端测试
|
|
|
|
### 5.1 历史会话显示测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| AGENT-01 | 90天内的已结单会话 | 显示在历史会话中 | P0 |
|
|
| AGENT-02 | 超过90天的已结单会话 | 不显示在历史会话中 | P0 |
|
|
| AGENT-03 | 活跃会话 | 显示在当前会话列表 | P0 |
|
|
|
|
### 5.2 筛选功能测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| AGENT-04 | 搜索历史会话 | 按关键词过滤 | P1 |
|
|
| AGENT-05 | 切换筛选标签 | 正确切换显示内容 | P1 |
|
|
|
|
---
|
|
|
|
## 6. 管理后台 UI 测试
|
|
|
|
### 6.1 归档状态筛选
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| UI-01 | 选择"全部" | 显示所有会话 | P0 |
|
|
| UI-02 | 选择"未归档" | 仅显示未归档会话 | P0 |
|
|
| UI-03 | 选择"已归档" | 仅显示已归档会话 | P0 |
|
|
|
|
### 6.2 归档状态显示
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| UI-04 | 查看未归档会话 | 显示"-"或空 | P0 |
|
|
| UI-05 | 查看已归档会话 | 显示"已归档"标签 | P0 |
|
|
|
|
---
|
|
|
|
## 7. 性能测试
|
|
|
|
| 用例ID | 测试场景 | 预期结果 | 优先级 |
|
|
|--------|----------|----------|--------|
|
|
| PERF-01 | 1000条会话归档 | 执行时间 < 5秒 | P1 |
|
|
| PERF-02 | 归档期间查询会话 | 不影响在线查询 | P1 |
|
|
|
|
---
|
|
|
|
## 8. 测试用例执行记录
|
|
|
|
| 执行日期 | 测试人员 | 通过数 | 失败数 | 备注 |
|
|
|----------|----------|--------|--------|------|
|
|
| 2026-07-15 | Duckula | — | — | 待执行 |
|
|
|
|
---
|
|
|
|
## 9. 版本历史
|
|
|
|
| 版本 | 日期 | 变更 |
|
|
|------|------|------|
|
|
| v1.0 | 2026-07-15 | 初始版本 |
|