6.7 KiB
6.7 KiB
运输计划 · 车辆维保申请与处理登记 — 设计文档
日期: 2026-06-29
状态: 已批准
前置:docs/superpowers/specs/2026-06-29-pl-vehicle-recharge-design.md(申请→登记两阶段参考)、docs/sql/pl_tables.sql(pl_vehicle)
界面模式: P01 标准列表 CRUD(双菜单);处理登记页参考 ETC 发放看板(申请 + 处理合并列表)
目标
在运输管理模块新增 车辆维保 管理能力,支持:
- 【车辆维保申请】:提交维保申请(车牌、申请人、申请时间、维保类型、开始/取车时间、内容、店铺地址、附件、备注)。
- 【车辆维保处理登记】:登记处理结果(金额、处理人、处理时间、附件;可关联申请或无申请补录)。
两菜单独立;本期不做审批流——申请提交后进入「待处理」,登记处理完成后变为「已处理」。
已确认业务规则
| # | 规则 | 决策 |
|---|---|---|
| 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 | 删除 | 软删除;已关联处理记录的申请不可删;删处理记录时释放申请为待处理 |
非目标(本期不做)
- 接入通用工作流 / 主管审批
- 维保店铺主数据维护
- 申请后自动将车辆设为「维修中」
- 维保费用统计报表、导出
- 小程序端申请
- 一次申请多次分批处理
选车维保提醒
在申请页(及处理页补录选车牌时)选择车牌后:
触发条件(同时满足):
- 存在该车牌 待处理(
status=pending)的维保申请; 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/