## Why 安庆山峡化工有限公司已建设 CRM 系统(线索/客户/商机/报价单/合同/产品管理)和地磅系统。现需建设**统一的运输计划管理系统**,将 CRM 合同与后续的运输、地磅、库存等环节串联,形成从合同→计划→运输→地磅→结算→归档的完整业务闭环。 ## What Changes ### 新增功能模块 1. **计划管理(Plan Management)** - 支持从 CRM 合同发起计划,自动带入合同基本信息、商品明细、结算方式等 - 支持三种单据类型:直销单、入库单、出库单(根据供应商/目的地自动判断) - 支持产品属性检查(易制毒/易制爆需上传购买证、运输证) - 支持跟进状态流转(等客户确认→待采购→待发货/待出库→待收货/待入库→已收货/已入库→待归档→归档完成) - 支持任意状态下取消计划 2. **运输管理(Transport Management)** - 支持选择车辆类型(自有/承运商)和具体车辆 - 支持生成二维码供司机/现场人员扫码 - 支持司机扫码回传运输单据和数量 - 支持运输安排状态管理(待安排/已安排) 3. **运输审批(Transport Approval)** - 支持简单审批流程(会签) - 提交审批时用户选择审批人,按选择顺序依次审批 - 状态流转:草稿→待执行→执行中→已完成→已取消 - **不允许状态回退** 4. **运费结算(Freight Settlement)** - 支持按重量或按趟次计算运费 - 支持多选运输单合并生成结算单 - 结算流程:待提交→已提交→审核通过→已确认 - 支持发票信息记录(发票号、开票日期、发票金额) - 支持汇款凭证上传 5. **车辆与司机管理(Vehicle & Driver Management)** - 车辆归属唯一性管理(自有 或 承运商) - 司机档案管理(姓名、联系方式、驾驶证、行驶证、危化品证) - 证件过期提醒(30天) 6. **盘存统计(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_` 前缀