# qms

**Repository Path**: bukcn/qms

## Basic Information

- **Project Name**: qms
- **Description**: Travel Management System
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: tms-java21
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-19
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QMS - 智游机票管理系统

企业商旅管理（TMC）平台，提供机票预订、酒店查询、订单管理、支付结算、报表统计等综合商旅服务。

## 技术栈

| 类别 | 技术 |
|------|------|
| 语言 | Java 21 |
| 框架 | Spring Boot 4.0.6 |
| ORM | Hibernate 7 (JPA) |
| 数据库 | MySQL 8 |
| 缓存 | Redis (Jedis) |
| 构建 | Maven |
| 打包 | WAR (支持 JSP) |

## 项目模块

```
qms/
├── qms-jedis           # Redis 缓存服务
├── qms-dao             # 数据访问层（实体 + DAO）
├── qms-flight-dao      # 航班数据访问层
├── qms-service         # 业务逻辑层
├── qms-flight-service  # 航班业务服务
├── qms-alert-service   # 告警通知服务
└── qms-bijia-webapp    # Web 应用（主入口）
```

## 环境要求

- JDK 21+
- Maven 3.8+
- MySQL 8.0+
- Redis

## 快速开始

### 1. 克隆代码

```bash
git clone <repository-url>
cd qms
```

### 2. 配置环境变量

```bash
cp env.properties.example .env
```

编辑 `.env` 文件，填入实际的数据库连接信息和服务地址。

### 3. 构建项目

```bash
# 全量构建（跳过测试，加快构建速度）
mvn clean package -Dmaven.test.skip=true
```

构建产物：`qms-bijia-webapp/target/hotel.war`

### 4. 启动应用

**方式一：使用启动脚本（推荐）**

脚本会自动加载 `.env` 环境变量：

```bash
./start.sh
```

**方式二：直接运行**

```bash
# 先加载环境变量
source .env
# 启动应用
export JAVA_HOME=/path/to/jdk-21   # 请替换为本地 JDK 路径
java -jar qms-bijia-webapp/target/hotel.war
```

## 环境变量说明

| 变量名 | 说明 |
|--------|------|
| `DB_HOST` | MySQL 主机地址 |
| `DB_PORT` | MySQL 端口 |
| `DB_NAME` | 主数据库名 |
| `FLIGHT_DB_NAME` | 航班数据库名 |
| `DB_USERNAME` | 数据库用户名 |
| `DB_PASSWORD` | 数据库密码 |
| `URL_TMS_WEIXIN_SERVICE` | 微信服务地址 |
| `URL_TMS_WORKWX_SERVICE` | 企业微信服务地址 |
| `API_FLIGHT_URL` | 航班 API 地址 |
| `API_HOTEL_URL` | 酒店 API 地址 |

## 文档

- [项目分析文档](doc/项目分析文档.md)
- [升级计划](doc/升级计划-SpringBoot4.0.6-Java21-MySQL8.md)

## License

见 [LICENSE](LICENSE) 文件。