CLAUDE.md

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

开发环境说明

多八多云端开发容器环境
Node.js 20.19.2
MySQL 8 (默认数据库: d8dai)
Redis 7
MinIO(默认存储桶: d8dai)
所有服务使用默认参数连接，正式环境参数相同
默认开放8080端口供外网访问

Project Standards & Rules

@.roo/rules/01-general.md - 通用开发规范
@.roo/rules/02-typescript.md - TypeScript规范
@.roo/rules/03-modules.md - 模块化规范
@.roo/rules/04-api.md - API开发规范
@.roo/rules/05-database.md - 数据库规范
@.roo/rules/06-service-di.md - 服务与依赖注入规范
@.roo/rules/07-openapi.md - OpenAPI规范
@.roo/rules/08-rpc.md - RPC调用规范
@.roo/rules/09-logging.md - 日志规范
@.roo/rules/10-entity.md - 实体定义规范
@.roo/rules/11-admin-frontend.md - 管理前端规范
@.roo/rules/11-custom-crud.md - 自定义CRUD规范
@.roo/rules/11-entity-creation.md - 实体创建规范
@.roo/rules/11-home-frontend.md - 首页前端规范
@.roo/rules/11-standard-crud.md - 标准CRUD规范
@.roo/rules/12-generic-crud.md - 通用CRUD规范
@.roo/rules/14-crud-filtering.md - CRUD筛选规范
@.roo/rules/15-user-tracking.md - 用户追踪规范

Claude Code

use pnpm
检查类型错误直接用pnpm typecheck检查整个项目，不要单独检查单个文件
数据库在同一容器组的另一个容器中，需要运行 mysql -h 127.0.0.1 -u root 来访问
vitest中，只有console.debug会显示，其他的都屏蔽了
vitest中，用import 来配合 vi.mocked，而不是require
e2e测试平常只运行 pnpm test:e2e:chromium 就行
e2e测试失败时先查看页面结构 test-results/**/error-context.md
前端是 hono/client hc rpc 的，不是直接fetch
bmad-core dir is in .bmad-core
必须用中文回答