CityBus城市公交管理

一、部署前置准备

1.1 环境要求

1.2 获取源码

git clone <repository-url>
cd bus

或将项目解压到 XAMPP 的 htdocs 文件夹：

C:\xampp\htdocs\bus

二、数据库配置

2.1 创建数据库

打开 phpMyAdmin（http://localhost/phpmyadmin），创建新数据库：

CREATE DATABASE local_bus_monitoring CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2.2 导入数据库结构

在 phpMyAdmin 中选择 local_bus_monitoring 数据库 → 导入 标签 → 选择 local_bus_monitoring.sql → 点击 执行。

2.3 导入示例数据（可选）

如需测试数据，导入 seed_dummy_data.sql。

2.4 配置数据库连接

编辑 includes/db.php，根据实际环境修改：

$host = "localhost";
$user = "root";
$password = "";  // 你的 MySQL 密码
$dbname = "local_bus_monitoring";
```[citation:3]


## 三、启动服务与访问

### 3.1 启动 XAMPP

打开 XAMPP 控制面板，启动 **Apache** 和 **MySQL**[citation:3]。

### 3.2 访问应用

浏览器打开：

### 3.3 测试账号

使用以下测试账号登录，或注册新账号[citation:3]：
- **邮箱**：`user1@example.com`
- **密码**：`user123`


## 四、常见问题

**数据库导入失败**：确认数据库字符集为 `utf8mb4`，SQL 文件完整未损坏。

**Apache 端口冲突**：XAMPP 默认使用 80 端口，如被占用可修改 Apache 端口配置。

**实时位置不显示**：开源项目若无真实 GPS 数据源，地图上显示的是基于时刻表的模拟位置。如需真实定位，需接入车载 GPS 设备。

**PHP 版本不兼容**：确认 PHP 版本 ≥ 8.2，低版本可能因语法差异导致运行错误。


## 五、商业方案说明

如果你需要的是**城市级公交管理能力**（而非校园场景），香港城巴的方案提供了参考方向，但它是 Velociti Solutions 的商业产品，不提供源码或自助部署：

- **Omnibus 软件套件**：覆盖网络规划、运营、服务后分析和财务报告[citation:5]
- **Control360 平台**：实时运营控制，主动应对运营挑战[citation:5]
- **NEC 车队管理系统**：与自动收费和报站系统集成，管理约1,700辆巴士[citation:17]

如需类似能力，建议联系 Velociti Solutions（Omnibus）或 NEC 获取商业方案。