shanxia2.0/openspec/changes/transport-plan-management/tasks.md

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

1. 数据库设计与创建

1.1 基础数据表

• 1.1.1 创建承运商表 pl_carrier
• 1.1.2 创建车辆表 pl_vehicle
• 1.1.3 创建司机表 pl_driver
• 1.1.4 创建证件提醒表 pl_document_reminder

1.2 计划管理表

• 1.2.1 创建计划主表 pl_plan
• 1.2.2 创建计划产品明细表 pl_plan_product
• 1.2.3 创建计划变更记录表 pl_plan_change

1.3 运输管理表

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

1.4 运费结算表

• 1.4.1 创建运费结算表 pl_freight_settlement
• 1.4.2 创建汇款凭证表 pl_remittance_voucher

1.5 库存管理表

• 1.5.1 创建库存表 pl_inventory
• 1.5.2 创建库存预警表 pl_inventory_warning

---

2. 后端 API 开发

2.1 基础数据 API

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

2.2 计划管理 API

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

2.3 运输管理 API

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

2.4 审批流程 API

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

2.5 运费结算 API

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

2.6 盘存统计 API

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

---

3. 前端页面开发

3.1 基础数据管理页面

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

3.2 计划管理页面

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

3.3 运输管理页面

• 3.3.1 实现运输列表页面 (/views/pl/transport/index.vue)

3.4 运费结算页面

• 3.4.1 实现结算单列表页面 (/views/pl/freight/index.vue)

3.5 盘存统计页面

• 3.5.1 实现库存台账页面 (/views/pl/inventory/ledger.vue)
• 3.5.2 实现证件提醒页面 (/views/pl/inventory/document-reminder.vue)
• 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. 路由配置

• 6.1 配置后端 API 路由注册（app/api/__init__.py, app/main.py）
• 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 验证生产环境功能