|
|
@@ -2,43 +2,49 @@
|
|
|
|
|
|
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
|
|
|
-- 必须用中文回答
|
|
|
+## 项目文档架构
|
|
|
+
|
|
|
+本项目已按照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`
|