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

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

@@ -0,0 +1,131 @@
+# 用户端 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` 的通知分组”。每次修改只调整指定页面及其必要的关联说明，不重做已确认的其他图片。