慧行引擎开发路线图 (Development Roadmap)
创建日期: 2026-03-18 版本: V1.0 状态: 执行中
📅 阶段划分与里程碑
Phase 0: 基础设施与文档 (2026-03-18)
目标: 建立协作规范，确保后续开发不踩重复坑，文档齐全。
- 创建
TASKS.md(任务总览) - 创建
help/文档目录 - 编写
help/DEPLOY.md(部署指南) - 编写
help/PITFALLS.md(踩坑记录 - 强制更新) - 编写
help/CONFIG_GUIDE.md(工程配置操作手册) - 创建
pre-flight-check.sh(环境预检脚本)
Phase 1: 核心数据与种子 (2026-03-19 ~ 20)
目标: 让数据库“活”起来，拥有可演示的真实数据。
- 模块 A: 数据库模型升级 (加入财务/资源字段) - 已完成
- 模块 B: 种子数据生成器
- 编写
qinghuayuan.seeder.ts(清华园模板) - 编写
anhui15th.seeder.ts(安徽省十五五模板) - 编写
sunset_red.seeder.ts(夕阳红模板) - 编写
startup.seeder.ts(创业工程模板)
- 编写
- 模块 C: 基础 API 增强
- 批量导入 API (
POST /api/v1/engineering/import) - 批量导出 API (
GET /api/v1/engineering/export)
- 批量导入 API (
Phase 2: 多后台后端 (2026-03-21 ~ 25)
目标: 实现四个后台的核心 API。
- 模块 D: 系统总控台 API (模板管理/分片路由)
- 模块 E: 用户中心 API (Auth/子账号/权限)
- 模块 F: 工程配置台 API (可视化编排后端支持)
- 模块 G: 工程运行台 API (日常操作/报表)
Phase 3: 前端与演示 (2026-03-26 ~ 30)
目标: 让演示成为可能。
- 模块 H: 四台前端界面 (React/Vue MVP)
- 模块 I: AI 分析引擎 (进度预测/风险预警)
- 模块 J: 插件系统 (ERP 适配器原型)
🚀 当前工作重点 (Today: 2026-03-18)
- 完成文档体系搭建 (
help/,TASKS.md,PITFALLS.md) - 重启 API 容器，应用数据库变更 (模块 A)
- 验证数据库字段已更新 (
budget,actual_cost等) - 开始编写种子数据生成器 (模块 B - 清华园部分)
📊 进度追踪
| 模块 | 状态 | 进度 | 备注 |
|---|---|---|---|
| 文档体系 | ✅ 完成 | 100% | 踩坑机制已建立 |
| 数据库升级 | ✅ 完成 | 100% | 实体类已更新 |
| 种子数据生成 | 🟡 进行中 | 10% | 准备编写脚本 |
| 四台后端 API | ⚪ 待开始 | 0% | 等待 Phase 1 完成 |
| 前端界面 | ⚪ 待开始 | 0% | - |
🎯 下一个里程碑
时间: 2026-03-20 23:59 目标: 完成 4 个种子数据生成脚本，API 可返回完整的工程树（含财务数据）。 验收标准: 老周可以通过 API 看到“清华园 5021 工程”的完整树形结构，包含预算和实际花费。
持续更新中...