Files
shanxia2.0/openspec/changes/vehicle-maintenance-management/specs/vehicle-maintenance/spec.md
T
2026-06-29 11:15:39 +08:00

5.6 KiB
Raw Blame History

ADDED Requirements

Requirement: 车辆维保申请提交

系统 SHALL 允许用户在「车辆维保申请」页创建维保申请,包含车牌号、申请人、申请时间、维保类型、维保开始时间、预计取车时间(可空)、维保内容、维保店铺地址、附件与备注。申请提交后状态 SHALL 为 pending(待处理),且 SHALL NOT 触发审批流。

Scenario: 成功创建申请

  • WHEN 用户填写必填字段并提交新建申请
  • THEN 系统生成唯一申请单号(前缀 SXWB + 日期 + 6 位序号)
  • AND 申请状态为待处理
  • AND 申请人默认为当前登录用户且可修改

Scenario: 车牌不存在

  • WHEN 用户提交的车牌号不在 pl_vehicle 中
  • THEN 系统拒绝创建并返回错误提示

Scenario: 日期顺序非法

  • WHEN 申请时间晚于维保开始时间,或开始时间晚于预计取车时间(取车时间有值时)
  • THEN 系统拒绝保存并提示日期顺序错误

Requirement: 车辆维保申请维护

系统 SHALL 允许用户对状态为 pending 的申请进行编辑、作废与软删除。已处理或已作废的申请 SHALL NOT 允许编辑。已关联处理记录的申请 SHALL NOT 允许删除。

Scenario: 编辑待处理申请

  • WHEN 用户编辑状态为待处理的申请并保存
  • THEN 系统更新申请字段并保持状态为待处理

Scenario: 作废申请

  • WHEN 用户对待处理申请执行作废
  • THEN 申请状态变为 cancelled(已作废)

Requirement: 维保类型输入

系统 SHALL 在申请表单提供维保类型下拉,预设选项为保养、维修、年检,且 SHALL 允许用户输入自定义类型文本。自定义类型 SHALL 以文本形式存储,SHALL NOT 强制写入字典表。

Scenario: 选择预设类型

  • WHEN 用户从下拉选择「保养」
  • THEN 申请记录的维保类型保存为「保养」

Scenario: 输入自定义类型

  • WHEN 用户在下拉中输入并确认自定义类型「四轮定位」
  • THEN 申请记录的维保类型保存为「四轮定位」

Requirement: 选车维保提醒

系统 SHALL 在用户选择车牌时查询该车牌待处理的维保申请,并在满足提醒条件时弹出维保信息提醒。提醒条件为:申请状态为 pending,且(预计取车时间为空 或 当前日期小于等于预计取车时间)。当当前日期大于预计取车时间时,系统 SHALL NOT 弹出提醒。

Scenario: 存在未过期待处理申请时提醒

  • WHEN 用户选择某车牌且该车牌存在待处理申请,预计取车日为今天或未来
  • THEN 系统弹窗展示该申请的维保类型、时间、内容、店铺地址等信息

Scenario: 超过预计取车日后不提醒

  • WHEN 用户选择某车牌且该车牌存在待处理申请,但预计取车日早于今天
  • THEN 系统不弹出维保提醒

Scenario: 预计取车时间为空仍提醒

  • WHEN 用户选择某车牌且该车牌存在待处理申请,预计取车时间为空
  • THEN 系统弹窗展示维保信息直至该申请被处理或作废

Requirement: 车辆维保处理登记

系统 SHALL 在「车辆维保处理登记」页提供处理看板,合并展示申请信息与处理信息。用户 SHALL 能够对待处理申请执行「处理」登记,登记字段包括金额(可选,有值时须大于 0)、处理人、处理时间、附件与备注。提交处理登记后,关联申请状态 SHALL 变为 processed(已处理)。

Scenario: 关联申请的处理登记

  • WHEN 用户对某待处理申请执行处理并提交
  • THEN 系统创建处理记录(单号前缀 SXWC)
  • AND 关联申请状态变为已处理
  • AND 同一申请 SHALL NOT 存在第二条有效处理记录

Scenario: 金额为空允许提交

  • WHEN 用户提交处理登记未填写金额
  • THEN 系统允许保存且处理记录金额为空

Scenario: 金额非法

  • WHEN 用户填写金额小于等于 0
  • THEN 系统拒绝保存

Requirement: 无申请补录

系统 SHALL 允许用户在处理登记页创建不关联申请单的处理记录(无申请补录),此时 apply_id SHALL 为空。

Scenario: 无申请补录

  • WHEN 用户通过「无申请补录」创建处理记录且不选择申请单
  • THEN 系统保存处理记录且 apply_id 为空

Requirement: 处理记录撤销与编辑

系统 SHALL 允许编辑已存在的处理记录(含补填金额)。删除处理记录时,若其关联申请,系统 SHALL 将申请状态恢复为 pending。

Scenario: 删除处理释放申请

  • WHEN 用户删除某条关联申请的处理记录
  • THEN 处理记录软删除
  • AND 原关联申请状态恢复为待处理

Requirement: 租户与权限隔离

所有维保申请与处理数据的查询与写入 SHALL 按当前用户租户过滤。列表与详情 SHALL 应用数据权限范围。删除 SHALL 为软删除(del_flag=1)。

Scenario: 跨租户不可见

  • WHEN 用户 A 所属租户与维保数据租户不一致
  • THEN 用户 A 无法查询或修改该数据

Requirement: Web 管理端 UI 规范

维保申请与处理登记页面 SHALL 遵循 Fresh Mint 规范:标准列表面板、弹窗表单 label-position="top"、状态字段使用 el-tag、操作列 fixed="right"。菜单 SHALL 注册于运输管理静态路由与数据库菜单。

Scenario: 菜单可访问

  • WHEN 已授权用户登录并展开运输管理
  • THEN 可见「车辆维保申请」与「车辆维保处理登记」菜单项