补充移动端产品设计与全量开发文档

doc/服务端APP-配送端-最新参考产品设计/产品设计说明_配送端APP_v1.0.md

@@ -0,0 +1,95 @@
+# 配送端 APP 最新产品设计说明 v1.0
+
+## 1. 文档定位
+
+本目录 42 张 PNG 是配送端目标产品设计。设计以原配送端产品图、当前 `apps/service_app` 配送能力、服务端 App 需求和核心配送流程为依据。图片用于开发验收，不表示所有接口和页面已经实现。
+
+## 2. 设计原则
+
+- 保留订单、排单、路线、到场、气瓶、随瓶安检、取证、收款、签收、空瓶回收、轨迹、用户和钱包能力。
+- 主色 `#2563EB`，背景 `#F7F8FA`，成功绿色、提醒橙色、高风险红色；禁止紫色及紫色渐变。
+- 不使用 AI 元素、AI 助手、聊天机器人或相关说明文案。
+- 采用正式、简洁、密度适中的移动端界面；统一 20px 边距、最大 8px 圆角、标准图标和清晰状态标签。
+- 气瓶、押金、收款、签收、库存、轨迹和任务完成以服务端确认结果为准。
+- 关键操作支持幂等、离线暂存、自动重试和冲突处理。
+
+## 3. 页面清单
+
+| 编号 | 页面 | 核心功能 |
+| --- | --- | --- |
+| 01 | 登录页 | 账号密码登录、协议确认 |
+| 02 | 岗位申请 | 配送员岗位、配送点、车辆与资质申请 |
+| 03 | 作业前检查 | 出勤、资质、车辆、设备、定位和网络 |
+| 04 | 准入阻断 | 资质、打卡、培训、车辆与设备阻断处理 |
+| 05 | 每日安全培训 | 配送安全题目、进度和结果 |
+| 06 | 配送工作台 | 今日订单、统计、快捷入口和安全提醒 |
+| 07 | 消息中心 | 订单、路线、安全、系统和结算消息 |
+| 08 | 配送订单列表 | 待配送、进行中、异常、完成筛选 |
+| 09 | 配送订单详情 | 用户、地址、商品、气瓶与付款信息 |
+| 10 | 接单与改派 | 接单、拒单原因、改派申请和审核 |
+| 11 | 按时间排单 | 时间窗、顺序、冲突和批量确认 |
+| 12 | 按路线排单 | 地图路线、里程、站点和顺序调整 |
+| 13 | 导航与到达 | 导航、用户联系、到场与围栏校验 |
+| 14 | 围栏异常处理 | 超距、定位异常、证据和人工审核 |
+| 15 | 气瓶扫描录入 | 瓶码、规格、状态、订单匹配与录入 |
+| 16 | 扫描异常拦截 | 重复、错瓶、无效瓶与不可提交原因 |
+| 17 | 随瓶安检 | 环境、连接、设备和风险检查 |
+| 18 | 安检不合格与整改 | 不合格项、处置、证据与终止配送 |
+| 19 | 配送取证 | 配送前中后、瓶体、安装、安检照片视频 |
+| 20 | 收款确认 | 应收、线上、线下凭证与异常对账 |
+| 21 | 签收确认 | 签收码、用户签名、交付清单和拒签 |
+| 22 | 配送完成 | 订单、库存、押金、轨迹和签收归档 |
+| 23 | 空瓶回收任务 | 回收数量、地址、计划与状态 |
+| 24 | 蓝牙设备连接 | 智能瓶阀搜索、配对、权限和故障 |
+| 25 | 空瓶扫描与确认 | 空瓶码、状态、押金核算和回收确认 |
+| 26 | 回收异常处理 | 错瓶、损坏、押金争议和证据 |
+| 27 | 配送轨迹与补传 | 实时轨迹、缺口、离线缓存和补传 |
+| 28 | 服务用户列表 | 授权用户、片区、状态和搜索 |
+| 29 | 服务用户详情 | 脱敏资料、用气、安检、配送和评价 |
+| 30 | 配送记录 | 历史订单、状态、时间和筛选 |
+| 31 | 配送记录详情 | 时间线、瓶码、取证、收款、签收和轨迹 |
+| 32 | 统计看板 | 配送量、准时率、里程、异常和收入 |
+| 33 | 钱包 | 余额、配送收入、奖励和明细 |
+| 34 | 提现申请与记录 | 金额、银行卡、手续费和提现状态 |
+| 35 | 银行卡管理 | 实名卡片、新增、解绑和安全校验 |
+| 36 | 离线队列与冲突 | 轨迹、证据、签收、草稿和版本冲突 |
+| 37 | 个人中心 | 车辆、资质、钱包、统计和支持入口 |
+| 38 | 个人资料车辆与资质 | 配送员、车辆、证照和到期提醒 |
+| 39 | 设置与通知 | 派单、路线、轨迹、安全、权限和账号 |
+| 40 | 推荐二维码 | 人员招募或服务推广二维码与记录 |
+| 41 | 服务支持中心 | 人工客服、配送点、抢险电话和工单 |
+| 42 | 配送知识库与视频教程 | 规范、气瓶、安检、设备和学习进度 |
+
+## 4. 当前实现对照
+
+| 范围 | 当前状态 | 后续开发要求 |
+| --- | --- | --- |
+| 登录与角色 | 已有真实登录与配送角色识别 | 补岗位申请、审核与设备绑定 |
+| 作业前检查 | 已有 `/preflight` 和考勤 | 补车辆、培训、服务区域和设备细项 |
+| 配送订单 | 已有列表、详情、开始、异常、恢复 | 补接单改派、排单、状态动作和专用详情字段 |
+| 轨迹与到场 | 已有轨迹追加和到场接口 | 补持续轨迹、围栏异常、离线补传与冲突处理 |
+| 签收提交 | 已有配送签收提交 | 补瓶码、安检、取证、收款、拒签、空瓶和押金完整链路 |
+| 钱包 | 已有钱包查询 | 补收入分类、提现、银行卡和结算审核 |
+| 记录与个人 | 已有通用入口 | 补用户、记录详情、统计、资质、知识库与人工支持 |
+
+## 5. 接口与状态机要求
+
+- 延续 `/heqi/client/v1/staff/delivery/orders` 现有接口，不修改已有字段语义。
+- 订单状态建议覆盖：待接单、已接单、已排单、配送中、已到达、气瓶已核验、安检完成、待收款、待签收、已完成、异常暂停、已取消。
+- 每个动作由服务端返回 `allowed_actions`，客户端不得只按本地页面推断下一步。
+- 气瓶扫描必须校验瓶码、规格、所属站点、库存状态、原订单和重复提交。
+- 围栏、轨迹、照片和视频需要设备时间、服务端时间、定位精度、文件哈希与上传状态。
+- 收款和押金分别核算，线上与线下金额不可混淆；差额必须进入对账审核。
+- 签收码与用户签名二选一时仍需记录使用方式、验证结果和服务端回执。
+
+## 6. 验收重点
+
+- 42 个页面和配送主链路可连续操作，返回、取消、异常和重试路径完整。
+- 订单金额、气瓶数量、空瓶押金、签收信息和库存变动前后一致。
+- 无网络时轨迹、取证和签收可安全暂存，恢复后可见同步结果。
+- 高风险随瓶安检不允许继续配送，必须先处置或走审核流程。
+- Android 常用尺寸下无文字遮挡、越界和底部导航覆盖。
+
+## 7. 图片校对方式
+
+图片按编号即业务顺序。修改时直接指出“文件名 + 位置 + 期望内容”，所有调整继续保存在本目录，不覆盖原产品设计。