From 98439ee3a8ef126ccff99baa4507c176008d4685 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E5=86=95?= Date: Sat, 18 Jul 2026 10:31:55 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E5=B0=8F=E7=A8=8B=E5=BA=8F?= =?UTF-8?q?=E6=A0=87=E6=B3=A8=E7=9B=AE=E5=BD=95=E4=B8=8E=20PRD=20V1.3.2?= =?UTF-8?q?=EF=BC=8C=E4=BE=9B=E5=8E=9F=E5=9E=8B=E5=AF=BC=E8=88=AA=E8=AF=BB?= =?UTF-8?q?=E5=8F=96=E6=9C=80=E6=96=B0=E8=AF=B4=E6=98=8E=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- src/prototypes/xll-miniapp/annotation-source.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/prototypes/xll-miniapp/annotation-source.json b/src/prototypes/xll-miniapp/annotation-source.json index 44deb0c..56a4922 100644 --- a/src/prototypes/xll-miniapp/annotation-source.json +++ b/src/prototypes/xll-miniapp/annotation-source.json @@ -5,7 +5,7 @@ "version": 2, "prototypeName": "xll-miniapp", "pageId": "todo", - "updatedAt": 1782802781462, + "updatedAt": 1784341606543, "nodes": [ { "id": "page-todo", @@ -309,7 +309,7 @@ "page-business": "# 业务页\n\n分三大区：运维管理、审批管理、数据可视化。\n\n点击模块图标跳转到对应独立原型页（hash 路由），各页内列表与表单可直接跳转。", "page-audit": "# 审批中心\n\n四类列表：我发起的、我的待办、我的已办、抄送我的。\n\n### 筛选与搜索\n\n- **流程类型 Chip**：全部、合同审批、提车应收款、租赁账单、还车应结款（含四部门子类型）、车辆调拨；「更多类型」抽屉展示全部流程类型。\n- **更多筛选**（搜索框右侧筛选按钮）：发起人、发起时间（开始至结束）。\n- **搜索**：按卡片加粗标题（工作流标题）模糊匹配，如提车应收款为**客户全称**、还车应结款为**车牌号**。\n\n### 更多筛选交互（小程序式）\n\n| 能力 | 说明 |\n| --- | --- |\n| 底部抽屉 | 「更多筛选」限定在**手机预览框内**弹出，不铺满浏览器（`.xll-mod-sheet-*`） |\n| 发起人 | 点击「请选择 ›」→ 底部滚轮；首项「不限」 |\n| 发起时间 | 「开始日期 至 结束日期」→ 年/月/日三列滚轮，取消/确定 |\n| 嵌套选择器 | 滚轮叠在筛选抽屉之上，高亮条在文字下层 |\n\n### 列表卡片（以提车应收款为例）\n\n| 区域 | 说明 |\n| --- | --- |\n| 左上角标签 | 流程类型，如「提车应收款」 |\n| 右上角状态 | 审批中 + 当前节点审批人（最多 2 人，超出显示 +N） |\n| 加粗标题 | 客户名称全称 |\n| 副标题 | 合同项目名称 |\n| 元信息 | 发起人、实收金额（选中车辆租金+服务费+保证金合计） |\n| 底部 | 发起时间精确至分钟；待办卡片可点「去审批」或整卡进入办理页 |\n\n**还车应结款**：主流程以车牌为主标题；子流程主标题为「还车应结款-部门名」。四部门子流程全部通过后，须由**业务管理组主动发起**主流程审批，任务才会进入审批列表。\n\n### 需求文档入口\n\n导航栏**不设**「需求说明」按钮；PRD 见标注目录「PRD 01｜审批中心改版说明」。\n\n### 审批操作弹窗\n\n待办详情底部「通过」「驳回」「终止」「评论」均从手机屏幕底部滑出半屏表单（限定在手机预览框内，非全浏览器宽）；通过/驳回/终止除标题外字段一致（通知方式、附件上传、抄送人、审批意见）。「通过」标题为「审批通过」。", "page-audit-return": "# 还车应结款\n\n**主工作流**「还车应结款」汇总四部门费用与应退/应补总额。\n\n**四个子流程**（各部门独立提交）：还车应结款-业务管理组、还车应结款-能源服务组、还车应结款-运维组、还车应结款-安全部。\n\n**主流程发起规则**：四部门子流程全部审批通过后，**不会自动生成**主流程任务；须由**业务管理组主动发起**主流程审批，发起后任务才会出现在审批列表。\n\n子流程 Hero 统一为「还车应结款-部门名」+ 车牌重点样式，仅展示本部门费用。\n\n### 原型 mock 场景\n\n| 场景 | 车牌 | 说明 |\n| --- | --- | --- |\n| A | 粤B58888F | 四部门已通过 → 业务管理组已发起 → 主流程在待办 |\n| B | 浙F06901F | 四部门子流程均在待办 |\n| C | 苏E12345F | 四部门已通过 → 业务管理组尚未发起 → 主流程不在列表 |\n\n### 部门结算卡片状态标签\n\n各分组费用卡片右上角展示本部门子流程提交状态：\n\n| 状态 | 展示文案 | 触发条件 |\n| --- | --- | --- |\n| 待提交 | 待提交 | 表单未提交、子流程未发起 |\n| 审批中 | 审批中 | 用户已提交子流程审批 |\n| 已提交 | 已提交 | 该部门子流程全部审批完成 |\n| 已驳回 | 已驳回 | 子流程审批被驳回 |\n\n**主流程详情**：四张分组卡片右上角均展示「已提交」（四部门已全部完成子流程审批，且业务管理组已发起主流程后才可进入）。\n\n| 部门 | 费用要点 |\n| --- | --- |\n| 业务管理组 | ETC、停车费等 |\n| 能源服务组 | 氢量差补缴、预付款退费等 |\n| 运维组 | 含「无忧包减免」列，应结算 = 金额 − 减免 |\n| 安全部 | 违章违约金、保险上浮、其他违规费用 |\n\n详见「PRD 01｜审批中心改版说明」。", - "page-delivery": "# 交车\n\n列表与多步骤交车办理在同一原型页内切换。\n\n完整产品需求见标注目录 **PRD 02｜交车说明**（与 `page-delivery` 标注节点对应）。", + "page-delivery": "# 交车\n\n列表与多步骤交车办理在同一原型页内切换。\n\n### V1.3.2 要点\n\n- **连拍相册单选**：连拍环节相册每次只能选 1 张\n- **瑕疵/其他多选**：补充照片仍可相册批量添加\n- **连拍自动保存**：点「完成」进入下一项时静默保存草稿\n- **拍照操作条**：拍照/相册及完成态三按钮等宽平铺\n- **被授权人空态**：合同无授权人时提示联系业管，并阻断发送签章\n\n完整产品需求见标注目录 **PRD 02｜交车说明**（与 `page-delivery` 标注节点对应）。\n", "page-inspection": "# 年审\n\n待办列表与检测表单在同一原型页内切换。", "page-vehicle": "# 车辆管理\n\n车辆列表与详情在同一原型页内切换。\n\n## 列表\n- 顶部 KPI：全部 / GPS 在线 / GPS 离线，可点击筛选\n- 卡片展示车牌、运营状态、GPS 状态、当前位置摘要\n- 支持搜索、运营状态与车辆状态筛选\n\n## 详情 · 车辆详情 Tab\n- **车辆位置**：参照交车表单，腾讯地图风格底图 + 定位标记 + 地址与坐标 + GPS 上传时间\n- 运营信息、车辆档案、权属与停放、交还车记录分卡片展示", "page-vehicle-detail-location": "# 车辆位置\n\n展示方式与交车表单「交车位置」一致：\n\n- 腾讯地图风格底图\n- 在线车辆显示定位标记与经纬度\n- 底部展示详细地址\n- 离线车辆地图置灰，无标记\n- 下方展示 GPS 上传时间", @@ -317,10 +317,10 @@ "page-replace": "# 替换车\n\n申请列表与详情/办理在同一原型页内切换。", "page-map": "# 地图模块\n\n## 核心资源\n氢能车 · 加氢站 · 维修站\n\n## 角色权限\n内部（管理/运维/授权）可见全量；外部（客户/司机/车队）按授权过滤。\n\n## 浏览模式\n1. **地图**：聚合点 → 展开标记 → 详情（多层信息 Tab）\n2. **列表**：搜索筛选 + 卡片穿透详情\n3. **统计**：KPI 卡片下钻列表明细", "page-mine": "# 我的\n\n展示当前用户头像、姓名、岗位与联系方式。", - "prd-overview": "# 小羚羚小程序 · 总览\n\n氢能车辆运营移动端原型，面向一线运维与管理人员。**原型无需登录**，默认进入工作台。\n\n## 核心路径\n\n1. 工作台处理待办\n2. 业务 → 进入各运维 / 审批模块（独立原型页）\n3. 审批中心 → 本页内跳转**本期已接入**的审批工作流（提车应收款、还车应结款及子类型、租赁账单、车辆调拨、替换车申请等）\n\n## 页面导航\n\n左侧预览列表可切换 10 个功能页；各业务模块内列表与表单在同一页内跳转。\n\n## 最新改版\n\n审批中心与还车应结款多部门子流程见 **PRD 01｜审批中心改版说明**（V1.4）。\n\n### 审批中心要点（与标注 `page-audit` 一致）\n\n- 搜索：仅按卡片加粗标题（工作流标题）模糊匹配\n- 更多筛选：发起人（滚轮选择）、发起时间（年/月/日滚轮，起止日期）\n- 底部抽屉与选择器：限定在手机预览框内，模拟小程序交互\n- 还车应结款：主流程以车牌为主标题；四部门子流程以「还车应结款-部门名」为主标题；四部门全过后须业务管理组发起主流程\n\n## 需求文档与标注\n\n- **标注目录**：PRD 00 / PRD 01 / PRD 02 及页面说明（`page-audit`、`page-delivery` 等）\n- **PRD 02｜交车说明**：交车列表、分步办理与签章流程\n- **导航栏**：不设「需求说明」入口；以标注工具与目录为主\n- **业务评审**：`.spec/prototype-review.md`\n", + "prd-overview": "# 小羚羚小程序 · 总览\n\n氢能车辆运营移动端原型，面向一线运维与管理人员。**原型无需登录**，默认进入工作台。\n\n## 核心路径\n\n1. 工作台处理待办\n2. 业务 → 进入各运维 / 审批模块（独立原型页）\n3. 审批中心 → 本页内跳转**本期已接入**的审批工作流（提车应收款、还车应结款及子类型、租赁账单、车辆调拨、替换车申请等）\n\n## 页面导航\n\n左侧预览列表可切换 10 个功能页；各业务模块内列表与表单在同一页内跳转。\n\n## 最新改版\n\n### 交车模块（PRD 02 · V1.3.2，2026-07-01）\n\n- **连拍相册单选**：连拍环节相册为单选模式，每次只能选 1 张\n- **瑕疵/其他多选**：补充照片仍支持相册一次选多张\n- **连拍自动保存**：每次确认照片并进入下一项时静默保存草稿\n- **拍照操作条**：「拍照 / 相册」及完成态三按钮等宽平铺\n\n### 审批中心（PRD 01 · V1.4）\n\n审批中心与还车应结款多部门子流程见 **PRD 01｜审批中心改版说明**。\n\n#### 审批中心要点（与标注 `page-audit` 一致）\n\n- 搜索：仅按卡片加粗标题（工作流标题）模糊匹配\n- 更多筛选：发起人（滚轮选择）、发起时间（年/月/日滚轮，起止日期）\n- 底部抽屉与选择器：限定在手机预览框内，模拟小程序交互\n- 还车应结款：主流程以车牌为主标题；四部门子流程以「还车应结款-部门名」为主标题；四部门全过后须业务管理组发起主流程\n\n## 需求文档与标注\n\n- **标注目录**：PRD 00 / PRD 01 / PRD 02 及页面说明（`page-audit`、`page-delivery` 等）\n- **PRD 02｜交车说明**：交车列表、分步办理与签章流程（含 V1.3.2 连拍相册单选与连拍自动保存）\n- **导航栏**：不设「需求说明」入口；以标注工具与目录为主\n- **业务评审**：`.spec/prototype-review.md`\n", "prd-approval-v11": "# 小羚羚小程序 · 审批中心改版说明\n\n**文档版本**：V1.4 \n**更新日期**：2026-06-29 \n**适用范围**：审批中心、还车应结款、提车应收款及相关导航结构\n\n---\n\n## 一、改版背景\n\n本次迭代聚焦审批体验与还车应结款多部门子流程，并调整原型信息架构：去除登录门槛、按功能拆分为独立预览页，便于评审与交付。\n\n---\n\n## 二、信息架构与导航\n\n### 2.1 去除登录\n\n- 原型默认进入「工作台 · 待办」，无需登录页。\n- 左侧预览列表可切换 **10 个功能页**（hash 路由）。\n- 源码中仍保留登录页组件与样式，**不在默认导航与预览目录中暴露**；评审以「免登录直达工作台」为准。\n\n### 2.2 页面清单\n\n| 路由 | 页面 | 说明 |\n| --- | --- | --- |\n| `todo` | 工作台 | 待办聚合，默认入口 |\n| `business` | 业务 | 运维 / 审批 / 数据可视化入口 |\n| `map` | 地图 | 氢能车与加氢站 |\n| `mine` | 我的 | 个人信息 |\n| `audit` | 审批中心 | 列表 + 本页内跳转各审批详情 |\n| `audit-return` | 还车应结款（说明） | 还车应结款专项说明页 |\n| `delivery` | 交车 | 列表与办理表单同页切换 |\n| `inspection` | 年审 | 列表与办理表单同页切换 |\n| `vehicle` | 车辆管理 | 列表与详情同页切换 |\n| `third-return` | 三方退车 | 列表与办理同页切换 |\n| `replace` | 替换车 | 列表与详情同页切换 |\n\n### 2.3 核心路径\n\n1. 工作台处理待办 → 「去处理」跳转对应业务页 \n2. 业务 → 进入各运维 / 审批模块（独立原型页） \n3. 审批中心 → 本页内打开**本期已接入**的审批工作流详情（见 §3.5）\n\n### 2.4 需求文档入口\n\n- 导航栏**不设**「需求说明」按钮（按批注已移除该入口）。\n- 需求与 PRD 通过**左侧标注目录**（「PRD 00｜小程序总览」「PRD 01｜审批中心改版说明」）及页面标注节点（如 `page-audit`）查看。\n\n---\n\n## 三、审批中心列表\n\n### 3.1 Tab\n\n四类：**我发起的**、**我的待办**、**我的已办**、**抄送我的**。\n\n### 3.2 筛选与搜索\n\n- **流程类型 Chip**：全部、合同审批、提车应收款、租赁账单、**还车应结款**（含四部门子类型）、车辆调拨等；「更多类型」抽屉展示全部流程类型。\n- 「还车应结款」Chip 同时匹配主流程与四个部门子流程。\n- **更多筛选**（搜索框右侧筛选按钮）：**发起人**、**发起时间**（开始至结束，按日期区间过滤）。\n- **搜索**：按**卡片加粗标题（工作流标题）**模糊匹配；不按单据号、摘要等多字段联合检索。示例：提车应收款搜**客户全称**；还车应结款主流程搜**车牌号**；还车四部门子流程搜**「还车应结款-部门名」**。\n\n> **决策说明**（与 `page-audit` 标注一致）：发起人、发起时间从搜索中拆出，归入「更多筛选」，搜索仅面向列表主识别字段。\n\n### 3.3 列表卡片字段\n\n以提车应收款为例：\n\n| 区域 | 说明 |\n| --- | --- |\n| 左上角标签 | 流程类型，如「提车应收款」 |\n| 右上角状态 | 审批中 + 当前节点审批人（最多 2 人，超出显示 +N） |\n| 加粗标题 | 工作流标题（见 §3.4 标题规则） |\n| 副标题 | 合同项目名称等 |\n| 元信息 | 发起人、实收金额（提车：选中车辆租金 + 服务费 + 保证金合计，**不含氢费预付款**） |\n| 底部 | 发起时间精确至分钟；待办卡片可点「去审批」或整卡进入办理页 |\n\n**还车应结款**：主流程以车牌为主标题并展示应退/应补；四部门子流程主标题为「还车应结款-部门名」，不展示汇总金额。四部门子流程全部通过后，须由**业务管理组主动发起**主流程审批，任务才会进入审批列表。\n\n### 3.4 列表卡片标题规则\n\n| 类型 | 主标题（加粗） | 辅信息 | 金额 |\n| --- | --- | --- | --- |\n| 主流程「还车应结款」 | **车牌号** | 客户、项目等 | 展示应退 / 应补 |\n| 四部门子流程 | **还车应结款-部门名** | 车牌、客户等 | 不展示汇总金额 |\n| 提车应收款 | **客户全称** | 合同项目 | 实收金额（见 §3.3） |\n| 租赁账单 / 替换车申请 | **客户全称** | — | 按业务 |\n| 车辆调拨 | **调拨路线摘要** | — | 按业务 |\n| 其他流程 | 摘要或单据号 | — | 按业务 |\n\n部门子流程包括：**还车应结款-业务管理组**、**还车应结款-能源服务组**、**还车应结款-运维组**、**还车应结款-安全部**。\n\n### 3.5 跳转与本期原型范围\n\n**已接入详情页（页内跳转）**：提车应收款、还车应结款（含四部门子类型）、租赁账单、车辆调拨、替换车申请。待办 Tab 展示底部操作栏；其余 Tab 为只读查看态。\n\n**列表占位（点击 Toast 提示，暂无办理页）**：合同审批、氢费对账单（对站/对客）、车辆异动等。演示时可在列表中看到待办，但无法进入完整办理流程。\n\n**审批操作弹窗**：待办详情底部「通过」「驳回」「终止」「评论」均从手机屏幕底部滑出半屏表单（限定在手机预览框内）；通过/驳回/终止除标题外字段一致（通知方式、附件上传、抄送人、审批意见）。「通过」标题为「审批通过」。\n\n### 3.6 更多筛选交互（小程序式）\n\n| 能力 | 规则 |\n| --- | --- |\n| 底部抽屉 | 「更多筛选」及同类 `.xll-mod-sheet-*` 抽屉从**手机预览框底部**滑出，遮罩与面板相对当前页面模块定位，**不铺满浏览器全屏** |\n| 发起人 | 表单行展示「请选择 ›」；点击后弹出底部**滚轮选择器**，选项来自 mock 发起人列表，首项「不限」 |\n| 发起时间 | 「开始日期 至 结束日期」两行可点；分别弹出**年 / 月 / 日**三列滚轮，工具栏「取消 / 确定」 |\n| 嵌套层级 | 滚轮选择器叠在筛选抽屉之上（`z-index` 更高），同样限定在手机预览框内；选中高亮条在文字下层，不遮挡选项文字 |\n\n---\n\n## 四、还车应结款审批\n\n### 4.1 流程结构\n\n**主工作流**：`还车应结款` — 汇总四部门费用，判定保证金抵扣后的应退/应补。\n\n**四个子流程**（各部门独立提交审批）：\n\n| 子流程 | 提交部门 |\n| --- | --- |\n| 还车应结款-业务管理组 | 业务管理组 |\n| 还车应结款-能源服务组 | 能源服务组 |\n| 还车应结款-运维组 | 运维组 |\n| 还车应结款-安全部 | 安全部 |\n\n**提交规则**：\n\n1. 四个子流程分别由对应部门填报费用并**独立提交审批**；\n2. 四个子流程**全部审批通过**后，**不会自动生成**主流程「还车应结款」审批任务；\n3. 须由**业务管理组**在还车结算侧**主动发起**主流程审批，发起后任务进入审批列表；\n4. 主流程进入列表后，由财务等环节整体审批；详情页展示四部门子流程通过状态；\n5. 四部门未全部通过前，主流程不可发起；若已进入主流程详情，「通过」操作在四部门未全过时仍被拦截。\n\n#### 原型 mock 场景（开发 / 测试对照）\n\n| 场景 | 车牌 | 单据号 | 说明 |\n| --- | --- | --- | --- |\n| A | 粤B58888F | HC-2026-0418 | 四部门已通过 → 业务管理组已发起 → 主流程在「我的待办」（财务审核） |\n| B | 浙F06901F | HC-2026-0625 | 四部门子流程均在待办（审批中）；主流程未发起 |\n| C | 苏E12345F | HC-2026-0610 | 四部门已通过 → 业务管理组**尚未发起** → 主流程不出现在列表 |\n\n> 主流程发起人 mock 为业务管理组人员（如陈高伟）；发起时间晚于四部门子流程全部通过时间。\n\n### 4.2 Hero 区规则\n\n| 类型 | Hero 主信息 | 是否展示应退/应补 |\n| --- | --- | --- |\n| 主流程「还车应结款」 | 应退还总额 / 应补缴总额；保证金、待结算总额、车辆实际租金；「结算明细」抽屉；部门子流程进度 | **是** |\n| 业务管理组子流程 | 「还车应结款-业务管理组」+ **车牌重点样式** | 否 |\n| 能源服务组子流程 | 「还车应结款-能源服务组」+ 车牌重点样式 | 否 |\n| 运维组子流程 | 「还车应结款-运维组」+ 车牌重点样式 | 否 |\n| 安全部子流程 | 「还车应结款-安全部」+ 车牌重点样式 | 否 |\n\n**车牌重点样式**：Hero 内展示「车牌号」标签 + 加粗胶囊样式车牌，便于子流程快速识别车辆。\n\n子流程 Hero **不展示**保证金、待结算总额、应退/应补等汇总类金额。\n\n### 4.3 分组费用明细\n\n#### 业务管理组\n\n- 固定费项表格（如 ETC 费用、停车费等）。\n- **不含**违章处理违约金、保险上浮（归属安全部）。\n- 底部展示本部门应结算总额。\n\n#### 能源服务组\n\n- 氢量差补缴、交/还车氢量、退还单价、预付款退费等。\n\n#### 运维组\n\n- 费项：清洗、保养、维修、车损、工具/证件/广告丢失、送接车服务、轮胎磨损等。\n- 表格列：**序号 / 费用项 / 金额 / 无忧包减免**（横向滚动，减免为输入框样式只读展示）。\n- **应结算 = 金额 − 无忧包减免**（按行合计后汇总）。\n\n#### 安全部\n\n- **固定费项三行**（由安全部填报）：\n 1. 违章处理违约金 \n 2. 保险上浮 \n 3. 其他违规费用 \n- 保留违章统计区：违章次数、已缴/未缴金额等。\n- 应结算总额为上述三行费用合计。\n\n#### 部门结算卡片状态标签\n\n各分组费用卡片右上角展示本部门子流程提交状态：\n\n| 状态 | 展示文案 | 触发条件 |\n| --- | --- | --- |\n| 待提交 | 待提交 | 表单未提交、子流程未发起 |\n| 审批中 | 审批中 | 用户已提交子流程审批 |\n| 已提交 | 已提交 | 该部门子流程全部审批完成 |\n| 已驳回 | 已驳回 | 子流程审批被驳回 |\n\n**主流程详情**：四张分组卡片右上角均展示「已提交」（四部门已全部完成子流程审批，且业务管理组已发起主流程后才可进入主流程详情）。\n\n### 4.4 审批操作\n\n- **审批情况**：纵向时间轴，节点展示审批人头像、状态 Tag、时间与评论气泡。\n- **待办态底部**：评论、终止、驳回、通过（规则同提车应收款）。\n- **查看态**：隐藏操作栏，仅浏览。\n\n---\n\n## 五、提车应收款审批\n\n### 5.1 页面目标\n\n审批人核对实收金额、车辆明细、氢费预付款（如有）及开票信息。\n\n### 5.2 布局细节\n\n- **车辆明细**：区块标题行（`.tc-section-head`）与首张车辆卡片之间保留 **12px** 上间距，避免标题分隔线与首卡紧贴。\n- **审批情况**：时间轴支持评论展示；待办态底部操作同还车应结款。\n\n### 5.3 实收金额口径\n\n| 位置 | 规则 |\n| --- | --- |\n| 列表卡片 | 选中车辆 **租金 + 服务费 + 保证金 − 减免** 合计（**不含氢费预付款**），由车辆明细动态汇总 |\n| 详情 Hero | 与列表卡片**同一口径**，展示实收款总额 |\n\n> **原型缺口**：当前列表已按 §3.3 动态计算，部分 mock 详情 Hero 仍使用静态 `actualAmount` 字段，评审时需对齐（见 `.spec/prototype-review.md`）。\n\n---\n\n## 六、验收要点\n\n请在预览中逐项确认（可提供截图或页面路径反馈）：\n\n- [ ] 打开原型无需登录，默认进入工作台 \n- [ ] 左侧可切换 10 个功能页 \n- [ ] 导航栏无「需求说明」按钮；PRD 可从标注目录打开 \n- [ ] 审批中心「还车应结款」Chip 可筛出主流程 + 四部门子流程 \n- [ ] **更多筛选**抽屉在手机预览框内弹出（非全浏览器宽） \n- [ ] **更多筛选**：发起人、发起时间为滚轮选择器（非原生输入框） \n- [ ] **搜索**仅匹配卡片加粗标题（工作流标题） \n- [ ] 子流程列表卡片主标题为「还车应结款-部门名」；主流程卡片以车牌为主标题并展示应退/应补 \n- [ ] 四部门子流程详情 Hero 为部门标题 + 车牌重点样式，无汇总金额 \n- [ ] 主流程还车应结款 Hero 展示应退/应补、结算明细与四部门子流程进度 \n- [ ] 四部门子流程未全部通过时，主流程不可发起；四部门全过但业务管理组未发起时，主流程不出现在列表 \n- [ ] 业务管理组无违章违约金、保险上浮；安全部固定三行费项 \n- [ ] 运维组费用表含「无忧包减免」列，应结算 = 金额 − 减免 \n- [ ] 提车应收款车辆明细首卡与标题间距 12px \n- [ ] 提车列表实收金额与详情 Hero 口径一致（不含氢费预付款） \n- [ ] 审批时间轴展示头像、状态与评论；待办态可操作通过/驳回/终止/评论 \n\n**预览地址示例**：`http://localhost:51721/prototypes/xll-miniapp#page=audit`\n\n---\n\n## 七、关联文档\n\n| 文档 | 位置 |\n| --- | --- |\n| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |\n| 原型评审结论 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |\n| 页面标注 | `page-audit`、`page-audit-return`、`page-audit-pickup` 等 |\n", "page-audit-pickup": "# 提车应收款\n\nHero 展示实收款总额与客户/合同/项目信息。\n\n**车辆明细**：区块标题与首张车辆卡片之间保留 12px 上间距。\n\n审批时间轴支持评论；待办态底部评论/终止/驳回/通过。", - "prd-delivery": "# 小羚羚小程序 · 交车说明\n\n**文档版本**：V1.2 \n**更新日期**：2026-06-29 \n**适用范围**：运维管理 / 交车模块（`#page=delivery`） \n**参照**：web 交车管理 + Axhub「交车（完成）」原型 · 默认区域权限：浙江省-嘉兴市\n\n---\n\n## 一、列表页\n\n- **KPI**：全部 / 进行中 / 已完成，点击切换筛选。\n- **搜索**：车牌、项目、客户名称。\n- **卡片字段**：车牌（未选车显示「车辆待选」）、交车状态 Tag（未开始 / 已保存 / 待客户签章 / 待重新签章 / 客户已签章）、项目、客户、交车区域。\n- **进行中 Tab**：提供状态筛选 Chip（全部状态、未开始、已保存、待客户签章、待重新签章）。\n- **操作**：进行中任务展示「去办理 / 继续办理」按钮。\n\n---\n\n## 二、分步表单（顶部步骤条）\n\n顶部步骤条：**车辆情况** → **交车检查项** → **拍摄照片**，可点击切换。\n\n### 2.1 车辆情况\n\nHero 展示客户名称、项目名称与交车区域；含选择车辆、车辆配置、驾驶培训、交车数据、交车位置（独立卡片）。\n\n#### 识别车牌号\n\n拍照 OCR 识别车牌后，根据识别结果匹配车辆并校验交车资格，须同时满足：\n\n- **车辆状态 = 已备车**\n- **保险状态 = 正常**\n- **证照状态 = 正常**\n\n任一条件不满足则报错阻断，不可选车。报错提示文案与「选择车辆」页车辆卡片底部 readiness 提示条一致，例如：\n\n- 「交强险已到期无法交车」\n- 「商业险已到期无法交车」\n- 「交强险、商业险已到期无法交车」\n- 「行驶证已到期无法交车」\n- 未备车时「该车辆未备车，请先进行备车」\n\n支持**拍照识别**或**相册选取**车牌照片。\n\n#### 相册上传\n\n交车模块内**所有拍照环节**均支持从手机相册本地上传图片，包括：识别车牌号、车辆配置（车身广告/放大字）、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等；相机页底部提供「拍照」「相册」操作。\n\n#### 车辆配置\n\n- 车身广告及放大字、尾板（必填，有则须上传照片）\n- 备胎（选填，仅选择有/无）\n\n#### 驾驶培训（必填）\n\n支持**电子培训** / **手动记录**两种模式。\n\n**电子培训**：展示培训二维码（微信扫码观看视频），完成后识别提车码。\n\n**手动记录（运维端）**：\n\n1. 录入司机手机号、姓名、身份证号\n2. 上传身份证正反面、驾驶证正反面、司机正面照片、从业资格证（重卡必填）\n3. 点击底部「生成培训码」\n4. 培训码与录入信息绑定，展示二维码供司机微信扫码\n5. 生成后交车页标记「待司机确认」，可「查看培训码」或「刷新培训状态」\n6. 司机签字完成并同步后标记「已完成驾驶培训」\n\n**手动记录 · 司机微信端**（仅需求说明，本期原型不实现）：\n\n司机微信扫描二维码后，首先阅读并同意安全培训文件（倒计时 10 秒后可点确定）；随后在司机微信浏览器展示运维登记的司机「姓名」「手机号」「身份证号」及身份证正反面、驾驶证正反面、司机正面照片、从业资格证照片；下方点击「确认签字」唤起签名板，完成签字后提示培训成功，相关信息同步至安全培训记录。\n\n#### 交车数据（必填）\n\n- 里程、氢量、电量均支持 2 位小数输入（无数字步进器）\n- 氢量单位按「型号参数」仪表盘单位随车型自动匹配（%/MPa，不可手动切换）\n- 送车服务费为选填，精确至 2 位小数（元）\n- 氢量下方备注为选填\n- **不含**交车时间字段\n\n#### 交车位置\n\n- 车辆 GPS 在线：交车位置取车辆 GPS 当前定位\n- 车辆 GPS 离线：交车位置取手机当前定位\n- 独立卡片展示地图、蓝点标记坐标；GPS 离线时支持手动「获取当前定位」\n\n### 2.2 交车检查项\n\n证件信息 → 工具信息 → 外观检查 → 轮胎检查。\n\n- 前 3 类：开关表示检查情况并可填备注\n- 轮胎检查项：填写胎纹深度 (mm)\n\n**实际交车时间**：运维提交 E签宝签章时系统自动记录；仅在交车列表「待客户签章」卡片展示。\n\n### 2.3 拍摄照片\n\n- 分车身 / 底盘 / 轮胎 / 瑕疵 / 其他五类\n- 连拍严格按顺序拍摄且不可跳过；中途退出后再次进入自动从下一项续拍\n- 模拟相机页支持**拍照或相册上传**，轮胎项下方录入胎纹；完成后可补拍瑕疵/其他\n- **所有拍照场景均支持调焦**：点击取景区域设定对焦点，右侧 +/- 调整 1.0×～3.0× 数码变焦（连拍、备胎、车身广告/放大字、手动记录证件照）\n\n**备胎照片**：从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项（有备胎时必拍）；车辆情况仅保留是否有备胎。\n\n**分步操作条**：车辆情况、交车检查项点击「下一步」时自动保存；拍摄照片完成后为「保存」「发送签章文件」。\n\n**照片上传**：连拍/单拍每次点击「完成」继续时，上一张自动上传并在服务端打水印（时间、地点）。\n\n**胎纹 OCR**：胎纹未反写成功时禁止继续拍摄下一张。\n\n### 2.4 签章流程\n\n**选择被授权人**：多卡片展示姓名与手机号，选中高亮；发送签章文件后跳转 E签宝 完成运维签字。若关联合同无被授权人，页面展示「无授权人，请联系{业管姓名}补充授权人信息」（业管自动取合同业务负责人 `businessOwner`），并阻断发送签章。规则全文见 `.spec/authorized-person.md`。\n\n| 状态 | 规则 |\n| --- | --- |\n| **待客户签章** | 只读查看各步骤，底部「返回」「清除签章」；确认后记录变为「待重新签章」 |\n| **待重新签章** | 交车信息全部锁定，仅可重选被授权人；底部「返回」「重新发起签章」，完成 E签宝 运维签字后恢复「待客户签章」 |\n| **客户已签章** | 被授权人短信完成签章后进入「已完成」列表 |\n\n---\n\n## 三、查看态\n\n- **客户已签章 / 待客户签章**：只读浏览各步骤，不可编辑。\n- **待重新签章**：各步骤只读，仅「选择被授权人」可改。\n- **已完成**：可下载 E签宝签章 PDF；展示是否归还。\n\n---\n\n## 四、导航\n\n- 表单内左上返回先退出办理页；再次返回退出交车模块。\n- 步骤条可点击跳转。\n\n---\n\n## 五、验收要点\n\n请在预览中逐项确认（可提供截图或页面路径反馈）：\n\n- [ ] 业务页进入交车模块，列表 KPI / 搜索 / 状态筛选可用\n- [ ] 进行中任务可「去办理 / 继续办理」，列表与表单同页切换\n- [ ] OCR / 相册识别车牌，未备车或保险/证照异常时阻断选车\n- [ ] 合同无被授权人时展示「无授权人，请联系{业管}补充授权人信息」并阻断发送签章\n- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写\n- [ ] 交车检查项四类可填，轮胎胎纹支持 mm 录入\n- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则\n- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转\n- [ ] 标注目录可打开本 PRD；页面标注 `page-delivery` 可定位交车模块\n\n**预览地址示例**：`http://localhost:51722/prototypes/xll-miniapp#page=delivery`\n\n---\n\n## 六、关联文档\n\n| 文档 | 位置 |\n| --- | --- |\n| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |\n| 审批中心改版 | 标注目录「PRD 01｜审批中心改版说明」 |\n| 页面标注 | `page-delivery` |\n| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |\n" + "prd-delivery": "# 小羚羚小程序 · 交车说明\n\n**文档版本**：V1.3.2 \n**更新日期**：2026-07-01 \n**适用范围**：运维管理 / 交车模块（`#page=delivery`） \n**参照**：web 交车管理 + Axhub「交车（完成）」原型 · 默认区域权限：浙江省-嘉兴市\n\n---\n\n## 一、列表页\n\n- **KPI**：全部 / 进行中 / 已完成，点击切换筛选。\n- **搜索**：车牌、项目、客户名称。\n- **卡片字段**：车牌（未选车显示「车辆待选」）、交车状态 Tag（未开始 / 已保存 / 待客户签章 / 待重新签章 / 客户已签章）、项目、客户、交车区域。\n- **进行中 Tab**：提供状态筛选 Chip（全部状态、未开始、已保存、待客户签章、待重新签章）。\n- **操作**：进行中任务展示「去办理 / 继续办理」按钮。\n\n---\n\n## 二、分步表单（顶部步骤条）\n\n顶部步骤条：**车辆情况** → **交车检查项** → **拍摄照片**，可点击切换。\n\n### 2.1 车辆情况\n\nHero 展示客户名称、项目名称与交车区域；含选择车辆、车辆配置、驾驶培训、交车数据、交车位置（独立卡片）。\n\n#### 识别车牌号\n\n拍照 OCR 识别车牌后，根据识别结果匹配车辆并校验交车资格，须同时满足：\n\n- **车辆状态 = 已备车**\n- **保险状态 = 正常**\n- **证照状态 = 正常**\n\n任一条件不满足则报错阻断，不可选车。报错提示文案与「选择车辆」页车辆卡片底部 readiness 提示条一致，例如：\n\n- 「交强险已到期无法交车」\n- 「商业险已到期无法交车」\n- 「交强险、商业险已到期无法交车」\n- 「行驶证已到期无法交车」\n- 未备车时「该车辆未备车，请先进行备车」\n\n支持**拍照识别**或**相册选取**车牌照片。\n\n#### 相册上传\n\n交车模块内**所有拍照环节**均支持从手机相册本地上传图片，包括：识别车牌号、车辆配置（车身广告/放大字）、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等；相机页底部提供「拍照」「相册」操作。\n\n**相册选择规则（V1.3.2）**：\n\n| 场景 | 规则 |\n| --- | --- |\n| **连拍环节** | **相册单选**：文件选择器为单选模式，每次只能选 1 张；选好后进入当前项预览，点「完成」确认 |\n| 瑕疵 / 其他补充照片 | 相册多选可一次添加多张（该类合计最多 6 张） |\n| 备胎 / 其他单拍场景 | 相册单选，每次 1 张 |\n| 通用限制 | 仅接受常见图片格式；单张不超过 5MB |\n\n#### 车辆配置\n\n- 车身广告及放大字、尾板（必填，有则须上传照片）\n- 备胎（选填，仅选择有/无）\n\n#### 驾驶培训（必填）\n\n支持**电子培训** / **手动记录**两种模式。\n\n**电子培训**：展示培训二维码（微信扫码观看视频），完成后识别提车码。\n\n**手动记录（运维端）**：\n\n1. 录入司机手机号、姓名、身份证号\n2. 上传身份证正反面、驾驶证正反面、司机正面照片、从业资格证（重卡必填）\n3. 点击底部「生成培训码」\n4. 培训码与录入信息绑定，展示二维码供司机微信扫码\n5. 生成后交车页标记「待司机确认」，可「查看培训码」或「刷新培训状态」\n6. 司机签字完成并同步后标记「已完成驾驶培训」\n\n**手动记录 · 司机微信端**（仅需求说明，本期原型不实现）：\n\n司机微信扫描二维码后，首先阅读并同意安全培训文件（倒计时 10 秒后可点确定）；随后在司机微信浏览器展示运维登记的司机「姓名」「手机号」「身份证号」及身份证正反面、驾驶证正反面、司机正面照片、从业资格证照片；下方点击「确认签字」唤起签名板，完成签字后提示培训成功，相关信息同步至安全培训记录。\n\n#### 交车数据（必填）\n\n- 里程、氢量、电量均支持 2 位小数输入（无数字步进器）\n- 氢量单位按「型号参数」仪表盘单位随车型自动匹配（%/MPa，不可手动切换）\n- 送车服务费为选填，精确至 2 位小数（元）\n- 氢量下方备注为选填\n- **不含**交车时间字段\n\n#### 交车位置\n\n- 车辆 GPS 在线：交车位置取车辆 GPS 当前定位\n- 车辆 GPS 离线：交车位置取手机当前定位\n- 独立卡片展示地图、蓝点标记坐标；GPS 离线时支持手动「获取当前定位」\n\n### 2.2 交车检查项\n\n证件信息 → 工具信息 → 外观检查 → 轮胎检查。\n\n- 前 3 类：开关表示检查情况并可填备注\n- 轮胎检查项：填写胎纹深度 (mm)\n\n**实际交车时间**：运维提交 E签宝签章时系统自动记录；仅在交车列表「待客户签章」卡片展示。\n\n### 2.3 拍摄照片\n\n- 分车身 / 底盘 / 轮胎 / 瑕疵 / 其他五类\n- 连拍严格按顺序拍摄且不可跳过；中途退出后再次进入自动从下一项续拍\n- 模拟相机页支持**拍照或相册上传**，轮胎项下方录入胎纹；完成后可补拍瑕疵/其他\n- **所有拍照场景均支持调焦**：点击取景区域设定对焦点，右侧 +/- 调整 1.0×～3.0× 数码变焦（连拍、备胎、车身广告/放大字、手动记录证件照）\n\n**备胎照片**：从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项（有备胎时必拍）；车辆情况仅保留是否有备胎。\n\n**拍照操作条布局（V1.3）**：\n\n相机页底部操作条（`.xll-dv-photo-camera-actions`）按钮等宽平铺：\n\n| 状态 | 按钮 |\n| --- | --- |\n| 未拍摄 | 「拍照」「相册」两按钮等宽 |\n| 已拍摄 | 「重新拍摄」「相册」「完成」三按钮等宽 |\n\n**分步操作条**：车辆情况、交车检查项点击「下一步」时自动保存；拍摄照片步骤完成后为「保存」「发送签章文件」。\n\n**连拍自动保存（V1.3）**：连拍中每次点击「完成」进入下一拍摄项时，**强制静默自动保存**交车单草稿（未开始 → 已保存）。与「下一步」自动保存规则一致，无需用户再点「保存」。\n\n**照片上传**：连拍/单拍每次点击「完成」继续时，上一张自动上传并在服务端打水印（时间、地点）。\n\n**胎纹 OCR**：胎纹未反写成功时禁止继续拍摄下一张。\n\n### 2.4 签章流程\n\n**选择被授权人**：多卡片展示姓名与手机号，选中高亮；发送签章文件后跳转 E签宝 完成运维签字。\n\n| 状态 | 规则 |\n| --- | --- |\n| **待客户签章** | 只读查看各步骤，底部「返回」「清除签章」；确认后记录变为「待重新签章」 |\n| **待重新签章** | 交车信息全部锁定，仅可重选被授权人；底部「返回」「重新发起签章」，完成 E签宝 运维签字后恢复「待客户签章」 |\n| **客户已签章** | 被授权人短信完成签章后进入「已完成」列表 |\n\n---\n\n## 三、查看态\n\n- **客户已签章 / 待客户签章**：只读浏览各步骤，不可编辑。\n- **待重新签章**：各步骤只读，仅「选择被授权人」可改。\n- **已完成**：可下载 E签宝签章 PDF；展示是否归还。\n\n---\n\n## 四、导航\n\n- 表单内左上返回先退出办理页；再次返回退出交车模块。\n- 步骤条可点击跳转。\n\n---\n\n## 五、验收要点\n\n请在预览中逐项确认（可提供截图或页面路径反馈）：\n\n- [ ] 业务页进入交车模块，列表 KPI / 搜索 / 状态筛选可用\n- [ ] 进行中任务可「去办理 / 继续办理」，列表与表单同页切换\n- [ ] OCR / 相册识别车牌，未备车或保险/证照异常时阻断选车\n- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写\n- [ ] 交车检查项四类可填，轮胎胎纹支持 mm 录入\n- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则\n- [ ] **连拍相册单选**：连拍环节相册为单选模式，每次只能选 1 张（无法多选）\n- [ ] **瑕疵/其他多选**：补充照片仍可相册批量添加\n- [ ] **连拍自动保存**：每次点「完成」进入下一项后草稿状态为「已保存」\n- [ ] **拍照操作条**：拍照/相册（及完成态三按钮）等宽平铺展示\n- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转\n- [ ] 标注目录可打开本 PRD；页面标注 `page-delivery` 可定位交车模块\n\n**预览地址示例**：`http://localhost:51721/prototypes/xll-miniapp#page=delivery`\n\n---\n\n## 六、关联文档\n\n| 文档 | 位置 |\n| --- | --- |\n| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |\n| 审批中心改版 | 标注目录「PRD 01｜审批中心改版说明」 |\n| 页面标注 | `page-delivery` |\n| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |\n\n---\n\n## 七、版本记录\n\n| 版本 | 日期 | 说明 |\n| --- | --- | --- |\n| V1.3.2 | 2026-07-01 | 连拍相册明确为单选模式（非多选后取首张） |\n| V1.3.1 | 2026-07-01 | 连拍环节相册改为仅支持单张上传（不支持批量） |\n| V1.3 | 2026-07-01 | 瑕疵/其他相册多选；连拍「完成」强制自动保存；拍照操作条按钮等宽平铺 |\n| V1.2 | 2026-06-29 | 交车分步表单、连拍、签章与相册上传基线 |\n" }, "assetMap": {}, "directory": { @@ -418,7 +418,7 @@ "id": "prd-overview", "title": "PRD 00｜小程序总览", "markdownPath": "src/resources/xll-miniapp/PRD-00-小程序总览.md", - "markdown": "# 小羚羚小程序 · 总览\n\n氢能车辆运营移动端原型，面向一线运维与管理人员。**原型无需登录**，默认进入工作台。\n\n## 核心路径\n\n1. 工作台处理待办\n2. 业务 → 进入各运维 / 审批模块（独立原型页）\n3. 审批中心 → 本页内跳转**本期已接入**的审批工作流（提车应收款、还车应结款及子类型、租赁账单、车辆调拨、替换车申请等）\n\n## 页面导航\n\n左侧预览列表可切换 10 个功能页；各业务模块内列表与表单在同一页内跳转。\n\n## 最新改版\n\n审批中心与还车应结款多部门子流程见 **PRD 01｜审批中心改版说明**（V1.4）。\n\n### 审批中心要点（与标注 `page-audit` 一致）\n\n- 搜索：仅按卡片加粗标题（工作流标题）模糊匹配\n- 更多筛选：发起人（滚轮选择）、发起时间（年/月/日滚轮，起止日期）\n- 底部抽屉与选择器：限定在手机预览框内，模拟小程序交互\n- 还车应结款：主流程以车牌为主标题；四部门子流程以「还车应结款-部门名」为主标题；四部门全过后须业务管理组发起主流程\n\n## 需求文档与标注\n\n- **标注目录**：PRD 00 / PRD 01 / PRD 02 及页面说明（`page-audit`、`page-delivery` 等）\n- **PRD 02｜交车说明**：交车列表、分步办理与签章流程\n- **导航栏**：不设「需求说明」入口；以标注工具与目录为主\n- **业务评审**：`.spec/prototype-review.md`\n" + "markdown": "# 小羚羚小程序 · 总览\n\n氢能车辆运营移动端原型，面向一线运维与管理人员。**原型无需登录**，默认进入工作台。\n\n## 核心路径\n\n1. 工作台处理待办\n2. 业务 → 进入各运维 / 审批模块（独立原型页）\n3. 审批中心 → 本页内跳转**本期已接入**的审批工作流（提车应收款、还车应结款及子类型、租赁账单、车辆调拨、替换车申请等）\n\n## 页面导航\n\n左侧预览列表可切换 10 个功能页；各业务模块内列表与表单在同一页内跳转。\n\n## 最新改版\n\n### 交车模块（PRD 02 · V1.3.2，2026-07-01）\n\n- **连拍相册单选**：连拍环节相册为单选模式，每次只能选 1 张\n- **瑕疵/其他多选**：补充照片仍支持相册一次选多张\n- **连拍自动保存**：每次确认照片并进入下一项时静默保存草稿\n- **拍照操作条**：「拍照 / 相册」及完成态三按钮等宽平铺\n\n### 审批中心（PRD 01 · V1.4）\n\n审批中心与还车应结款多部门子流程见 **PRD 01｜审批中心改版说明**。\n\n#### 审批中心要点（与标注 `page-audit` 一致）\n\n- 搜索：仅按卡片加粗标题（工作流标题）模糊匹配\n- 更多筛选：发起人（滚轮选择）、发起时间（年/月/日滚轮，起止日期）\n- 底部抽屉与选择器：限定在手机预览框内，模拟小程序交互\n- 还车应结款：主流程以车牌为主标题；四部门子流程以「还车应结款-部门名」为主标题；四部门全过后须业务管理组发起主流程\n\n## 需求文档与标注\n\n- **标注目录**：PRD 00 / PRD 01 / PRD 02 及页面说明（`page-audit`、`page-delivery` 等）\n- **PRD 02｜交车说明**：交车列表、分步办理与签章流程（含 V1.3.2 连拍相册单选与连拍自动保存）\n- **导航栏**：不设「需求说明」入口；以标注工具与目录为主\n- **业务评审**：`.spec/prototype-review.md`\n" }, { "type": "markdown", @@ -432,7 +432,7 @@ "id": "prd-delivery", "title": "PRD 02｜交车说明", "markdownPath": "src/resources/xll-miniapp/PRD-02-交车说明.md", - "markdown": "# 小羚羚小程序 · 交车说明\n\n**文档版本**：V1.2 \n**更新日期**：2026-06-29 \n**适用范围**：运维管理 / 交车模块（`#page=delivery`） \n**参照**：web 交车管理 + Axhub「交车（完成）」原型 · 默认区域权限：浙江省-嘉兴市\n\n---\n\n## 一、列表页\n\n- **KPI**：全部 / 进行中 / 已完成，点击切换筛选。\n- **搜索**：车牌、项目、客户名称。\n- **卡片字段**：车牌（未选车显示「车辆待选」）、交车状态 Tag（未开始 / 已保存 / 待客户签章 / 待重新签章 / 客户已签章）、项目、客户、交车区域。\n- **进行中 Tab**：提供状态筛选 Chip（全部状态、未开始、已保存、待客户签章、待重新签章）。\n- **操作**：进行中任务展示「去办理 / 继续办理」按钮。\n\n---\n\n## 二、分步表单（顶部步骤条）\n\n顶部步骤条：**车辆情况** → **交车检查项** → **拍摄照片**，可点击切换。\n\n### 2.1 车辆情况\n\nHero 展示客户名称、项目名称与交车区域；含选择车辆、车辆配置、驾驶培训、交车数据、交车位置（独立卡片）。\n\n#### 识别车牌号\n\n拍照 OCR 识别车牌后，根据识别结果匹配车辆并校验交车资格，须同时满足：\n\n- **车辆状态 = 已备车**\n- **保险状态 = 正常**\n- **证照状态 = 正常**\n\n任一条件不满足则报错阻断，不可选车。报错提示文案与「选择车辆」页车辆卡片底部 readiness 提示条一致，例如：\n\n- 「交强险已到期无法交车」\n- 「商业险已到期无法交车」\n- 「交强险、商业险已到期无法交车」\n- 「行驶证已到期无法交车」\n- 未备车时「该车辆未备车，请先进行备车」\n\n支持**拍照识别**或**相册选取**车牌照片。\n\n#### 相册上传\n\n交车模块内**所有拍照环节**均支持从手机相册本地上传图片，包括：识别车牌号、车辆配置（车身广告/放大字）、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等；相机页底部提供「拍照」「相册」操作。\n\n#### 车辆配置\n\n- 车身广告及放大字、尾板（必填，有则须上传照片）\n- 备胎（选填，仅选择有/无）\n\n#### 驾驶培训（必填）\n\n支持**电子培训** / **手动记录**两种模式。\n\n**电子培训**：展示培训二维码（微信扫码观看视频），完成后识别提车码。\n\n**手动记录（运维端）**：\n\n1. 录入司机手机号、姓名、身份证号\n2. 上传身份证正反面、驾驶证正反面、司机正面照片、从业资格证（重卡必填）\n3. 点击底部「生成培训码」\n4. 培训码与录入信息绑定，展示二维码供司机微信扫码\n5. 生成后交车页标记「待司机确认」，可「查看培训码」或「刷新培训状态」\n6. 司机签字完成并同步后标记「已完成驾驶培训」\n\n**手动记录 · 司机微信端**（仅需求说明，本期原型不实现）：\n\n司机微信扫描二维码后，首先阅读并同意安全培训文件（倒计时 10 秒后可点确定）；随后在司机微信浏览器展示运维登记的司机「姓名」「手机号」「身份证号」及身份证正反面、驾驶证正反面、司机正面照片、从业资格证照片；下方点击「确认签字」唤起签名板，完成签字后提示培训成功，相关信息同步至安全培训记录。\n\n#### 交车数据（必填）\n\n- 里程、氢量、电量均支持 2 位小数输入（无数字步进器）\n- 氢量单位按「型号参数」仪表盘单位随车型自动匹配（%/MPa，不可手动切换）\n- 送车服务费为选填，精确至 2 位小数（元）\n- 氢量下方备注为选填\n- **不含**交车时间字段\n\n#### 交车位置\n\n- 车辆 GPS 在线：交车位置取车辆 GPS 当前定位\n- 车辆 GPS 离线：交车位置取手机当前定位\n- 独立卡片展示地图、蓝点标记坐标；GPS 离线时支持手动「获取当前定位」\n\n### 2.2 交车检查项\n\n证件信息 → 工具信息 → 外观检查 → 轮胎检查。\n\n- 前 3 类：开关表示检查情况并可填备注\n- 轮胎检查项：填写胎纹深度 (mm)\n\n**实际交车时间**：运维提交 E签宝签章时系统自动记录；仅在交车列表「待客户签章」卡片展示。\n\n### 2.3 拍摄照片\n\n- 分车身 / 底盘 / 轮胎 / 瑕疵 / 其他五类\n- 连拍严格按顺序拍摄且不可跳过；中途退出后再次进入自动从下一项续拍\n- 模拟相机页支持**拍照或相册上传**，轮胎项下方录入胎纹；完成后可补拍瑕疵/其他\n- **所有拍照场景均支持调焦**：点击取景区域设定对焦点，右侧 +/- 调整 1.0×～3.0× 数码变焦（连拍、备胎、车身广告/放大字、手动记录证件照）\n\n**备胎照片**：从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项（有备胎时必拍）；车辆情况仅保留是否有备胎。\n\n**分步操作条**：车辆情况、交车检查项点击「下一步」时自动保存；拍摄照片完成后为「保存」「发送签章文件」。\n\n**照片上传**：连拍/单拍每次点击「完成」继续时，上一张自动上传并在服务端打水印（时间、地点）。\n\n**胎纹 OCR**：胎纹未反写成功时禁止继续拍摄下一张。\n\n### 2.4 签章流程\n\n**选择被授权人**：多卡片展示姓名与手机号，选中高亮；发送签章文件后跳转 E签宝 完成运维签字。若关联合同无被授权人，页面展示「无授权人，请联系{业管姓名}补充授权人信息」（业管自动取合同业务负责人 `businessOwner`），并阻断发送签章。规则全文见 `.spec/authorized-person.md`。\n\n| 状态 | 规则 |\n| --- | --- |\n| **待客户签章** | 只读查看各步骤，底部「返回」「清除签章」；确认后记录变为「待重新签章」 |\n| **待重新签章** | 交车信息全部锁定，仅可重选被授权人；底部「返回」「重新发起签章」，完成 E签宝 运维签字后恢复「待客户签章」 |\n| **客户已签章** | 被授权人短信完成签章后进入「已完成」列表 |\n\n---\n\n## 三、查看态\n\n- **客户已签章 / 待客户签章**：只读浏览各步骤，不可编辑。\n- **待重新签章**：各步骤只读，仅「选择被授权人」可改。\n- **已完成**：可下载 E签宝签章 PDF；展示是否归还。\n\n---\n\n## 四、导航\n\n- 表单内左上返回先退出办理页；再次返回退出交车模块。\n- 步骤条可点击跳转。\n\n---\n\n## 五、验收要点\n\n请在预览中逐项确认（可提供截图或页面路径反馈）：\n\n- [ ] 业务页进入交车模块，列表 KPI / 搜索 / 状态筛选可用\n- [ ] 进行中任务可「去办理 / 继续办理」，列表与表单同页切换\n- [ ] OCR / 相册识别车牌，未备车或保险/证照异常时阻断选车\n- [ ] 合同无被授权人时展示「无授权人，请联系{业管}补充授权人信息」并阻断发送签章\n- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写\n- [ ] 交车检查项四类可填，轮胎胎纹支持 mm 录入\n- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则\n- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转\n- [ ] 标注目录可打开本 PRD；页面标注 `page-delivery` 可定位交车模块\n\n**预览地址示例**：`http://localhost:51722/prototypes/xll-miniapp#page=delivery`\n\n---\n\n## 六、关联文档\n\n| 文档 | 位置 |\n| --- | --- |\n| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |\n| 审批中心改版 | 标注目录「PRD 01｜审批中心改版说明」 |\n| 页面标注 | `page-delivery` |\n| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |\n" + "markdown": "# 小羚羚小程序 · 交车说明\n\n**文档版本**：V1.3.2 \n**更新日期**：2026-07-01 \n**适用范围**：运维管理 / 交车模块（`#page=delivery`） \n**参照**：web 交车管理 + Axhub「交车（完成）」原型 · 默认区域权限：浙江省-嘉兴市\n\n---\n\n## 一、列表页\n\n- **KPI**：全部 / 进行中 / 已完成，点击切换筛选。\n- **搜索**：车牌、项目、客户名称。\n- **卡片字段**：车牌（未选车显示「车辆待选」）、交车状态 Tag（未开始 / 已保存 / 待客户签章 / 待重新签章 / 客户已签章）、项目、客户、交车区域。\n- **进行中 Tab**：提供状态筛选 Chip（全部状态、未开始、已保存、待客户签章、待重新签章）。\n- **操作**：进行中任务展示「去办理 / 继续办理」按钮。\n\n---\n\n## 二、分步表单（顶部步骤条）\n\n顶部步骤条：**车辆情况** → **交车检查项** → **拍摄照片**，可点击切换。\n\n### 2.1 车辆情况\n\nHero 展示客户名称、项目名称与交车区域；含选择车辆、车辆配置、驾驶培训、交车数据、交车位置（独立卡片）。\n\n#### 识别车牌号\n\n拍照 OCR 识别车牌后，根据识别结果匹配车辆并校验交车资格，须同时满足：\n\n- **车辆状态 = 已备车**\n- **保险状态 = 正常**\n- **证照状态 = 正常**\n\n任一条件不满足则报错阻断，不可选车。报错提示文案与「选择车辆」页车辆卡片底部 readiness 提示条一致，例如：\n\n- 「交强险已到期无法交车」\n- 「商业险已到期无法交车」\n- 「交强险、商业险已到期无法交车」\n- 「行驶证已到期无法交车」\n- 未备车时「该车辆未备车，请先进行备车」\n\n支持**拍照识别**或**相册选取**车牌照片。\n\n#### 相册上传\n\n交车模块内**所有拍照环节**均支持从手机相册本地上传图片，包括：识别车牌号、车辆配置（车身广告/放大字）、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等；相机页底部提供「拍照」「相册」操作。\n\n**相册选择规则（V1.3.2）**：\n\n| 场景 | 规则 |\n| --- | --- |\n| **连拍环节** | **相册单选**：文件选择器为单选模式，每次只能选 1 张；选好后进入当前项预览，点「完成」确认 |\n| 瑕疵 / 其他补充照片 | 相册多选可一次添加多张（该类合计最多 6 张） |\n| 备胎 / 其他单拍场景 | 相册单选，每次 1 张 |\n| 通用限制 | 仅接受常见图片格式；单张不超过 5MB |\n\n#### 车辆配置\n\n- 车身广告及放大字、尾板（必填，有则须上传照片）\n- 备胎（选填，仅选择有/无）\n\n#### 驾驶培训（必填）\n\n支持**电子培训** / **手动记录**两种模式。\n\n**电子培训**：展示培训二维码（微信扫码观看视频），完成后识别提车码。\n\n**手动记录（运维端）**：\n\n1. 录入司机手机号、姓名、身份证号\n2. 上传身份证正反面、驾驶证正反面、司机正面照片、从业资格证（重卡必填）\n3. 点击底部「生成培训码」\n4. 培训码与录入信息绑定，展示二维码供司机微信扫码\n5. 生成后交车页标记「待司机确认」，可「查看培训码」或「刷新培训状态」\n6. 司机签字完成并同步后标记「已完成驾驶培训」\n\n**手动记录 · 司机微信端**（仅需求说明，本期原型不实现）：\n\n司机微信扫描二维码后，首先阅读并同意安全培训文件（倒计时 10 秒后可点确定）；随后在司机微信浏览器展示运维登记的司机「姓名」「手机号」「身份证号」及身份证正反面、驾驶证正反面、司机正面照片、从业资格证照片；下方点击「确认签字」唤起签名板，完成签字后提示培训成功，相关信息同步至安全培训记录。\n\n#### 交车数据（必填）\n\n- 里程、氢量、电量均支持 2 位小数输入（无数字步进器）\n- 氢量单位按「型号参数」仪表盘单位随车型自动匹配（%/MPa，不可手动切换）\n- 送车服务费为选填，精确至 2 位小数（元）\n- 氢量下方备注为选填\n- **不含**交车时间字段\n\n#### 交车位置\n\n- 车辆 GPS 在线：交车位置取车辆 GPS 当前定位\n- 车辆 GPS 离线：交车位置取手机当前定位\n- 独立卡片展示地图、蓝点标记坐标；GPS 离线时支持手动「获取当前定位」\n\n### 2.2 交车检查项\n\n证件信息 → 工具信息 → 外观检查 → 轮胎检查。\n\n- 前 3 类：开关表示检查情况并可填备注\n- 轮胎检查项：填写胎纹深度 (mm)\n\n**实际交车时间**：运维提交 E签宝签章时系统自动记录；仅在交车列表「待客户签章」卡片展示。\n\n### 2.3 拍摄照片\n\n- 分车身 / 底盘 / 轮胎 / 瑕疵 / 其他五类\n- 连拍严格按顺序拍摄且不可跳过；中途退出后再次进入自动从下一项续拍\n- 模拟相机页支持**拍照或相册上传**，轮胎项下方录入胎纹；完成后可补拍瑕疵/其他\n- **所有拍照场景均支持调焦**：点击取景区域设定对焦点，右侧 +/- 调整 1.0×～3.0× 数码变焦（连拍、备胎、车身广告/放大字、手动记录证件照）\n\n**备胎照片**：从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项（有备胎时必拍）；车辆情况仅保留是否有备胎。\n\n**拍照操作条布局（V1.3）**：\n\n相机页底部操作条（`.xll-dv-photo-camera-actions`）按钮等宽平铺：\n\n| 状态 | 按钮 |\n| --- | --- |\n| 未拍摄 | 「拍照」「相册」两按钮等宽 |\n| 已拍摄 | 「重新拍摄」「相册」「完成」三按钮等宽 |\n\n**分步操作条**：车辆情况、交车检查项点击「下一步」时自动保存；拍摄照片步骤完成后为「保存」「发送签章文件」。\n\n**连拍自动保存（V1.3）**：连拍中每次点击「完成」进入下一拍摄项时，**强制静默自动保存**交车单草稿（未开始 → 已保存）。与「下一步」自动保存规则一致，无需用户再点「保存」。\n\n**照片上传**：连拍/单拍每次点击「完成」继续时，上一张自动上传并在服务端打水印（时间、地点）。\n\n**胎纹 OCR**：胎纹未反写成功时禁止继续拍摄下一张。\n\n### 2.4 签章流程\n\n**选择被授权人**：多卡片展示姓名与手机号，选中高亮；发送签章文件后跳转 E签宝 完成运维签字。\n\n| 状态 | 规则 |\n| --- | --- |\n| **待客户签章** | 只读查看各步骤，底部「返回」「清除签章」；确认后记录变为「待重新签章」 |\n| **待重新签章** | 交车信息全部锁定，仅可重选被授权人；底部「返回」「重新发起签章」，完成 E签宝 运维签字后恢复「待客户签章」 |\n| **客户已签章** | 被授权人短信完成签章后进入「已完成」列表 |\n\n---\n\n## 三、查看态\n\n- **客户已签章 / 待客户签章**：只读浏览各步骤，不可编辑。\n- **待重新签章**：各步骤只读，仅「选择被授权人」可改。\n- **已完成**：可下载 E签宝签章 PDF；展示是否归还。\n\n---\n\n## 四、导航\n\n- 表单内左上返回先退出办理页；再次返回退出交车模块。\n- 步骤条可点击跳转。\n\n---\n\n## 五、验收要点\n\n请在预览中逐项确认（可提供截图或页面路径反馈）：\n\n- [ ] 业务页进入交车模块，列表 KPI / 搜索 / 状态筛选可用\n- [ ] 进行中任务可「去办理 / 继续办理」，列表与表单同页切换\n- [ ] OCR / 相册识别车牌，未备车或保险/证照异常时阻断选车\n- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写\n- [ ] 交车检查项四类可填，轮胎胎纹支持 mm 录入\n- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则\n- [ ] **连拍相册单选**：连拍环节相册为单选模式，每次只能选 1 张（无法多选）\n- [ ] **瑕疵/其他多选**：补充照片仍可相册批量添加\n- [ ] **连拍自动保存**：每次点「完成」进入下一项后草稿状态为「已保存」\n- [ ] **拍照操作条**：拍照/相册（及完成态三按钮）等宽平铺展示\n- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转\n- [ ] 标注目录可打开本 PRD；页面标注 `page-delivery` 可定位交车模块\n\n**预览地址示例**：`http://localhost:51721/prototypes/xll-miniapp#page=delivery`\n\n---\n\n## 六、关联文档\n\n| 文档 | 位置 |\n| --- | --- |\n| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |\n| 审批中心改版 | 标注目录「PRD 01｜审批中心改版说明」 |\n| 页面标注 | `page-delivery` |\n| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |\n\n---\n\n## 七、版本记录\n\n| 版本 | 日期 | 说明 |\n| --- | --- | --- |\n| V1.3.2 | 2026-07-01 | 连拍相册明确为单选模式（非多选后取首张） |\n| V1.3.1 | 2026-07-01 | 连拍环节相册改为仅支持单张上传（不支持批量） |\n| V1.3 | 2026-07-01 | 瑕疵/其他相册多选；连拍「完成」强制自动保存；拍照操作条按钮等宽平铺 |\n| V1.2 | 2026-06-29 | 交车分步表单、连拍、签章与相册上传基线 |\n" } ] }