#CLAUDE.md 与项目约定

# CLAUDE.md

## 项目概述

这是一个基于 Next.js 的电商平台，使用 PostgreSQL 数据库。

## 常用命令

- `npm run dev` — 启动开发服务器
- `npm run build` — 构建生产版本
- `npm test` — 运行所有测试
- `npm run test:watch` — 监听模式运行测试
- `npm run lint` — 检查代码规范

## 代码规范

- 使用 TypeScript strict 模式
- 组件使用函数式写法，不用 class
- 样式使用 Tailwind CSS，不写自定义 CSS
- API 路由放在 app/api/ 目录下

## 项目结构

- `src/app/` — Next.js App Router 页面
- `src/components/` — 可复用组件
- `src/lib/` — 工具函数和配置
- `src/hooks/` — 自定义 React hooks
- `prisma/` — 数据库 schema 和迁移

## 代码规范

- 写清晰的代码
- 添加适当的注释
- 处理错误情况

## 代码规范

- 错误统一用 AppError 类抛出，不用原生 Error
- API 响应格式统一为 { code, data, message }
- 数据库查询必须用 Prisma，不用原生 SQL

## 常用命令

- `pnpm dev` — 启动开发（注意用 pnpm 不是 npm）
- `pnpm test -- --watch` — 监听测试
- `pnpm db:migrate` — 运行数据库迁移
- `pnpm db:seed` — 填充测试数据

## 约定

- 路由文件命名用 kebab-case（如 user-profile.ts）
- 组件文件命名用 PascalCase（如 UserProfile.tsx）
- 数据库表名用 snake_case（如 user_profiles）
- API 路径用 kebab-case（如 /api/user-profiles）

# CLAUDE.md

本文件为 Claude Code (claude.ai/code) 提供项目上下文。

## 项目概述

基于 Next.js 14 的 SaaS 应用，多租户架构。

## 技术栈

- Next.js 14 (App Router)
- TypeScript (strict)
- Prisma + PostgreSQL
- Tailwind CSS
- NextAuth.js

## 常用命令

- `pnpm dev` — 开发服务器
- `pnpm build` — 生产构建（会运行类型检查）
- `pnpm test` — 运行测试
- `pnpm test src/path/to/file.test.ts` — 运行单个测试文件
- `pnpm lint` — ESLint 检查
- `pnpm db:push` — 同步 schema 到数据库
- `pnpm db:studio` — 打开 Prisma Studio

## 架构说明

- 所有页面组件在 app/ 目录下，使用 Server Components 优先
- 客户端组件用 'use client' 标记
- API 路由在 app/api/ 下，统一用 Route Handlers
- 数据库操作通过 Prisma Client，放在 lib/db.ts

## 代码规范

- 禁止使用 any 类型
- 组件 props 必须定义 interface
- 错误处理用 try-catch，不用 .catch()
- 样式用 Tailwind，不写自定义 CSS
- 提交信息用英文，格式：type(scope): description