Skip to content

1634594707/DispatchFlow

BranchesTags

Repository files navigation

DispatchFlow

CI License: MIT Java Spring Boot Vue TypeScript version

DispatchFlow 是面向园区短驳配送场景的无人车调度平台。前端提供调度工作台、车辆监控、移动下单与运营分析界面；后端基于 Spring Boot 多模块组织订单、车辆、调度与园区设施。

在线演示：aplicity.online

项目全面总结

📘 项目全面总结 — 功能层面（12 大核心模块）+ 底层逻辑层面（技术架构 / 核心数据结构 / 关键算法 / 数据流转 / 技术决策）。新人上手与面试深挖首选文档。

目录

功能范围

模块 说明
订单与任务 移动端下单、订单查询、调度任务创建、任务列表与详情、改派与取消
调度工作台 任务池、自动派车、手动派车、改派、批量撤销、异常重新派单、暂停派单全局开关
车辆管理 车辆列表、车辆详情、车辆回报、8 状态运行态监控（在线/配送/前往充电/装卸/等待/充电/偏离/离线/手动接管）
园区基础设施 园区、站点（A/B/C 可信度）、服务位、路网（等级/通行语义/时间窗）、地理围栏、停车位、充电桩、换电柜
路线安全 起终点吸附、车辆包络碰撞校验、建筑 Polygon 障碍物膨胀、路线审计、路线健康指标
能源与异常 充电会话、换电会话、异常记录、异常处置、告警聚合
运营分析 运营概览、充电报表、自定义报表、报表历史、调度助手
系统管理 登录认证、用户管理、系统健康、集成配置、操作日志、通知设置
GIS 总览 L0/L1/L2 三层地图（产业带 10km / 试点 14 / 站点 16）、数字孪生轨迹回放
Fleet 集成 SIM / REAL 车辆链路、VDA5050 MQTT 配置与模拟脚本

技术栈

层级 技术
前端 Vue 3.5、TypeScript 5.7、Vite 6、Ant Design Vue 4.2、Pinia、Vue Router、高德地图 JS API、Leaflet、Axios、@fontsource 自托管字体、vite-plugin-pwa、Capacitor 6
后端 Java 21、Spring Boot 3.3.12、MyBatis-Plus、SpringDoc OpenAPI、Lombok、MapStruct、Flyway
数据与消息 MySQL、Redis、RabbitMQ、Mosquitto MQTT
工程化 Maven 多模块、ESLint、Prettier、vue-tsc、Playwright、JaCoCo、Checkstyle、SpotBugs
部署与运维 Docker Compose、GitHub Actions、GitHub Container Registry、Prometheus、Filebeat

系统架构

┌──────────────────────┐
│ front Vue SPA        │
│ 管理端 / 监控 / 移动端 │
└──────────┬───────────┘
           │ HTTP / SSE
┌──────────▼───────────┐
│ fsd-admin-api        │
│ 管理端聚合 API        │
└──────────┬───────────┘
           │
┌──────────▼────────────────────────────────────────────┐
│ back Maven modules                                     │
│ fsd-order / fsd-vehicle / fsd-dispatch / fsd-common    │
└──────────┬──────────────────────┬─────────────────────┘
           │                      │
┌──────────▼───────────┐  ┌───────▼────────┐
│ MySQL                │  │ Redis          │
│ 业务状态与 Flyway 迁移 │  │ Fleet 运行态    │
└──────────────────────┘  └───────┬────────┘
                                  │
                         ┌────────▼────────┐
                         │ RabbitMQ / MQTT │
                         │ 事件与车辆集成    │
                         └─────────────────┘

后端入口模块为 fsd-bootstrap。业务模块通过 Maven Reactor 一起构建，启动和测试命令必须使用 -pl fsd-bootstrap -am，确保依赖模块按当前源码参与构建。

项目结构

