# WonderQ 文档索引

本目录只保留当前有效文档，用于支撑 `WonderQ-Admin`、`WonderQ-Admin-UI`、`WonderQ-MiniAPP` 三端并行开发和联调。非当前技术路径不放在当前文档集中。

## 推荐阅读路径

后端开发：

1. `backend-api-service.md`
2. `backend-plan.md`
3. `admin-api-requirements.md`
4. `module-config-api.md`
5. `public-api.md`

管理前端开发：

1. `integration-workflow.md`
2. `admin-api-requirements.md`
3. `module-config-api.md`
4. `development-status.md`

MiniAPP 前台开发：

1. `integration-workflow.md`
2. `public-api.md`
3. `development-status.md`

## 文档清单

| 文档 | 作用 | 主要读者 |
| --- | --- | --- |
| `integration-workflow.md` | 三端本地启动、联调顺序、接口变更流程和验证命令 | 全部 |
| `development-status.md` | 三端能力对接状态矩阵和优先联调路径 | 全部 |
| `decisions.md` | 当前有效技术和文档决策 | 全部 |
| `backend-api-service.md` | 后端 API 服务运行与前端联调说明 | 后端 |
| `backend-plan.md` | 当前 FastAPI 后端定位、业务模块、近期优先级和安全部署原则 | 后端 |
| `admin-api-requirements.md` | Admin UI 必需的 Admin API 主契约 | 后端、管理前端 |
| `module-config-api.md` | 页面模块配置 CRUD 的唯一细节契约 | 后端、管理前端 |
| `public-api.md` | MiniAPP 对接后端的 Public API 契约 | 后端、MiniAPP |

## 文档边界

- `public-api.md` 是 MiniAPP 对接后端的唯一 Public API 契约。
- `admin-api-requirements.md` 是 Admin UI 对接后端的主契约。
- `module-config-api.md` 是页面模块 CRUD 细节的唯一权威文档。
- `integration-workflow.md` 只写联调流程，不重复接口字段。
- `development-status.md` 只记录当前状态，不替代测试结果。
- `decisions.md` 只记录当前有效决策。

## 安全约束

- 文档示例不得写入真实 Token、JWT secret、客服链接、企业 ID、手机号或生产环境变量值。
- `.env`、`.env.local` 和生产配置不进入文档目录。
- 涉及重置数据、发布、回滚、迁移或生产操作的文档，需要明确风险和验证方式。