| adxp-adapter | ||
| deploy | ||
| doc | ||
| qaup-admin | ||
| qaup-collision | ||
| qaup-common | ||
| qaup-framework | ||
| qaup-generator | ||
| qaup-quartz | ||
| qaup-system | ||
| qaup-ui | ||
| scripts | ||
| sql | ||
| tools | ||
| .env.example | ||
| .gitignore | ||
| changelog.md | ||
| CLAUDE.md | ||
| IFLOW.md | ||
| mock.sh | ||
| pom.xml | ||
| qaup.sh | ||
| QWEN.md | ||
| README_WEBSOCKET.md | ||
| README.md | ||
| VERSION.md | ||
QAUP-Management 平台管理系统
机场无人车冲突管理平台,集成了机场冲突避免系统,提供完整的车辆管理、空间分析、实时监控等功能。
项目架构
本项目采用Maven多模块架构:
- qaup-admin: Web服务入口,集成所有模块
- qaup-framework: 核心框架,提供通用功能
- qaup-system: 系统管理模块,用户、角色、权限等
- qaup-collision: 冲突避免系统模块,提供空间分析、车辆监控、WebSocket实时通信等功能
- qaup-common: 公共工具类和基础组件
- qaup-quartz: 定时任务调度
- qaup-generator: 代码生成器
核心特性
🚗 冲突避免系统 (collision模块)
- 空间数据分析: 基于PostGIS的空间计算和几何分析
- 实时车辆监控: WebSocket实时位置数据推送和展示
- 机场区域管理: 跑道、滑行道、停机坪等区域配置和监控
- 冲突检测算法: 实时检测车辆与飞机、车辆间的潜在冲突
- 数据适配器: QuapDataAdapter统一数据访问,避免重复DAO开发
- Redis缓存: 高性能数据缓存和会话管理
🛠️ 系统管理功能
- 用户管理:用户是系统操作者,该功能主要完成系统用户配置。
- 部门管理:配置系统组织机构(公司、部门、小组),树结构展现支持数据权限。
- 岗位管理:配置系统用户所属担任职务。
- 菜单管理:配置系统菜单,操作权限,按钮权限标识等。
- 角色管理:角色菜单权限分配、设置角色按机构进行数据范围权限划分。
- 字典管理:对系统中经常使用的一些较为固定的数据进行维护。
- 参数管理:对系统动态配置常用参数。
- 通知公告:系统通知公告信息发布维护。
- 操作日志:系统正常操作日志记录和查询;系统异常信息日志记录和查询。
- 登录日志:系统登录日志记录查询包含登录异常。
- 在线用户:当前系统中活跃用户状态监控。
- 定时任务:在线(添加、修改、删除)任务调度包含执行结果日志。
- 代码生成:前后端代码的生成(java、html、xml、sql)支持CRUD下载 。
- 系统接口:根据业务代码自动生成相关的api接口文档。
- 服务监控:监视当前系统CPU、内存、磁盘、堆栈等相关信息。
- 缓存监控:对系统的缓存信息查询,命令统计等。
- 在线构建器:拖动表单元素生成相应的HTML代码。
- 连接池监视:监视当前系统数据库连接池状态,可进行分析SQL找出系统性能瓶颈。
技术栈
- 后端: Spring Boot 2.5.15 + MyBatis + JPA (Hibernate)
- 数据库: PostgreSQL + PostGIS (空间数据扩展)
- 缓存: Redis
- 实时通信: WebSocket + STOMP
- 空间计算: JTS + GeoTools
- 构建工具: Maven 3.6+
- Java版本: JDK 8
快速启动
1. 环境准备
# Java 8
java -version
# Maven 3.6+
mvn -version
# PostgreSQL + PostGIS
psql --version
# Redis
redis-server --version
2. 数据库配置
- 创建PostgreSQL数据库并启用PostGIS扩展
- 执行SQL初始化脚本:
sql/create_qaup_database.sql- 创建数据库sql/create_sys_vehicle_info_table.sql- 车辆信息表sql/create_sys_driver_info_table.sql- 司机信息表
3. 启动Redis服务
redis-server
4. 配置应用
修改 qaup-admin/src/main/resources/application.yml:
spring:
datasource:
url: jdbc:postgresql://localhost:5432/your_database
username: your_username
password: your_password
redis:
host: localhost
port: 6379
5. 编译和启动
# 清理并编译整个项目
mvn clean install
# 启动应用
cd qaup-admin
mvn spring-boot:run
# 或者运行打包后的jar
java -jar target/qaup-admin.jar
6. 访问系统
- 管理后台: http://localhost:8080
- WebSocket端点: ws://localhost:8080/ws
- API文档: http://localhost:8080/swagger-ui/
项目合并说明
本项目已将独立的CollisionAvoidanceSystem项目合并到若依框架中,通过以下方式实现:
- 模块化集成: 创建
qaup-collision模块,保持功能独立性 - 数据适配器:
QuapDataAdapter提供统一数据访问,连接若依Service层 - 配置整合: 将PostGIS、JPA、WebSocket等配置整合到若依配置体系
- 版本兼容: 降级Spring Boot版本,确保Java 8兼容性
开发指南
collision模块核心组件
QuapDataAdapter: 数据访问适配器,连接若依系统数据WebSocketConfig: WebSocket配置,支持实时数据推送VehicleLocationService: 车辆位置管理服务GeopositionController: WebSocket消息控制器
扩展开发
- 新增spatial实体时,继承spatial基类并配置PostGIS映射
- WebSocket消息通过
/topic前缀向客户端广播 - 使用
QuapDataAdapter获取车辆和司机数据,避免直接访问DAO
版本信息
- 当前版本: 1.0.1
- 更新日志: 详见
change_log.md