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

6.7 KiB
Raw Blame History

运输计划 · 车辆维保申请与处理登记 — 设计文档

日期: 2026-06-29
状态: 已批准
前置: docs/superpowers/specs/2026-06-29-pl-vehicle-recharge-design.md(申请→登记两阶段参考)、docs/sql/pl_tables.sql(pl_vehicle)
界面模式: P01 标准列表 CRUD(双菜单);处理登记页参考 ETC 发放看板(申请 + 处理合并列表)

目标

在运输管理模块新增 车辆维保 管理能力,支持:

  1. 【车辆维保申请】:提交维保申请(车牌、申请人、申请时间、维保类型、开始/取车时间、内容、店铺地址、附件、备注)。
  2. 【车辆维保处理登记】:登记处理结果(金额、处理人、处理时间、附件;可关联申请或无申请补录)。

两菜单独立;本期不做审批流——申请提交后进入「待处理」,登记处理完成后变为「已处理」。

已确认业务规则

# 规则 决策
D1 审批 无需审批;申请提交即「待处理」
D2 菜单结构 车辆维保申请 / 车辆维保处理登记
D3 申请与处理关联 1 申请 : 0~1 处理;已处理的申请不可再关联
D4 无申请补录 允许;apply_id 可空
D5 处理完成语义 提交处理登记即 已处理;不设独立「是否已处理」字段
D6 金额 非必填;有值须 > 0;可后补编辑
D7 申请人/处理人 下拉选择用户(fetchUserOptions);默认当前登录人
D8 维保类型 下拉预设(保养、维修、年检)+ allow-create 自定义;存 varchar 自由文本
D9 车辆状态联动 V1 不自动改 pl_vehicle.vehicle_status
D10 选车提醒 见 §选车维保提醒
D11 申请单号 SXWB + YYYYMMDD + 6 位序号
D12 处理单号 SXWC + YYYYMMDD + 6 位序号
D13 附件 JPG/PNG/PDF,单文件 ≤ 20MB,每单最多 5 个;MinIO 逗号分隔 URL
D14 删除 软删除;已关联处理记录的申请不可删;删处理记录时释放申请为待处理

非目标(本期不做)

  • 接入通用工作流 / 主管审批
  • 维保店铺主数据维护
  • 申请后自动将车辆设为「维修中」
  • 维保费用统计报表、导出
  • 小程序端申请
  • 一次申请多次分批处理

选车维保提醒

在申请页(及处理页补录选车牌时)选择车牌后:

触发条件(同时满足):

  1. 存在该车牌 待处理(status=pending)的维保申请;
  2. expected_pickup_date IS NULL 或 today <= expected_pickup_date。

不提醒:today > expected_pickup_date(即使仍为待处理)。

展示:ElMessageBox.alert 或等价弹窗,展示维保类型、开始时间、预计取车、内容、店铺地址、申请单号等;多条时合并展示或取最近一条(实现取 全部待提醒 列表)。

API:GET /api/transport/vehicle-maintenance-apply/reminders?licensePlate=xxx


页面与路由

菜单名 Hash 组件 menuCode
车辆维保申请 /#/pl/vehicle-maintenance-apply web-admin/src/views/pl/vehicle-maintenance-apply/index.vue pl:vehicle-maintenance-apply:list
车辆维保处理登记 /#/pl/vehicle-maintenance-process web-admin/src/views/pl/vehicle-maintenance-process/index.vue pl:vehicle-maintenance-process:list

侧栏位置:运输管理 → 与 ETC/加油 菜单并列(order_num 33 / 34)。

权限编码

模块 权限
申请 pl:vehicle-maintenance-apply:list query add edit remove cancel
处理 pl:vehicle-maintenance-process:list query add edit remove

数据模型

1. 申请单 pl_vehicle_maintenance_apply

字段 类型 说明
id varchar(64) UUID 主键
apply_no varchar(32) SXWB+日期+6位,唯一
license_plate varchar(20) 车牌,校验 pl_vehicle
applicant_id varchar(64) 申请人
apply_date date 申请时间
maintenance_type varchar(64) 维保类型(可自定义文本)
start_date date 维保开始时间
expected_pickup_date date NULL 预计取车时间
maintenance_content varchar(1000) 维保内容
shop_address varchar(500) 维保店铺地址
attachment_urls varchar(2000) 申请附件
status varchar(20) pending / processed / cancelled
+ 公共字段 tenant_no … del_flag

日期校验:apply_date <= start_date;若 expected_pickup_date 有值则 start_date <= expected_pickup_date。

2. 处理登记 pl_vehicle_maintenance_process

字段 类型 说明
id varchar(64) UUID 主键
process_no varchar(32) SXWC+日期+6位,唯一
apply_id varchar(64) NULL 关联申请,唯一索引(允许多 NULL)
license_plate varchar(20) 车牌冗余
amount decimal(10,2) NULL 金额(元)
handler_id varchar(64) 处理人
process_date date 处理时间
attachment_urls varchar(2000) 处理附件
+ 公共字段

字典

dict_type 预设
pl_maintenance_type 保养、维修、年检
pl_maintenance_apply_status 待处理、已处理、已作废

状态流转

创建申请 → pending
pending + 登记处理(有 apply_id)→ processed
pending → cancelled(作废)
删除处理记录 → 关联申请回 pending

API 概要

方法 路径 说明
GET /transport/vehicle-maintenance-apply/ 申请分页列表
POST /transport/vehicle-maintenance-apply/ 新建申请
PUT /transport/vehicle-maintenance-apply/{id} 编辑(仅 pending)
POST /transport/vehicle-maintenance-apply/{id}/cancel 作废
DELETE /transport/vehicle-maintenance-apply/{id} 软删
GET /transport/vehicle-maintenance-apply/reminders 选车提醒
GET /transport/vehicle-maintenance-process/process-board 处理看板(申请 LEFT JOIN 处理)
POST /transport/vehicle-maintenance-process/ 新建处理(含补录)
PUT /transport/vehicle-maintenance-process/{id} 编辑处理
DELETE /transport/vehicle-maintenance-process/{id} 软删处理

实现参考

复制并改造 ETC/加油 模块:

  • 后端:pl_vehicle_recharge_service.py → pl_vehicle_maintenance_service.py
  • 前端:vehicle-recharge-apply / vehicle-recharge-record → 维保对应页面
  • 静态路由:web-admin/src/router/modules/pl.ts

OpenSpec

变更目录:openspec/changes/vehicle-maintenance-management/