# docs/ CLAUDE.md

> 本文件为 Claude Code 提供上下文优化指引，避免每次加载完整文档。

## 文档加载指引

| 场景 | 加载文档 |
|------|----------|
| 了解项目是做什么的 | `01-用户需求.md` |
| 添加/修改功能 | `03-功能列表.md` + `02-产品需求.md` |
| 编写用户故事 | `04-用户故事.md` |
| 架构设计 | `07-系统架构.md` + `08-数据库设计.md` + `09-API契约.md` |
| 安全相关变更 | `02-产品需求.md`（安全性 NFR） |
| 查阅 Mermaid 图 | `13-Mermaid图集.md` |
| UI/前端开发 | `05-设计-UI.md` + `06-设计-UX.md` + 对应模块文件 |
| 术语不理解 | `11-工程规范.md`（术语表） |
| 部署相关 | `运维-部署实施.md` |
| 测试相关 | `10-测试-方案.md` + `测试-用例.md` |
| 发布追踪 | `运维-发布日志.md` |

## 关键约束速查

### 架构
- 模块独立性：各模块完全独立，禁止跨模块引用
- 通信方式：仅通过 REST API
- 数据库：SQLite 3.45+

### 编码规范
- 语言：Python 3.12+ / TypeScript（前端）
- 格式化：ruff format / ruff check
- 类型：mypy strict，禁止 Any
- 详见 `.claude/CLAUDE.md`

## 文件命名规范

docs/ 下所有 `.md` 文件使用**分类前缀**命名：
- 核心文档: `01-` ~ `12-` 编号前缀
- 设计文档: `设计-` 前缀
- 管理文档: `管理-` 前缀
- 运维文档: `运维-` 前缀
- 测试文档: `测试-` 前缀

描述部分使用中文，避免与前缀重复。仅 UI/UX 等通用缩写可保留英文。