# 运输计划管理系统 - 实施任务清单

## 1. 数据库设计与创建

### 1.1 基础数据表

- [x] 1.1.1 创建承运商表 `pl_carrier`
- [x] 1.1.2 创建车辆表 `pl_vehicle`
- [x] 1.1.3 创建司机表 `pl_driver`
- [x] 1.1.4 创建证件提醒表 `pl_document_reminder`

### 1.2 计划管理表

- [x] 1.2.1 创建计划主表 `pl_plan`
- [x] 1.2.2 创建计划产品明细表 `pl_plan_product`
- [ ] 1.2.3 创建计划变更记录表 `pl_plan_change`

### 1.3 运输管理表

- [x] 1.3.1 创建运输表 `pl_transport`
- [x] 1.3.2 创建计划-运输关联表 `pl_plan_transport`
- [x] 1.3.3 创建运输审批记录表 `pl_transport_approval`

### 1.4 运费结算表

- [x] 1.4.1 创建运费结算表 `pl_freight_settlement`
- [ ] 1.4.2 创建汇款凭证表 `pl_remittance_voucher`

### 1.5 库存管理表

- [x] 1.5.1 创建库存表 `pl_inventory`
- [x] 1.5.2 创建库存预警表 `pl_inventory_warning`

---

## 2. 后端 API 开发

### 2.1 基础数据 API

- [x] 2.1.1 实现承运商 CRUD API (`/api/carrier/*`)
- [x] 2.1.2 实现车辆 CRUD API (`/api/vehicle/*`)
- [x] 2.1.3 实现司机 CRUD API (`/api/driver/*`)
- [x] 2.1.4 实现车辆列表 API（含承运商筛选）
- [x] 2.1.5 实现司机列表 API（含车辆绑定信息）

### 2.2 计划管理 API

- [x] 2.2.1 实现计划列表 API (`/api/plan/list`)
- [x] 2.2.2 实现计划详情 API (`/api/plan/{id}`)
- [x] 2.2.3 实现从合同发起计划 API (`/api/plan/create-from-contract`)
- [x] 2.2.4 实现计划编辑 API (`/api/plan/{id}`, PUT)
- [x] 2.2.5 实现计划取消 API (`/api/plan/{id}/cancel`)
- [x] 2.2.6 实现计划归档 API (`/api/plan/{id}/archive`)
- [x] 2.2.7 实现跟进状态流转 API (`/api/plan/{id}/status`)
- [x] 2.2.8 实现单据类型自动判断逻辑
- [x] 2.2.9 实现产品属性检查逻辑（易制毒/易制爆）
- [x] 2.2.10 实现金额自动计算逻辑（入库/出库金额）

### 2.3 运输管理 API

- [x] 2.3.1 实现运输安排 API (`/api/transport/arrange`)
- [x] 2.3.2 实现运输列表 API (`/api/transport/list`)
- [x] 2.3.3 实现运输详情 API (`/api/transport/{id}`)
- [x] 2.3.4 实现二维码生成 API (`/api/transport/{id}/qrcode`)
- [x] 2.3.5 实现司机扫码回传 API (`/api/transport/scan/feedback`)
- [x] 2.3.6 实现计划-运输关联管理 API (`/api/plan-transport/*`)

### 2.4 审批流程 API

- [x] 2.4.1 实现提交审批 API (`/api/transport/{id}/submit-approval`)
- [x] 2.4.2 实现审批 API (`/api/approval/{id}`)
- [x] 2.4.3 实现审批列表 API (`/api/approval/list`)
- [x] 2.4.4 实现审批详情 API (`/api/approval/{id}/detail`)

### 2.5 运费结算 API

- [x] 2.5.1 实现结算单生成 API (`/api/freight/generate`)
- [x] 2.5.2 实现结算单列表 API (`/api/freight/list`)
- [x] 2.5.3 实现结算单详情 API (`/api/freight/{id}`)
- [x] 2.5.4 实现结算单提交 API (`/api/freight/{id}/submit`)
- [x] 2.5.5 实现结算单审核 API (`/api/freight/{id}/approve`)
- [x] 2.5.6 实现发票信息记录 API (`/api/freight/{id}/invoice`)
- [x] 2.5.7 实现汇款凭证上传 API (`/api/freight/{id}/voucher`)

### 2.6 盘存统计 API

