4.1 KiB
4.1 KiB
运输计划 · 车辆尿素申请与发放登记 — 设计文档
日期: 2026-06-29
状态: 已批准
前置:docs/superpowers/specs/2026-06-29-pl-vehicle-recharge-design.md、docs/superpowers/specs/2026-06-29-vehicle-maintenance-design.md
界面模式: P01 标准列表 CRUD(双菜单);发放页参考 ETC 发放看板
目标
在运输管理模块新增 车辆尿素 管理能力:
- 【车辆尿素申请】:提交入库/采购类申请(车牌、申请人、申请时间、入库时间、单位、入库数、申请金额、附件、备注)。
- 【车辆尿素发放登记】:登记实际发放(发放金额、处理人、发放时间、附件;可关联申请或无申请补录)。
无审批流;申请提交后 待发放,发放登记后 已发放。
已确认业务规则
| # | 规则 | 决策 |
|---|---|---|
| D1 | 审批 | 无需审批 |
| D2 | 菜单 | 车辆尿素申请 / 车辆尿素发放登记 |
| D3 | 关联 | 1 申请 : 0~1 发放 |
| D4 | 无申请补录 | 允许 |
| D5 | 申请 vs 发放金额 | 计划 vs 实付;发放默认带出申请金额,可修改 |
| D6 | 申请金额 | 必填 > 0 |
| D7 | 发放金额 | 必填 > 0 |
| D8 | 入库数 | 必填,支持小数 |
| D9 | 单位 | 默认「吨桶」+ allow-create |
| D10 | 是否已处理 | 不设字段;发放提交 → disbursed |
| D11 | 申请人/处理人 | 用户下拉,默认当前登录人 |
| D12 | 单号 | 申请 SXNS* / 发放 SXUF* |
| D13 | 日期 | apply_date ≤ warehouse_in_date |
| D14 | 附件 | JPG/PNG/PDF,≤20MB,最多 5 个 |
| D15 | 删除 | 软删除;有关联发放的申请不可删;删发放释放申请为待发放 |
非目标(V1)
- 审批流、库存台账联动、报表导出、小程序、车辆状态联动、选车提醒
页面与路由
| 菜单 | Hash | menuCode |
|---|---|---|
| 车辆尿素申请 | /#/pl/vehicle-urea-apply |
pl:vehicle-urea-apply:list |
| 车辆尿素发放登记 | /#/pl/vehicle-urea-disburse |
pl:vehicle-urea-disburse:list |
侧栏 order_num: 35 / 36(运输管理下,维保之后)。
数据模型
pl_vehicle_urea_apply
| 字段 | 类型 | 说明 |
|---|---|---|
| apply_no | varchar(32) | SXNS+日期+6位 |
| license_plate | varchar(20) | 车牌 |
| applicant_id | varchar(64) | 申请人 |
| apply_date | date | 申请时间 |
| warehouse_in_date | date | 入库时间 |
| unit | varchar(32) | 单位 |
| quantity | decimal(10,2) | 入库数 |
| apply_amount | decimal(10,2) | 申请金额 |
| attachment_urls | varchar(2000) | 附件 |
| status | varchar(20) | pending / disbursed / cancelled |
pl_vehicle_urea_disburse
| 字段 | 类型 | 说明 |
|---|---|---|
| disburse_no | varchar(32) | SXUF+日期+6位 |
| apply_id | varchar(64) NULL | 关联申请,唯一 |
| license_plate | varchar(20) | 冗余 |
| amount | decimal(10,2) | 发放金额(实付) |
| handler_id | varchar(64) | 处理人 |
| disburse_date | date | 发放时间 |
| attachment_urls | varchar(2000) | 附件 |
字典
pl_urea_unit:吨桶(UI 预设 + allow-create,库内可存自由文本)pl_urea_apply_status:待发放 / 已发放 / 已作废
API 概要
| 路径 | 说明 |
|---|---|
/transport/vehicle-urea-apply/* |
申请 CRUD + 作废 |
/transport/vehicle-urea-disburse/disburse-board |
发放看板 |
/transport/vehicle-urea-disburse/* |
发放 CRUD |
发放弹窗交互
- 只读展示:车牌、入库时间、单位、入库数、申请金额
- 发放金额:默认 = 申请金额,可编辑(实付可与计划不同)
- 处理人:下拉,默认当前用户
- 发放时间:默认今天
实现参考
- 后端/页面:复制
pl_vehicle_recharge_*/vehicle-recharge-* - 申请扩展字段:入库时间、单位、数量、申请金额
sys_role_menu:固定 id / MD5,禁止单语句多行UUID()
OpenSpec:openspec/changes/vehicle-urea-management/