完善小羚羚小程序待办分区与交车连拍交互,并同步 PRD V1.3.2 与侧栏结构。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -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": "小羚羚「小程序」"
|
||||
|
||||
@@ -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": [],
|
||||
|
||||
56
src/prototypes/xll-miniapp/.spec/authorized-person.md
Normal file
56
src/prototypes/xll-miniapp/.spec/authorized-person.md
Normal 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签宝
|
||||
- [ ] 聚德订单(有授权人)仍可点选卡片并发送签章
|
||||
12
src/prototypes/xll-miniapp/.spec/prototype-comments.json
Normal file
12
src/prototypes/xll-miniapp/.spec/prototype-comments.json
Normal 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
@@ -14,9 +14,18 @@
|
||||
|
||||
## 最新改版
|
||||
|
||||
审批中心与还车应结款多部门子流程见 **PRD 01|审批中心改版说明**(V1.4)。
|
||||
### 交车模块(PRD 02 · V1.3.2,2026-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`
|
||||
|
||||
@@ -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 | 交车分步表单、连拍、签章与相册上传基线 |
|
||||
|
||||
Reference in New Issue
Block a user