完善小羚羚小程序待办分区与交车连拍交互,并同步 PRD V1.3.2 与侧栏结构。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-18 10:23:13 +08:00
parent a619938e0c
commit 0c108f1459
8 changed files with 1334 additions and 212 deletions

View File

@@ -4,7 +4,6 @@
"repository": "https://github.com/lintendo/Axhub-Make/tree/main/client",
"templateUrl": "https://github.com/lintendo/Axhub-Make/releases/download/make-client-template-v0.1.4/axhub-make-client-template.zip",
"templateVersion": "0.1.4",
"makeVersion": "0.6.4",
"project": {
"id": "make-project-20260629",
"name": "小羚羚「小程序」"

View File

@@ -3,10 +3,17 @@
"updatedAt": "2026-06-30T02:16:40.884Z",
"prototypes": [
{
"id": "item:prototypes:xll-miniapp",
"kind": "item",
"title": "小程序",
"itemKey": "prototypes/xll-miniapp"
"id": "folder-prototypes-xll-miniapp",
"kind": "folder",
"title": "小羚羚小程序",
"children": [
{
"id": "item:prototypes:xll-miniapp",
"kind": "item",
"title": "小程序",
"itemKey": "prototypes/xll-miniapp"
}
]
}
],
"docs": [],

View File

@@ -0,0 +1,56 @@
# 交车 · 被授权人空态
**模块**:小羚羚小程序 / 交车(`#page=delivery`
**代码路径**`src/prototypes/xll-miniapp/index.tsx``dvGetAuthorizedPersons` / `dvFormatEmptyAuthorizedHint` / `renderAuthorizedPersonBlock` / `validateDeliveryBeforeSign`
**数据说明**:原型本地种子;正式环境被授权人列表与业管姓名来自关联租赁合同,未接真实 API。
---
## 1. 判定优先级
| 顺序 | 条件 | 用户可见结果 | 是否可发送签章 |
| --- | --- | --- | --- |
| 1 | 关联合同被授权人列表长度为 0 | 选择区展示:`无授权人,请联系{业管姓名}补充授权人信息`;点「发送签章文件 / 重新发起签章」时 Toast 同文案 | 否 |
| 2 | 列表非空,但未选中任何人 | 展示候选人卡片Toast「请选择被授权人」 | 否 |
| 3 | 列表非空且已选中 | 选中卡片高亮,可继续签章流程 | 是 |
---
## 2. 前置条件
- 仅在交车办理页「拍摄照片」步骤的「选择被授权人」区块生效。
- 只读查看态(待客户签章 / 客户已签章)若已落库被授权人姓名,仍展示只读卡片;若无姓名且列表为空,同样展示空态提示。
- 待重新签章:列表非空时可重选;列表为空时展示空态并阻断重新发起。
---
## 3. 数据源
| 字段 | 来源(原型) | 说明 |
| --- | --- | --- |
| 被授权人列表 | 交车订单 `authorizedPersons` | 按订单挂载;`[]` 表示合同无被授权人 |
| 业管姓名 | 交车订单 `businessOwner` | 合同业务负责人;为空时文案回退为「业管」 |
| 已选被授权人 | 单车草稿 `authorizedPersonId/Name/Phone` | 发送签章前必填(列表非空时) |
演示种子:
- `o1`(桐乡韵达):`authorizedPersons: []`,业管「刘念念」——用于验收空态。
- `o4` / `o5`:有候选人列表——用于验收正常选择。
---
## 4. 文案规则
```text
无授权人,请联系{businessOwner}补充授权人信息
```
示例:`无授权人,请联系刘念念补充授权人信息`
---
## 5. 验收要点
- [ ] 打开桐乡韵达「未开始」交车单,到「选择被授权人」可见橙色空态提示,姓名为「刘念念」
- [ ] 点「发送签章文件」弹出同文案 Toast不进入 E签宝
- [ ] 聚德订单(有授权人)仍可点选卡片并发送签章

View File

@@ -0,0 +1,12 @@
{
"schemaVersion": 1,
"kind": "prototype-edit-comments",
"resource": {
"id": "xll-miniapp",
"targetPath": "prototypes/xll-miniapp",
"filePath": "src/prototypes/xll-miniapp/.spec/prototype-comments.json"
},
"comments": [],
"tasks": {},
"images": []
}

File diff suppressed because one or more lines are too long

File diff suppressed because it is too large Load Diff

View File

@@ -14,9 +14,18 @@
## 最新改版
审批中心与还车应结款多部门子流程见 **PRD 01审批中心改版说明**V1.4)。
### 交车模块PRD 02 · V1.3.22026-07-01
### 审批中心要点(与标注 `page-audit` 一致)
- **连拍相册单选**:连拍环节相册为单选模式,每次只能选 1 张
- **瑕疵/其他多选**:补充照片仍支持相册一次选多张
- **连拍自动保存**:每次确认照片并进入下一项时静默保存草稿
- **拍照操作条**:「拍照 / 相册」及完成态三按钮等宽平铺
### 审批中心PRD 01 · V1.4
审批中心与还车应结款多部门子流程见 **PRD 01审批中心改版说明**
#### 审批中心要点(与标注 `page-audit` 一致)
- 搜索:仅按卡片加粗标题(工作流标题)模糊匹配
- 更多筛选:发起人(滚轮选择)、发起时间(年/月/日滚轮,起止日期)
@@ -26,6 +35,6 @@
## 需求文档与标注
- **标注目录**PRD 00 / PRD 01 / PRD 02 及页面说明(`page-audit``page-delivery` 等)
- **PRD 02交车说明**:交车列表、分步办理与签章流程
- **PRD 02交车说明**:交车列表、分步办理与签章流程(含 V1.3.2 连拍相册单选与连拍自动保存)
- **导航栏**:不设「需求说明」入口;以标注工具与目录为主
- **业务评审**`.spec/prototype-review.md`

View File

@@ -1,7 +1,7 @@
# 小羚羚小程序 · 交车说明
**文档版本**V1.2
**更新日期**2026-06-29
**文档版本**V1.3.2
**更新日期**2026-07-01
**适用范围**:运维管理 / 交车模块(`#page=delivery`
**参照**web 交车管理 + Axhub「交车完成」原型 · 默认区域权限:浙江省-嘉兴市
@@ -47,6 +47,15 @@ Hero 展示客户名称、项目名称与交车区域;含选择车辆、车辆
交车模块内**所有拍照环节**均支持从手机相册本地上传图片,包括:识别车牌号、车辆配置(车身广告/放大字)、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等;相机页底部提供「拍照」「相册」操作。
**相册选择规则V1.3.2**
| 场景 | 规则 |
| --- | --- |
| **连拍环节** | **相册单选**:文件选择器为单选模式,每次只能选 1 张;选好后进入当前项预览,点「完成」确认 |
| 瑕疵 / 其他补充照片 | 相册多选可一次添加多张(该类合计最多 6 张) |
| 备胎 / 其他单拍场景 | 相册单选,每次 1 张 |
| 通用限制 | 仅接受常见图片格式;单张不超过 5MB |
#### 车辆配置
- 车身广告及放大字、尾板(必填,有则须上传照片)
@@ -103,7 +112,18 @@ Hero 展示客户名称、项目名称与交车区域;含选择车辆、车辆
**备胎照片**:从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项(有备胎时必拍);车辆情况仅保留是否有备胎。
**分步操作条**车辆情况、交车检查项点击「下一步」时自动保存;拍摄照片完成后为「保存」「发送签章文件」。
**拍照操作条布局V1.3**
相机页底部操作条(`.xll-dv-photo-camera-actions`)按钮等宽平铺:
| 状态 | 按钮 |
| --- | --- |
| 未拍摄 | 「拍照」「相册」两按钮等宽 |
| 已拍摄 | 「重新拍摄」「相册」「完成」三按钮等宽 |
**分步操作条**:车辆情况、交车检查项点击「下一步」时自动保存;拍摄照片步骤完成后为「保存」「发送签章文件」。
**连拍自动保存V1.3**:连拍中每次点击「完成」进入下一拍摄项时,**强制静默自动保存**交车单草稿(未开始 → 已保存)。与「下一步」自动保存规则一致,无需用户再点「保存」。
**照片上传**:连拍/单拍每次点击「完成」继续时,上一张自动上传并在服务端打水印(时间、地点)。
@@ -146,10 +166,14 @@ Hero 展示客户名称、项目名称与交车区域;含选择车辆、车辆
- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写
- [ ] 交车检查项四类可填,轮胎胎纹支持 mm 录入
- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则
- [ ] **连拍相册单选**:连拍环节相册为单选模式,每次只能选 1 张(无法多选)
- [ ] **瑕疵/其他多选**:补充照片仍可相册批量添加
- [ ] **连拍自动保存**:每次点「完成」进入下一项后草稿状态为「已保存」
- [ ] **拍照操作条**:拍照/相册(及完成态三按钮)等宽平铺展示
- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转
- [ ] 标注目录可打开本 PRD页面标注 `page-delivery` 可定位交车模块
**预览地址示例**`http://localhost:51722/prototypes/xll-miniapp#page=delivery`
**预览地址示例**`http://localhost:51721/prototypes/xll-miniapp#page=delivery`
---
@@ -161,3 +185,14 @@ Hero 展示客户名称、项目名称与交车区域;含选择车辆、车辆
| 审批中心改版 | 标注目录「PRD 01审批中心改版说明」 |
| 页面标注 | `page-delivery` |
| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |
---
## 七、版本记录
| 版本 | 日期 | 说明 |
| --- | --- | --- |
| V1.3.2 | 2026-07-01 | 连拍相册明确为单选模式(非多选后取首张) |
| V1.3.1 | 2026-07-01 | 连拍环节相册改为仅支持单张上传(不支持批量) |
| V1.3 | 2026-07-01 | 瑕疵/其他相册多选;连拍「完成」强制自动保存;拍照操作条按钮等宽平铺 |
| V1.2 | 2026-06-29 | 交车分步表单、连拍、签章与相册上传基线 |