# Kylin Logistics

Kylin 智慧物流调度系统核心扩展包 — 运单管理、车辆调度、GPS 定位、冷链温控。

## 功能特性

- **运单管理**（Waybill）：运单全生命周期管理
- **车辆调度**（Dispatch）：智能调度
- **车辆管理**（Vehicle）：车辆信息管理
- **司机管理**（Driver）：司机信息管理
- **路线规划**（Route）：路线规划与优化
- **签收确认**（Sign Record）：电子签收
- **GPS 定位**（Gps Location）：实时定位
- **GPS 轨迹**（Gps Track）：轨迹回放
- **冷链温控**（Temp Record）：温度监控
- **异常报警**（Alarm）：偏航/超速/超温报警

## 行业标准合规

- JT/T 1285-2020《道路运输车辆卫星定位系统》
- WB/T 1104-2020《道路货物运输车辆智能视频监控报警系统》
- GB/T 22239-2019 网络安全等级保护
- GB/T 35273-2020 个人信息保护

## 安装

```bash
composer require kylin/logistics
```

## 配置说明

```php
// config/logistics.php
return [
    'gps_accuracy_threshold' => 15,       // GPS 定位精度（米），JT/T 1285-2020
    'track_retention_days' => 90,         // 轨迹保留天数
    'route_deviation_threshold' => 500,   // 偏航报警阈值（米），WB/T 1104-2020
    'alarm_push_delay_max' => 5,          // 报警推送延迟（秒）
    'cold_chain_temp_threshold' => 2,     // 冷链温控阈值（±℃）
    'overspeed_threshold' => 1.1,         // 超速阈值（标准速度的 110%）
];
```

## 使用示例

### API 路由

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/kylin/logistics/waybills | 运单列表 |
| POST | /api/kylin/logistics/waybills | 创建运单 |
| GET | /api/kylin/logistics/vehicles | 车辆列表 |
| GET | /api/kylin/logistics/gps/track/{waybillId} | 轨迹查询 |
| POST | /api/kylin/logistics/sign | 签收确认 |
| GET | /api/kylin/logistics/alarms | 报警列表 |

## 法律合规

详见 [LEGAL.md](./LEGAL.md)，涵盖：
- JT/T 1285-2020《道路运输车辆卫星定位系统》
- WB/T 1104-2020《道路货物运输车辆智能视频监控报警系统》
- 《中华人民共和国道路运输条例》(2023.7.20 修订)
- 《中华人民共和国个人信息保护法》(2021.11.1)

## 依赖

- PHP ^8.5
- Laravel ^13.0
- kylin/core

## 许可证

私有软件，未经授权禁止使用。