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

This commit is contained in:
czl231
2026-09-07 19:14:58 +08:00
parent 1dd21e6df1
commit a0a4bb1218
196 changed files with 2601 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 842 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1012 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 929 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1024 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1006 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 953 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1020 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1006 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 960 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 980 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 986 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 994 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 985 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1011 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 936 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 962 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 895 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 978 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 994 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 996 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 882 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1018 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1006 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 970 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1006 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

View File

@@ -0,0 +1,122 @@
# 用户端 App 最新参考产品设计
> 本版本保留早期逐稿确认记录。用户已于 2026-09-05 将流程调整为“每种页面类型生成一张并直接保存”;完整页面清单与当前规则请查看 `产品设计说明_用户端APP_v1.1.md`。
## 1. 设计目标
- 以 `doc/用户端APP-产品设计` 中的业务功能和页面流程为基础逐类优化,不删除后续规划功能。
- 视觉与现有用户端 Design System 保持一致,主色使用 `#2563EB`,背景使用 `#F7F8FA`。
- 界面采用正式移动 App 的信息层级、间距和交互组件,不使用紫色、渐变、Emoji、玻璃拟态、三维装饰或夸张 AI 风格元素。
- 每类页面先生成三个独立候选,仅保存用户明确选定的版本。
## 2. 已选页面
| 序号 | 页面类型 | 来源参考 | 入选文件 | 状态 |
| --- | --- | --- | --- | --- |
| 01 | 登录页 | `../用户端APP-产品设计/1.jpg` | `01-登录页.png` | 已选择方案 1 |
| 02 | 智能角阀功能介绍 | `../用户端APP-产品设计/2.jpg`、`3.jpg` | `02-智能角阀功能介绍.png` | 已选择方案 1 |
| 03 | 首页与设备概览 | 当前真实首页、`../用户端APP-产品设计/4.jpg`、`4-1.jpg` | `03-首页.png` | 已选择方案 1 并完成公告区优化 |
| 04 | 智能角阀设备详情与控制 | `03-首页.png`、`../用户端APP-产品设计/4.jpg`、`4-6.jpg` | `04-智能角阀控制.png` | 已选择方案 1 |
| 05 | 一键报修 | `04-智能角阀控制.png`、`../用户端APP-产品设计/4-3.jpg`、`4-4.jpg` | `05-一键报修.png` | 已选择方案 2 |
| 06-1 | 扫码添加确认 | `03-首页.png`、`../用户端APP-产品设计/4-5.jpg` | `06-1-扫码添加确认.png` | 添加设备必需流程 |
| 06-2 | 蓝牙连接设备 | `03-首页.png`、`../用户端APP-产品设计/4-7.jpg` | `06-2-蓝牙连接设备.png` | 添加设备必需流程 |
| 06-3 | 手动输入设备码 | `03-首页.png`、`../用户端APP-产品设计/4-5.jpg`、`4-7.jpg` | `06-3-手动输入设备码.png` | 添加设备必需流程 |
## 3. 产品设计依据
新版产品设计必须同时合并三类依据,任何一类已有能力都不得因视觉改版被删除:
1. 原产品设计图:`doc/用户端APP-产品设计` 中的完整页面和交互流程。
2. 当前真实用户端:`apps/user_app` 已实现的登录、首页、商城、订单和个人中心能力。
3. 正式需求文档:`docs/03-用户端App需求.md` 中已明确的首期功能和后续迭代能力。
### 3.1 当前已实现能力
- 登录、注册、会话恢复和登录后返回原目标页。
- 首页安全内容、安全公告、内容详情和当前服务归属;服务归属分别展示所属气站与服务配送点。
- 商城商品列表、购买确认、地址选择、订单创建和余额支付。
- 商城订单、供气订单、退款记录、服务工单,以及支付宝、微信支付和退款申请入口。
- 个人资料、头像、钱包余额、地址管理、供气合同、钱包流水、申请维修和退出登录。
### 3.2 原设计及需求文档保留能力
- 智能角阀列表、设备详情、在线/离线、开关状态、电量、环境压力、温度、自动关阀时间、燃气检测和最后更新时间。
- 扫码添加、手动输入、蓝牙连接、设备校验、安装地址、设备昵称和重复绑定校验。
- 单设备开关阀、操作确认、命令回执、失败/超时状态,以及高风险事件禁止开阀。
- 厨房、热水器、暖气等设备分组,全开、全关、编辑、删除和逐设备失败明细。
- 气瓶规格、钢瓶号、充装日期、充装单位、充装数量、有效期、制造厂和异常提示。
- 可燃气体报警器列表、最近告警、安全提示、触发报警、紧急电话、一键报修和处理进度。
- 报修类型、故障描述、语音输入、联系人、地址、当前位置和最多三张现场照片。
- 商城分类、搜索、收藏、数量调整、商品详情、购物车、库存、配送费、预约时段和支付方式。
- 订单状态、配送轨迹、确认收货、售后、退款、评价和电子发票。
- 钱包、押金、消息、用气统计、收藏、客服、紧急联系人、家庭共享、通知与通用设置。
### 3.3 导航与页面组织原则
- 保留当前真实 App 的“首页、商城、订单、我的”四栏结构,避免底部导航过度拥挤。
- 智能角阀作为首页核心设备模块及独立详情流程;收藏放入商城和“我的”,不因取消独立底栏入口而删除功能。
- 当前已实现功能在设计稿中按真实可用状态呈现;后续能力按完整交互流程设计,但开发时必须等待真实接口,不使用静态成功结果冒充上线能力。
## 4. 登录页功能范围
- 手机号输入。
- 验证码登录与获取验证码。
- 密码登录切换。
- 记住登录状态。
- 忘记密码。
- 用户协议与隐私政策入口。
## 5. 设计规范
- 品牌主色:`#2563EB`。
- 成功色:`#16875D`。
- 警告色:`#B86400`。
- 危险色:`#C7352A`。
- 页面背景:`#F7F8FA`。
- 最小触控区域:48dp。
- 常规按钮高度:52dp。
- 间距使用 4dp 基础网格。
- 圆角优先使用 10dp、12dp、16dp。
### 5.1 智能角阀功能介绍
- 保留功能介绍、安全案例、法律法规和气价信息四类内容入口。
- 功能介绍保留远程开关阀门、实时状态监控、安全报警提醒和定时关阀设置。
- 使用统一线性图标,移除 Emoji、浏览器浮层、系统状态栏和截图侧边控件。
### 5.2 首页与设备概览
- 保留“当前服务归属”,分别显示所属气站与服务配送点。
- 首页增加厨房智能角阀概览,展示在线状态、开关状态、电量、环境压力、温度、可燃气体状态和最后更新时间。
- 提供扫码添加、蓝牙连接、分组控制和一键报修快捷入口。
- 提供安全记录、最近告警和气瓶信息入口,高风险开阀操作进入设备详情后执行。
- 安全公告使用圆角描边列表卡,展示真实中文摘要、日期和“查看全部”入口。
- 保留当前“首页、商城、订单、我的”四栏底部导航。
### 5.3 智能角阀设备详情与控制
- 展示在线状态、当前开关状态、设备状态说明和最后更新时间。
- 展示电量、环境压力、温度、可燃气体、关阀时间和使用气瓶六项设备数据。
- 开阀前明确校验设备在线、燃气泄漏和传感器状态,不允许绕过安全检查。
- 以单一主按钮执行开阀操作,并提示现场通风和远离明火。
- 保留安全记录、气瓶详情和一键报修入口;设备命令开发时必须展示最终回执或超时待确认状态。
### 5.4 一键报修
- 使用“故障信息、联系与地址、确认提交”三步引导,减少长表单一次性填写压力。
- 支持燃气泄漏、阀门故障、报警器故障和其他问题四类故障。
- 支持故障描述、语音输入和最多三张现场照片,照片记录拍摄时间及当前位置。
- 保留脱敏联系电话、报修地址、定位状态和紧急电话入口。
- 报修提交结果以服务端工单为准,失败时保留已填写内容,避免用户重复录入。
### 5.5 添加设备
- 扫码添加、手动输入和蓝牙连接是三种并存的必需方式,不作为互相替代的视觉候选。
- 扫码识别后展示设备编号、设备昵称、安装地址、安装位置和校验结果,再由用户确认绑定。
- 蓝牙连接展示附近设备、信号强度、连接状态、重新搜索、权限开启和连接帮助。
- 手动输入提供设备编号格式提示、编号位置示例、校验失败处理和其他添加方式入口。
- 绑定前统一校验设备归属、激活状态、服务区域和重复绑定;权限失败不得阻塞手动输入。
## 6. 后续流程
其余页面继续按“原始产品设计图 → 同一功能内容的三个布局候选 → 用户选择 → 保存入选稿”的顺序推进。不同业务方式或流程状态必须分别保留,不得作为互斥候选。全部视觉方案完成后,再据此更新 Flutter 用户端界面和相关功能。

