opc-backup/README.md

云超服 / 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。