98 lines
4.1 KiB
Markdown
98 lines
4.1 KiB
Markdown
## 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_` 前缀
|