View File

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

View File

@@ -0,0 +1,114 @@
# 用户端 App 产品设计优化操作日志
操作时间:2026-09-05 21:44:12
操作类型:新增、修改
影响模块:用户端 App 产品设计资料
操作前状态:新版参考目录仅包含已确认的登录页和智能角阀功能介绍页,首页候选稿尚未确认。
具体操作:以当前真实用户端首页为视觉基准,合并原产品设计及正式需求中的设备、安全和服务功能;根据用户标注优化安全公告区域;用户确认后保存入选稿并更新设计说明。
操作后状态:已新增正式首页设计稿,产品设计说明已记录首页功能范围和选稿状态。
代码变更:无代码变更。
文件变更:新增 `03-首页.png`;更新 `产品设计说明_用户端APP_v1.0.md`;新增本操作日志。
验证结果:确认图片文件存在且未覆盖其他设计稿;公告区域完整显示两条中文公告、日期和查看全部入口;四栏底部导航完整可见。
风险评估:当前交付为产品设计图片,不代表智能设备接口已经上线;后续开发必须使用真实接口和命令回执,不得以静态成功结果替代。
---
操作时间:2026-09-05 21:48:32
操作类型:新增、修改
影响模块:智能角阀设备详情与控制
操作前状态:已完成首页设备概览,智能角阀详情页尚未确定。
具体操作:基于已确认首页、原角阀控制设计和正式需求生成三个方案;按用户选择保存方案一。
操作后状态:已形成智能角阀详情与控制页设计稿。
代码变更:无代码变更。
文件变更:新增 `04-智能角阀控制.png`;更新 `产品设计说明_用户端APP_v1.0.md`。
验证结果:设备六项数据、安全检查、开阀操作、气瓶详情、安全记录和一键报修入口均完整显示。
风险评估:开阀属于高风险操作,后续实现必须依赖服务端权限、风险检查、幂等命令和最终设备回执。
---
操作时间:2026-09-05 22:14:22
操作类型:新增、修改
影响模块:用户端一键报修
操作前状态:现有 App 仅提供简化的问题描述和工单提交,原设计包含更完整的报修信息。
具体操作:合并当前工单能力、原报修流程和正式需求,生成三个方案并按用户选择保存引导式方案。
操作后状态:已形成包含故障、照片、联系与地址、紧急提示的分步报修设计。
代码变更:无代码变更。
文件变更:新增 `05-一键报修.png`;更新 `产品设计说明_用户端APP_v1.0.md`。
验证结果:故障类型、描述、语音、照片、联系人、地址、定位、紧急提示和下一步操作均完整可见。
风险评估:照片、定位和语音涉及权限与隐私,后续实现需按使用时申请权限并避免日志记录敏感数据。
---
操作时间:2026-09-05 22:18:00
操作类型:新增、修改
影响模块:用户端添加设备流程
操作前状态:扫码、蓝牙和手动输入被错误作为同一页面的互斥设计候选。
具体操作:按用户纠正,将三张图重新定义为添加设备的三个必需流程页面并全部保存;同步修订后续选稿规则。
操作后状态:添加设备包含扫码确认、蓝牙连接和手动输入三个完整入口。
代码变更:无代码变更。
文件变更:新增 `06-1-扫码添加确认.png`、`06-2-蓝牙连接设备.png`、`06-3-手动输入设备码.png`;更新产品设计说明。
验证结果:三张来源图片均已复制到最新参考产品设计目录,页面功能彼此补充而非互相替代。
风险评估:后续候选必须保持业务内容一致,仅比较布局、层级和交互表达;不得因选稿删除扫码、蓝牙或手动输入能力。
---
操作时间:2026-09-05 23:30:00
操作类型:新增、扩展
影响模块:用户端 App 全量产品设计参考
操作前状态:目录仅完成登录、首次宣导、首页、角阀控制、报修和添加设备流程;其余商城、押金、订单履约、个人中心及扩展能力尚无统一新版设计稿。
具体操作:按用户最新要求取消逐页三方案选稿,改为每种页面类型直接生成一张;同时对照原产品设计、当前用户端能力和 `docs/03-用户端App需求.md`,补全设备、安全、商城、气瓶购买、押金、订单、配送、售后、钱包、地址、消息、合同、家庭共享、内容中心及扩展页面。
操作后状态:形成 49 个编号页面类型,其中添加设备包含三个并存流程,共 51 张 PNG;新增 `产品设计说明_用户端APP_v1.1.md` 作为完整索引。
代码变更:无代码变更。
文件变更:新增 `07-气瓶基本信息.png` 至 `49-预约安全巡检.png` 对应页面;新增 `产品设计说明_用户端APP_v1.1.md`。
行为变化:设计交付流程由“每类三稿、逐张选择”调整为“每类一稿、直接落盘、按文件名定向返修”;三种设备添加方式继续作为独立业务流程保留。
验证结果:共检查 51 张 PNG,全部可读取;主体图片尺寸为 853×1844,少量为 852×1846、885×1777 或 929×1693,均保持移动端竖屏比例;文件名唯一,未覆盖原产品设计目录;页面清单与设计说明已同步。
边界验证:设计稿中未把后续规划功能标记为当前真实上线能力;支付、充值、提现、退款、设备命令、告警与配送轨迹均保留服务端回执、审核、失败或更新时间约束。
风险评估:本次图片用于产品与开发参考,部分设备、安全、押金、消息、发票、收藏、紧急联系人及完整售后能力仍需等待 Client API;实现时禁止使用静态成功响应。图片中文字与真实业务字段仍需在开发前由产品和合规复核,紧急电话、服务范围、费用和协议版本必须由后台配置。
---
操作时间:2026-09-06 00:20:00
操作类型:新增、补全
影响模块:首次安全宣导标签页
操作前状态:`02-智能角阀功能介绍.png` 仅呈现“功能介绍”标签内容,“安全案例、法律法规、气价信息”只有入口,缺少独立内容状态设计。
具体操作:沿用原弹层结构、四标签导航和蓝白视觉规范,分别生成安全案例、法律法规和气价信息三个标签状态。
操作后状态:首次宣导四个标签均有对应设计图,可按同一页面的标签切换实现。
代码变更:无代码变更。
文件变更:新增 `02-1-安全案例.png`、`02-2-法律法规.png`、`02-3-气价信息.png`;更新 `产品设计说明_用户端APP_v1.1.md`。
验证结果:三张新增图片均可读取,尺寸为 852×1846 或 853×1844;标签选中状态正确,未覆盖原 `02-智能角阀功能介绍.png`。
风险评估:法规版本、地方适用范围、气价、押金和配送费必须由后台配置并带更新时间;设计稿中的金额仅作为结构示例,实际展示以服务端返回为准。
---
操作时间:2026-09-06 00:40:00
操作类型:新增、补全
影响模块:安全内容中心分类页
操作前状态:`43-安全内容中心.png` 仅呈现“全部”聚合状态,“安全宣传、安全视频、法律法规、平台公告”只有分类入口,缺少独立内容状态设计。
具体操作:基于原安全内容中心的顶部导航、分类标签和蓝白视觉规范,结合用户端实际安全内容能力,分别生成安全宣传、安全视频、法律法规和平台公告四个分类页;各页保留检索、筛选、阅读状态、发布来源和日期等真实业务字段。
操作后状态:安全内容中心五个分类状态均有对应设计图,可按同一页面的分类切换实现。
代码变更:无代码变更。
文件变更:新增 `43-1-安全宣传.png`、`43-2-安全视频.png`、`43-3-法律法规.png`、`43-4-平台公告.png`;更新 `产品设计说明_用户端APP_v1.1.md`。
行为变化:补齐四个分类标签对应的完整内容页,不再仅将标签作为静态入口。
验证结果:四张新增图片均可读取,尺寸均为 853×1844;文件哈希互不重复,未覆盖原 `43-安全内容中心.png`;目录内 PNG 总数更新为 58。
风险评估:法规版本、生效日期、公告范围、视频时长、阅读状态及内容发布时间必须以后端数据为准;外部法规链接仍需保留跳转风险提示与域名校验。
---
操作时间:2026-09-06 11:28:15
操作类型:新增、扩展
影响模块:用户端 App 全量产品设计开发文档
操作前状态:最新参考产品设计目录已有 49 个主编号页面组、58 张设计图及设计说明,但缺少一份逐页面连接 Flutter 路由、Client API、数据模型、平台配置与验收测试的统一开发文档。
具体操作:对照全部设计图、当前用户端代码、现有用户 Client API、平台内容配置及正式需求,新增全量功能开发文档;按 49 个页面组登记路由、现状、接口扩展和实施范围,并补充 UI 规范、数据模型、状态机、安全、测试、灰度与回滚要求。
操作后状态:产品设计具备统一开发实施基线,现有能力与待开发能力已明确分开,可按阶段开展 UI 优化和接口补全。
代码变更:无代码变更。
文件变更:新增 `docs/项目文档_用户端APP全量功能开发_v1.0.md`;更新 `docs/README.md`、`doc/用户端APP-最新参考产品设计/产品设计说明_用户端APP_v1.1.md` 和本操作日志。
验证结果:开发文档共 650 行,49 个主编号页面组、58 张设计图均已登记;文档包含项目概述、目录结构、核心文件、路由、Client API、数据模型、状态机、测试、交付阶段、风险与维护指南。
风险评估:文档中的新增接口和数据实体属于目标设计,不代表已经上线;气价来源、安全视频性质、设备协议、支付渠道、退押规则、地图服务、发票服务和巡检规则仍需在对应阶段开发前完成业务确认。