Files
platforms/doc/用户端APP-最新参考产品设计/产品设计说明_用户端APP_v1.1.md

132 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 用户端 App 最新参考产品设计说明 v1.1
## 1. 本次交付
- 交付目录:`doc/用户端APP-最新参考产品设计`。
- 共保留 49 个主编号页面组;“添加设备”包含三个并存流程,“智能角阀功能介绍”包含四个独立标签状态,“安全内容中心”包含五个独立分类状态,因此目录内共有 58 张 PNG 设计图。
- 本轮按用户最新要求执行:每种页面类型只生成一张,不再等待逐张选稿;后续按用户对具体图片的反馈定向修改。
- 本轮仅交付产品设计图片与说明文档,不修改 Flutter 代码,不把后续规划能力标记为已经上线。
## 2. 设计依据
新版设计同时对照以下三类资料:
1. 原产品设计:`doc/用户端APP-产品设计`。
2. 当前用户端 App:`apps/user_app` 中已经存在的登录、首页、商城、订单、钱包、地址、合同与工单能力。
3. 正式需求:`docs/03-用户端App需求.md` 中的首期边界与后续设备、安全、押金、消息、发票等能力。
4. 开发实施文档:`docs/项目文档_用户端APP全量功能开发_v1.0.md`,用于落实页面路由、UI 优化、接口、数据模型、测试与分阶段交付。
设计稿保留完整产品方向,但开发时必须继续区分“当前真实可用”和“等待 Client API 落地”两种状态。设备控制、安全事件、押金、消息、发票、收藏、紧急联系人、账户注销及完整售后等未落地能力,不得用静态成功页面冒充真实业务结果。
## 3. 视觉规范
- 主色:`#2563EB`。
- 背景:`#F7F8FA`。
- 成功色:`#16875D`。
- 警告色:`#B86400`。
- 危险色:`#C7352A`。
- 组件:白色卡片、1px 浅灰边框、10dp/12dp/16dp 圆角、4dp 基础间距网格、扁平线性图标。
- 导航:一级页面使用“首页、商城、订单、我的”四栏底部导航;二级页面使用返回导航,不重复放底栏。
- 禁止项:紫色、渐变、AI 元素、Emoji、玻璃拟态、三维装饰、发光、浏览器栏、手机外壳和系统状态栏。
- 安全原则:危险告警不可关闭;开阀必须经过在线、权限、告警和传感器校验;离线、超时或失败不得伪造成成功。
## 4. 页面清单
### 4.1 入口、首页与设备
| 文件 | 页面类型 | 关键功能 |
| --- | --- | --- |
| `01-登录页.png` | 登录 | 手机号验证码、密码登录、协议、记住状态、忘记密码 |
| `02-智能角阀功能介绍.png` | 首次安全宣导 | 功能介绍、安全案例、法规、安全注意事项与阅读确认 |
| `02-1-安全案例.png` | 安全案例标签 | 泄漏自动关阀案例、设备离线案例、处理过程与安全提醒 |
| `02-2-法律法规.png` | 法律法规标签 | 国家法规、国家标准、地方指引、平台规则与外链提示 |
| `02-3-气价信息.png` | 气价信息标签 | 服务归属、气瓶规格价格、更新时间、押金与配送费说明 |
| `03-首页.png` | 首页 | 服务归属、安全公告、设备概览、快捷服务、四栏导航 |
| `04-智能角阀控制.png` | 角阀详情与控制 | 在线状态、遥测、安全检查、开关阀、命令结果入口 |
| `05-一键报修.png` | 报修提交 | 故障类型、语音、照片、联系人、地址、定位与紧急电话 |
| `06-1-扫码添加确认.png` | 扫码添加 | 扫码结果、设备校验、昵称、安装地址与确认绑定 |
| `06-2-蓝牙连接设备.png` | 蓝牙添加 | 附近设备、信号、权限、连接状态与失败引导 |
| `06-3-手动输入设备码.png` | 手动添加 | 设备码格式、编号位置、校验与其他添加方式 |
| `07-气瓶基本信息.png` | 气瓶信息 | 规格、钢瓶号、充装、制造、有效期、来源与异常提示 |
| `08-设备分组控制.png` | 设备分组 | 厨房/热水/暖气分组、全开全关、编辑删除与失败明细 |
| `09-安全告警与报警器.png` | 安全告警 | 报警器列表、在线状态、最近告警、测试、紧急电话 |
| `10-紧急联系人.png` | 紧急联系人 | 联系顺序、告警通知、查看/控制权限与编辑 |
### 4.2 商城、押金与购买
| 文件 | 页面类型 | 关键功能 |
| --- | --- | --- |
| `11-燃气商城.png` | 商城首页 | 搜索、分类、商品、收藏、购物车与库存状态 |
| `12-商品详情.png` | 商品详情 | 轮播主图、规格、配送、服务、押金、收藏与购买 |
| `13-购物车.png` | 购物车 | 单选全选、数量、失效商品、押金提示与结算 |
| `14-提交订单.png` | 商城结算 | 地址、配送时间、商品、费用、发票、备注和支付方式 |
| `15-我的收藏.png` | 收藏 | 分类、取消收藏、加入购物车与下架保留 |
| `16-押金管理.png` | 押金管理 | 押金汇总、使用中、退款中、已退回与规则 |
| `17-退瓶退押金.png` | 退瓶退款 | 气瓶选择、上门回收、状态确认、预计退款与审核规则 |
| `18-气瓶下单.png` | 气瓶购买 | 气站、规格数量、库存、配送时段、换气免重复押金 |
| `19-支付确认.png` | 支付 | 微信/支付宝/余额、支付密码、优惠与订单明细 |
### 4.3 订单、配送与售后
| 文件 | 页面类型 | 关键功能 |
| --- | --- | --- |
| `20-订单中心.png` | 订单中心 | 气瓶/商城/报修切换、状态筛选与常用操作 |
| `21-订单详情.png` | 订单详情 | 商品、费用、支付、合同、履约、人员、进度与售后 |
| `22-配送详情.png` | 配送详情 | 配送员、车辆资质、订单、受控联系与安全交付 |
| `23-配送轨迹.png` | 配送轨迹 | 最近位置、路线进度、预计时间、更新时间与历史节点 |
| `24-电子发票.png` | 发票申请 | 订单、可开票金额、抬头、税号、邮箱与申请状态 |
| `35-安全记录详情.png` | 安全事件 | 风险等级、自动关阀、证据、时间线、复检与不可删除 |
| `36-申请售后.png` | 售后申请 | 类型、原因、方案、图像/视频、联系人与退款审核 |
| `42-报修工单详情.png` | 报修详情 | 工单进度、故障证据、工程师、改期、记录与联系 |
| `48-服务评价.png` | 服务评价 | 总体/分项评分、标签、凭证与安全交付确认 |
| `49-预约安全巡检.png` | 巡检预约 | 服务内容、设备、日期时段、联系人、周期巡检与须知 |
### 4.4 个人中心、账户与消息
| 文件 | 页面类型 | 关键功能 |
| --- | --- | --- |
| `25-个人中心.png` | 个人中心 | 资料、钱包、订单、设备、安全家庭与常用功能入口 |
| `26-我的记录.png` | 记录中心 | 用气、设备、告警、报修、押金与发票统一追溯 |
| `27-用气统计.png` | 用气统计 | 日周月年、用气趋势、构成、安全趋势与明细 |
| `28-我的钱包.png` | 钱包 | 余额、押金、优惠券、充值、提现、账单与资金安全 |
| `29-地址管理.png` | 地址 | 默认地址、编辑、服务范围校验与新增 |
| `30-消息中心.png` | 消息 | 安全、订单、服务、公告、已读与跳转对象 |
| `31-设置.png` | 设置 | 账号、通知、权限、支付密码、协议、退出与注销入口 |
| `32-供气合同.png` | 合同 | 待签/生效/到期、查看、下载、变更与续签 |
| `33-家庭成员与设备共享.png` | 家庭共享 | 成员、设备、查看/控制权限、邀请与撤销 |
| `34-我的设备.png` | 设备总览 | 搜索、筛选、分组、在线/离线、快捷控制与添加 |
| `37-邀请注册.png` | 邀请注册 | 气站二维码、服务地址、服务关系与异常校验 |
| `38-余额充值.png` | 充值 | 套餐、自定义金额、渠道支付、限额与回调说明 |
| `39-余额提现.png` | 提现 | 到账卡、金额、手续费、支付密码、审核与受限资金 |
| `40-银行卡管理.png` | 银行卡 | 储蓄卡、默认到账卡、实名验证与解除绑定 |
| `41-个人资料.png` | 资料编辑 | 头像、昵称、手机号、认证、服务关系与默认地址 |
### 4.5 内容、安全设置与扩展能力
| 文件 | 页面类型 | 关键功能 |
| --- | --- | --- |
| `43-安全内容中心.png` | 内容中心 | 全部内容聚合、宣传、视频、法规、公告、外链风险与版本确认 |
| `43-1-安全宣传.png` | 安全宣传 | 宣传文章、阅读状态、分类筛选、专题学习与平台发布信息 |
| `43-2-安全视频.png` | 安全视频 | 推荐视频、视频分类、时长、阅读状态与继续学习 |
| `43-3-法律法规.png` | 法律法规 | 法规检索、适用层级筛选、版本与生效日期、外部链接风险提示 |
| `43-4-平台公告.png` | 平台公告 | 公告检索、类型筛选、重要公告、已读状态与所属气站/区域展示 |
| `44-自动关阀设置.png` | 定时关阀 | 规则、重复周期、提前提醒、执行记录与告警优先 |
| `45-电子保修卡.png` | 保修卡 | 保修状态、范围、服务商、维修记录与凭证 |
| `46-设备健康月报.png` | 健康月报 | 健康评分、在线率、异常、预测、来源与更新时间 |
| `47-安全知识考试.png` | 安全考试 | 题目、计时、进度、及格规则与危险题约束 |
## 5. 核心业务约束
- “扫码添加、蓝牙连接、手动输入”是并存方式,不是三选一视觉候选。
- 所属气站与服务配送点分开显示;无配送点时显示气站直接服务。
- 设备开阀、群组全开、定时控制都不能绕过高风险告警、设备离线和权限限制。
- 气瓶订单与普通商城订单共用支付能力,但气瓶订单必须保留气站、气瓶规格、换气、押金和预约时段规则。
- 商品金额、气瓶押金、配送费、优惠与可开票金额分别展示;押金不能作为普通商品收入开票。
- 配送位置必须展示最近更新时间;无有效位置时显示“暂未获取位置”,不伪造实时轨迹。
- 余额充值以支付渠道回调为准,提现与退款以服务端审核和资金流水为准。
- 用户、联系人、配送员、银行卡和证件信息使用脱敏展示。
## 6. 后续修改方式
用户可直接按文件名提出修改,例如“修改 `23-配送轨迹.png` 的地图占比”或“修改 `31-设置.png` 的通知分组”。每次修改只调整指定页面及其必要的关联说明,不重做已确认的其他图片。