Claude Code: Claude Code 基础用法

> 创建 src/services/email.ts，实现邮件发送服务：
> - 支持 HTML 和纯文本格式
> - 使用模板引擎渲染邮件内容
> - 添加重试机制（最多3次）
> - 写单元测试（mock SMTP）

Claude Code:
  → Creating src/services/email.ts
  → Creating src/services/__tests__/email.test.ts
  → Installing dependencies: nodemailer, handlebars
  → Running: npm test -- email.test.ts
  ✅ 5 tests passed

> 在 UserService 中添加密码重置功能

Claude Code:
  → Reading src/services/user.ts
  → Reading src/models/user.ts
  → Reading src/services/email.ts (已存在的邮件服务)
  → Modifying src/services/user.ts (adding resetPassword)
  → Modifying src/routes/user.ts (adding POST /reset-password)
  → Creating tests for password reset
  ✅ All tests passed

> 创建完整的 Product CRUD 模块：
> 1. Prisma 模型定义
> 2. Repository 层
> 3. Service 层
> 4. Controller 层
> 5. 路由定义
> 6. 完整测试

Claude Code:
  → Reading prisma/schema.prisma (existing schema)
  → Adding Product model to schema
  → Creating src/repositories/product.repository.ts
  → Creating src/services/product.service.ts
  → Creating src/controllers/product.controller.ts
  → Creating src/routes/product.routes.ts
  → Creating tests/product.test.ts
  → Running: npm test
  ✅ 12 tests passed (CRUD: create, read, update, delete, list, search)

> 修复 src/utils/date.ts 中 relativeTime 函数在跨年时的计算错误

Claude Code:
  → Reading src/utils/date.ts
  → Reading tests/date.test.ts
  → Found bug: relativeTime uses daysOnly comparison
  → Fixing: adding year boundary check
  → Running: npm test -- date.test.ts
  ✅ All tests passed (including new edge case)

> 运行测试并修复所有失败用例

Claude Code:
  → Running: npm test
  ❌ 3 tests failed:
    - auth.test.ts: token expiry check
    - user.test.ts: email validation
    - order.test.ts: date format

  → Reading failed test files...
  → Fixing auth.test.ts: adjusting time comparison logic
  → Fixing user.test.ts: updating regex pattern
  → Fixing order.test.ts: using ISO date format

  → Running: npm test
  ✅ All 47 tests passed

> 应用启动报错：TypeError: Cannot read property 'id' of undefined at UserController.getProfile

Claude Code:
  → Reading src/controllers/user.controller.ts
  → Found: getProfile doesn't check if req.user exists
  → Adding null check with proper error response
  → Running: npm run build ✓
  → Running: npm test -- user.controller.test.ts
  ✅ All tests passed

> 重构 src/utils/format.ts 中的 formatCurrency 函数，使用 Intl.NumberFormat

Claude Code:
  → Reading src/utils/format.ts
  → Replacing manual formatting with Intl.NumberFormat
  → Adding locale support (default: zh-CN)
  → Running: npm test -- format.test.ts
  ✅ All tests passed

> 将 src/helpers/ 目录下的所有工具函数按功能重组到 src/utils/ 下：
> - 日期相关 → utils/date.ts
> - 字符串相关 → utils/string.ts
> - 数字相关 → utils/number.ts
> 更新所有 import 路径

Claude Code:
  → Scanning src/helpers/ (15 files)
  → Categorizing functions by type
  → Creating new files in src/utils/
  → Moving functions with proper exports
  → Updating 32 import statements across the project
  → Deleting src/helpers/
  → Running: npm test
  ✅ All 89 tests passed

> 为 src/services/ 下所有没有测试的 service 写测试，覆盖率目标 80%

Claude Code:
  → Scanning src/services/ (8 files)
  → Checking test coverage...

  Missing tests:
  - email.service.ts (0% coverage)
  - payment.service.ts (0% coverage)
  - search.service.ts (12% coverage)

  → Writing tests for email.service.ts (5 test cases)
  → Writing tests for payment.service.ts (8 test cases)
  → Writing tests for search.service.ts (6 test cases)

  → Running: npm test
  ✅ All new tests passed

  Coverage:
  - email.service.ts: 85%
  - payment.service.ts: 82%
  - search.service.ts: 88%
  Average: 85% ✓

> 审查 src/auth/jwt.ts 的安全性

Claude Code:
  ⚠️ Found 3 issues:
  1. Hardcoded secret key (line 12) → Use env variable
  2. No token expiry validation (line 34) → Add expiry check
  3. Algorithm not specified (line 8) → Force RS256

  Suggested fixes:
  → Line 12: process.env.JWT_SECRET
  → Line 34: if (decoded.exp < Date.now()/1000) throw new Error()
  → Line 8: algorithm: 'RS256'

> 为 src/api/ 下所有路由生成 API 文档

Claude Code:
  → Reading all route files (12 files)
  → Generating API documentation...
  → Creating docs/api.md with:
    - Endpoint listing table
    - Request/Response examples
    - Authentication requirements
    - Error codes reference

# Alice 用 Claude Code 完成用户权限功能

> 实现用户权限系统：
> 1. 定义 Role 和 Permission 模型
> 2. 实现 RBAC 中间件
> 3. 添加权限检查装饰器
> 4. 写完整的集成测试
> 5. 生成 API 文档

Claude Code 执行过程：
  → Reading existing auth module...
  → Creating models/role.model.ts
  → Creating models/permission.model.ts
  → Creating middleware/rbac.ts
  → Creating decorators/require-permission.ts
  → Modifying routes to add permission checks
  → Writing integration tests (15 test cases)
  → Running: npm test → 15/15 passed ✓
  → Generating docs/permissions.md

Total: 8 files created, 4 files modified, 15 tests passing