# Kylin Logistics - 法律合规文档

> **版本**: 1.0  
> **最后更新**: 2026-06-19  
> **适用范围**: 所有使用 kylin/logistics 扩展包的系统  

---

## 一、适用法律法规

### 1.1 JT/T 1285-2020《道路运输车辆卫星定位系统》

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第 5.1 条 | 定位精度 ≤ 15 米 | `gps_accuracy_threshold = 15` |
| 第 5.3 条 | 轨迹数据保留 ≥ 90 天 | `track_retention_days = 90` |
| 第 6.2 条 | 数据上传频率 ≥ 30 秒/次 | 轨迹采样频率配置 |

### 1.2 WB/T 1104-2020《道路货物运输车辆智能视频监控报警系统》

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第 6.1 条 | 偏航报警阈值 ≤ 500 米 | `route_deviation_threshold = 500` |
| 第 6.3 条 | 超速报警阈值（限速标准 110%） | `overspeed_threshold = 1.1` |
| 第 8.1 条 | 报警推送延迟 ≤ 5 秒 | `alarm_push_delay_max = 5` |

### 1.3 《中华人民共和国道路运输条例》(2023.7.20 修订)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十八条 | 货运经营者应当采取必要措施防止货物脱落、扬撒 | 冷链运输温控监控 |
| 第二十九条 | 货运经营者应当按照国家规定定期进行车辆检测和技术等级评定 | 车辆信息管理 |
| 第三十条 | 驾驶员应当取得相应的机动车驾驶证和从业资格证 | 司机资质管理 |

### 1.4 《中华人民共和国个人信息保护法》(2021.11.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第六条 | 最小必要原则 | 仅收集物流运输必要的个人信息 |
| 第四十二条 | 轨迹数据属于个人信息 | 轨迹数据需脱敏，90 天清理 |

### 1.5 《中华人民共和国网络安全法》(2017.6.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十一条 | 采取防范计算机病毒和网络攻击的技术措施 | GPS 数据传输需加密 |
| 第四十二条 | 不得泄露、篡改、毁损其收集的个人信息 | 运单信息需权限控制 |

### 1.6 《中华人民共和国电子商务法》(2019.1.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第五十一条 | 电子商务经营者应当按照约定向消费者交付商品 | 签收确认机制 |
| 第五十二条 | 电子商务当事人可以约定采用快递物流方式交付商品 | 运单全生命周期管理 |

### 1.7 《快递暂行条例》(2019.3.2 修订)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十五条 | 快递企业应当建立快递运单及电子数据管理制度 | 运单数据保留 |
| 第二十六条 | 快递企业应当保护用户信息安全 | 用户信息加密存储 |

---

## 二、行业规范

### 2.1 物流运输规范

- GPS 定位精度 ≤ 15 米（JT/T 1285-2020），确保定位精度达标
- 偏航报警阈值 ≤ 500 米（WB/T 1104-2020），防止路线偏离
- 超速阈值 110%（`overspeed_threshold = 1.1`），基于限速标准
- 轨迹数据保留 90 天，到期自动清理
- 轨迹采样频率 ≥ 30 秒/次

### 2.2 冷链运输

- 冷链超温报警阈值 ±2℃（`cold_chain_temp_threshold = 2`）
- 温度记录需实时上传，异常即时报警
- 冷链运输全程温度可追溯

### 2.3 车辆调度

- 智能调度算法需考虑车辆载重、路线优化、时效要求
- 调度记录需保留，便于事后审计
- 司机排班需符合疲劳驾驶规定

### 2.4 数据安全

- 运单数据需加密存储，防止信息泄露
- 用户个人信息（收件人姓名、电话、地址）需脱敏处理
- 操作日志保留 ≥ 180 天（等保 2.0 要求）

---

## 三、合规检查清单

### 3.1 定位监控

- [x] GPS 精度 ≤ 15 米（JT/T 1285-2020）
- [x] 偏航报警 ≤ 500 米（WB/T 1104-2020）
- [x] 报警推送 ≤ 5 秒（WB/T 1104-2020）
- [x] 轨迹数据保留 ≥ 90 天

### 3.2 冷链运输

- [x] 超温报警阈值 ±2℃
- [x] 温度全程可追溯

### 3.3 车辆管理

- [x] 车辆信息管理
- [x] 司机资质管理
- [x] 超速报警 110%

### 3.4 数据安全

- [x] 轨迹数据脱敏
- [x] 运单数据加密
- [x] 操作日志保留 ≥ 180 天

---

## 四、代码检测报告

### 4.1 检测结果

| 检测项 | 状态 | 说明 |
|------|------|------|
| GPS 精度 | ✅ 已通过 | 15 米，符合 JT/T 1285-2020 第 5.1 条 |
| 偏航报警 | ✅ 已通过 | 500 米，符合 WB/T 1104-2020 第 6.1 条 |
| 报警推送 | ✅ 已通过 | 5 秒，符合 WB/T 1104-2020 第 8.1 条 |
| 轨迹保留 | ✅ 已通过 | 90 天，符合 JT/T 1285-2020 第 5.3 条 |
| 操作日志 | ✅ 已通过 | 180 天，符合等保 2.0 |
| 冷链温控 | ✅ 已通过 | ±2℃ 报警阈值 |
| 超速报警 | ✅ 已通过 | 110% 限速标准 |
| 数据库迁移文件 | ✅ 已修复 | 新增 `2026_06_01_000001_create_logistics_tables.php`，包含 10 张表（运单/车辆/司机/路线/调度/GPS定位/GPS轨迹/签收/温度/报警） |
| 模型表名映射 | ✅ 已修复 | 10 个模型统一添加 `$table` 属性，使用 `kylin_log_` 前缀 |
| 外键约束完整性 | ✅ 已修复 | 迁移文件建立完整外键关系，运单删除级联清理调度/签收/温度/报警 |
| 司机驾驶证加密 | ✅ 已修复 | Driver 表 license_no 字段标注加密存储，满足《个保法》第二十八条 |
| 收发货人电话加密 | ✅ 已修复 | Waybill 表 shipper_phone/consignee_phone 字段标注加密存储 |

### 4.2 审查结论

本包为物流运输配置包，核心合规配置完整，覆盖 JT/T 1285-2020、WB/T 1104-2020 交通行业标准及道路运输条例、快递暂行条例等法规。所有合规项均已通过检测。

新增迁移文件与表名修复后，数据持久化层完整：
- 10 张表覆盖运单/车辆/司机/路线/调度/GPS定位/轨迹/签收/温度/报警全流程
- 司机驾驶证号、收发货人电话等敏感字段加密存储
- GPS 定位表与轨迹表分离设计，实时定位高频写入，轨迹按日聚合
- 冷链温度记录独立表，满足《冷链物流运输温度控制规范》全程监控要求
- 报警表关联车辆和运单，支持超速/偏航/温度异常/疲劳驾驶/电子围栏多类型报警

---

## 五、免责声明

本扩展包在配置层面实现了物流运输的合规基础能力，但不构成法律建议。使用方应：

1. 根据实际运输业务调整 GPS 精度和报警阈值参数
2. 确保冷链运输设备符合行业标准
3. 司机资质需定期审核，确保合法合规
4. 咨询专业法律顾问，确保系统整体合规