- [x] 2.6.1 实现库存台账 API (`/api/inventory/ledger`)
- [x] 2.6.2 实现出入库明细 API (`/api/inventory/details`)
- [x] 2.6.3 实现出入库汇总 API (`/api/inventory/summary`)
- [x] 2.6.4 实现运输统计 API (`/api/inventory/transport-stats`)
- [x] 2.6.5 实现库存预警列表 API (`/api/inventory/warnings`)
- [x] 2.6.6 实现预警阈值设置 API (`/api/inventory/warning-threshold`)

---

## 3. 前端页面开发

### 3.1 基础数据管理页面

- [x] 3.1.1 实现承运商管理页面 (`/views/transport/carrier/index.vue`)
- [x] 3.1.2 实现车辆管理页面 (`/views/transport/vehicle/index.vue`)
- [x] 3.1.3 实现司机管理页面 (`/views/transport/driver/index.vue`)
- [x] 3.1.4 实现证件到期提醒页面 (`/views/transport/document-reminder/index.vue`)

### 3.2 计划管理页面

- [x] 3.2.1 实现计划列表页面 (`/views/pl/plan/index.vue`)
- [x] 3.2.2 实现计划新增/编辑页面 (`/views/pl/plan/form.vue`)
- [x] 3.2.3 实现计划详情页面 (`/views/pl/plan/detail.vue`)
- [x] 3.2.4 实现运输安排页面 (`/views/pl/plan/arrange.vue`)

### 3.3 运输管理页面

- [x] 3.3.1 实现运输列表页面 (`/views/pl/transport/index.vue`)

### 3.4 运费结算页面

- [x] 3.4.1 实现结算单列表页面 (`/views/pl/freight/index.vue`)

### 3.5 盘存统计页面

- [x] 3.5.1 实现库存台账页面 (`/views/pl/inventory/ledger.vue`)
- [x] 3.5.2 实现证件提醒页面 (`/views/pl/inventory/document-reminder.vue`)
- [x] 3.6 车辆/人员/证书重构（`docs/superpowers/specs/2026-06-19-pl-vehicle-personnel-cert-design.md`）

### 3.7 工作台集成

- [ ] 3.7.1 实现待办任务列表组件 (`PendingTasks.vue`)
- [ ] 3.7.2 实现证件到期提醒组件 (`DocumentReminder.vue`)
- [ ] 3.7.3 实现库存预警提醒组件 (`InventoryWarning.vue`)

---

## 4. 定时任务开发

- [ ] 4.1 实现证件过期提醒定时任务（每日检查）
- [ ] 4.2 实现库存预警检查定时任务（每日检查）
- [ ] 4.3 实现库存统计更新定时任务（可选，如有统计表）

---

## 5. 菜单与权限配置

- [ ] 5.1 配置计划管理菜单
- [ ] 5.2 配置运输管理菜单
- [ ] 5.3 配置审批管理菜单
- [ ] 5.4 配置运费结算菜单
- [ ] 5.5 配置盘存统计菜单
- [ ] 5.6 配置基础数据管理菜单（车辆、司机、承运商）
- [ ] 5.7 配置权限标识（`transport:plan:*`, `transport:vehicle:*` 等）

---

## 6. 路由配置

- [x] 6.1 配置后端 API 路由注册（`app/api/__init__.py`, `app/main.py`）
- [x] 6.2 配置前端路由（`web-admin/src/router/modules/pl.ts`）

---

## 7. 测试与验证

### 7.1 单元测试

- [ ] 7.1.1 编写单据类型判断逻辑测试
- [ ] 7.1.2 编写金额计算逻辑测试
- [ ] 7.1.3 编写审批流程逻辑测试
- [ ] 7.1.4 编写运费计算逻辑测试

### 7.2 API 测试

- [ ] 7.2.1 验证计划 CRUD API
- [ ] 7.2.2 验证运输安排 API
- [ ] 7.2.3 验证审批流程 API
- [ ] 7.2.4 验证运费结算 API

### 7.3 集成测试

- [ ] 7.3.1 验证从合同发起计划完整流程
- [ ] 7.3.2 验证审批流程完整流转
- [ ] 7.3.3 验证运费结算完整流程
- [ ] 7.3.4 验证盘存统计准确性

---

## 8. 文档与培训

- [ ] 8.1 编写用户操作手册
- [ ] 8.2 更新 API 文档
- [ ] 8.3 编写技术设计文档（如有更新）

---

## 9. 部署与上线

- [ ] 9.1 执行数据库变更脚本
- [ ] 9.2 部署后端服务
- [ ] 9.3 部署前端服务
- [ ] 9.4 配置生产环境参数
- [ ] 9.5 验证生产环境功能