Refactor code structure and optimize performance across multiple modules

README.md

@@ -1,25 +1,30 @@
 # 云超服 / PineAgents — 工作区
 
-**OPC 超级个体综合服务平台（云南省 OPC 超级个体综合服务平台，云超服）** 的代码工作区。多仓库组合：后端、核心端、网页展示端彼此独立。
+**云南省 OPC 超级个体综合服务平台（云超服）** 及其配套业务（园区大屏展播、OPC 培训体系、资料搜集）的工作区根目录。
 
-## 组成
+> 目录按 **代码 / 设计 / 资料** 三桶分层，各仓库独立跟踪。详细约定见根目录 `CLAUDE.md`。
 
-- **`PineAgentsServer/`** — 总后端（FastAPI，uv 管理）。
-- **`PineAgents/`** — 核心部分：前端 / 桌面端 / CLI 端，含 UI 基调来源 `console/`。
-- **`PineAgentsWeb/`** — 网页展示端口（Vite + React 静态站，SPA）。
-- **`reference/`** — 参考：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化）。
-- **`docs/`** — 整体设计与相关文档。
+## 顶层结构
+
+| 目录 | 说明 |
+|------|------|
+| `code/` | **代码**：`PineAgents`（核心端）、`PineAgentsServer`（总后端）、`PineAgentsWeb`（网页端）、`dpm`（园区大屏）、`bark-notify`（推送工具）、`opc-training`（培训系统代码） |
+| `design/` | **设计与架构文档**：`云超服平台/`、`dpm/` |
+| `materials/` | **资料/内容**：`培训计划/`（课程内容）、`搜集资料/`（云南 OPC 政策）、`园区数据资料/` |
+| `reference/` | **参考源**：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化） |
 
 ## 快速入口
 
 | 模块 | 命令 |
 |------|------|
-| 后端 | `cd PineAgentsServer && uv sync && uv run uvicorn app.main:app --port 8090 --reload` |
-| 核心 console | `cd PineAgents/console && yarn dev` |
-| 网页展示端 | `cd PineAgentsWeb && pnpm install && pnpm run dev` |
+| 云超服后端 | `cd code/PineAgentsServer && uv sync && uv run uvicorn app.main:app --port 8090 --reload` |
+| 核心 console | `cd code/PineAgents/console && yarn dev` |
+| 网页展示端 | `cd code/PineAgentsWeb && pnpm install && pnpm run dev` |
+| 园区大屏后端 | `cd code/dpm/backend && uv run python main.py` |
+| 培训后端 | `cd code/opc-training/server && uv run uvicorn app.main:app --port 8091 --reload` |
 
 ## 约定
 
-- 前端 UI 一律沿用 `PineAgents/console/` 主基调。
-- 整体设计文档放 `docs/`。
+- 前端 UI 一律沿用 `code/PineAgents/console/` 主基调。
+- 设计文档放 `design/`，代码放 `code/`，资料/内容放 `materials/`，不得混放。
 - 各仓库独立提交；详细约定见根目录 `CLAUDE.md`。