第17课：Claude Code实战案例一，从零开发一个完整 API 模块

需求标题：文章收藏功能

用户价值：
- 用户可以把感兴趣的文章收藏起来，方便以后阅读
- 在个人中心可以看到自己的收藏列表
- 可以取消收藏
- 列表页和详情页要能看到收藏状态

技术要求：
- 下周四发布
- 要有充分的测试覆盖
- 不能影响现有的文章阅读性能

我要开发一个文章收藏功能。在开始写代码之前，帮我做情报收集。

同时启动5个 Explore Agent 并行扫描：

1. 扫描 src/modules/ 下所有模块的目录结构
   (thoroughness: quick)
   → 找一个最合适的模块作为我的参考模板
   → 特别关注有没有类似"用户-内容"多对多关系的模块（比如点赞、评论）

2. 扫描用户（user）和文章（article）模块
   (thoroughness: medium)
   → 了解这两个实体的完整数据结构
   → 找到它们当前的 Repository 查询方式

3. 扫描项目的数据库 migration 文件
   (thoroughness: quick)
   → 了解项目的数据库设计惯例
   → 看看主键、时间戳、索引的约定

4. 扫描 src/common/ 和 src/utils/
   (thoroughness: quick)
   → 找到项目的通用工具：分页、错误处理、响应格式化等

5. 扫描现有的 API 接口文档
   (thoroughness: quick)
   → 了解接口路径、响应格式的约定

5个任务互不依赖，并行执行。给我一份综合报告。

📊 情报汇总报告

1. 参考模板：
   → 发现 src/modules/like/ 模块实现了"用户点赞文章"功能
   → 这是一个多对多关系的典型实现，可以作为收藏功能的直接参考
   → 关键文件：
     - like.entity.ts：数据模型
     - like.service.ts：业务逻辑
     - like.controller.ts：接口层
     - like.repository.ts：数据访问层

2. 实体结构：
   → User 实体：id (UUID), email, username, created_at, updated_at
   → Article 实体：id (UUID), title, content, author_id, status, 
     view_count, like_count, created_at, updated_at, deleted_at
   → 注意：Article 已有 deleted_at 字段（软删除模式）

3. 数据库约定：
   → 主键：UUID，字段名 id
   → 时间戳：created_at, updated_at 自动维护
   → 软删除：deleted_at (nullable)
   → 索引命名：idx_[table]_[column]
   → 外键命名：fk_[table]_[reference]

4. 通用工具：
   → 分页：使用游标分页（CursorPagination），在 src/common/pagination.ts
   → 错误处理：AppError 类，错误码约定在 src/common/error-codes.ts
   → 响应格式：{ code, msg, data }，自动包装在拦截器里

5. API 约定：
   → 路径：RESTful 风格，/api/v1/[resource]
   → 认证：所有接口默认需要 JWT，用 @Public() 装饰器标记公开接口
   → 文档：使用 @nestjs/swagger，每个接口有完整注解

关键发现：
⚠️ like 模块的实现中有一个性能问题——列表页每个文章都单独查一次点赞状态
  （N+1问题）。如果你要做收藏功能，建议在设计时就避免这个问题。