proposal.md 4.1 KB
Why
安庆山峡化工有限公司已建设 CRM 系统（线索/客户/商机/报价单/合同/产品管理）和地磅系统。现需建设统一的运输计划管理系统，将 CRM 合同与后续的运输、地磅、库存等环节串联，形成从合同→计划→运输→地磅→结算→归档的完整业务闭环。
What Changes
新增功能模块
计划管理（Plan Management）
- 支持从 CRM 合同发起计划，自动带入合同基本信息、商品明细、结算方式等
- 支持三种单据类型：直销单、入库单、出库单（根据供应商/目的地自动判断）
- 支持产品属性检查（易制毒/易制爆需上传购买证、运输证）
- 支持跟进状态流转（等客户确认→待采购→待发货/待出库→待收货/待入库→已收货/已入库→待归档→归档完成）
- 支持任意状态下取消计划
运输管理（Transport Management）
- 支持选择车辆类型（自有/承运商）和具体车辆
- 支持生成二维码供司机/现场人员扫码
- 支持司机扫码回传运输单据和数量
- 支持运输安排状态管理（待安排/已安排）
运输审批（Transport Approval）
- 支持简单审批流程（会签）
- 提交审批时用户选择审批人，按选择顺序依次审批
- 状态流转：草稿→待执行→执行中→已完成→已取消
- 不允许状态回退
运费结算（Freight Settlement）
- 支持按重量或按趟次计算运费
- 支持多选运输单合并生成结算单
- 结算流程：待提交→已提交→审核通过→已确认
- 支持发票信息记录（发票号、开票日期、发票金额）
- 支持汇款凭证上传
车辆与司机管理（Vehicle & Driver Management）
- 车辆归属唯一性管理（自有 或 承运商）
- 司机档案管理（姓名、联系方式、驾驶证、行驶证、危化品证）
- 证件过期提醒（30天）
盘存统计（Inventory Statistics）
- 库存台账（按产品汇总库存量和库存金额）
- 出入库明细与汇总报表
- 运输统计（按运输公司/车辆统计趟次和运费）
- 库存预警（按产品设置阈值）
数据库变更
- 新增
pl_plan（计划主表） - 新增
pl_plan_product（计划产品明细表） - 新增
pl_transport（运输信息表） - 新增
pl_transport_approval（运输审批记录表） - 新增
pl_vehicle（车辆表） - 新增
pl_driver（司机表） - 新增
pl_freight_settlement（运费结算表） - 新增
pl_inventory（库存表）
API 变更
- 新增
/api/plan/*（计划管理相关接口） - 新增
/api/transport/*（运输管理相关接口） - 新增
/api/vehicle/*（车辆管理相关接口） - 新增
/api/driver/*（司机管理相关接口） - 新增
/api/freight/*（运费结算相关接口） - 新增
/api/inventory/*（库存统计相关接口）
Capabilities
New Capabilities
transport-plan: 运输计划管理 — 计划创建、编辑、取消、状态流转transport-order: 运输单管理 — 运输安排、二维码生成、扫码回传transport-approval: 运输审批 — 审批流程、会签审批、审批记录freight-settlement: 运费结算 — 结算单生成、发票管理、汇款凭证vehicle-driver: 车辆司机管理 — 车辆档案、司机档案、证件提醒inventory-statistics: 盘存统计 — 库存台账、出入库报表、运输统计、库存预警
Modified Capabilities
- 无（暂无对现有 capability 的需求变更）
Impact
受影响系统
- 后端：
backend/app/— 新增计划、运输、车辆、司机、运费、库存相关模块 - 前端：
web-admin/src/— 新增计划管理、运输管理、车辆管理等页面 - 数据库：新增
pl_*系列表
外部依赖
- CRM 合同系统（
crm_contract,crm_contract_product）— 读取合同信息 - 地磅系统（
dibang_*）— 接收出入库数据 - MinIO 对象存储 — 附件上传
表前缀规范
按需求文档要求，所有计划相关表统一使用 pl_ 前缀