🧠 AI - Claude Code 记忆系统 CLAUDE.md

第一次对话：
你：帮我写一个用户登录接口
Claude：好的，这是一个基础的登录接口...（使用 Express + JavaScript）

你：我们项目用的是 Fastify 和 TypeScript
Claude：好的，让我重新写...

第二次对话：
你：帮我写一个订单创建接口
Claude：好的，这是一个基础的订单接口...（又用 Express + JavaScript）

你：（崩溃）我们用 Fastify 和 TypeScript！

# 公司开发策略

## 安全要求

- 禁止在代码中硬编码任何秘钥或敏感信息
- 所有 API 调用必须使用 HTTPS
- 用户输入必须经过验证和清理

## 合规要求

- 所有日志必须排除 PII（个人身份信息）
- 数据库连接必须使用加密传输

## 禁止项

- 禁止使用未经审批的第三方库
- 禁止直接访问生产数据库

# 个人偏好

## 沟通方式

- 使用中文回复
- 代码注释使用英文
- 解释简洁直接，不要过多铺垫

## 通用代码风格

- 缩进使用 2 个空格
- 优先使用 async/await
- 变量命名使用 camelCase
- 常量命名使用 UPPER_SNAKE_CASE

## 我的常用工具

- 包管理器：pnpm
- 编辑器：VS Code
- 终端：zsh

# 项目：订单服务 API

## 技术栈

- Node.js 20 + TypeScript
- Fastify（Web 框架）
- Prisma（ORM）
- PostgreSQL + Redis
- Zod（数据验证）

## 目录结构

src/
├── routes/ # 路由定义
├── controllers/ # 请求处理
├── services/ # 业务逻辑
├── repositories/ # 数据访问
├── schemas/ # Zod schemas
└── types/ # 类型定义

## 编码规范

- TypeScript strict 模式
- 禁止使用 any，使用 unknown + 类型守卫
- 所有 API 端点必须有 Zod schema 验证
- 业务错误使用自定义 Error 类

## 常用命令

- pnpm dev - 启动开发服务器
- pnpm test - 运行测试
- pnpm prisma migrate dev - 运行数据库迁移

# 本地开发笔记

## 我的环境

- 本地 API：http://localhost:3000
- 测试数据库：order_service_dev
- Redis：localhost:6379

## 测试账号

- admin@test.com / test123
- user@test.com / test123

## 当前工作

- 正在重构支付模块
- 参考 PR #234 的讨论
- 周五前完成

## 调试技巧

- 订单状态机日志: LOG_LEVEL=debug pnpm dev
- 查看 Redis 缓存: redis-cli KEYS "order:\*"

echo "CLAUDE.local.md" >> .gitignore

.claude/
└── rules/
├── typescript.md # TypeScript 规范
├── testing.md # 测试规范
├── api-design.md # API 设计规范
└── security.md # 安全规范

---
paths:
  - "src/**/*.test.ts"
  - "tests/**/*.ts"
---

# 测试规范

## 命名

- 单元测试: `*.test.ts`
- 集成测试: `*.integration.test.ts`

## 结构

使用 Arrange-Act-Assert 模式：

```typescript
describe("OrderService", () => {
  describe("createOrder", () => {
    it("should create order when stock is available", async () => {
      // Arrange
      const mockProduct = createMockProduct({ stock: 10 });

      // Act
      const order = await orderService.createOrder(mockProduct.id, 1);

      // Assert
      expect(order.status).toBe("created");
    });
  });
});
```

## 覆盖率要求

- 业务逻辑: > 80%
- 工具函数: > 90%
- 路由/控制器: 可以较低

# 项目规范

## 代码质量

- 请写出高质量的代码。
- 代码应该是可读的。
- 使用有意义的变量名。
- 保持代码整洁。
- 遵循最佳实践。

# 项目规范

## TypeScript

- 使用 `interface` 定义对象结构，`type` 用于联合类型
- 禁止 `any`，使用 `unknown` + 类型守卫
- 函数参数 > 3 个时，使用对象参数

## 错误处理

