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

doc/服务端APP-安全检查端-最新参考产品设计/产品设计说明_安全检查端APP_v1.0.md

@@ -0,0 +1,95 @@
+# 安全检查端 APP 最新产品设计说明 v1.0
+
+## 1. 文档定位
+
+本目录 40 张 PNG 是安全检查端目标产品设计。设计依据为原安全检查端产品图、当前 `apps/service_app` ticket 能力、服务端 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 | 问题反馈与投诉 | 功能、数据、结算、投诉和附件提交 |
+
+## 4. 当前实现对照
+
+| 范围 | 当前状态 | 后续开发要求 |
+| --- | --- | --- |
+| 登录与角色 | 已有真实登录与角色识别 | 补岗位申请、审核与资质状态 |
+| 作业前检查 | 已有 `/preflight` 与考勤 | 补安检设备自检、培训、阻断细项与处理入口 |
+| 安检任务 | 已有 ticket 列表、详情、开始、异常、恢复 | 补安检专用字段、围栏、设备与环境清单、拒检和复检状态机 |
+| 取证与提交 | 已有图片证据、结果提交和加密草稿 | 补视频、用户签名、风险分级、整改单、隐患与复检闭环 |
+| 钱包 | 已有钱包查询 | 补安检收入、提现、银行卡和结算状态 |
+| 记录与统计 | 仅有通用记录入口 | 补完整记录、关联隐患、统计、导出和抽查地图 |
+| 个人中心 | 已有基础资料和草稿入口 | 补资质、知识库、人工支持、二维码、会诊和反馈 |
+
+## 5. 风险与状态机要求
+
+- 延续 `/heqi/client/v1/staff/tickets` 现有接口，不修改已有字段语义。
+- 安检状态建议覆盖：待到场、执行中、待签名、待评定、已完成、异常暂停、拒检、待整改、待复检、已关闭。
+- 风险分级固定为：一级高风险立即处置，二级中风险限期整改，三级低风险提出建议。
+- 一级高风险的关阀、通风、疏散、警戒、通知和移交均需单独时间戳和证据；未完成移交不能结束任务。
+- 每个检查项保存结果、说明、测量值、照片、视频、操作者、设备时间和服务端时间。
+- 整改通知单、隐患和复检任务必须由同一服务端事务关联，避免重复或孤立记录。
+- 拒检需要原因、联系记录、现场证据、见证信息和后续安排，结果字段保持为空。
+- 区域地图仅显示业务所需的模糊点位，进入任务详情后再按权限查看精确地址。
+
+## 6. 验收重点
+
+- 40 个页面和安检主链路可连续操作，正常、隐患、一级高风险、拒检和离线分支完整。
+- 设备、环境、取证、签名、风险、整改单、隐患和复检数据前后一致。
+- 一级高风险不能被普通完成动作绕过；安全通知不能被用户关闭。
+- 复检通过后才能关闭隐患，资料初审不得代替现场复检。
+- Android 常用尺寸下无文字遮挡、越界和底部导航覆盖。
+
+## 7. 图片校对方式
+
+图片按编号即业务顺序。修改时直接指出“文件名 + 位置 + 期望内容”，所有调整继续保存在本目录，不覆盖原产品设计。

doc/服务端APP-安全检查端-最新参考产品设计/操作日志_安全检查端APP产品设计优化_20260906.md

@@ -0,0 +1,19 @@
+# 安全检查端 APP 产品设计优化操作日志
+
+操作时间：2026-09-06
+
+操作类型：新增
+
+影响模块：服务端 APP 安全检查岗位产品设计
+
+操作前状态：原安全检查端界面包含紫色主题和旧式布局，安检、隐患、整改、复检、拒检与高风险处置链路不完整；当前客户端只实现通用 ticket 列表、详情、开始、异常、恢复、结果提交和证据草稿的部分能力。
+
+具体操作：在新目录中生成 40 张目标产品设计图，补齐准入、任务、到场、设备、环境、取证、签名、合格、不合格、风险分级、一级高风险、整改、复检、拒检、地图、记录、钱包、离线、资质、人工支持、知识库、人工专家和反馈页面。
+
+操作后状态：原目录未修改；最新目录可独立用于逐页评审和后续开发。
+
+代码变更：本次未修改业务代码，仅新增产品设计图片与 Markdown 文档。
+
+验证结果：PNG 数量 40；图片可读取；文件名按业务顺序编号；未使用紫色与 AI 元素。
+
+风险评估：设计包含尚未实现的目标能力；开发时必须重点验证一级高风险强制流程、隐患事务一致性、拒检真实性、复检关闭条件和离线证据同步。

doc/服务端APP-安装端-最新参考产品设计/产品设计说明_安装维修端APP_v1.0.md

@@ -0,0 +1,92 @@
+# 安装维修端 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. 图片校对方式
+
+图片按编号即业务顺序。修改时以“文件名 + 位置 + 期望内容”提出，避免覆盖旧产品设计目录。

doc/服务端APP-安装端-最新参考产品设计/操作日志_安装维修端APP产品设计优化_20260906.md

@@ -0,0 +1,19 @@
+# 安装维修端 APP 产品设计优化操作日志
+
+操作时间：2026-09-06
+
+操作类型：新增
+
+影响模块：服务端 APP 安装维修岗位产品设计
+
+操作前状态：原产品设计存在旧式页面、紫色元素、部分流程缺页；当前 Flutter 客户端仅覆盖通用登录、准入、任务、取证、记录和个人中心的部分能力。
+
+具体操作：在新目录中生成 40 张目标产品设计图，统一视觉系统，补齐安装、维修、巡检、复检、取证、测试、签名、收款、离线、钱包、人工支持、备件与保修回访页面；新增开发对照说明。
+
+操作后状态：原目录未修改；最新目录可独立用于逐页评审和后续开发。
+
+代码变更：本次未修改业务代码，仅新增产品设计图片与 Markdown 文档。
+
+验证结果：PNG 数量 40；图片可读取；文件名按业务顺序编号；未使用紫色与 AI 元素。
+
+风险评估：图片为目标状态，部分接口和页面尚未实现；开发时必须以服务端状态机和接口返回为准，并补充异常、离线和幂等测试。