Files
shanxia2.0/docs/superpowers/specs/2026-06-29-vehicle-urea-design.md
T
2026-06-29 11:15:39 +08:00

4.1 KiB
Raw Blame History

运输计划 · 车辆尿素申请与发放登记 — 设计文档

日期: 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 发放看板

目标

在运输管理模块新增 车辆尿素 管理能力:

  1. 【车辆尿素申请】:提交入库/采购类申请(车牌、申请人、申请时间、入库时间、单位、入库数、申请金额、附件、备注)。
  2. 【车辆尿素发放登记】:登记实际发放(发放金额、处理人、发放时间、附件;可关联申请或无申请补录)。

无审批流;申请提交后 待发放,发放登记后 已发放。

已确认业务规则

# 规则 决策
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/