FleetHub 文档

在 Hostinger Single（共享主机）上部署

建议没有 VPS 或技术经验的人使用此方法。 FleetHub 与最便宜的 Hostinger 单一虚拟主机 计划（约 2.99 美元/月）完全兼容。无需 SSH、Composer 或命令行 — Single 附带本机 cron 作业、PHP 8.3 和免费 SSL。

第 1 步 — 准备托管

1. 登录Hostinger hPanel。
2. 前往托管→管理查看您的域名。
3. 通过高级→PHP配置将PHP版本设置为8.2或8.3。
4. 确保启用这些 PHP 扩展（通常默认情况下）：
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo

第 2 步 — 创建 MySQL 数据库

1. 在 hPanel 中，转到 数据库 → MySQL 数据库。
2. 按创建新数据库。
3. 记录这 3 个值：
   • 数据库名称 — 例如u123_FleetHub
   • 登录名 — 例如u123_admin
   • 密码 — 自行生成并精心保存

第 3 步 — 上传文件

1. 进入hPanel中的文件→文件管理器。
2. 导航至public_html/（这是域名的根）。
3. 删除此文件夹中所有默认的 index.html 或 default.php 文件。
4. 点击上传文件，从安装包中下载所有source.zip。
   或者如果需要，可以直接通过FTP下载文件夹/source/的内容。
5. 如果上传 ZIP，右键单击 → Extract。解压后，所有文件必须位于根目录public_html/。
6. 确认public_html/包含：app/、public/、vendor/、.htaccess、index.php（public/中）、.env等。

第 4 步 — 运行安装程序

1. 打开浏览器并转到https://yourdomain.com/install。
2. 您将看到 FleetHub 安装程序。
3. 第 1 步：要求 — 所有项目都必须通过（绿色）。如果出现错误，请联系 Hostinger 支持以启用缺少的 PHP 扩展。
4. 步骤 2：数据库 — 输入上述步骤 2 中的信息：
   • 主持人: localhost
   • 港口: 3306
   • 数据库: u123_FleetHub
   • 用户名: u123_admin
   • 密码：（由 Hostinger 生成）
5. 第 3 步：迁移 — 单击“运行迁移和种子”。大约需要 10 秒。别刷新。
6. 第 4 步：管理 — 创建管理员帐户。使用强密码。
7. 完成！ — 您将看到 Cron URL（保存！）和登录按钮。

第 5 步 — 通过 Hostinger Cron 设置自动电子邮件警报

FleetHub 使用 Laravel 调度程序：合规警报、维护提醒、逾期请求、驾驶执照、车辆价值更新和车队健康评分重新计算。在 hPanel 上配置 a cron。

1. 在 hPanel 中，转到 Advanced → Cron Jobs。
2. 单击创建 Cron 作业。
3. 选择类型：Custom（不是“PHP”——因为需要传递参数）。
4. 输入以下命令（将 uXXXXXX 替换为您的 Hostinger 用户名）：

   /usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

   提示：打开文件管理器，找到文件artisan（项目根目录），右键→属性复制完整路径。
5. 将计划设置为每分钟 — 所有五个字段（分钟、小时、日、月、星期几）设置为 *。
6. 按保存。

FleetHub 将发送逾期索赔提醒、维护、合规和许可证警报、折旧更新以及自动车队健康评分重新计算。

第 6 步 — 配置电子邮件 (SMTP)

Hostinger 为每个计划提供电子邮件帐户。对于 FleetHub 通知：

1. 在 hPanel 中，转到 电子邮件 → 电子邮件帐户 并创建一个帐户（例如 noreply@yourdomain.com）。
2. 通过文件管理器编辑public_html/中的文件.env：

   MAIL_MAILER=smtp
   MAIL_HOST=smtp.hostinger.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. 保存文件。
4. 登录 FleetHub → 设置 → 电子邮件选项卡 → 发送测试电子邮件。如果你明白了，你就完成了。

Hostinger Single 上的常见问题

上传后出现“500内部服务器错误”

• 验证 .htaccess 是否存在于根 public_html/ 并包含重写规则。
• 确认 hPanel 中的 PHP 版本设置为 8.2 或 8.3。
• 通过文件管理器检查storage/logs/laravel.log以查看实际错误。

上传时提示“权限被拒绝”

