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

22 KiB
Raw Blame History

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,正式对接另立接口条目