# 公交车动态调度系统

**Repository Path**: achen5055/bus-system-master

## Basic Information

- **Project Name**: 公交车动态调度系统
- **Description**: 智慧公交动态调度平台是一个综合管理系统，旨在实现公交车辆、线路、站点和司机的全面管理，提供实时监控、动态调度和数据统计分析功能，提升公交运营效率和服务质量。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-24
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧公交动态调度平台

## 项目概述

智慧公交动态调度平台是一个综合管理系统，旨在实现公交车辆、线路、站点和司机的全面管理，提供实时监控、动态调度和数据统计分析功能，提升公交运营效率和服务质量。

## 技术栈

### 前端
- **框架**：Vue 3 + Vue Router + Pinia
- **UI组件库**：Element Plus
- **构建工具**：Vite
- **地图可视化**：Leaflet
- **图表展示**：ECharts + Vue-ECharts
- **网络请求**：Axios
- **实时通信**：Socket.IO
- **样式处理**：Sass

### 后端
- **框架**：Spring Boot 2.7.18
- **ORM框架**：MyBatis Plus 3.5.3.1
- **数据库**：H2（运行时）
- **缓存**：Redis
- **认证**：JWT
- **实时通信**：WebSocket
- **JSON处理**：Fastjson

## 项目结构

```
bus-system-master/
├── backend/             # 后端源码目录
│   ├── src/            # Java源代码
│   ├── logs/           # 日志文件
│   ├── pom.xml         # Maven配置文件
│   └── target/         # 编译输出目录
├── frontend/            # 前端源码目录
│   ├── src/            # Vue源代码
│   │   ├── assets/     # 静态资源
│   │   ├── components/ # 组件
│   │   ├── router/     # 路由配置
│   │   ├── stores/     # Pinia状态管理
│   │   ├── utils/      # 工具函数
│   │   ├── views/      # 页面视图
│   │   ├── App.vue     # 应用主组件
│   │   └── main.js     # 应用入口
│   ├── dist/           # 构建输出目录
│   ├── index.html      # HTML入口
│   ├── package.json    # 依赖配置
│   └── vite.config.js  # Vite配置
└── docs/                # 文档目录
    └── database-design.md # 数据库设计文档
```

## 核心功能模块

### 1. 车辆管理
- 车辆信息的增删改查
- 车辆状态监控（实时位置、速度）
- 车辆分配与调度

### 2. 线路管理
- 线路信息的增删改查
- 线路站点配置
- 线路状态管理

### 3. 站点管理
- 站点信息的增删改查
- 站点地图可视化
- 站点与线路的关联管理

### 4. 司机管理
- 司机信息的增删改查
- 司机状态管理
- 司机排班管理

### 5. 实时监控
- 车辆实时位置追踪
- 线路运行状态监控
- 异常情况告警

### 6. 统计分析
- 客流量统计
- 运营效率分析
- 数据可视化展示

### 7. 系统管理
- 用户权限管理
- 系统参数配置
- 日志记录与查询

## 数据库设计

### 主要数据表

1. **车辆表 (buses)**
   - 存储车辆基本信息、运行状态和实时位置

2. **线路表 (routes)**
   - 存储线路信息、起止站点和运营时间

3. **站点表 (stations)**
   - 存储站点信息、地理位置和状态

4. **线路站点关联表 (route_stations)**
   - 维护线路与站点的多对多关系

5. **司机表 (drivers)**
   - 存储司机基本信息、资质和工作状态

详细的数据库设计请参考 [数据库设计文档](./docs/database-design.md)。

## 安装部署

### 环境要求

#### 前端
- Node.js 14+
- Yarn 1.22+

#### 后端
- JDK 8+
- Maven 3.6+
- Redis 5+

### 前端安装

```bash
# 进入前端目录
cd frontend

# 安装依赖
yarn install

# 开发环境运行
yarn dev

# 构建生产版本
yarn build
```

### 后端安装

```bash
# 进入后端目录
cd backend

# 编译打包
mvn clean package

# 运行应用
java -jar target/bus-scheduling-system-1.0.0.jar
```

## 配置说明

### 前端配置

主要配置文件：`frontend/vite.config.js`

- 开发服务器端口：3002
- API代理目标：http://localhost:8080
- 构建输出目录：dist

### 后端配置

主要配置文件：`backend/src/main/resources/application.properties`

- 服务器端口：8080
- 数据库配置
- Redis配置
- JWT配置

## 开发指南

### 前端开发

1. 确保Node.js和Yarn环境已正确安装
2. 运行`yarn install`安装依赖
3. 运行`yarn dev`启动开发服务器
4. 访问 http://localhost:3002 进行开发调试

### 后端开发

1. 确保JDK和Maven环境已正确安装
2. 导入项目到IDE（如IntelliJ IDEA或Eclipse）
3. 配置数据库连接
4. 运行主应用类启动服务
5. 访问 http://localhost:8080 进行API测试

## 注意事项

1. 开发环境下，前端通过代理访问后端API
2. 生产环境部署时，需要配置正确的数据库连接信息
3. 系统默认使用H2数据库，可根据需要切换为MySQL等其他数据库
4. 实时位置追踪功能依赖WebSocket服务

## 许可证

[MIT](LICENSE)