DispatchFlow/
├── back/                         后端 Maven 多模块工程
│   ├── fsd-common/               公共枚举、异常、响应模型、安全配置
│   ├── fsd-order/                订单域
│   ├── fsd-vehicle/              车辆域
│   ├── fsd-dispatch/             调度、Fleet、园区设施、事件、地理与 MAPF
│   ├── fsd-admin-api/            管理端聚合 API
│   ├── fsd-bootstrap/            Spring Boot 启动模块
│   ├── sql/init/                 数据库初始化入口
│   ├── sql/migrations/           Flyway 迁移脚本（V1 → V47）
│   ├── mqtt/                     Mosquitto 配置
│   └── observability/            Prometheus / Filebeat 配置
├── front/                        Vue 管理端与监控前端
│   ├── android/                  Capacitor Android 移动端工程
│   ├── src/api/                  前端 API 封装
│   ├── src/components/           通用与业务组件（含移动端组件）
│   ├── src/views/                页面视图（含移动端页面）
│   ├── src/stores/               Pinia 状态管理
│   ├── src/router/               路由配置
│   ├── public/icons/             车辆 8 状态与站点分类 SVG 图标
│   ├── scripts/e2e/              Playwright 端到端测试
│   └── scripts/perf/             性能与导航测试脚本
├── data/                         OSM、CARLA 与园区地理数据
├── docs/                         项目路线图、运维手册与治理文档
├── scripts/                      根级开发、验收、CARLA 与部署脚本
│   ├── carla/                    CARLA 仿真相关脚本
│   ├── dev/                      开发辅助脚本
│   ├── deploy.sh                 生产部署入口脚本
│   └── scan_encoding.py          UTF-8 编码扫描
├── .github/workflows/            CI、镜像发布、Release 工作流
├── docker-compose.yml            根级本地编排入口
├── docker-compose.prod.yml       生产编排（含 fsd-backend / fsd-frontend）
├── CHANGELOG.md                  版本变更记录
├── CONTRIBUTING.md               贡献说明
├── SECURITY.md                   安全说明
└── LICENSE                       MIT License

快速启动

环境要求

依赖 版本
JDK 21
Maven 3.9+
Node.js 20+
Docker 24+

1. 启动后端与基础设施

docker compose up -d

默认后端 API 地址为 http://localhost:8080。

如需本地源码方式启动后端：

cd back
mvn -pl fsd-bootstrap -am clean install -DskipTests
mvn -pl fsd-bootstrap spring-boot:run

2. 启动前端

cd front
npm install
npm run dev

默认前端地址为 http://localhost:3000，开发代理将 /api 转发到后端服务。

3. 登录信息

系统启动后，使用以下默认账号密码登录：

角色 用户名 密码 权限
系统管理员 admin admin123 完整权限，包括用户管理、系统配置、数据管理
调度员 operator operator123 调度操作权限，包括派车、改派、异常处理
观察员 viewer viewer123 只读权限，可查看监控和报表

注意：生产环境请务必修改默认密码！登录后可在系统管理页面修改密码。

4. 生产部署

参见 docs/DEPLOYMENT.md 获取完整部署流程、发布产物与回滚策略。核心步骤：

cd /opt/dispatchflow
cp .env.production .env
chmod 600 .env
bash scripts/deploy.sh
docker compose -f docker-compose.prod.yml ps
curl -fsS http://127.0.0.1:8080/internal/actuator/health

开发命令

后端

命令 说明
mvn -pl fsd-bootstrap -am test 运行后端测试
mvn -pl fsd-bootstrap -am verify -Pquality 运行后端质量门禁（Checkstyle / SpotBugs / JaCoCo）
mvn -pl fsd-bootstrap spring-boot:run 启动后端应用

前端

命令 说明
npm run dev 启动 Vite 开发服务
npm run build TypeScript 检查并构建生产包
npm run typecheck 仅运行 TypeScript 检查
npm run lint 运行 ESLint
npm run format:check 检查 Prettier 格式
npm run test:e2e 运行 Playwright 端到端测试（scripts/e2e）
npm run perf:nav 运行导航性能测试
npm run perf:lighthouse 运行 Lighthouse 路由性能脚本

质量门禁

GitHub Actions 已配置两条主要流水线：

