51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# 后台管理系统执行计划（独立项目）
|
||
|
||
## 目标
|
||
- 建立独立的后台管理系统，用于对现有 App 数据进行 CRUD 管理。
|
||
- 仅使用管理员角色，不做多角色权限体系。
|
||
- 当前阶段不考虑软删除与审计日志。
|
||
|
||
## 范围与边界
|
||
- 后台管理系统前端单独开发，不在本仓库落地。
|
||
- 本仓库后端若需补齐管理能力，只新增接口，不影响现有 App 侧接口。
|
||
- 以“可用、稳定、可维护”为交付标准，优先覆盖核心数据。
|
||
|
||
## 里程碑与阶段
|
||
### 阶段 0：需求与字段确认
|
||
- 交付物：管理端功能清单、字段字典、角色定义（仅管理员）。
|
||
- 重点确认：哪些数据允许删除、哪些字段允许编辑、是否需要导出。
|
||
|
||
### 阶段 1：接口盘点与差距分析
|
||
- 交付物：现有 API 清单与管理端需求映射表。
|
||
- 结论预期：当前接口以“用户本人”为作用域，管理端需要跨用户访问能力。
|
||
|
||
### 阶段 2：管理端 API 设计
|
||
- 交付物：管理端 API 规范。
|
||
- 约定：统一路径前缀建议为 `/api/admin/*`。
|
||
- 约定：统一分页字段 `page`、`per_page`，统一筛选方式（query）。
|
||
|
||
### 阶段 3：后端能力补齐（如需）
|
||
- 交付物：管理员鉴权、跨用户 CRUD、内容管理写接口、缓存失效策略。
|
||
- 风险控制：只新增接口，不改动现有用户侧行为。
|
||
|
||
### 阶段 4：管理端前端工程建设（独立仓库）
|
||
- 交付物：登录、用户、宝宝、成长、预约、内容、聊天管理页面。
|
||
- 规范：统一分页、筛选、详情展示、表单校验。
|
||
|
||
### 阶段 5：联调与验收
|
||
- 交付物：联调清单、验收记录、问题关闭清单。
|
||
- 重点：权限隔离、分页与筛选稳定性、关键字段一致性。
|
||
|
||
## 风险与对策
|
||
- 风险：管理端操作可能影响 App 侧数据一致性。
|
||
- 对策：操作前确认字段范围，新增接口遵循现有模型与数据约束。
|
||
|
||
## 回滚方式
|
||
- 仅为文档规划与外部系统开发，不影响现有运行。
|
||
- 若后端新增管理端 API，可通过禁用蓝图注册或环境开关关闭。
|
||
|
||
## 交付物清单
|
||
- 管理端执行计划文档（本文件）。
|
||
- 管理端 API 文档（见 `docx/API_REFERENCE.md`）。
|
||
- 项目说明（见 `docx/PROJECT_OVERVIEW.md`）。
|