Hostinger 通常会自行设置正确的权限，但如果没有：

• 右键单击文件管理器中的storage/→权限→递归设置为755。
• 与bootstrap/cache/相同。

QR扫描仪无法打开相机

浏览器摄像头 API 需要 HTTPS。 Hostinger 通过 Let's Encrypt 提供免费 SSL — 在 hPanel 中的SSL → Manage 下启用。

预定的电子邮件未发送

• 在 hPanel → Cron Jobs → 检查 cron 条目中的 Last run 列。如果为空，则 cron 未运行 - 确认 artisan 路径正确。
• 手动测试命令：在hPanel中打开Terminal（如果可用）并运行cron命令。如果出现错误，错误消息会明确指出问题所在（错误的PHP版本、错误的路径等）。
• 确认 SMTP 配置正确（设置 → 电子邮件 → 发送测试）。
• 检查 storage/logs/laravel.log 是否有调度程序错误。

性能缓慢

Hostinger Single 共享 CPU/RAM。如果您的团队超过 20 人，请考虑：

• 升级到 Premium（约 3.99 美元/月）——更快的服务器、更多的资源、更多的数据库。
• 或者业务（~5.99 美元/月）——专用资源、每日备份、暂存环境。

配置

.env 文件

安装在应用程序中

大多数非敏感选项在管理→设置配置：

• 常规：公司名称/电子邮件/电话、品牌
• 车队：车辆代码前缀、交接清单模板、维护默认、公共车辆页面模式
• 电子邮件：发送测试电子邮件以测试 SMTP
• 通知：启用/禁用合规警报、维护、车辆要求、许可证
• 多语言：时区、日期格式、货币 — 适用于整个应用程序
• 合规：管理合规类型预设（保险、注册、路税...）
• 品牌：应用程序名称和徽标 - 更新登录、页脚、选项卡标题
• 外观：自定义品牌颜色、状态和浅色/深色文本 — 请参阅常见问题解答中的品牌重塑指南

多语言支持

FleetHub 提供 11 种语言版本，包括阿拉伯语 (RTL) 和印地语。用户通过右上角的标志下拉菜单更改语言。

Shipped languages

如何更改语言

1. 单击右上角的旗帜图标以打开下拉菜单。
2. Pick your language from the list.
3. 页面将重新加载；所有 UI 标签、日期和货币格式都会保留。
4. 选择同时保存在用户帐户和 cookie 中（1 年）。

添加自定义语言（管理员）

前往管理→翻译（管理员有权限管理翻译）：

• 单击“添加区域设置” — 输入代码（例如，mk 代表马其顿语）、显示名称、区域设置名称、SVG 标志文件名、方向 (LTR/RTL) 和原始区域设置以复制翻译。
• 新的区域设置出现在语言切换器和默认语言列表中（位于“设置”→“本地化”）。
• DB 翻译会自动覆盖 lang/{code}/ 中的文件。

翻译编辑

编辑器按文件列出所有翻译键（资产、导航、设置...）。每个键都显示基线文件和覆盖数据库（如果有）。

• 按区域设置、翻译组或文本搜索进行过滤。
• 点击值进行内联编辑；现在保存到数据库。
• 重置键返回到基线文件。
• 内置语言环境（en、vi、es...）可以编辑；来自数据库的完全自定义区域设置。
• 只有具有管理翻译权限的用户才能访问此页面。

CSV 导入/导出

• Export — 将语言环境的所有密钥下载为 CSV (group,key,value)。
• Import — 在同一列中上传 CSV；更新覆盖数据库，添加新密钥。

根据用户的默认区域设置

每个用户都有列locale。由于 Laravel 的 HasLocalePreference 合约，通知电子邮件会根据收件人的语言自动发送。

站点默认语言位于设置→本地化→默认语言。个人用户通过标题上的语言切换器进行覆盖。

功能列表（15个模块组）

用户和角色

FleetHub 有 5 个可用于内部车队运营的角色：

模拟账户（密码：password）：admin@fleethub.test、manager@fleethub.test、dept@fleethub.test、accountant@fleethub.test、driver@fleethub.test。安装或播种时启用演示数据。 Spatie 权限——管理员可以微调每个权限。

车辆管理

创建新车

