# 测试体系模块

## 概述
追光AI使用 Vitest 作为测试框架，已建立 5 个测试套件覆盖 132 个测试，目标覆盖率 80%+。测试文件位于 `src/__tests__/` 目录。

---

## 基础设施

### vitest.config.ts
```typescript
import { defineConfig } from "vitest/config";
import path from "path";

export default defineConfig({
  test: {
    globals: true,
    environment: "node",
    setupFiles: ["./vitest.setup.ts"],
    include: ["src/__tests__/**/*.test.ts"],
    coverage: {
      provider: "v8",
      reporter: ["text", "json", "html"],
      thresholds: {
        lines: 80,
        branches: 80,
        functions: 80,
        statements: 80,
      },
    },
  },
  resolve: {
    alias: { "@": path.resolve(__dirname, "./src") },
  },
});
```

### vitest.setup.ts
- 全局 mock 配置
- Prisma mock 初始化
- 测试环境清理

### tsconfig 配置
```json
{
  "compilerOptions": {
    "types": ["vitest/globals"]
  }
}
```

---

## 测试套件

### 1. level-config.test.ts
- **测试数量**: 28
- **覆盖**: `src/lib/level-config.ts`
- **测试内容**:
  - 20个等级边界值检查
  - 等级徽章映射
  - 每日限额表
  - 积分→等级转换
  - 下一级积分计算

### 2. elo.test.ts
- **测试数量**: 24
- **覆盖**: ELO 评分计算逻辑
- **测试内容**:
  - 基础 ELO 计算
  - K因子变化
  - 平局处理
  - 极端分差

### 3. forum-hot.test.ts
- **测试数量**: 30
- **覆盖**: 论坛热度排序算法
- **测试内容**:
  - 热度公式计算
  - 时间衰减
  - 回复加权
  - 点赞加权
  - 置顶优先

### 4. achievements.test.ts
- **测试数量**: 26
- **覆盖**: 成就系统逻辑
- **测试内容**:
  - 成就解锁条件
  - 进度计算
  - 徽章授予
  - 边界条件

### 5. points-reward.test.ts
- **测试数量**: 24
- **覆盖**: `src/lib/points-reward.ts`
- **测试内容**:
  - 各操作积分奖励
  - 每日上限检查
  - Streak freeze 逻辑
  - 商店购买消耗
  - 等级升级触发

---

## 运行命令

```bash
# 运行所有测试
npx vitest run

# 监听模式
npx vitest

# 生成覆盖率报告
npx vitest run --coverage

# 运行特定测试文件
npx vitest run src/__tests__/level-config.test.ts

# UI 模式
npx vitest --ui
```

---

## 测试规范

### 文件命名
- 测试文件: `*.test.ts`
- 目录: `src/__tests__/`

### 测试结构
```typescript
import { describe, it, expect, beforeEach, vi } from "vitest";

describe("模块名", () => {
  beforeEach(() => {
    // setup
  });

  describe("功能点", () => {
    it("应该满足某条件", () => {
      // arrange
      // act
      // assert
    });

    it("应该处理边界情况", () => {
      // ...
    });

    it("应该优雅处理错误", () => {
      // ...
    });
  });
});
```

### 测试原则
- 每个 `it` 测试单一行为
- 使用 `describe` 组织相关测试
- Arrange → Act → Assert 三段式
- 覆盖正常路径 + 边界条件 + 错误路径
- 禁止 `.skip` 除非有明确 TODO 注释
- Mock 外部依赖（Prisma、外部 API）

### 覆盖率目标
| 指标 | 目标 |
|------|------|
| 行覆盖率 | ≥ 80% |
| 分支覆盖率 | ≥ 80% |
| 函数覆盖率 | ≥ 80% |
| 语句覆盖率 | ≥ 80% |