shanxia2.0/openspec/changes/vehicle-maintenance-management/proposal.md

Why

客户需要在运输管理模块中管理车辆维保全流程：业务人员提交维保申请，车管/财务登记处理结果与费用。现有 ETC/加油 已验证「申请 + 登记」双菜单模式，维保场景字段更多且需选车提醒，宜平行扩展而非改造 ETC 模块。

What Changes

新增功能模块

1. 车辆维保申请

   • 车牌、申请人、申请时间、维保类型（预设 + 自定义）、维保开始/预计取车时间、内容、店铺地址、附件、备注
   • 无审批；提交后状态为「待处理」
   • 选车时弹窗提醒该车未过期（预计取车日前）的待处理维保信息

2. 车辆维保处理登记

   • 看板列表合并展示申请与处理信息
   • 待处理行内「处理」；已处理可编辑/撤销
   • 支持无申请补录
   • 处理字段：金额（可选）、处理人、处理时间、附件

数据库变更

• 新增 pl_vehicle_maintenance_apply
• 新增 pl_vehicle_maintenance_process
• 新增字典 pl_maintenance_type、pl_maintenance_apply_status
• 新增菜单与按钮权限（运输管理下）

API 变更

• 新增 /api/transport/vehicle-maintenance-apply/*
• 新增 /api/transport/vehicle-maintenance-process/*

Capabilities

New Capabilities

• vehicle-maintenance: 车辆维保申请与处理登记 — 双表 CRUD、状态联动、选车提醒、处理看板

Modified Capabilities

• （无）

Impact

受影响系统

• 后端：backend/app/models/pl_models.py、services/、api/pl/、schemas/pl/
• 前端：web-admin/src/views/pl/、api/pl/index.ts、router/modules/pl.ts、utils/pl-display.ts
• 数据库：docs/sql/migrations/、docs/sql/pl_tables.sql

外部依赖

• pl_vehicle — 车牌校验
• sys_user — 申请人/处理人
• MinIO — 附件

参考实现

• pl_vehicle_recharge_* / vehicle-recharge-apply / vehicle-recharge-record