57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# 车辆维保申请与处理登记 — Implementation Plan
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans.
|
||
|
||
**Goal:** 在运输管理下新增「车辆维保申请」「车辆维保处理登记」,复用 ETC/加油 架构,含选车维保提醒。
|
||
|
||
**Architecture:** `pl_vehicle_maintenance_apply` + `pl_vehicle_maintenance_process`;`pl_vehicle_maintenance_service.py`;两 Vue 页面 + process-board API。
|
||
|
||
**Spec:** `docs/superpowers/specs/2026-06-29-vehicle-maintenance-design.md`
|
||
**OpenSpec:** `openspec/changes/vehicle-maintenance-management/`
|
||
|
||
---
|
||
|
||
## 文件结构
|
||
|
||
| 文件 | 职责 |
|
||
|------|------|
|
||
| `docs/sql/migrations/2026-06-29-pl-vehicle-maintenance.sql` | DDL + 字典 + 菜单 |
|
||
| `backend/app/models/pl_models.py` | ORM |
|
||
| `backend/app/schemas/pl/vehicle_maintenance.py` | Pydantic |
|
||
| `backend/app/services/pl_vehicle_maintenance_service.py` | 业务逻辑 |
|
||
| `backend/app/api/pl/vehicle_maintenance.py` | REST |
|
||
| `web-admin/src/views/pl/vehicle-maintenance-apply/index.vue` | 申请页 |
|
||
| `web-admin/src/views/pl/vehicle-maintenance-process/index.vue` | 处理页 |
|
||
| `web-admin/src/api/pl/index.ts` | 前端 API |
|
||
| `web-admin/src/router/modules/pl.ts` | 静态路由 |
|
||
|
||
**API 前缀:** `/api/transport/vehicle-maintenance-apply/*`、`/api/transport/vehicle-maintenance-process/*`
|
||
|
||
---
|
||
|
||
## 实现顺序
|
||
|
||
1. SQL 迁移 → ORM → Schema → Service → API
|
||
2. 前端 API + pl-display → 申请页 → 处理页 → 路由
|
||
3. 联调选车提醒与 process-board
|
||
4. graphify 更新
|
||
|
||
**参考复制源:** `pl_vehicle_recharge_*`、`vehicle-recharge-apply`、`vehicle-recharge-record`
|
||
|
||
---
|
||
|
||
## 关键差异对照 ETC
|
||
|
||
| 项 | ETC | 维保 |
|
||
|----|-----|------|
|
||
| 申请状态 | pending/disbursed/cancelled | pending/**processed**/cancelled |
|
||
| 处理单号 | SXCL | SXWC |
|
||
| 金额 | 必填 | **可选** |
|
||
| 类型 | 固定枚举 | **allow-create** |
|
||
| 选车 | 无 | **reminders API + 弹窗** |
|
||
| 车辆状态 | 无 | V1 **不联动** |
|
||
|
||
---
|
||
|
||
详细任务勾选见 `openspec/changes/vehicle-maintenance-management/tasks.md`。
|