# 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缓存**: 高性能数据缓存和会话管理

### 🛠️ 系统管理功能

1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3. 岗位管理：配置系统用户所属担任职务。
4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7. 参数管理：对系统动态配置常用参数。
8. 通知公告：系统通知公告信息发布维护。
9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 登录日志：系统登录日志记录查询包含登录异常。
11. 在线用户：当前系统中活跃用户状态监控。
12. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
13. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。
14. 系统接口：根据业务代码自动生成相关的api接口文档。
15. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
16. 缓存监控：对系统的缓存信息查询，命令统计等。
17. 在线构建器：拖动表单元素生成相应的HTML代码。
18. 连接池监视：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。

## 技术栈

- **后端**: Spring Boot 2.5.15 + MyBatis + JPA (Hibernate)
- **数据库**: PostgreSQL + PostGIS (空间数据扩展)
- **缓存**: Redis
- **实时通信**: WebSocket + STOMP
- **空间计算**: JTS + GeoTools
- **构建工具**: Maven 3.6+
- **Java版本**: JDK 8

## 部署指南

### 方式一：自动部署（推荐）

使用提供的自动化部署脚本：

```bash
# 1. 进入部署目录
cd deploy/

# 2. 赋予执行权限
chmod +x deploy-all.sh

# 3. 执行自动部署
./deploy-all.sh
```

自动化部署脚本将自动完成：

- ✅ 环境检查和依赖验证
- ✅ Docker及Docker Compose安装检查
- ✅ 磁盘空间检查（至少3GB）
- ✅ 端口占用检测
- ✅ Docker镜像处理（本地载入或在线拉取）
- ✅ 冲突容器清理
- ✅ 数据目录创建和权限设置
- ✅ 配置文件验证
- ✅ 基础设施服务启动（PostgreSQL + PostGIS、Redis）
- ✅ 应用服务启动和数据库迁移
- ✅ 健康状态检查和验证

### 方式二：手动部署

#### 1. 环境准备

**必需组件：**

```bash
# Java 8+
java -version

# Maven 3.6+
mvn -version

# Docker & Docker Compose
docker --version
docker-compose --version
```

**可选组件（用于本地开发）：**

```bash
# PostgreSQL + PostGIS（用于本地开发）
psql --version

# Redis（用于本地开发）
redis-server --version
```

#### 2. 数据库配置

**Docker启动数据库：**

```bash
# 启动PostgreSQL + PostGIS
docker run -d \
  --name qaup-postgres \
  -e POSTGRES_DB=qaup \
  -e POSTGRES_USER=qaup \
  -e POSTGRES_PASSWORD=qaup123 \
  -e POSTGRES_INITDB_ARGS="--encoding=UTF-8 --lc-collate=C --lc-ctype=C" \
  -p 5432:5432 \
  m.daocloud.io/docker.io/postgis/postgis:17-3.5-alpine

# 启动Redis
docker run -d \
  --name qaup-redis \
  -e REDIS_PASSWORD=qaup123 \
  -p 6379:6379 \
  m.daocloud.io/docker.io/library/redis:8.0-alpine redis-server --requirepass qaup123
```

**本地数据库初始化：**

1. 执行SQL初始化脚本：

   ```bash
   # 创建数据库和基础表
   psql -U qaup -d qaup -f sql/create_qaup_database.sql
   psql -U qaup -d qaup -f sql/create_sys_vehicle_info_table.sql
   psql -U qaup -d qaup -f sql/create_sys_driver_info_table.sql
   ```

#### 3. 环境配置

**更新应用配置：**
修改 `qaup-admin/src/main/resources/application.yml`:

```yaml
spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/qaup
    username: qaup
    password: qaup123
    driver-class-name: org.postgresql.Driver
  redis:
    host: localhost
    port: 6379
    password: qaup123
    database: 0
```

**环境变量配置：**
确保各模块 `.env` 文件配置正确：

- `adxp-adapter/.env.example` - ADXP数据中台适配器配置
- `qaup-admin/.env.example` - 主应用配置

#### 4. 编译和启动

```bash
# 1. 清理并编译整个项目
mvn clean install

# 2. 进入管理模块
cd qaup-admin

# 3. 启动应用（开发模式）
mvn spring-boot:run

# 或打包启动（生产模式）
mvn clean package -DskipTests
java -jar target/qaup-admin.jar
```

#### 5. 验证部署

**服务状态检查：**

```bash
# 检查应用健康状态
curl http://localhost:8080/actuator/health

# 检查数据库连接
docker exec qaup-postgres pg_isready -U qaup

# 检查Redis连接
docker exec qaup-redis redis-cli -a qaup123 ping
```

### 6. 系统访问

- **管理后台**: <http://localhost:8080>
- **初始登录**:
  - 用户名: `admin`
  - 密码: `admin123`
- **WebSocket端点**: ws://localhost:8080/ws
- **API文档**: <http://localhost:8080/swagger-ui/>
- **健康检查**: <http://localhost:8080/actuator/health>

### 7. 管理命令

```bash
# 查看服务状态
docker compose ps

# 查看应用日志
docker compose logs -f qaup-app

# 查看数据库日志
docker compose logs -f qaup-postgres

# 查看Redis日志
docker compose logs -f qaup-redis

# 重启应用
docker compose restart qaup-app

# 停止所有服务
docker compose down

# 查看数据库迁移状态
docker exec qaup-postgres psql -U qaup -d qaup -c \
  "SELECT version,description FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 5;"

# 清理Docker资源
docker system prune -a
```

## 项目合并说明

本项目已将独立的CollisionAvoidanceSystem项目合并到若依框架中，通过以下方式实现：

1. **模块化集成**: 创建`qaup-collision`模块，保持功能独立性
2. **数据适配器**: `QuapDataAdapter`提供统一数据访问，连接若依Service层
3. **配置整合**: 将PostGIS、JPA、WebSocket等配置整合到若依配置体系
4. **版本兼容**: 降级Spring Boot版本，确保Java 8兼容性

## 开发指南

### collision模块核心组件

- `QuapDataAdapter`: 数据访问适配器，连接若依系统数据
- `WebSocketConfig`: WebSocket配置，支持实时数据推送
- `VehicleLocationService`: 车辆位置管理服务
- `GeopositionController`: WebSocket消息控制器

### 扩展开发

1. 新增spatial实体时，继承spatial基类并配置PostGIS映射
2. WebSocket消息通过`/topic`前缀向客户端广播
3. 使用`QuapDataAdapter`获取车辆和司机数据，避免直接访问DAO

## 版本信息

- 当前版本: 1.0.1
- 更新日志: 详见 `change_log.md`