# 云超服 / PineAgents — 工作区

**云南省 OPC 超级个体综合服务平台（云超服）** 及其配套业务（园区大屏展播、OPC 培训体系、资料搜集）的工作区根目录。

> 目录按 **代码 / 设计 / 资料** 三桶分层，各仓库独立跟踪。详细约定见根目录 `CLAUDE.md`。

## 顶层结构

| 目录 | 说明 |
|------|------|
| `code/` | **代码**：`PineAgents`（核心端）、`PineAgentsServer`（总后端）、`PineAgentsWeb`（网页端）、`dpm`（园区大屏）、`bark-notify`（推送工具）、`opc-training`（培训系统代码） |
| `design/` | **设计与架构文档**：`云超服平台/`、`dpm/` |
| `materials/` | **资料/内容**：`培训计划/`（课程内容）、`搜集资料/`（云南 OPC 政策）、`园区数据资料/` |
| `reference/` | **参考源**：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化） |

## 快速入口

| 模块 | 命令 |
|------|------|
| 云超服后端 | `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 一律沿用 `code/PineAgents/console/` 主基调。
- 设计文档放 `design/`，代码放 `code/`，资料/内容放 `materials/`，不得混放。
- 各仓库独立提交；详细约定见根目录 `CLAUDE.md`。