慧行引擎开发任务总览 (Master Task List)

版本: V2.0 (模块化协作版) 最后更新: 2026-03-18 状态: 开发中

0. 协作原则

模块化: 每个模块独立文档、独立开发、独立测试。
上下文无关: 新加入的智能体（如二龙、三龙）只需阅读对应模块文档即可开工，无需阅读整个项目历史。
数据驱动: 先有数据结构，后有业务逻辑，最后才是界面。
踩坑必填: 遇到任何问题，必须先更新 help/PITFALLS.md，再解决问题。

0.1 开发推进计划 (Roadmap)

阶段	时间窗口	核心目标	关键交付物	负责人
Phase 0: 基建	2026-03-18	文档体系、部署流程、踩坑机制	`help/` 文档集、`PITFALLS.md`	一龙
Phase 1: 内核	2026-03-19 ~ 20	数据库升级、种子数据生成	4 大模板数据、CLI 生成器	一龙
Phase 2: 后端	2026-03-21 ~ 25	四台后端 API 实现	用户/配置/运行/总控 API	一龙/二龙
Phase 3: 前端	2026-03-26 ~ 30	四台前端界面 (MVP)	Web 管理后台、C 端 H5	二龙/三龙
Phase 4: 智能	2026-04-01 ~	AI 分析、插件系统	进度预测、ERP 适配器	待定

当前阶段: Phase 0 (收尾) -> Phase 1 (即将开始)

1. 阶段划分

阶段一：核心数据与种子 (Current Phase)

模块 A: 数据库模型升级 (财务/资源字段)
模块 B: 种子数据生成器 (CLI 脚本)
- 清华园工程模板 (含财务/资源节点)
- 安徽省十五五规划模板
- 夕阳红工程模板
- 创业工程模板
模块 C: 基础 API 增强 (批量导入/导出)

阶段二：多后台后端 (Backend for Portals)

模块 D: 系统总控台 API (模板管理/分片路由)
模块 E: 用户中心 API (Auth/子账号/权限)
模块 F: 工程配置台 API (可视化编排后端支持)
模块 G: 工程运行台 API (日常操作/报表)

阶段三：前端与智能 (Frontend & AI)

模块 H: 四台前端界面 (React/Vue)
模块 I: AI 分析引擎 (进度预测/风险预警)
模块 J: 插件系统 (ERP 适配器)

阶段零：基础设施与文档 (Infrastructure & Docs) - 正在进行

模块 0.1: 开发任务文档体系建立
模块 0.2: 部署与运维文档 (help/DEPLOY.md)
模块 0.3: 工程配置操作手册 (help/CONFIG_GUIDE.md)
模块 0.4: 生产环境部署脚本 (CI/CD)

2. 模块索引

模块 ID	模块名称	优先级	状态	负责人	文档链接
0.1	开发任务文档体系	P0	已完成	一龙	查看
0.2	部署与运维文档	P0	进行中	一龙	查看
0.3	工程配置操作手册	P0	进行中	一龙	查看
A	数据库模型升级	P0	已完成	一龙	查看文档
B	种子数据生成器	P0	待开始	一龙	查看文档
C	基础 API 增强	P1	待开始	-	-
D	系统总控台 API	P1	待开始	-	-
E	用户中心 API	P1	待开始	-	-
F	工程配置台 API	P2	待开始	-	-
G	工程运行台 API	P2	待开始	-	-
H	四台前端界面	P3	待开始	-	-
I	AI 分析引擎	P3	待开始	-	-
J	插件系统	P4	待开始	-	-

3. 快速启动指令

# 进入项目目录
cd /root/.openclaw/workspace/huixing-engine

# 查看 Docker 状态
docker compose ps

# 查看 API 日志
docker compose logs -f api

# 运行种子数据生成器 (模块 B)
npm run seed:qinghuayuan
npm run seed:anhui15th

注：具体开发请查阅 docs/ 目录下的详细模块文档。