Files
lujianlucha-prd/05-mobile-field.md
T

278 lines
22 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.
# 05 手机端 · 链路与兜底
| 项目 | 内容 |
| --- | --- |
| 版本 | v1.3,2026-11-03 |
| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §3、`02-pages/P25 P01 P19 P02 P03 P04 P20 P06`、`04-components.md` C-35 至 C-41、C-53 |
| 原型 | p25-launch、p01-login、p19-home、p02-object、p03-task、p04-capture、p20-review、p06-submit |
| 功能点 | 81(P25 5、P01 7、P19 11、P02 11、P03 12、P04 14、P20 8、P06 13) |
| 视口 | 375×812 |
| 数据来源 | `reference/mock-data.md`,八页示例值取自该文件 |
| 状态 | G4 交付,待评审 |
## 1 端的定位
手机由主操作界面降为链路中转与兜底端。现场主路径在眼镜与语音里走完,手机在口袋里当中转;掏出来只有五个时刻:选场景、对象核对失败要手工录入、要改值、要看证据、要复核。
这个定位决定三条设计取向:
1. 页面不为「常用」优化,为「必须用时一次做对」优化。既然不常掏,就要求一次就位,不做多级跳转。
2. 凡是眼镜能做的主入口,手机不重复做一遍。改值是例外,因为改值本来就要看清单与证据。
3. 手机有眼镜没有的四样东西:键盘、相机回放、列表浏览、批量操作。手机的价值在这四样上,不在「也能提交」这条上。
## 2 八页一览
| 页面 | 路由 | 一句话 | 入口 | 出口 | 功能点 |
| --- | --- | --- | --- | --- | --- |
| P25 启动页 | `/launch` | 遮住必然的等待,超时给退路 | 冷启动 | P19 或 P01 | 5 |
| P01 登录 | `/login` | 进得来,把不该进来的拦住 | P25;退出 | P19 | 7 |
| P19 主页 | `/home` | 眼镜在不在、能查哪几类、还欠几张单 | P01;P06 回主页 | P02、P03、P20、P05 | 11 |
| P02 核对检查对象 | `/confirm/:taskId` | 系统看到的那一个对象,人再核对一次 | P19 可作业卡;眼镜识别失败 | P03、P19 | 11 |
| P03 任务 | `/task/:taskId` | 这个对象该查什么,一眼看全 | P02;P04 返回;P19 在办单 | P04、P05、P06 | 12 |
| P04 填报与采集 | `/item/:taskId/:itemId` | 把这一项的值改对、证据补齐 | P03 项行;P20 跳转 | P03、P05 | 14 |
| P20 待复核清单 | `/review/:taskId?` | 哪些值是机器或嘴给的,人核对一遍 | P06 回执;P19 待复核条数 | P04 | 8 |
| P06 提交与回执 | `/submit/:taskId` | 交没交成、交完是什么状态 | P03 底部;P19 在办单 | P20、P19、P03 | 13 |
P07 回执页停用,整体并入 P06 尾部的 S3 段。
## 3 主页高度账
375×812,含 44px 系统状态栏。上方各块高度固定,只有场景区可伸缩。
| 层 | 高度 | 说明 |
| --- | --- | --- |
| R0 状态栏 | 44 | 系统占位,照画不画内容 |
| R4 账号卡 | 60 | 姓名、角色、组织 |
| R5 眼镜卡 | 80 | 连接态、路径、电量、固件 |
| R7 在办与待复核 | 128 起 | 块标题 24 + 在办行 64×n + 待复核行 40 |
| R6 场景区 | 328 起 | 族标题 32 + 可作业卡 96 + 占位行 40×5 |
| R8 底栏 | 56 | 手输识别键、智能问答 |
| 安全区 | 20 | 手势区按 20 算 |
三种实排结果:
| 情形 | 合计 | 结论 |
| --- | --- | --- |
| 在办 0 条、待复核 0 条(主态,即常态) | 612 | 余 200,场景区可多留白 |
| 在办 1 条、待复核 3 条(在办与待复核态) | 716 | 余 96,无需下滚 |
| 在办 3 条、待复核 3 条(上限) | 844 | 超 32,页面下滚 |
一条硬规则从这里来:占位场景在主页一律用 40 高行,不用 96 高卡。一期五类无模板,五张灰卡吃掉 480px,会把在办单挤出首屏;改五行只占 200px。占位卡形态只在说明弹层与全部场景列表里出现,那里需要与可作业卡并列比较。
## 4 逐页定义
### 4.1 P25 启动页
深色,全局唯一。取景框四角、车牌轮廓、斜向光带、透视网格全部矢量绘制,色值只取两档蓝。
状态行三句依次替换:恢复登录态、连接眼镜、正在同步场景授权,每句最短停留 300 毫秒。三步在 3 秒内返回就跳,不等动画播完;超过 5 秒转兜底,给「重试」与「先进入」,无登录态时只给「重试」。
眼镜连不上不拦人:前两步完成即放行,连接状态交给主页眼镜卡。
功能点合并说明:入场淡入与光带扫过视为同一功能点「入场动效」,验收时一起看,因此本页计 5。分片把两者拆成两条,合并后与 `01-SPEC` §3 的计数一致。
### 4.2 P01 登录
只保留未登录态。品牌在启动页已露出过一次,这里只留一行小字「现场检查助手」。
五角色里只放行执法员与中队负责人,其余三个登录即整页拦截:标题「无现场作业权限」,一行说明,只有「退出登录」。平台管理员不上手机,是避免现场用一个能改授权的高权账号作业。不给申请入口,一期没有申请流。
登录失败分两种,文案必须分开:账号密码错是「工号或密码不正确」,角色越权是「当前账号无现场作业权限」。前者可重试,后者重试无用,混成一句会让人一直试密码。
### 4.3 P19 主页
渲染顺序固定:状态栏、账号卡、眼镜卡、在办与待复核、场景区、底栏。在办块排在场景区之前,因为主页要回答的三个问题里只有「还欠几张单」每天都在变。
场景卡三态由三个条件串起来决定:已授权、已启用、有冻结模板。三者齐备是可作业卡,缺模板是占位行,未授权或未启用不渲染。判定只读 `template.frozenVersion` 是否为空,不读 moduleId,也不读角色。
场景区按判定结构分四族:单对象、送检、区域、事件。族内无卡时整族不渲染,包括标题。第一行右侧固定一张「全部场景」入口卡,作用是对冲「系统只支持一类检查」的误读。
页面两态,主态是常态:在办 0 且待复核 0,在办块整块不渲染,场景卡不显在办数(画布 P19-a)。在办与待复核态只在异常时出现(在办 ≥1 或待复核 >0,画布 P19):一期无派单,在办块是中断、设备没电、换班后的恢复入口,不是待办列表,不设「待办」字样与红点角标,避免开发做成任务推送。高度账见 §3。
说明层 M-05 有两个入口:占位行点击与「全部场景」卡点击,共用同一弹层。层内列六类场景,可作业的排前面并带识别键标签,待开通的显示「尚未开放」;层头一行计数「可检查 N 个场景 · 待开通 M 个」。层内不设起单按钮,底部固定一句「待开通场景仅可查看说明,暂不能开始检查」,说明页不是入口。
### 4.4 P02 核对检查对象
页面名「核对检查对象」,按钮「开始检查」。基线的「确认」像签收,实际动作是核对一致性。
识别键随对象类型变,录入形态随之变:车牌裁掉 I 与 O,机械登记码保留全字符,机构名与信用代码走编码手输,点位与排口走扫码或编码。
车辆档案在识别成功后按车牌带出,展示五个字段(车型、品牌型号、排放阶段、燃料类型、注册日期),卡头标来源「档案」。不设独立车型选择区:档案已经给了答案,单摆一个选择区等于暗示还要人工填。发现档案车型与实际不符时点车型行弹三选修正,来源转手输并留痕。
两条确认路径:眼镜语音确认是默认路径,手机不点亮;手机界面确认是兜底路径,只在识别失败、复合键缺第二字段、语音确认超时 20 秒三种情况下被拉起。复合键缺第二字段只在复合键对象上出现(堆场场景的统一社会信用代码加点位编号,起单前必须两项齐备);路检路查车牌是单键,一期 M01 不触发该状态,画面照建是为 M04 类场景接入时同一路由直接可用。
### 4.5 P03 任务
三层外壳不动,内层按判定结构换:对象条、进度摘要、清单主体。四种布局由 `structure` 决定,界面不给手动切换控件。一期只有 L1 单对象清单落地;L2 清单加送检、L3 对象加点位、L4 事件线索是 M03/M04/M05 实装后的同页形态,画布有分镜(P03-b/c/d),一期不实现。
分组标题与组内计数取模板的 `groupName` 与 `groupSeq`,不硬编码排气、OBD、装置这类名字。分组一旦硬编码,加一类场景就要改一次前端,模块化指标当场破。
任务切换态只在从主页「还有 N 单」进入时出现,从对象核对或填报返回一律不出。切换态回答的是「我手上还有几张单」,起单那一刻这个问题不存在。
### 4.6 P04 填报与采集
改的不是控件,是取值、落库、标记三件事。五类控件按 `value_type` 分支的机制原样保留,它已经是数据驱动的。
来源标记四类全显,包括手输。人工改写后来源转手输,留痕记改前来源。改回原值仍记手输:判定值有没有被人动过,是复核时最想知道的一件事,不能因为改回原样就抹掉。
送检类项值区转只读,显示「送检项,结论由科室回填」,素材与备注仍可补。手机端不提供送检推进,给出可点入口就会产生现场自作结论的口子。
### 4.7 P20 待复核清单
清单在提交之后,不在提交之前。定型主流程是「落库留痕 → 复核」,复核不是第二道校验,是一轮事后核对。
只收识别、语音、转抄三类来源(推断:清单过长会被弃用,待现场验证),手输是人亲自敲的,不进清单。
跨任务视图不出现批量确认:一次误点会确认掉另一单的条目。这条是本文加的约束,分片未写。
### 4.8 P06 提交与回执
同路由四阶段:校验、提交中、回执、待送检变体。S4 不是第五个页面,也不是弹层,是同一路由的渲染分支。
阻断分三层:必检未查、关键项缺素材、不适用无原因。前两条界面拦一次,第三条界面与服务端各拦一次,因为眼镜语音提交不经过本页。
两路提交先进为准。本单已被眼镜提交时,进入即转回执并提示「本单已提交」,不产生第二条记录。
## 5 跨页规则
| 规则 | 内容 |
| --- | --- |
| 对象类型驱动 | 识别键字段、录入形态、任务布局、列头标签四处都读 `objectType` 与 `structure`,不读 moduleId |
| 来源标记 | 识别、语音、手输、转抄四类全显;缺失标黄,不改写成任何来源 |
| 提交两路 | 眼镜与手机都能提交,先进为准,不产生第二条记录 |
| 复核在后 | 复核在提交之后,改值留痕标已修改,不走审批 |
| 断网 | 可浏览已加载内容;提交直接失败并提示,不进提交中态,因为校验在服务端 |
| 准入 | 只有执法员与中队负责人可登录,其余角色整页拦截 |
| 场景停用 | 任务页顶部出提示,填报页全页只读,提交禁用并给原因 |
## 6 功能点清单
| 编号 | 功能 | 验收 |
| --- | --- | --- |
| F-P25-01 | 品牌露出 | 产品名与版本号常显,不可点 |
| F-P25-02 | 进度转述 | 三句依次替换,每句最短 300 毫秒 |
| F-P25-03 | 就绪跳转 | 三步返回即跳,不等动画播完 |
| F-P25-04 | 超时兜底 | 超 5 秒给「重试」与「先进入」;无登录态时只给「重试」 |
| F-P25-05 | 入场动效 | 淡入 400 毫秒加光带扫过一次,不循环;从后台恢复不重播 |
| F-P01-01 | 品牌小字 | 一行 14px 次要色「现场检查助手」 |
| F-P01-02 | 工号输入 | 记住上次工号,可清空 |
| F-P01-03 | 密码输入 | 密文显示,可切换明文 |
| F-P01-04 | 登录提交 | 提交中按钮内加载,字段禁编辑 |
| F-P01-05 | 登录失败提示 | 账号密码错与角色越权文案分开,不清空工号 |
| F-P01-06 | 待提交队列徽标 | 数量取本地未提交队列,为空不渲染 |
| F-P01-07 | 记住工号 | 开关状态本地保存 |
| F-P19-01 | 账号卡 | 姓名、角色、组织,不做头像,不可点 |
| F-P19-02 | 眼镜卡 | 连接三态、路径、电量、固件版本 |
| F-P19-03 | 眼镜卡点开 | 已连接进详情,未连接为「重试连接」 |
| F-P19-04 | 场景区渲染 | 可作业出卡、已启用无模板出占位行,按四族分组,空族不渲染 |
| F-P19-05 | 可作业卡起单 | 点卡进 P02 并带 moduleId |
| F-P19-06 | 占位行说明 | 点行进说明层,层内无起单按钮 |
| F-P19-07 | 在办单列表 | 最多三条,第 4 条起换「还有 N 单」,跨日整行转红 |
| F-P19-08 | 待复核入口 | 条数大于 0 才显示 |
| F-P19-09 | 手输识别键 | 无可用场景时先弹场景选择 |
| F-P19-10 | 智能问答 | 进 P05,标记来源为主页(from=home) |
| F-P19-11 | 眼镜推送处理 | 连接态、电量、固件变化时刷新眼镜卡 |
| F-P02-01 | 截帧展示 | 带设备时间与来源水印,仅用于核对,不入素材正片 |
| F-P02-02 | 识别结果大字 | 主字段随对象类型;复合键出两个字段位,缺段转黄 |
| F-P02-03 | 开始检查按钮 | 重复在办时不新建,转既有单并提示 |
| F-P02-04 | 修正入口 | 修正后原值与录入值双存,来源转手输 |
| F-P02-05 | 识别键录入器 | 字符集按类型裁,三种形态共用同一提交与留痕 |
| F-P02-06 | 省份简称选择 | 仅车牌形态出现 |
| F-P02-07 | 车型档案卡 | 档案带出五字段;未命中退化为三选手选;仅 M01 渲染 |
| F-P02-08 | 手输入口 | 识别失败时直接展开,不阻断 |
| F-P02-09 | 识别失败兜底 | 三条路径都能落,落完必标来源 |
| F-P02-10 | 重新识别 | 清空结果重新走识别 |
| F-P02-11 | 复合键第二字段 | 独立录入位与格式校验;缺字段时按钮禁用并给原因 |
| F-P03-01 | 对象条 | 主字段 20px 等宽加场景徽标,复合键副行 13px |
| F-P03-02 | 进度摘要 | 四套随 structure 换,圆环与计数同步 |
| F-P03-03 | 清单分组 | 组名与顺序取模板,不硬编码 |
| F-P03-04 | 进入单项填报 | 行可点,返回恢复滚动位置 |
| F-P03-05 | 当前项焦点 | 语音翻项只移动焦点并高亮 2 秒 |
| F-P03-06 | 进入问答 | 带任务号与来源标记(taskId、from=task) |
| F-P03-07 | 进入提交 | 有未查项也进;有待送检加只读条 |
| F-P03-08 | 清单刷新 | 下拉刷新,返回自动静默刷新 |
| F-P03-09 | 电量徽标 | 只留电量百分比,完整信息在主页 |
| F-P03-10 | 布局渲染 | 按 structure 渲染四套之一,无手动切换控件 |
| F-P03-11 | 点位切换与阶段展示 | L3 横滑切点位,L4 阶段时间线;L1、L2 不渲染 |
| F-P03-12 | 任务切换态 | 只从主页「还有 N 单」进入时出现,退出不记忆 |
| F-P04-01 | 项名与依据 | 依据带层号 A 至 D |
| F-P04-02 | 值控件 | 枚举、数值、布尔三类按 value_type 分支 |
| F-P04-03 | 单位与区间 | 字典未到位显示破折号,不显示 0 |
| F-P04-04 | 不适用原因 | 原因为空不允许确认,弹层内即拦 |
| F-P04-05 | 素材采集 | 六行信息齐全,采集与接收时间并排 |
| F-P04-06 | 素材重采与删除 | 删除只标缺失,不物理删 |
| F-P04-07 | 语音提问 | 进 P05,标记来源为填报页(from=item)并自动带入问题 |
| F-P04-08 | 保存 | 写值与来源;未改动保留原来源 |
| F-P04-09 | 已提交可改 | 原提交人可改,留痕标已修改 |
| F-P04-10 | 异常标 | 命中异常判定显示异常,字典未到位不显示 |
| F-P04-11 | 标缺失 | 素材缺失走弹层填原因 |
| F-P04-12 | 备注 | 长文本可录,不做截断提示 |
| F-P04-13 | 来源标记 | 四类全显;人工改写转手输并记改前来源;改回原值仍记手输 |
| F-P04-14 | 送检项只读段 | 值区只读并说明结论由科室回填;素材与备注仍可补 |
| F-P20-01 | 条目列表 | 按录入时间倒序,每页 20 条上滑加载 |
| F-P20-02 | 条目内容 | 值、来源标、所属项、时间四件齐 |
| F-P20-03 | 跨任务识别键 | 无 taskId 时每条显示识别键与场景名 |
| F-P20-04 | 单条确认 | 行渐隐移出,计数减一,不弹轻提示 |
| F-P20-05 | 跳转改值 | 点行其他区域进 P04 并带 from=review |
| F-P20-06 | 批量确认本单 | 仅单任务视图出现,走二次确认 |
| F-P20-07 | 剩余条数 | 「还剩 3 / 21」,随确认实时变 |
| F-P20-08 | 全部确认后返回 | 计数归零后按钮换「完成」回主页 |
| F-P06-01 | 校验清单 | 三类阻断分层展示 |
| F-P06-02 | 三层阻断 | 必检未查、关键项缺素材、不适用无原因 |
| F-P06-03 | 软缺失标缺失 | 行内「标缺失」弹层,不阻断 |
| F-P06-04 | 提交按钮 | 阻断未清禁用并写原因;有待送检加只读条 |
| F-P06-05 | 二次确认 | 文案写明提交后仍可改、改动留痕 |
| F-P06-06 | 提交中 | 清单禁点,按钮加载 |
| F-P06-07 | 提交失败 | 校验不过留原页并高亮差异项;网络失败轻提示可重试 |
| F-P06-08 | 素材待补先交 | 允许,回执标待补数量 |
| F-P06-09 | 回执卡 | 记录号、提交时间、提交人、状态、素材进度 |
| F-P06-10 | 记录号复制 | 长按复制完整任务号并提示已复制 |
| F-P06-11 | 素材补传进度 | 逐项转已传,失败单项可重试 |
| F-P06-12 | 回执后去向 | 有待复核给「去复核 N 项」,无则「回主页」 |
| F-P06-13 | 两路提交冲突 | 已被眼镜提交时直接转回执并提示 |
## 7 Mock 数据一致性
八页共用 `reference/mock-data.md` 的事实集。本次主态的数字链:
| 页 | 关键数据 |
| --- | --- |
| P19 | 在办 1 条:苏A12345 · 路检路查 · 已查 3/7 · 14:20 起单;待复核 3 项;场景区一张可作业卡加五行占位 |
| P02 | 苏A12345 · 小型轿车 · 汽油 · 国Ⅴ · 大众牌 FV7160 · 注册 2018-06-12 |
| P03 | 七项清单,第 3 项光吸收系数已判不符合并录 1.2,进度已查 3 / 未查 4 / 不适用 0 |
| P04 | 第 3 项光吸收系数,值 1.2 m⁻¹,来源语音,排烟短片 1 张已传 |
| P20 | 跨任务视图 3 条:苏A12345 车牌(识别)、苏A12345 光吸收系数 1.2(语音)、苏A88888 车牌(识别);不出现批量确认 |
| P06 | 校验清单阻断 4 项:OBD 就绪状态未查、尿素使用情况不适用未填原因、OBD 通信未查、车载诊断系统故障指示未查;M01 无送检结构,页面不出现送检条 |
## 8 验收范围
81 个功能点进一期验收,对应 `03-user-stories-and-journey.md` 的 US-05-01 至 US-05-10。启动页离线缓存、P20 批量条数上限、P06 的 S4 催办三项属设计值,客户表态前不作验收判据。
## 9 状态覆盖(页内切换)
状态切换与原型分离,两条入口:一是独立切换台 `prototypes/pages/p-states-mobile.html`(manifest 登记 P-STATES,R4 模块,占画布一张卡位),左列按页分组列出 48 个状态,右侧手机框内嵌对应页面,支持 `?state=` 深链;二是各原型页浏览器单独打开时的左侧固定面板(底座内嵌时隐藏)。登记原则:弹层与可点击触发的状态不设独立页,直接在主原型页内点击体验(M-05 全部场景说明层在 P19 点「全部场景」卡或占位行打开,点遮罩关闭;P02 重新识别与手工录入、P04 不适用切换同此);其余条件态不铺开到画布,统一收进画板导航,标注(M03/M04/复合键场景)的一期 M01 不触发。48 个的清点口径:下表「可切换状态」列之和,页内点击体验项(M-05)不计入,同一状态的按钮变体计 1;纯过程态(重试、先进入、跳转中)不占画面,在面板说明或注释中标注去向。P05 智能问答的状态另见 08 板块 §8。
| 页 | 主态 | 可切换状态 | 过程态与页内体验(不占状态画板) |
| --- | --- | --- | --- |
| P25 | 正常就绪 | 超时 5 秒(重试/先进入)、超时且无登录(仅重试) | 无登录态跳 P01、眼镜未连接不阻塞、授权失败进 P19 后重试 |
| P01 | 默认 | 提交中、密码错误、角色越权、网络失败、登录已过期 | 输入中(默认态含已填字段即可审) |
| P19 | 常态(P19-a,无在办块) | 在办与待复核态(P19)、加载中、连接中、未连接、电量低、无场景授权、全部占位、场景加载失败 | 场景停用(卡片消失,落点在 P03 顶部提示)、全部场景说明层(M-05,页内点击体验,不进状态画板;画布 P19-b) |
| P02 | 识别成功 | 识别中、识别失败、复合键缺字段、重复在办、语音确认超时 | 场景无模板(在 P19 即拒)、场景停用、点位超限(M04,一期不触发) |
| P03 | 正常 | 加载中、全部已查、含待送检(M03)、含阻断项、场景停用、已提交只读、模板为空、加载失败、任务切换态(在办 ≥2 从主页进入时) | 眼镜推送同步(静默刷新无画面)、点位超限(防御分支) |
| P04 | 已填 | 未填、不适用、送检项(M03)、已提交修改、未保存离开、保存失败 | 保存中(按钮 loading)、场景停用(同 P03 只读链) |
| P20 | 有数据(跨任务视图) | 加载中、空(本单)、空(跨任务)、加载失败、确认中、场景停用、单任务视图(有批量确认,画布 P20 主图) | 改完返回(条目移出即结果)、并发删除(提示后刷新) |
| P06 | S1 有阻断 | S1 无阻断、S2 提交中、S3 回执、S4 待送检(M03)、已被眼镜提交、网络失败 | — |
标注(M03)的状态一期 M01 不触发,画面照建并注明出现条件。各状态层是页面内固定定位的完整 375×812 屏。
## 10 未闭合
| 编号 | 内容 | 本板块的落法 |
| --- | --- | --- |
| — | 启动页离线缓存 7 天 | 分片自定值,需复核;本篇按 7 天写 |
| — | 登录态 8 小时、超时 5 秒 | 设计值,客户未表态 |
| W-03 | 复核与提交先后 | 按定型:先提交后复核 |
| W-07 | 送检项四态标签与手机是否可改判定 | 只读,可进 P04 但送检字段只读 |
| V13-Q27 | 语音识别率 | 影响 P04 改值频次,不改页面 |
| V13-Q45 | 车辆档案数据源 | 一期本地 mock,正式对接另立接口条目 |