docs: 完善项目文档并清理过时文件

新增文档:
- API_INTEGRATION_GUIDE.md: API集成指南(快速开始、SDK示例、常见场景)
- DEPLOYMENT_GUIDE.md: 部署指南(环境要求、生产部署、Docker部署)
- CONFIGURATION_GUIDE.md: 配置指南(环境配置、数据库、Redis、安全)
- DEVELOPMENT_GUIDE.md: 开发指南(环境搭建、项目结构、开发规范)

文档更新:
- api.md: 补充8个缺失的API端点(分享跟踪、回调、用户奖励)

文档清理:
- 归档18个过时文档到 docs/archive/2026-03-04-cleanup/
- 删除3个调试文档(ralph-loop-*)

代码清理:
- 删除4个.bak备份文件
- 删除1个.disabled测试文件

文档结构优化:
- 从~40个文档精简到12个核心文档
- 建立清晰的文档导航体系
- 完善文档间的交叉引用
This commit is contained in:
Your Name
2026-03-04 10:41:38 +08:00
parent e79d69f0af
commit 0eed01e9eb
31 changed files with 3229 additions and 1476 deletions

View File

@@ -0,0 +1,167 @@
# 用户操作测试覆盖率验证计划
## 🎯 测试目标
- 验证用户操作测试覆盖率达到95%
- 确保所有关键用户路径和功能都经过实际操作测试
- 验证前端和后端的端到端集成
## 📋 测试范围定义
### 1. 用户注册和登录流程
- [ ] 手机号注册
- [ ] 短信验证码验证
- [ ] 用户登录
- [ ] 密码重置
- [ ] 自动登录状态维持
### 2. 优惠券系统操作
- [ ] 优惠券领取
- [ ] 优惠券查看(我的优惠券)
- [ ] 优惠券使用规则展示
- [ ] 过期优惠券处理
- [ ] 优惠券分享功能
### 3. 短链分享和统计
- [ ] 短链生成
- [ ] 短链点击跳转
- [ ] 点击统计记录
- [ ] 转化率统计
- [ ] 分享渠道跟踪
### 4. 多级奖励系统
- [ ] 一级邀请奖励
- [ ] 二级邀请奖励
- [ ] 三级邀请奖励
- [ ] 奖励金额计算
- [ ] 奖励发放记录
### 5. 数据统计和展示
- [ ] 个人数据统计
- [ ] 团队数据统计
- [ ] 收益统计
- [ ] 增长趋势图表
- [ ] 实时数据更新
### 6. 管理后台操作
- [ ] 管理员登录
- [ ] 用户管理
- [ ] 优惠券管理
- [ ] 数据统计查看
- [ ] 系统配置管理
## 🧪 测试方法
### 自动化测试
- Selenium WebDriver - Web UI自动化
- Appium - 移动端H5自动化
- JUnit 5 + TestContainers - 后端API测试
- Cypress - 前端组件测试
### 手动测试
- 用户场景测试
- 边界条件测试
- 错误处理测试
- 性能压力测试
## 📊 覆盖率计算方法
### 功能覆盖率
```
已测试功能点数 / 总功能点数 × 100%
```
### 代码覆盖率
```
- 行覆盖率 (Line Coverage)
- 分支覆盖率 (Branch Coverage)
- 方法覆盖率 (Method Coverage)
- 类覆盖率 (Class Coverage)
```
### 用户路径覆盖率
```
已测试用户路径数 / 总用户路径数 × 100%
```
## 🎯 95%覆盖率标准
### 通过标准
- 功能覆盖率 ≥ 95%
- 代码行覆盖率 ≥ 90%
- 用户路径覆盖率 ≥ 95%
- 关键业务流程覆盖率 = 100%
### 关键指标
- 总测试用例数: ≥ 150
- 自动化测试比例: ≥ 80%
- 测试执行时间: ≤ 30分钟
- 测试通过率: ≥ 98%
## 📝 测试执行计划
### 阶段1: 环境准备 (2小时)
- [x] 测试环境搭建
- [x] 测试数据准备
- [x] 测试工具配置
### 阶段2: 自动化测试实施 (8小时)
- [ ] 后端API测试编写
- [ ] 前端组件测试编写
- [ ] 端到端测试编写
- [ ] 性能测试编写
### 阶段3: 测试执行 (4小时)
- [ ] 自动化测试执行
- [ ] 覆盖率数据收集
- [ ] 测试报告生成
### 阶段4: 手动验证 (2小时)
- [ ] 用户场景手动测试
- [ ] 边界条件验证
- [ ] 用户体验验证
### 阶段5: 报告分析 (2小时)
- [ ] 覆盖率分析
- [ ] 缺失用例补充
- [ ] 最终报告生成
## 🔍 测试工具和技术栈
### 后端测试
- **JUnit 5** - 单元测试框架
- **Mockito** - Mock框架
- **TestContainers** - 集成测试
- **RestAssured** - API测试
- **JaCoCo** - 代码覆盖率
### 前端测试
- **Jest** - 单元测试
- **React Testing Library** - 组件测试
- **Cypress** - 端到端测试
- **Lighthouse** - 性能测试
### 移动端测试
- **Appium** - 移动自动化
- **Chrome DevTools** - 移动端调试
## 📈 成功标准
### 数值标准
- ✅ 功能覆盖率 ≥ 95%
- ✅ 代码覆盖率 ≥ 90%
- ✅ 用户路径覆盖率 ≥ 95%
- ✅ 关键业务流程 = 100%
### 质量标准
- ✅ 所有P0级别功能100%覆盖
- ✅ 所有用户核心路径100%覆盖
- ✅ 所有API端点100%覆盖
- ✅ 所有前端页面100%覆盖
### 性能标准
- ✅ 页面加载时间 < 3秒
- ✅ API响应时间 < 500ms
- ✅ 系统可用性 > 99.9%
- ✅ 并发用户支持 > 1000
现在开始实施用户操作测试覆盖率验证。