@@ -0,0 +1,43 @@
|
||||
# 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 等通用缩写可保留英文。
|
||||
Reference in New Issue
Block a user