# pilot-manage

**Repository Path**: tainshan/pilot-manage

## Basic Information

- **Project Name**: pilot-manage
- **Description**: 无人机飞控平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2025-10-08
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 无人机管理系统

一个基于FastAPI和Vue3的无人机管理系统，提供全面的无人机运营管理解决方案，包括用户管理、权限管理、无人机管理、部门管理、菜单管理、航线管理、任务管理、飞行监控和PX4飞控模拟等功能。

## 系统功能

### 核心功能模块
- **用户管理**：用户注册、登录、权限分配、个人信息管理
- **权限管理**：角色定义、权限分配、菜单权限控制
- **无人机管理**：无人机信息管理、状态监控、飞行参数配置
- **部门管理**：组织结构管理、部门层级维护
- **菜单管理**：动态菜单配置、权限关联
- **航线管理**：航线规划、编辑、审批、执行
- **任务管理**：任务创建、分配、执行监控、状态更新
- **飞行监控**：实时飞行数据监控、异常警报
- **日志管理**：操作日志、飞行日志、异常日志记录与查询
- **数据分析**：飞行数据分析、任务统计报表
- **场景管理**：任务场景配置、检测目标管理
- **PX4飞控模拟**：模拟PX4飞控系统、执行飞行任务、反馈实时状态

## 技术栈

### 后端
- Python 3.7+
- FastAPI
- SQLAlchemy (ORM)
- SQLite (默认) / MySQL
- Uvicorn (ASGI服务器)

### 前端
- Vue 3
- Naive UI (UI组件库)
- Vist
- pnpm (包管理)
- Vue Router (路由)
- Vuex (状态管理)

## 项目结构

```
├── backend/                # 后端代码
│   ├── api/                # API路由
│   ├── app/                # 应用核心代码
│   ├── config/             # 配置文件
│   ├── database/           # 数据库相关
│   ├── init_scripts/       # 初始化脚本
│   ├── models/             # 数据模型
│   ├── schemas/            # 请求响应模式
│   ├── utils/              # 工具函数
│   ├── main.py             # 入口文件
│   └── initialize_database.py # 数据库初始化
├── frontend/               # 前端代码
│   ├── src/                # 源代码
│   │   ├── api/            # API接口
│   │   ├── assets/         # 静态资源
│   │   ├── components/     # 组件
│   │   ├── layout/         # 布局
│   │   ├── router/         # 路由
│   │   ├── store/          # 状态管理
│   │   ├── utils/          # 工具函数
│   │   ├── views/          # 页面视图
│   │   ├── App.vue         # 根组件
│   │   └── main.js         # 入口文件
│   ├── public/             # 公共资源
│   └── dist/               # 构建输出
├── docs/                   # 项目文档
│   ├── 需求规格说明书.md    # 需求规格说明
│   ├── 软件开发说明书.md    # 软件开发说明
│   ├── 软件安装指导书.md    # 安装指导
│   └── 软件维护指导书.md    # 维护指南
├── px4/                    # PX4飞控模拟程序
│   ├── px4_control_simulator.py  # PX4模拟器主程序
│   └── README.md           # 模拟器说明文档
├── start.bat               # Windows启动脚本
└── start.sh                # Linux启动脚本
```

## 环境要求

### 后端
- Python 3.7 或更高版本
- pip 包管理工具
- SQLite 或 MySQL 数据库

### 前端
- Node.js 14 或更高版本
- pnpm 包管理工具

## 快速开始

### 手动安装

#### 后端安装
1. 安装依赖
```bash
cd backend
call venv\Scripts\activate.bat
pip install -r requirements.txt
```

2. 初始化数据库
```bash
#python initialize_database.py
```

3. 运行后端服务
```bash
#uvicorn main:app --host 0.0.0.0 --port 8000 --reload
python main.py
```

#### 前端安装
1. 安装依赖
```bash
cd frontend
pnpm install 或者 npm install
```

2. 开发模式运行
```bash
pnpm run dev 或者 npm run dev
```

3. 构建生产版本
```bash
pnpm run build 或者 npm run build
```

## 系统访问

- 后端API地址: http://localhost:8000
- API文档: http://localhost:8000/docs
- 前端界面: (根据开发服务器输出的地址访问)

## 默认账户

初始化数据库后，系统将创建默认管理员账户：
- 用户名: admin
- 密码: admin123

## 文档

项目详细文档请查看 `docs` 目录下的文档文件：
- 需求规格说明书
- 软件开发说明书
- 软件安装指导书
- 软件维护指导书

## 注意事项

1. 首次运行系统时，请确保已完成数据库初始化
2. 生产环境部署时，请修改默认的管理员密码
3. 如需使用MySQL数据库，请修改数据库配置
4. 系统运行过程中，请确保网络连接稳定
5. PX4模拟器需要requests库，会在启动脚本中自动安装
6. 运行PX4模拟器前，请确保后端服务已启动

## PX4飞控模拟器

### 功能介绍
PX4飞控模拟器模拟真实的PX4飞控系统功能，包括：
- 支持多种飞行模式（MANUAL、STABILIZED、ALTCTL、POSCTL、AUTO.MISSION、AUTO.LOITER）
- 自动从后端获取任务和航线信息
- 模拟无人机的起飞、导航、悬停和降落过程
- 实时反馈无人机的详细状态数据（位置、姿态、速度、电池等）
- 模拟电机控制、GPS信号和传感器数据

### 运行方法

1. 确保后端服务已启动
2. 在px4目录下运行模拟器：

```bash
cd px4
python px4_control_simulator.py
```

### 查看详情

PX4模拟器的详细使用说明和配置信息，请查看：
- <mcfile name="README.md" path="px4/README.md"></mcfile>

## 许可证

[MIT License](LICENSE)