# 直升机试验试飞业务平台

**Repository Path**: guocongll/htfp

## Basic Information

- **Project Name**: 直升机试验试飞业务平台
- **Description**: 直升机试验试飞业务平台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-20
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 直升机试验试飞工作平台（HTFP）

HTFP 是基于 RuoYi-Vue 定制的直升机试验试飞信息化管理平台，采用单后端 API + 双前端的前后端分离架构。

| 服务 | 本地开发端口 | 生产端口 | 说明 |
| --- | --- | --- | --- |
| `htfp-admin` | `8080` | `8080`（本机） | Spring Boot REST API |
| `frontend/ui` | `80` | `4000` | 管理后台 |
| `frontend/portal` | `8081` | `4001` | 业务门户 |

## 技术栈

- 后端：Java 17、Spring Boot、Spring Security、MyBatis、Druid、Redis、JWT
- 前端：Vue 3、Vite、Element Plus
- 部署：JDK 17、Nginx、MariaDB/MySQL、Redis

## 目录结构

```text
htfp/
├── backend/          # Maven 后端（pom.xml、sql、htfp-* 模块）
├── frontend/
│   ├── ui/           # 管理后台
│   └── portal/       # 业务门户
├── deploy/           # 原生部署配置（systemd、Nginx、生产配置模板）
├── doc/
└── scripts/          # 构建与发布脚本
```

## 模块结构

| 模块 | 职责 |
| --- | --- |
| `backend/htfp-admin` | Web 服务入口、启动类、Controller |
| `backend/htfp-common` | 公共实体、注解、常量、工具类 |
| `backend/htfp-framework` | 安全、过滤器、AOP、Redis、Web 框架配置 |
| `backend/htfp-system` | 用户、角色、菜单、字典等系统管理能力 |
| `backend/htfp-flight` | 试飞业务领域 |
| `backend/htfp-safety` | 安全监控业务领域 |
| `backend/htfp-quartz` | 定时任务 |
| `backend/htfp-generator` | 代码生成器 |
| `frontend/ui` | 管理后台前端 |
| `frontend/portal` | 业务门户前端 |
| `backend/sql` | 数据库初始化与修复脚本 |
| `deploy` | 原生部署配置与手册 |

## 快速开始

1. 创建 MySQL 数据库并导入脚本，详见 [backend/sql/README.md](backend/sql/README.md)。
2. 确认 Redis 可用。
3. 按需调整后端环境变量，详见 [BUILD.md](BUILD.md)。
4. 构建后端：

```bash
cd backend && mvn clean package -DskipTests
```

5. 构建前端：

```bash
cd frontend/ui && npm ci && npm run build:prod
cd ../portal && npm ci && npm run build:prod
```

## 生产部署

适用于麒麟等离线服务器：MariaDB、Redis、Nginx、JDK 17 安装在宿主机，上传 jar 与前端 dist 即可更新。

详细步骤见 [deploy/DEPLOY.md](deploy/DEPLOY.md)。

### 一键打包发布（有网构建机）

```bash
chmod +x scripts/package-release.sh
./scripts/package-release.sh
```

生成 `dist/htfp-release-<version>-<date>.tar.gz`，传输至服务器后：

```bash
sudo ./scripts/update-release.sh dist/htfp-release-*.tar.gz
```

Nginx 对外暴露 **4000**（管理后台）和 **4001**（业务门户）。后端 API 由 Nginx 将 `/prod-api/` 反代至 `127.0.0.1:8080`，无需对公网开放 8080。

生产环境默认关闭 Swagger UI 和 Druid 监控入口。配置见 `deploy/application-prod.yml.example`。

## 默认账号

导入 `backend/sql/htfp_init.sql` 后可使用：

| 账号 | 角色 | 默认密码 |
| --- | --- | --- |
| `admin` | 超级管理员 | `admin123` |
| `pilot` | 门户飞行员角色 | `admin123` |
| `engineer` | 门户工程师角色 | `admin123` |

## 工程规范

- 不在仓库中提交真实生产配置、构建产物、上传目录、日志或依赖目录。
- 后端敏感配置通过外置 `application-prod.yml` 覆盖，生产环境不得使用默认密钥和默认密码。
- `htfp-admin` 中的 Controller 只负责 Web 入口，不承载复杂业务逻辑。
- 管理端使用 `Admin-Token`，门户端使用 `Portal-Token`，两者不要混用。
- 所有文本、SQL 和文档统一保存为 UTF-8。

更多架构治理规则见 [doc/ARCHITECTURE_BASELINE.md](doc/ARCHITECTURE_BASELINE.md)。