Claude Code: Coding Plan（编程计划）

# 方式1：使用 /plan 命令
> /plan 将认证从 Session 迁移到 JWT

# 方式2：指令中包含"先出计划"
> 将认证从 Session 迁移到 JWT，先出计划再执行

# 方式3：自动触发（大任务时 Claude Code 自动出计划）
> 重构整个项目的错误处理

Claude Code:
  这个任务影响范围较大，让我先制定计划：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Coding Plan: Session → JWT 认证迁移
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 目标
将认证方式从 Session 迁移到 JWT

## 影响范围
- 修改文件: 12 个
- 新增文件: 3 个
- 删除文件: 2 个
- 数据库变更: 无

## 执行步骤

### Step 1: 创建 JWT 工具模块
- 新建 src/auth/jwt.ts
- 实现 token 生成、验证、刷新
- 编写单元测试

### Step 2: 修改认证中间件
- 修改 src/middleware/auth.ts
- 从 Session 验证改为 JWT 验证
- 保持接口不变

### Step 3: 修改登录/注册路由
- 修改 src/routes/auth.ts
- 返回 JWT token 替代设置 Session

### Step 4: 修改受保护路由
- 修改 8 个路由文件
- 调整认证检查方式

### Step 5: 清理 Session 代码
- 删除 session 相关配置
- 删除 express-session 依赖

## 风险评估
- 🔴 高风险: 中间件迁移可能影响所有已登录用户
- 🟡 中风险: Token 刷新逻辑需要仔细设计
- 🟢 低风险: 工具模块独立，不影响现有代码

## 预估
- Token: ~80K
- 时间: ~15 min
- 费用: ~$1.60

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
确认执行？[y/n/modify]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

# 修改计划
> Step 5 不需要删除 Session，保留兼容期2周

Claude Code:
  更新计划：
  Step 5: 保留 Session 兼容
  - 不删除 express-session
  - 添加双认证支持（Session + JWT）
  - 2周后清理 Session 代码

  确认？[y/n/modify] y

  开始执行...

# 确认后按步骤执行

[Step 1/5] 创建 JWT 工具模块
  → Creating src/auth/jwt.ts
  → Creating tests/jwt.test.ts
  → Running: npm test -- jwt.test.ts
  ✅ Step 1 完成

/checkpoint "jwt-module-complete"

[Step 2/5] 修改认证中间件
  → Modifying src/middleware/auth.ts
  → Running: npm test -- auth.test.ts
  ✅ Step 2 完成

/checkpoint "middleware-complete"

[Step 3/5] 修改登录/注册路由
  → Modifying src/routes/auth.ts
  → Running: npm test -- auth.test.ts
  ✅ Step 3 完成

[Step 4/5] 修改受保护路由
  → Modifying src/routes/user.ts
  → Running: npm test
  ❌ 3 tests failed

  分析原因：部分路由依赖 req.session，JWT 模式下不存在

  修正方案：在中间件中将 JWT payload 映射到 req.user

  → Modifying src/middleware/auth.ts (添加映射)
  → Re-running: npm test
  ✅ Step 4 完成

> /plan 将 Express 迁移到 Fastify

Claude Code 生成计划：
  Step 1: 安装 Fastify 依赖
  Step 2: 创建 Fastify 应用入口
  Step 3: 转换中间件为 Fastify 插件
  Step 4: 转换路由定义
  Step 5: 转换错误处理
  Step 6: 更新测试配置
  Step 7: 清理 Express 依赖

  影响: 修改 28 个文件，新增 5 个，删除 4 个
  风险: 中（路由语法差异大）

> 确认执行

[Step 1-3 完成] /checkpoint "fastify-core"
[Step 4 完成] /checkpoint "routes-converted"
[Step 5-6 完成] /checkpoint "error-and-test"
[Step 7 完成] /checkpoint "cleanup"

> 运行全量测试
✅ All 134 tests passed

迁移完成！

> /plan 将整个微服务项目从 JavaScript 迁移到 TypeScript

Claude Code 生成详细计划：

## Phase 1: 基础设施（1-2小时）
  Step 1: 安装 TypeScript 和类型定义
  Step 2: 创建 tsconfig.json（宽松模式先迁移）
  Step 3: 配置构建脚本

## Phase 2: 共享模块（2-3小时）
  Step 4: 迁移 shared/types/ (5 files)
  Step 5: 迁移 shared/utils/ (8 files)
  Step 6: 迁移 shared/constants/ (3 files)

## Phase 3: 服务模块（3-4小时，可并行）
  Step 7: 迁移 user-service/ (12 files)
  Step 8: 迁移 order-service/ (15 files)
  Step 9: 迁移 payment-service/ (10 files)

## Phase 4: 严格模式（1-2小时）
  Step 10: 启用 strict 模式
  Step 11: 修复所有类型错误
  Step 12: 全量测试验证

  总影响: 修改 53 个文件，新增 8 个
  预估 Token: ~200K (需分段)
  预估费用: ~$4.00

> 分 Phase 执行，每个 Phase 完成后 /checkpoint

[Phase 1 完成] /checkpoint "ts-infra"
[Phase 2 完成] /checkpoint "shared-modules"
[Phase 3 Step7完成] /checkpoint "user-service"
[Phase 3 Step8完成] /checkpoint "order-service"
[Phase 3 Step9完成] /checkpoint "payment-service"
[Phase 4 完成] /checkpoint "strict-mode"

✅ 全量测试通过，迁移完成！