1. 导航至车辆→新车。
2. 填写车牌号、品牌、型号、年份、燃料类型、类别和部门。
3. 添加购买日期和价格（折旧和 TCO 所需）。
4. 上传照片（多个文件，每个文件最大 5 MB — 在移动设备上自动压缩）。
5. 保存 — 自动生成车辆代码和二维码。

车辆代码格式

默认值：{PREFIX}-{YEAR}-{NNNN}，例如VH-2026-0001。在设置→车队→车辆代码前缀进行配置。

批量导入

1. 在车辆页面点击导入。
2. 下载 Excel 模板。
3. 填写数据 — 必填列：license_plate、make、model、category_name。
4. 上传文件。

二维码&快速扫描

每辆车在创建时都会自动生成一个二维码。扫描即可打开公共车辆页面，或在应用程序中对已登录的驾驶员执行快速操作。

打印二维码标签

• 单个标签：点击车辆上的打印机图标。
• 批量打印：选择多辆车辆→打印二维码标签。 A4 尺寸，每行 2 个标签。

在应用程序中扫描

在车辆页面点击扫描二维码。允许摄像头。适用于具有 HTTPS 或 localhost 的现代浏览器。

公共汽车页面

每辆车都有一个位于 /v/{vehicle_code} 的公共 URL — 无需登录即可快速识别。

• 在设置→车队→公共车辆页面进行配置：公共，需要登录或关闭。
• 访客模式仅查看基本信息（车牌、品牌/型号）。快速操作需要登录。
• 更改APP_URL后，按重新生成设置中的所有二维码。

程序

请求一辆车

员工发送使用车辆的请求。流：requested → approved → returned（或rejected）。车队经理或审批部门负责人。该日历显示整个车队的车辆预订。逾期归还车辆并发送警告电子邮件。

车辆交接

1. 请求获得批准后，在司机取车前创建下车交接。
2. 记录时钟、完成检查表、在二维图表上标记损坏、附加照片和数字签名。
3. 保存并下载 PDF 交付报告以供记录。
4. 还车时，创建交接 — 比较状态、更新仪表、删除司机分配。
5. 完成入库交接会将申请标记为已归还，并将车辆状态设为可用。

折旧和总体拥有成本

FleetHub 使用三种方法之一计算车辆折旧。折旧与燃料和费用日志一起包含在 TCO 表中。

默认继承自车辆类别。 current_value 每月通过 fleethub:update-vehicle-values 进行更新。 TCO = 购买价格 + 所选期间的车辆总成本。

自定义字段

管理 → 自定义字段允许向车辆添加无限的属性：

• 类型：文本、数字、日期、选择、文本区域、文件、复选框
• 范围：适用于所有类别或特定车辆类别
• 排列：拖放手柄
• 保存车辆时检查必填字段

报告

七个综合车队报告，可从“报告”菜单访问：

1. 总 TCO — 车辆和整个车队的总拥有成本
2. 折旧表 — 按车辆折旧，带文件导出
3. 维护成本 — 按车辆、类型和月份划分的支出
4. 燃油消耗和成本 — 公里/升趋势，不规则标记
5. 车辆请求使用 — 一段时间内的车辆预订率
6. 合规期满 — 车辆证件和驾照即将过期
7. 各部门车辆分配 — 各部门车辆及使用情况

所有报告均支持通过页面顶部的按钮导出Excel和PDF。

Webhook 集成

当发生重要的车队事件时，FleetHub 可以通知外部服务。

可用性事件

• vehicle.created, vehicle.updated, vehicle.deleted
• requisition.approved, requisition.rejected, requisition.overdue, requisition.returned
• handover.completed
• compliance.expiring, compliance.expired
• maintenance.due, maintenance.overdue, maintenance.completed
• fleet_health_score.dropped

有效负载格式

{
  "event": "handover.completed",
  "timestamp": "2026-06-23T08:00:00+00:00",
  "data": {
    "vehicle_id": 1,
    "vehicle_code": "VH-2026-0001",
    "license_plate": "51A-12345",
    "handover_id": 12,
    "direction": "outgoing",
    "driver_id": 4
  }
}

验证签名

如果配置为机密，则请求的标头 X-FleetHub-Signature 包含主体的 HMAC-SHA256。验证你的一方：

$expected = hash_hmac('sha256', $rawBody, $secret);
if (hash_equals($expected, $request->header('X-FleetHub-Signature'))) {
  // 有效的
}

