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

96 lines
6.7 KiB
Markdown
Raw Permalink Normal View History

# 安全检查端 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. 图片校对方式
图片按编号即业务顺序。修改时直接指出“文件名 + 位置 + 期望内容”,所有调整继续保存在本目录,不覆盖原产品设计。