// 用 AI 设计 Schema 的提示词示例
// """
// 你是一个有 10 年经验的数据库架构师，精通 PostgreSQL。
// 
// 业务场景：一个在线学习平台，包含以下实体：
// - 用户（User）：id, 邮箱, 密码哈希, 昵称, 头像, 角色(学习者/管理员), 注册时间
// - 课程（Course）：id, 标题, 描述, 封面图, 作者ID, 难度(入门/中级/高级), 价格, 创建时间
// - 课时（Lesson）：id, 课程ID, 标题, 内容(富文本), 排序, 时长(分钟)
// - 学习进度（Progress）：id, 用户ID, 课时ID, 状态(未开始/学习中/已完成), 最后学习时间, 完成时间
// - 练习（Exercise）：id, 课时ID, 类型(选择题/代码题), 题目内容, 答案, 分值
// - 答题记录（Answer）：id, 用户ID, 练习ID, 用户答案, 是否正确, 得分, 提交时间
// 
// 要求：
// 1. 用 PostgreSQL 语法，给出完整的 CREATE TABLE 语句
// 2. 所有表都要有主键（id，BIGSERIAL）、created_at、updated_at
// 3. 外键约束要明确（ON DELETE 策略）
// 4. 常用查询字段要加索引（用户邮箱、课程作者、学习进度的用户+课时）
// 5. 字段类型要合理（邮箱用 TEXT UNIQUE、状态用 ENUM 或 CHECK、时间用 TIMESTAMPTZ）
// 6. 给出 ER 图描述（实体之间的关系：一对一/一对多/多对多）
// 7. 说明每个索引的用途（为什么要加这个索引）
// """
print("给 AI 清晰的业务实体和要求，它能生成高质量的 Schema")

// Prisma 迁移示例（Node/TypeScript 最现代的 ORM）
// schema.prisma 文件：
// model User {
//   id        BigInt   @id @default(autoincrement())
//   email     String   @unique
//   name      String?
//   role      Role     @default(LEARNER)
//   createdAt DateTime @default(now())
//   updatedAt DateTime @updatedAt
//   lessons   Progress[]
// }
//
// model Lesson {
//   id       BigInt   @id @default(autoincrement())
//   courseId BigInt
//   title    String
//   content  String?
//   course   Course   @relation(fields: [courseId], references: [id])
// }
//
// 命令行：
// npx prisma migrate dev --name add_user_table  // 生成并执行迁移
// npx prisma migrate deploy                      // 生产环境执行迁移
// npx prisma studio                              // 打开可视化数据库管理界面
//
// 迁移文件会生成在 prisma/migrations/ 目录下，每个迁移一个时间戳命名的文件夹，
// 包含 migration.sql（SQL 语句），可以进版本控制，团队共享。

// 让 AI 实现 API 的提示词示例
// """
// 你是一个有 10 年经验的 Node.js 后端工程师，精通 Express + TypeScript + Prisma + PostgreSQL。
// 
// 技术栈：
// - 框架：Express + TypeScript
// - ORM：Prisma
// - 数据库：PostgreSQL
// - 验证：zod
// - 认证：JWT（从 Authorization: Bearer <token> 解析，中间件 authMiddleware 已存在）
// 
// 请实现以下 API 接口（参考已有的 user.routes.ts 的代码风格）：
// 
// 1. POST /api/v1/courses
//    - 描述：创建课程（仅管理员可创建）
//    - 请求体：{ title: string, description: string, difficulty: 'BEGINNER'|'INTERMEDIATE'|'ADVANCED', price: number }
//    - 响应：201 Created，返回创建的课程对象
//    - 权限：需要登录且 role=ADMIN
//    - 验证：title 1-100字符，description 最多2000字符，price >=0
// 
// 2. GET /api/v1/courses
//    - 描述：获取课程列表（分页+按难度筛选+按创建时间排序）
//    - 查询参数：page(默认1), page_size(默认20,最大50), difficulty(可选), sort(可选, 'newest'|'oldest'|'popular')
//    - 响应：200 OK，{ data: Course[], total: number, page: number, page_size: number }
//    - 权限：公开（不需要登录）
// 
// 3. GET /api/v1/courses/:id
//    - 描述：获取单个课程详情（含课时列表）
//    - 响应：200 OK，返回课程对象+lessons数组
//    - 404：课程不存在
// 
// 要求：
// - 用 zod 做输入验证，验证失败返回 400 + 统一错误格式
// - 用 Prisma Client 做数据库操作
// - 数据库错误要 catch，返回 500 + 统一错误格式，日志记录详情
// - 代码要有中文注释
// - 遵循已有的代码结构（routes/controller/service 分层）
// """
print("给 AI 技术栈+契约+Schema+已有代码风格，它能生成高质量的接口实现")

// 让 AI 生成测试的提示词示例
// """
// 你是一个有 10 年经验的测试工程师，精通 Jest + Supertest + TypeScript。
// 
// 请为以下 API 接口编写完整的集成测试（参考已有的 user.test.ts 的风格）：
// 
// 接口：POST /api/v1/courses（创建课程，仅管理员）
// 
// 测试用例：
// 1. 正常流程：管理员登录→发送合法请求→201 Created→数据库有记录→返回正确的课程对象
// 2. 未登录：不携带 Token→401 Unauthorized
// 3. 普通用户：学习者角色登录→403 Forbidden
// 4. 参数缺失：不传 title→400 Bad Request→错误信息明确
// 5. 参数非法：title 超过100字符→400 Bad Request
// 6. 价格为负数：price=-10→400 Bad Request
// 7. 重复创建：相同 title 创建两次→应该允许（title 不唯一）或按设计处理
// 
// 要求：
// - 用 Jest + Supertest
// - 每个测试前清理测试数据库（beforeEach）
// - 测试之间互不影响（用不同的测试数据）
// - 断言要充分（状态码、响应体字段、数据库记录）
// - 用工厂函数生成测试数据（如 createTestUser()、createTestAdmin()）
// - 代码有中文注释
// """
print("让 AI 生成测试，覆盖正常/异常/边界场景，跑通所有测试才算完成")

// 用 AI 调试 Bug 的提示词示例
// """
// 你是一个有 10 年经验的后端调试专家，精通 Node.js + PostgreSQL + Prisma。
// 
// 问题描述：
// 用户反馈「创建课程时偶尔会失败，提示 'Internal Server Error'，但重试一次就成功了」。
// 这个问题不是每次都出现，大约 10 次里有 1 次。
// 
// 报错信息（完整堆栈）：
// Error: Invalid `prisma.course.create()` invocation in
// /app/src/controllers/course.controller.ts:45:32
//   Unique constraint failed on the fields: (`id`)
//   at ... (堆栈省略)
// 
// 相关代码（course.controller.ts 创建课程的部分）：
// [粘贴完整的创建课程函数代码]
// 
// Schema（Prisma）：
// model Course {
//   id        BigInt   @id @default(autoincrement())
//   title     String
//   ...
// }
// 
// 我已经尝试过的：
// - 检查了请求参数，没有问题
// - 数据库连接正常
// - 不是每次都出现，偶尔出现
// 
// 请分析：
// 1. 根因是什么？（为什么 id 会冲突？autoincrement 不应该冲突啊）
// 2. 为什么偶尔出现而不是每次？
// 3. 怎么修复？
// 4. 怎么防止类似问题？
// """
print("给 AI 完整报错+相关代码+上下文+已尝试排查，它能精准定位根因")