// 单元测试示例（Vitest/Jest，TypeScript）
// 被测函数：
// export function calculateDiscount(price: number, discountPercent: number): number {
//   if (price < 0) throw new Error('价格不能为负');
//   if (discountPercent < 0 || discountPercent > 100) throw new Error('折扣比例必须在0-100之间');
//   const discount = price * (discountPercent / 100);
//   return Math.round((price - discount) * 100) / 100;
// }
//
// 测试文件：
// import { describe, it, expect } from 'vitest';
// import { calculateDiscount } from './discount';
//
// describe('calculateDiscount', () => {
//   // 正常场景
//   it('应该正确计算折扣', () => {
//     expect(calculateDiscount(100, 20)).toBe(80);
//     expect(calculateDiscount(50, 50)).toBe(25);
//     expect(calculateDiscount(99.99, 10)).toBe(89.99);
//   });
//
//   // 边界场景
//   it('折扣为0时返回原价', () => {
//     expect(calculateDiscount(100, 0)).toBe(100);
//   });
//   it('折扣为100时返回0', () => {
//     expect(calculateDiscount(100, 100)).toBe(0);
//   });
//
//   // 异常场景
//   it('价格为负时抛出错误', () => {
//     expect(() => calculateDiscount(-10, 20)).toThrow('价格不能为负');
//   });
//   it('折扣比例超出范围时抛出错误', () => {
//     expect(() => calculateDiscount(100, -5)).toThrow();
//     expect(() => calculateDiscount(100, 110)).toThrow();
//   });
//
//   // 浮点数精度
//   it('应该正确处理浮点数精度', () => {
//     expect(calculateDiscount(0.1, 10)).toBe(0.09);
//   });
// });
//
// 好的单元测试特点：
// - 测试名描述行为（「应该正确计算折扣」），不是「测试1」「test1」
// - 每个测试只测一个场景
// - 覆盖正常、边界、异常三类场景
// - 不依赖外部状态（不连数据库、不调API、不依赖当前时间）
// - 断言清晰（期望什么结果）

// Mock 示例（Vitest）
// 被测代码：从 API 获取用户信息
// import axios from 'axios';
// export async function getUserInfo(userId: string) {
//   const response = await axios.get(`/api/users/${userId}`);
//   if (response.status !== 200) throw new Error('获取用户失败');
//   return response.data;
// }
//
// 测试：Mock 掉 axios，不真实发请求
// import { describe, it, expect, vi } from 'vitest';
// import axios from 'axios';
// import { getUserInfo } from './user';
//
// vi.mock('axios');  // Mock 整个 axios 模块
//
// describe('getUserInfo', () => {
//   it('应该返回用户信息', async () => {
//     // 设置 Mock 的返回值
//     (axios.get as any).mockResolvedValue({ status: 200, data: { id: '1', name: '张三' } });
//     
//     const user = await getUserInfo('1');
//     
//     expect(user).toEqual({ id: '1', name: '张三' });
//     // 验证调用了正确的 URL
//     expect(axios.get).toHaveBeenCalledWith('/api/users/1');
//   });
//
//   it('API 返回非200时抛出错误', async () => {
//     (axios.get as any).mockResolvedValue({ status: 404 });
//     await expect(getUserInfo('999')).rejects.toThrow('获取用户失败');
//   });
// });

// API 集成测试示例（Supertest + 测试数据库）
// import request from 'supertest';
// import app from './app';
// import { prisma } from './db';
//
// describe('POST /api/auth/login', () => {
//   // 每个测试前清理测试数据库
//   beforeEach(async () => {
//     await prisma.user.deleteMany();
//     // 创建一个测试用户
//     await prisma.user.create({
//       data: { email: 'test@example.com', passwordHash: 'hashed_password', name: '测试用户' }
//     });
//   });
//
//   afterAll(async () => {
//     await prisma.$disconnect();
//   });
//
//   it('正确的邮箱密码应该返回 token', async () => {
//     const res = await request(app)
//       .post('/api/auth/login')
//       .send({ email: 'test@example.com', password: 'correct_password' });
//     
//     expect(res.status).toBe(200);
//     expect(res.body).toHaveProperty('token');
//     expect(res.body.user.email).toBe('test@example.com');
//   });
//
//   it('错误的密码应该返回 401', async () => {
//     const res = await request(app)
//       .post('/api/auth/login')
//       .send({ email: 'test@example.com', password: 'wrong_password' });
//     
//     expect(res.status).toBe(401);
//     expect(res.body.error).toBe('INVALID_CREDENTIALS');
//   });
//
//   it('缺少参数应该返回 400', async () => {
//     const res = await request(app)
//       .post('/api/auth/login')
//       .send({ email: 'test@example.com' });  // 没传 password
//     
//     expect(res.status).toBe(400);
//   });
// });
//
// 集成测试要点：
// - 用独立的测试数据库（不要连开发/生产数据库）
// - 每个测试前清理数据（deleteMany 或事务回滚）
// - 测试完整的请求-响应流程（包括数据库写入）
// - 覆盖正常和异常场景

// E2E 测试示例（Playwright）
// import { test, expect } from '@playwright/test';
//
// test.describe('用户学习流程', () => {
//   test('注册→登录→学习课程→答题', async ({ page }) => {
//     // 1. 注册
//     await page.goto('http://localhost:3000/register');
//     await page.fill('input[name="email"]', 'test@example.com');
//     await page.fill('input[name="password"]', 'Test123456');
//     await page.fill('input[name="confirmPassword"]', 'Test123456');
//     await page.click('button[type="submit"]');
//     await expect(page).toHaveURL('http://localhost:3000/dashboard');
//
//     // 2. 进入课程
//     await page.click('text=Python 入门');
//     await expect(page.locator('h1')).toContainText('Python 入门');
//
//     // 3. 开始学习第一节课
//     await page.click('text=什么是编程');
//     await expect(page.locator('h1')).toContainText('什么是编程');
//
//     // 4. 答题
//     await page.click('text=开始答题');
//     await page.check('input[value="A"]');  // 选答案A
//     await page.click('text=提交');
//     await expect(page.locator('.result')).toContainText('正确');
//
//     // 5. 验证进度保存
//     await page.goto('http://localhost:3000/dashboard');
//     await expect(page.locator('.progress')).toContainText('1/37');
//   });
// });
//
// E2E 测试要点：
// - 只测最核心的用户流程（5-10个测试就够）
// - 用真实的测试环境（真实数据库、真实后端）
// - Playwright 自动等待（不用手动 sleep，它会等元素出现/可点击）
// - 测试要稳定（不要依赖时序、不要用固定的等待时间）
// - 失败时截图/录屏，方便定位问题

// 让 AI 生成测试的提示词示例
// """
// 你是一个有 10 年经验的测试工程师，精通 Vitest + TypeScript。
// 
// 请为以下函数编写完整的单元测试：
// 
// [粘贴被测函数代码]
// 
// 要求：
// 1. 用 Vitest 语法（describe/it/expect）
// 2. 覆盖正常场景、边界场景（0/空/最大值/临界值）、异常场景（非法输入/错误处理）
// 3. 测试名用「应该...」的行为描述
// 4. 每个测试只测一个场景
// 5. 外部依赖用 vi.mock 隔离
// 6. 用 Arrange-Act-Assert 三段式结构
// 7. 代码有中文注释
// 8. 不要测试实现细节，只测试输入输出行为
// """