6.5 KiB
6.5 KiB
运输计划管理系统 - 实施任务清单
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 验证生产环境功能