仓库结构地图

公开版：仅说明各子项目职责与本地开发入口。部署、SSH、生产路径等见仓库内 .codebuddy/skills/ 或根目录 docs/，不对外发布。

monorepo/
├── chenyue-platform/          # 后端 API（FastAPI）
├── chenyue-flow/              # 编排控制台（Vue）
├── chenyue-flow-admin/        # 编排管理后台
├── chenyue-app/               # 生活类小程序（uni-app）
├── chenyue-official-web/      # 品牌官网（Vue）
├── chenyue-product/           # 本实践手册（VitePress）← 你在这里
├── chenyue-admin/             # 业务管理后台
├── docs/                      # 工程文档（仓库内，不全部同步到本站）
├── scripts/                   # 部署与运维脚本（勿在公开文档写死生产参数）
└── CONVENTIONS.md             # 工程约定

常用命令（本地开发）

场景	命令
后端 API	cd chenyue-platform && source .venv/bin/activate && uvicorn app.main:app --reload
品牌官网	cd chenyue-official-web && npm run dev
实践手册	cd chenyue-product && npm run dev
数据种子	cd chenyue-platform && python -m scripts.<name>

文档站端口（仅本地）

站点	默认端口	目录
实践手册	5207	chenyue-product/
品牌官网	5173	chenyue-official-web/

工程约定

写代码前请阅读仓库根目录 CONVENTIONS.md：

• user_id 使用 resolve_dev_user_id()，禁止硬编码
• 配置使用 get_settings()，禁止在业务代码里直接 os.getenv()
• 脚本使用 python -m scripts.xxx 形式执行