Job 关键步骤
Backend Tests JDK 21、mvn -pl fsd-bootstrap -am test -B、mvn -pl fsd-bootstrap -am verify -Pquality -B、上传 JaCoCo 报告
Frontend Build Node.js 20、npm ci、npm run lint -- --max-warnings 50、npm run build、安装 Playwright Chrome、运行 npm run test:e2e

本地提交前建议至少运行：

cd front
npm run lint -- --max-warnings 50
npm run typecheck

cd ../back
mvn -pl fsd-bootstrap -am test

接口与入口

类型 地址
前端首页 http://localhost:3000
调度工作台 http://localhost:3000/workbench
调度看板 http://localhost:3000/dashboard
园区 GIS 总览 http://localhost:3000/gis/park
车辆监控 http://localhost:3000/vehicle-tracking
移动下单 http://localhost:3000/mobile/order
异常管理 http://localhost:3000/exceptions
数字孪生 http://localhost:3000/digital-twin
API 文档 http://localhost:8080/swagger-ui.html
OpenAPI JSON http://localhost:8080/api-docs

配置说明

文件 说明
.env.example 根级环境变量示例
.env.production 生产环境变量模板（部署时复制为 .env）
front/.env.example 前端环境变量示例
back/fsd-bootstrap/src/main/resources/application.yml 后端主配置
back/docker-compose.yml 后端目录内 Docker Compose 配置
back/docker-compose.mqtt.yml MQTT 相关 Compose 配置
back/docker-compose.observability.yml 可观测性相关 Compose 配置
back/docker-compose.ghcr.yml 镜像发布部署相关 Compose 配置

不要提交真实密钥、账号密码或本地 .env 文件。

版本与变更

当前版本：0.6.0（2026-07-19）。

本版本聚焦 ZJF 基地单一原点收敛、园区配置校正与端到端测试修复：

  • V44–V47 Flyway 迁移：扩展 ZJF 实际服务范围、清理历史演示数据、重置基地车辆坐标、修复零距离路线污染
  • E2E 测试修复：ant-design-vue 4.x Modal 选择器与 zhCN locale 适配，CI 全绿
  • 前端视觉规范：车辆 8 状态与站点 5 类 SVG 图标资源补齐
  • 文档治理：新增 11 份项目治理与运维文档，删除冗余 Python 部署脚本

完整变更记录见 CHANGELOG.md。

文档与治理

文件 说明
back/README.md 后端模块、启动、测试与 Docker 说明
front/README.md 前端页面、开发、构建与环境说明
docs/DEPLOYMENT.md 生产部署流程、发布产物与回滚策略
docs/坐标基准-叠石桥家纺城.md ZJF 基地坐标系与原点定义
docs/运维手册-园区配置与围栏设计.md 园区围栏设计与 L0/L1/L2 分层
docs/运维手册-评分权重与能量阈值.md 评分权重与能量阈值配置
docs/真实配送范围与地图视觉规范_2026-07-18.md 视觉规范 §1–§7
docs/DispatchFlow_最终更新路线图_2026-07-18.md P0/P1 优先级路线图
docs/DispatchFlow_生产运维清单_2026-07-18.md 生产运维检查清单
项目全面总结 功能 + 底层逻辑双维度总览（架构图 / 数据流转 / 关键算法 / 技术决策）
CHANGELOG.md 版本变更记录
CONTRIBUTING.md 贡献流程
SECURITY.md 安全问题报告方式

License

MIT License © 2026 DispatchFlow Contributors

About

DispatchFlow 是面向园区物流的无人车 FMS 调度中台（Java 21 + Vue 3）。覆盖下单→派车→执行→充电/换电→异常闭环，支持 SIM/REAL/VDA5050 车队、多园区、SSE 监控大屏、Webhook 开放集成与家纺垂直场景。演示：https://www.aplicity.online

www.aplicity.online

Topics

mysql redis devops spring-boot rabbitmq docker-compose self-hosted logistics fleet-management vue3 dispatch-system

Resources

Readme

License

MIT license

Contributing

Contributing

Security policy

Security policy
Activity

Stars

2 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases 3

v0.6.0 ZJF 基地原点收敛 + E2E 测试修复 + 文档治理 Latest
Jul 18, 2026
+ 2 releases

Packages

 
 
 

Contributors

Languages