重试政策

投递失败，重试 3 次，每 200 毫秒一次。连续 10 次失败后，Webhook 将自行关闭。

计划任务

FleetHub 使用 Laravel 调度程序执行后台任务。只需 one cron — Laravel 按时运行每个 fleethub: 命令。

共享托管（Cron Jobs cPanel / Hostinger）

请参阅安装 cPanel → 步骤 7 或安装 Hostinger → 步骤 5。简而言之：高级 → Cron Jobs，命令：

/usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

日历：每分钟（所有五个字段中*）。

cPanel cron 命令

将 CPANELUSER 替换为您的 cPanel 用户名：

/usr/local/bin/php /home/CPANELUSER/public_html/artisan schedule:run

VPS/私人服务器（crontab）

使用 Web 用户运行 crontab -e 并添加：

* * * * * cd /path/to/FleetHub && php artisan schedule:run >> /dev/null 2>&1

后备：ping 外部 URL

如果主机没有 cron，请使用应用程序（设置 → 系统）中的 Cron URL 和 cron-job.org（免费，每 15 分钟一次）。

任务自动运行

升级指南

FleetHub v1.0.0 是 CodeCanyon 上的首次发布。

故障排除

存储上“权限被拒绝”

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

QR 扫描仪无法打开相机

浏览器摄像头 API 需要 HTTPS。测试时安装 SSL 或使用 localhost。

未收到电子邮件

检查storage/logs/laravel.log是否有错误。使用设置→电子邮件→发送测试电子邮件确认SMTP信息。确保 SMTP 服务器允许发送 IP。

cPanel 上的数据库“访问被拒绝”(1045)

用户/密码错误，用户尚未分配给数据库，或者密码中的特殊字符损坏.env。参见安装cPanel→常见问题。

迁移错误 1067（默认值无效）

共享主机上的 MySQL 严格模式拒绝多个 timestamp NOT NULL 列。从 v2.1.0+ 开始修复。更新软件包或在迁移中将 yêu cầu xe_date / expected_return_date 更改为 dateTime 需要 xes。

安装前APP_KEY丢失/错误500

在应用程序运行之前，Laravel 需要 .env 中的 APP_KEY。如果 cPanel 没有终端，请参阅安装 cPanel → 步骤 5（SSH、genkey.php 或在 PC 上创建）。

重置设置

删除storage/installed.lock并再次访问/install。如果再次运行迁移，现有数据将被删除。

性能——慢车列表

运行php artisan optimize。确保 MySQL 索引位于 vehicles.vehicle_code、vehicles.license_plate、vehicles.status。

变更日志

v1.0.0 — 首次发布 (2026-06)

• 使用自行生成的二维码和公共页面对车辆进行增删改查/v/{vehicle_code}
• 5个角色（管理员、车队经理、经理、会计、司机）
• 管理驾驶员，将驾驶执照到期时间同步到合规部分
• 带有时间表和逾期警报的车辆请求流程
• 移交车辆并附上二维损坏图、清单、签名和 PDF
• 燃油日志、防抄表、费用自动同步
• 车辆成本和 TCO 表以及成本/公里分析
• 折旧 — 直线、余额递减、生产单位（公里）
• 商品符合 30/14/7/1 天过期警告
• 安排维护、预防性自我更新、跟踪成本
• 车队健康评分、每日重新计算和详细模态
• 7 份车队报告，Excel 和 PDF 导出
• 按车辆类别划分的自定义字段（7 种类型）
• Webhooks 签署 HMAC (X-FleetHub-Signature) 并重试
• 带 diff 的 Spatie Activitylog 审核日志
• 多语言 UI：11 种语言环境，包括阿拉伯语 RTL 和印地语
• 公司、车队、电子邮件、通知、合规预设设置
• 带有演示数据播种器的 Web 安装程序
• 深色模式，UI 移动优先，上传时压缩图像

笔记

使用的开源库

• Laravel 11 — MIT
• Vue 3 — MIT
• Inertia.js — MIT
• Tailwind CSS — MIT
• Spatie Permission, Media Library, Activitylog — MIT
• Phosphor Icons — MIT (duotone weight)
• ApexCharts — MIT
• html5-qrcode — Apache 2.0
• Simple QrCode — MIT
• Laravel Excel — MIT
• Laravel DomPDF — MIT