DispatchFlow v3.0.0 — Phase 12–15 FMS 中台

对应 main 分支 70ec7cf 及之后稳定点。在 v2.0.0(Phase 10–11)基础上,交付 Phase 12–15 全量能力。

亮点

Phase 12–14

• 轨迹回放(含异常停留标注)、引擎级仿真、园区配置向导
• Webhook / Open API、PDF 与定时邮件报表、链路 KPI、高峰对比
• 家纺垂直:线路 CRUD、枢纽分流、旺季 cron、IF-THEN 自动化规则、换电柜管理
• 路网拖拽 MVP、FIELD_OPS 工单、运维快照大屏、TOTP 2FA

Phase 15

• REAL 换电:RealFleetSwapCoordinator + 低电/换电自动化规则
• VDA5050 MQTT:VehicleLinkMode.VDA5050、Mosquitto 联调栈、模拟 AGV 脚本
• 规模化:任务池 V20 索引、服务端分页(POST /admin/dispatch/task-pool/query)、Redis Fleet multiGet
• 云运维:UPDATE-OPERATIONS.md 更新手册

工程化

• Flyway baseline(V01–V20)、Swagger 全 Controller @Tag
• ESLint + Prettier、JaCoCo、Prometheus /actuator/prometheus
• 可选观测栈:docker-compose.observability.yml

数据库迁移

已有数据卷从 v2.0.0 升级需补跑 V15–V20(见 UPDATE-OPERATIONS.md §4)。

新部署:Docker MySQL 首次 init 或应用 Flyway 启动均可。

GitHub Packages(容器镜像)

docker pull ghcr.io/1634594707/dispatchflow:v3.0.0
cd back
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up -d

部署(本地构建)

git pull origin main
git checkout v3.0.0
# 补跑缺失迁移(见 UPDATE-OPERATIONS.md)
cd back && docker compose build fsd-core-server && docker compose up -d
cd front && npm ci && npm run build

验收

• GET /api/health · Swagger UI /swagger-ui.html
• VDA5050:cd back && docker compose -f docker-compose.mqtt.yml up -d + python scripts/vda5050-sim-agv.py
• 工作台任务池「加载更多」、Fleet SSE 监控正常

下一版本

V3 路线图(MAPF、覆盖率 80%、可观测性深化)见 ROADMAP-V2.md 第二节。

DispatchFlow v2.0.0 — Phase 10–11 (M1)

首个正式 GitHub Release,对应 main 分支提交 f9da7f3 。

亮点

• Phase 10:命令面板(Ctrl+K)、全局搜索、调度快捷指令、数字孪生态势页、系统健康检查
• Phase 11 (M1):全站园区上下文(Park Scope 2.0)、VIEWER 只读对齐、派车失败可解释、交通管制 MVP(区域暂停 + 路段降权)

新增 API(管理端)

数据库迁移

从 V13b 升级只需补跑:

docker cp back/sql/migrations/V14__ensure_default_park_active.sql fsd-mysql:/tmp/V14.sql
docker exec fsd-mysql sh -c "mysql -uroot -p<密码> --default-character-set=utf8mb4 fsd_core < /tmp/V14.sql"

已有 MySQL 数据卷时 不要 docker compose down -v。完整步骤见 DEPLOYMENT.md。

部署(Docker)

git pull origin main
# 执行 V14(见上)
cd back && docker compose build --no-cache fsd-core-server && docker compose up -d fsd-core-server
cd front && npm ci && npm run build

验收

• GET /api/health 返回正常
• 顶栏切换园区后,车辆/异常/分析列表一致过滤
• 派车失败展示 reasonCode 与建议
• /infrastructure/traffic 可框选管制区

完整变更

89 files changed, +4188 / -719 lines(相对 Phase 5–9 基线 4cd7eaa)。

路线图:ROADMAP-V2.md · 下一里程碑:Phase 12(地图化编辑、轨迹回放)。