```typescript
// 业务错误
throw new BusinessError("ORDER_NOT_FOUND", "订单不存在");

// 验证错误（Zod 自动抛出）
const data = orderSchema.parse(input);

// controller 中不要 try-catch
// 由全局错误中间件统一处理
```

## 为什么使用 Zod？

- TypeScript 只有编译时类型检查
- API 输入需要运行时验证
- Zod 可以同时生成 TS 类型和验证逻辑
- 错误信息自动生成，对用户友好

## 数据库操作规范

- 所有查询通过 Prisma ORM
- 复杂查询封装在 `src/repositories/`
- 禁止在 controller/service 中直接写 SQL
- 事务使用 `prisma.$transaction()`

## 创建新 API 端点

1. 在 `src/schemas/` 创建请求/响应 Zod schema
2. 在 `src/routes/` 添加路由定义
3. 在 `src/controllers/` 实现请求处理
4. 在 `src/services/` 实现业务逻辑
5. 在 `tests/` 添加测试用例

示例参考: `src/routes/orders.ts`

# 项目规范

## 核心

[精简的核心规范]

## 详细文档

- 数据库设计: 见 `docs/database.md`
- API 规范: 见 `docs/api-spec.md`
- 部署流程: 见 `docs/deployment.md`

touch CLAUDE.md

# 项目：React 电商前端

## 技术栈

- React 18 + TypeScript
- Vite 构建工具
- TanStack Query (数据获取)
- Zustand (状态管理)
- Tailwind CSS (样式)
- React Router v6 (路由)

## 目录结构

```

src/
├── components/ # 可复用组件
│ ├── ui/ # 基础 UI 组件
│ └── features/ # 功能组件
├── pages/ # 页面组件
├── hooks/ # 自定义 Hooks
├── stores/ # Zustand stores
├── api/ # API 调用
├── types/ # TypeScript 类型
└── utils/ # 工具函数

```

## 编码规范

### 组件规范

- 使用函数组件 + Hooks
- Props 使用 interface 定义，命名为 `ComponentNameProps`
- 组件文件使用 PascalCase：`ProductCard.tsx`
- 每个组件一个目录，包含 index.tsx 和样式

### 状态管理

- 全局状态使用 Zustand
- 服务器状态使用 TanStack Query
- 本地状态使用 useState/useReducer

### 样式规范

- 使用 Tailwind 工具类
- 复杂样式抽取为组件
- 响应式使用 sm/md/lg/xl 断点

## 常用命令

```bash
pnpm dev          # 启动开发服务器
pnpm build        # 构建生产版本
pnpm test         # 运行测试
pnpm lint         # 代码检查
pnpm preview      # 预览构建结果
```

## API 集成

- 基础 URL: `import.meta.env.VITE_API_URL`
- 使用 axios 实例，配置在 `src/api/client.ts`
- 所有 API 调用封装在 `src/api/` 目录

## Git 规范

- Commit: `type(scope): message`
- 分支: feature/_, bugfix/_, hotfix/\*
- PR 必须通过 CI 检查

touch CLAUDE.local.md
echo "CLAUDE.local.md" >> .gitignore

# 本地笔记

## 环境

- API: http://localhost:8080
- Mock: 使用 MSW

## 当前任务

- 重构购物车组件
- 截止: 本周五

mkdir -p .claude/rules

---
paths:
  - "src/**/*.test.tsx"
  - "src/**/*.test.ts"
---

# 测试规范

- 使用 Vitest + React Testing Library
- 测试文件放在同目录: `Button.test.tsx`
- 优先测试用户行为，而非实现细节

```typescript
// ✅ 好
expect(screen.getByRole("button")).toBeEnabled();

// ❌ 不好
expect(component.state.isLoading).toBe(false);
```

## 核心规范

[精简内容]

## 详细参考

- API 端点清单: @docs/api.md
- 数据库 Schema: @prisma/schema.prisma
- 部署配置: @docs/deploy.md

/memory

/memory edit         # 编辑项目级 CLAUDE.md
/memory edit user    # 编辑用户级记忆
/memory edit local   # 编辑本地级记忆

你：请记住，我们项目使用 pnpm 而不是 npm

Claude：好的，我可以将这个信息添加到项目的 CLAUDE.md 中。
        要我现在更新吗？