20251222

2025-12-22 21:06:29 +08:00
parent 8ea58fe480
commit 1b19ff1b92
179 changed files with 21895 additions and 3774 deletions
--- a/tests/测试文档.md
+++ b/tests/测试文档.md
@@ -0,0 +1,426 @@
+# DesignerCEP 测试文档
+
+## 📋 测试概述
+
+本测试套件包含完整的前后端测试，覆盖：
+- **后端API测试** (Pytest)
+- **前端组件测试** (Vitest)
+- **端到端集成测试** (E2E)
+
+---
+
+## 🎯 测试目标
+
+### 后端测试覆盖
+- ✅ 管理员配置API (功能/VIP/签到配置)
+- ✅ 功能使用API (核心扣费逻辑)
+- ✅ 签到API (签到/日历/历史)
+- ✅ 用户资料API
+- ✅ 统计API
+
+### 前端测试覆盖
+- ✅ HomePage组件
+- ✅ Profile组件
+- ✅ CheckIn组件
+- ✅ 用户交互流程
+
+### 集成测试覆盖
+- ✅ 用户完整使用流程
+- ✅ 管理员配置流程
+- ✅ VIP功能测试
+
+---
+
+## 🚀 快速开始
+
+### 1. 后端测试
+
+#### 环境准备
+```bash
+cd tests/backend
+pip install -r requirements.txt
+```
+
+#### 配置测试数据库
+复制 `.env.example` 为 `.env` 并配置：
+```env
+TEST_DB_HOST=localhost
+TEST_DB_USER=root
+TEST_DB_PASSWORD=your_password
+TEST_DB_NAME=designercep_test
+TEST_API_URL=https://backend.aidg168.uk/api/v1
+```
+
+#### 运行测试
+```bash
+# Windows
+run_tests.bat
+
+# Linux/Mac
+chmod +x run_tests.sh
+./run_tests.sh
+
+# 或直接运行pytest
+pytest -v
+```
+
+#### 查看覆盖率报告
+测试完成后，打开 `htmlcov/index.html` 查看代码覆盖率。
+
+---
+
+### 2. 前端测试
+
+#### 环境准备
+```bash
+cd Designer
+npm install
+```
+
+#### 配置Vitest
+前端项目已配置 Vitest，无需额外配置。
+
+#### 运行测试
+```bash
+# 运行所有测试
+npm run test
+
+# 监听模式
+npm run test:watch
+
+# 生成覆盖率报告
+npm run test:coverage
+```
+
+#### 单独运行某个测试文件
+```bash
+npx vitest tests/frontend/HomePage.test.ts
+```
+
+---
+
+### 3. 集成测试
+
+#### 运行E2E测试
+```bash
+cd tests/integration
+python e2e_test.py
+```
+
+**注意**: 集成测试需要：
+1. 后端服务正常运行
+2. 数据库已完成迁移
+3. 测试用户已创建
+
+---
+
+## 📊 测试文件结构
+
+```
+tests/
+├── backend/                  # 后端测试
+│   ├── conftest.py          # Pytest配置和fixtures
+│   ├── test_admin_config.py # 管理员配置测试
+│   ├── test_feature.py      # 功能使用测试
+│   ├── test_checkin.py      # 签到功能测试
+│   ├── test_user_profile.py # 用户资料测试
+│   ├── test_stats.py        # 统计功能测试
+│   ├── requirements.txt     # Python依赖
+│   └── run_tests.bat        # Windows测试脚本
+│
+├── frontend/                 # 前端测试
+│   ├── HomePage.test.ts     # 首页组件测试
+│   ├── Profile.test.ts      # 个人中心测试
+│   └── CheckIn.test.ts      # 签到页面测试
+│
+├── integration/              # 集成测试
+│   └── e2e_test.py          # 端到端测试
+│
+└── README.md                 # 测试说明文档
+```
+
+---
+
+## 🧪 测试用例详解
+
+### 后端测试
+
+#### 1. 管理员配置测试 (`test_admin_config.py`)
+```python
+class TestFeaturesConfig:
+    - test_get_features_config()        # 获取功能配置列表
+    - test_create_feature_config()      # 创建新功能
+    - test_update_feature_config()      # 更新功能配置
+    - test_delete_feature_config()      # 删除功能配置
+    - test_update_nonexistent_feature() # 更新不存在的功能
+
+class TestVIPConfig:
+    - test_get_vip_config()            # 获取VIP配置
+    - test_update_vip_config()         # 更新VIP配置
+
+class TestCheckInConfig:
+    - test_get_checkin_config()        # 获取签到配置
+    - test_create_checkin_config()     # 创建签到档位
+    - test_update_checkin_config()     # 更新签到档位
+```
+
+#### 2. 功能使用测试 (`test_feature.py`)
+```python
+class TestFeatureUsage:
+    - test_use_feature_normal_user()       # 普通用户使用功能
+    - test_use_feature_insufficient_points() # 积分不足
+    - test_use_feature_vip_user_with_quota() # VIP用户使用配额
+    - test_use_disabled_feature()          # 使用已禁用功能
+    - test_use_nonexistent_feature()       # 不存在的功能
+```
+
+#### 3. 签到测试 (`test_checkin.py`)
+```python
+class TestDailyCheckIn:
+    - test_first_checkin()                 # 首次签到
+    - test_duplicate_checkin()             # 重复签到
+    - test_consecutive_checkin_calculation() # 连续天数计算
+    - test_broken_consecutive_checkin()    # 中断连续签到
+    - test_vip_multiplier()                # VIP倍数
+```
+
+### 前端测试
+
+#### 1. HomePage测试 (`HomePage.test.ts`)
+```typescript
+describe('HomePage', () => {
+  - it('应该正确渲染组件')
+  - it('应该显示欢迎信息')
+  - it('应该显示正确的积分数量')
+  - it('应该显示VIP状态')
+  - it('点击功能卡片应该调用使用功能API')
+  - it('积分不足时应该显示错误提示')
+})
+```
+
+#### 2. Profile测试 (`Profile.test.ts`)
+```typescript
+describe('Profile', () => {
+  - it('应该显示用户基本信息')
+  - it('应该显示统计数据卡片')
+  - it('应该能够编辑资料')
+  - it('应该显示积分历史列表')
+})
+```
+
+#### 3. CheckIn测试 (`CheckIn.test.ts`)
+```typescript
+describe('CheckIn', () => {
+  - it('应该显示签到状态')
+  - it('未签到时应该显示签到按钮')
+  - it('点击签到按钮应该调用签到API')
+  - it('应该显示签到日历')
+  - it('应该显示签到历史记录')
+})
+```
+
+---
+
+## 🔧 测试工具和技术
+
+### 后端测试技术栈
+- **Pytest**: Python测试框架
+- **Requests**: HTTP客户端
+- **PyMySQL**: 数据库连接
+- **pytest-cov**: 代码覆盖率
+- **pytest-html**: HTML测试报告
+
+### 前端测试技术栈
+- **Vitest**: Vue3测试框架
+- **@vue/test-utils**: Vue组件测试工具
+- **jsdom**: DOM环境模拟
+
+---
+
+## 📝 编写新测试
+
+### 后端测试示例
+
+```python
+def test_your_api(test_user):
+    """测试你的API"""
+    # 1. 准备数据
+    request_data = {
+        'username': test_user['username'],
+        'param': 'value'
+    }
+    
+    # 2. 调用API
+    response = requests.post(
+        f"{API_BASE_URL}/your/endpoint",
+        json=request_data
+    )
+    
+    # 3. 断言结果
+    assert response.status_code == 200
+    data = response.json()
+    assert data['code'] == 200
+    assert data['data']['field'] == expected_value
+```
+
+### 前端测试示例
+
+```typescript
+it('应该测试你的功能', async () => {
+  // 1. Mock API
+  ;(axios.get as any).mockResolvedValue({
+    data: { code: 200, data: mockData }
+  })
+  
+  // 2. 挂载组件
+  const wrapper = mount(YourComponent)
+  await new Promise(resolve => setTimeout(resolve, 100))
+  
+  // 3. 断言
+  expect(wrapper.text()).toContain('期望文本')
+})
+```
+
+---
+
+## ⚠️ 注意事项
+
+### 1. 测试数据隔离
+- 后端测试使用独立的测试数据库
+- 每个测试用例结束后自动回滚数据
+- 测试用户名以 `test_` 开头
+
+### 2. 异步操作
+```python
+# 后端：等待数据库更新
+time.sleep(1)
+
+# 前端：等待组件更新
+await new Promise(resolve => setTimeout(resolve, 100))
+```
+
+### 3. 测试环境变量
+确保测试环境不会影响生产数据：
+```env
+ENV=test
+DB_NAME=designercep_test
+API_URL=https://test.backend.aidg168.uk
+```
+
+### 4. Mock外部依赖
+```typescript
+// Mock axios
+vi.mock('axios')
+
+// Mock router
+vi.mock('vue-router', () => ({
+  useRouter: () => mockRouter
+}))
+```
+
+---
+
+## 📈 测试覆盖率目标
+
+| 模块 | 目标覆盖率 | 当前状态 |
+|------|-----------|---------|
+| 后端API | > 80% | ✅ 已达标 |
+| 前端组件 | > 70% | ✅ 已达标 |
+| 集成测试 | 核心流程全覆盖 | ✅ 已达标 |
+
+---
+
+## 🐛 问题排查
+
+### 后端测试失败
+
+**问题1**: 数据库连接失败
+```
+解决: 检查 .env 配置，确保测试数据库存在
+```
+
+**问题2**: API返回500错误
+```
+解决: 检查后端服务是否正常运行
+```
+
+### 前端测试失败
+
+**问题1**: 组件挂载失败
+```
+解决: 检查是否正确Mock了所有依赖
+```
+
+**问题2**: 异步断言失败
+```
+解决: 增加等待时间或使用 waitFor()
+```
+
+---
+
+## 📊 CI/CD集成
+
+### GitHub Actions示例
+
+```yaml
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  backend-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+      - name: Install dependencies
+        run: |
+          cd tests/backend
+          pip install -r requirements.txt
+      - name: Run tests
+        run: pytest -v --cov
+
+  frontend-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Node.js
+        uses: actions/setup-node@v2
+      - name: Install dependencies
+        run: |
+          cd Designer
+          npm install
+      - name: Run tests
+        run: npm run test
+```
+
+---
+
+## ✅ 测试检查清单
+
+### 提交代码前
+- [ ] 所有测试通过
+- [ ] 新功能已添加测试
+- [ ] 测试覆盖率达标
+- [ ] 无eslint/pylint警告
+
+### 发布前
+- [ ] 运行完整测试套件
+- [ ] 运行E2E集成测试
+- [ ] 检查测试报告
+- [ ] 验证关键流程
+
+---
+
+## 📚 参考资料
+
+- [Pytest文档](https://docs.pytest.org/)
+- [Vitest文档](https://vitest.dev/)
+- [Vue Test Utils](https://test-utils.vuejs.org/)
+- [Testing Best Practices](https://testingjavascript.com/)
+
+---
+
+**测试是质量的保证！** 🎯
+