59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
## 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`
|