# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目文档架构

本项目已按照BMAD架构规范重新组织文档结构。所有开发规范、技术栈和架构文档已迁移到 `docs/architecture/` 目录中。

### 主要架构文档
- **主架构文档**: `docs/architecture.md` - 完整的架构概述和索引
- **分片架构文档**: `docs/architecture/` - 详细的架构分片文档
- **开发时始终加载**:
  - `docs/architecture/coding-standards.md` - 编码标准
  - `docs/architecture/tech-stack.md` - 技术栈
  - `docs/architecture/source-tree.md` - 源码树结构

### 开发规范文档
详细的开发规范已整合到 `docs/architecture/development-standards.md`，包含：
- 开发环境说明
- 项目标准和规范（引用 `.roo/rules/` 目录中的规范文件）
- Claude Code开发工具配置

### 开发工作流
开发工作流和命令参考 `docs/architecture/development-workflow.md`

## Claude Code特定配置

### 语言要求
- 必须用中文回答

### 项目结构
- BMAD核心目录在 `.bmad-core`

### 包管理器
- 使用 `pnpm` 作为包管理器

### 类型检查
- 检查类型错误直接用 `pnpm typecheck` 检查整个项目，不要单独检查单个文件

### 数据库访问
- 数据库在同一容器组的另一个容器中，需要运行 `mysql -h 127.0.0.1 -u root` 来访问

### 测试相关
- **Vitest配置**: 只有 `console.debug` 会显示，其他的都屏蔽了
- **Mock导入**: 用 `import` 来配合 `vi.mocked`，而不是 `require`
- **E2E测试**: 平常只运行 `pnpm test:e2e:chromium` 就行
- **E2E调试**: 测试失败时先查看页面结构 `test-results/**/error-context.md`

### 前端开发
- 前端使用 `hono/client` 的 `hc` RPC 调用，不是直接 `fetch`