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