# design/ — 项目设计与架构文档

本目录集中存放云超服工作区内的**设计与架构文档**，按「代码 / 设计 / 资料」分桶规范与 `code/`（代码）、`materials/`（资料内容）隔离。

> 新增设计 / 架构 / 规范文档一律放本目录，不要放入 `code/` 或 `materials/`。

## 子目录索引

| 子目录 | 内容 |
|--------|------|
| `云超服平台/` | 云超服平台的设计与架构文档：顶层总览 `DESIGN.md`、系统方案、身份体系、全量方案、架构推演、组件规范、`任务类别.json`。 |
| `dpm/` | 园区大屏系统（DPM）的运维 / 部署 / 控制文档：Windows 部署、更新接口、实时语音、MQTT 手册、ESP32。 |

## 云超服平台设计文档

- `DESIGN.md` — 平台**顶层系统设计总览**（简洁版）。
- `云南省OPC超级个体综合服务平台（云超服）系统设计方案.md` — **主设计文档**。
- `云超服平台全量方案设计.md` — 构建蓝图（身份体系、六端口、状态机、数据模型、接口设计）。
- `身份体系与端口权限设计方案.md` — 多身份 / 六端口账号与 RBAC + 数据范围模型。
- `架构初步设计.md` — 分阶段架构推演。
- `Creative-Cards-DESIGN.md` — Creative Cards 组件设计规范。
- `任务类别.json` — 任务撮合分类数据（种子/参考数据）。

## DPM 系统文档

- `win-deploy.md`（Windows 部署 / 地址覆盖）、`update-check.md`（更新接口）、`voice-integration-plan.md`（实时语音）、`mqtt-commands.md`（MQTT 控制手册）、`esp32-ir-control.md`（ESP32 遥控）。

## 关联位置

- 代码实现见 `code/`（DPM → `code/park-desktop/`，权威后端说明 `code/park-desktop/backend/README.md`）。
- 培训系统的代码 / 内容说明见 `materials/培训计划/`。