6.3 KiB
6.3 KiB
安装维修端 APP 最新产品设计说明 v1.0
1. 文档定位
本目录 40 张 PNG 是安装维修端的目标产品设计，供后续 Flutter 页面、交互和接口开发使用。设计依据包括原安装端产品图、当前 apps/service_app 实现、服务端 App 需求与核心业务流程文档。图片表示目标状态，不代表当前代码已经完成对应功能。
2. 设计原则
- 保留现有安装、维修、巡检、复检、取证、签名、收款、钱包和个人中心等业务能力，不因 UI 优化删除功能。
- 主色为
#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 | 服务支持中心 | 人工客服、组织电话、服务请求和 FAQ |
| 37 | 维修知识库与视频教程 | 规范、案例、视频和学习进度 |
| 38 | 远程专家会诊 | 人工专家视频、语音、资料和意见留痕 |
| 39 | 备件领用 | 备件申请、扫码、库存与归还 |
| 40 | 电子保修卡与用户回访 | 保修范围、状态、回访和服务记录 |
4. 当前实现对照
| 范围 | 当前状态 | 后续开发要求 |
|---|---|---|
| 登录与角色 | 已有真实登录与角色识别 | 补岗位申请、审核状态与异常提示 |
| 作业前检查 | 已有 /preflight 与考勤调用 |
补培训、资质到期、工具设备细项与阻断引导 |
| 工单列表与详情 | 已有 ticket 列表、详情、开始、异常、恢复 | 按 08 至 24 页面拆分状态机和专用表单 |
| 取证与提交 | 已有证据上传、结果提交和加密草稿 | 补视频、签名、材料、测试、收款、失败恢复与冲突处理 |
| 钱包 | 已有钱包查询 | 补明细、提现、银行卡管理和服务端审核状态 |
| 记录与统计 | 仅有通用记录入口 | 补记录详情、筛选、统计指标与导出 |
| 个人中心 | 已有基础资料和草稿入口 | 补资质、知识库、人工支持、二维码、备件、保修与回访 |
5. 关键接口与数据要求
- 继续复用
/heqi/client/v1/staff根路径和现有身份模型，不破坏既有接口。 - 新增接口应按岗位权限返回可见字段，禁止客户端自行推断高风险结果、结算结果或任务完成状态。
- 工单操作至少包含
start、exception、recover、条件核验、材料领用、过程取证、测试、签名、收款、结果提交和完成确认。 - 每次状态变更携带幂等键、设备标识、定位、客户端时间和版本号；服务端返回最终状态与可执行动作。
- 证据对象需要类型、文件哈希、拍摄时间、定位、任务编号、上传状态和服务端文件标识。
- 离线草稿采用本地加密、分片重试、冲突比较和用户可见的同步结果。
6. 验收重点
- 40 个页面功能入口、状态文案和返回路径完整。
- 正常、阻断、失败、离线、冲突、重复提交和服务端拒绝均有明确界面反馈。
- 安装、维修、巡检、复检四类任务不会共用错误字段或错误流程。
- 金额、签名、取证、风险和完成状态均以后端确认结果为准。
- Android 常用尺寸下无文字遮挡、越界、按钮错位或底部导航覆盖。
7. 图片校对方式
图片按编号即业务顺序。修改时以“文件名 + 位置 + 期望内容”提出，避免覆盖旧产品设计目录。