Files
shanxia2.0/docs/superpowers/specs/2026-11-12-document-reminder-edit-jump-design.md
T
wuzilongandCursor 01d607d766 feat(web-admin): open cert maintain dialog on reminder page
Keep users on the document reminder list by reusing vehicle/personnel
form dialogs instead of navigating away to base-info pages.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-12 19:29:37 +08:00

2.8 KiB
Raw Blame History

证件到期提醒本页维护证件弹窗(Web)

背景与问题

Web【证件到期提醒】展示车辆、人员证件过期信息。用户需要补录/更新证件时,若整页跳到【基础信息库】再返回,连续处理多条很麻烦。

已确认决策

项 结论
交互(方案 A) 在提醒页点「维护证件」,本页弹出与基础信息库同款编辑弹窗;关闭后仍停在提醒列表
车辆弹窗 复用 PlVehicleFormDialog;按 vehicleType 传 self / carrier
人员弹窗 复用 PlPersonnelFormDialog;按 personnelAffiliation 传 self / carrier
打开前 get 主体详情以判定归属;缺 ID / 失败则提示,不弹窗
保存后 刷新提醒列表与菜单角标;不自动将提醒标为已处理
整页跳转 提醒页「维护证件」不再 router.push 离开本页
editId 深链 车辆/人员档案页已有的 editId 能力可保留(书签/外链),与本页弹窗无关
后端 不改
范围 仅 Web

范围

包含

  • document-reminder.vue:操作列改为打开本页 PlVehicleFormDialog / PlPersonnelFormDialog
  • pl-document-reminder-jump.ts:增加表单模式解析(或复用归属判定);路径函数可保留给深链/兼容

不包含

  • 小程序
  • 保存后自动 resolve 提醒
  • 抽离档案列表页内联大表单(已有独立 dialog 组件则直接复用)

前端设计

提醒页

  1. 模板挂载:
<PlVehicleFormDialog
  v-model="vehicleFormVisible"
  :vehicle-type="vehicleFormType"
  :vehicle-id="editingOwnerId"
  @saved="handleOwnerFormSaved"
/>
<PlPersonnelFormDialog
  v-model="personnelFormVisible"
  :affiliation="personnelFormAffiliation"
  :personnel-id="editingOwnerId"
  @saved="handleOwnerFormSaved"
/>
  1. handleMaintainCert:校验 → get → resolveDocumentReminderFormMode → 设置 editingOwnerId 与 type/affiliation → vehicleFormVisible 或 personnelFormVisible = true。
  2. @saved:fetchData() + refreshMenuBadges();成功提示可选。
  3. 文案:「缺少主体信息,无法维护」等,不再提「跳转」。

模式解析

type ReminderFormMode =
  | { kind: 'vehicle'; vehicleType: 'self' | 'carrier' }
  | { kind: 'personnel'; affiliation: 'self' | 'carrier' }
  | null
  • vehicle + vehicleType self → self,否则 carrier
  • personnel + affiliation carrier → carrier,否则 self

验收

  1. 提醒页点「维护证件」不离开当前路由,弹出编辑框(含证件)。
  2. 关窗后列表仍在,可立刻点下一条。
  3. 保存后列表/角标刷新;提醒状态仍须手动「处理」。
  4. 车辆自有/三方、人员山峡/三方弹窗标题与校验与基础信息库一致。

状态

用户确认方案 A(本页弹窗)。实现于 V3.0。