# {模块名称}

> **负责人**: {团队/个人}
> **状态**: 🟢 Active / 🚧 In Development / 📋 Planning / ⚠️ Deprecated
> **最后更新**: YYYY-MM-DD

---

## 模块概述

{2-3句话说明模块的核心功能和业务价值}

## 文档导航

| 文档 | 用途 | 何时读取 | 状态 |
|------|------|---------|------|
| [01-prd](./01-prd.md) | 功能边界、权限矩阵、边界规则、验收标准 | 任何任务前先读，明确做什么不做什么 | ✅ / 🚧 |
| [02-user-journey](./02-user-journey.md) | 用户场景、正常/异常路径 | 实现用户交互或编写 E2E 时 | ✅ / 🚧 |
| [03-architecture](./03-architecture.md) | 技术分层、组件职责、实施阶段 | 开始实现前确认架构和实施顺序 | ✅ / 🚧 |
| [04-state-machine](./04-state-machine.md) | 状态转换规则、守卫条件、异常路径 | 涉及状态流转的实现或测试时 | ✅ / 🚧 |
| [05-ui-spec](./05-ui-interaction-spec.md) | 页面结构、组件、交互行为 | 前端页面开发时 | ✅ / 🚧 |
| [06-data-model](./06-data-model.md) | 数据结构、字段定义、约束关系 | 涉及 schema 变更或数据查询时 | ✅ / 🚧 |
| [07-api](./07-api.md) | API 端点、请求/响应类型签名、权限 | 实现或调用 API 时 | ✅ / 🚧 |
| [08-error-codes](./08-error-codes.md) | 错误码定义、触发条件 | 实现错误处理或编写异常测试时 | ✅ / 🚧 |
| [09-test-scenarios](./09-test-scenarios.md) | 测试场景清单（覆盖面） | 编写集成测试时 | ✅ / 🚧 |
| [10-e2e-test-spec](./10-e2e-test-spec.md) | E2E 执行编排（操作步骤） | 执行 E2E 测试时 | ✅ / 🚧 |

> **加载原则**：不需要全部读取。根据"何时读取"列按需加载，减少上下文占用。

## 代码与数据位置

- **前端**: `frontend/src/app/{module}/` 或 `frontend/src/components/{module}/`
- **后端**: `backend/src/modules/{module}/`
- **数据库**: `{schema}.{table}`（如 `platform_performance.perf_cycles`）