Files
lujianlucha-prd/03-user-stories-and-journey.md
T

13 KiB
Raw Blame History

03 用户故事与旅程

项目 内容
版本 v1.3,2026-11-03
依据 shaping/v1.3-多场景模块化/04-pages-and-flows.md、prototype/v1.3-多场景模块化/03-flows.md
状态 G2 交付,已确认(confirmed)

1 主旅程

一次现场检查从起单到留档,主线在眼镜与语音里走完,手机是五个介入点,平台在事后接手。

flowchart TD
  A1[手机主页点场景卡] --> B
  A2[眼镜说开始检查·用上次场景] --> B
  B[核对检查对象:手机界面确认或眼镜语音确认] --> C[按冻结模板返清单]
  B -->|识别失败| B2[手机手输或扫码]
  B2 --> B
  C --> D[眼镜清单屏:当前项]
  D -->|说项名或下一项| E[单项引导:说结论]
  D -->|手机介入| F[手机填报与采集]
  E -->|不符合要数值| G[眼镜录入屏说数值]
  E -->|结论已定| H[下一项]
  G --> H
  F --> H
  H --> I{全部项有结论}
  I -->|否| D
  I -->|是| J[语音提交或手机提交]
  J --> K[服务端校验]
  K -->|不过| L[差哪几项]
  L --> D
  K -->|过| M[落库留痕]
  M --> N[手机待复核清单]
  N --> O[逐条确认或改值]
  M --> P[平台任务列表与详情]
  P --> Q[送检回填]

两个起单入口在核对检查对象处汇合。手机起单走界面确认;眼镜起单走语音确认,手机不点亮,只有识别失败或复合键缺段才拉起手机。起单之后仍可反悔:在清单屏说「重新核对」,本单作废并留痕,回到核对检查对象环节重新识别。不给原地改识别键的口子,改键等于换对象,作废重建比改字段干净。

2 手机介入的五个时点

时点 为什么必须手机 眼镜为什么做不了
选场景 六选一 多轮语音比掏一次手机慢,厂商词表能力未书面确认
核对检查对象失败 键盘逐字录入、扫码、坐标手标 眼镜无键盘,长文本不可用
要改值 改已判定的值、补不适用原因、补证据 眼镜只承载数值口述,不承载表单
要看证据 回放截帧与短片、看素材状态 眼镜分辨率与带宽都不够
要复核 逐条核对识别与语音来源的值 清单长度与阅读负担不适合抬头显示

不介入时整条流在眼镜与语音里走完。这五个点是设计上的上限,不是建议。

3 场景从授权到出卡

场景在手机上能不能看见、能不能起单,由三个条件串起来决定,不由角色写死。

stateDiagram-v2
  [*] --> 未授权
  未授权 --> 已授权未启用: 平台配授权
  已授权未启用 --> 已启用无模板: 平台启用场景
  已启用无模板 --> 已启用有模板: 冻结模板新版本
  已启用有模板 --> 已启用无模板: 版本归档且无在办单
  已启用有模板 --> 已授权未启用: 停用(需在办单为 0)
  已启用无模板 --> 已授权未启用: 停用(需在办单为 0)
  已授权未启用 --> 未授权: 撤授权
状态 手机主页 能否进核对检查对象 能否起单
未授权 不渲染 否 否
已授权未启用 不渲染 否 否
已启用无模板 占位行「尚未开放」 进说明层 否,起单被拒并提示联系管理员
已启用有模板 可作业卡 是 是

停用只要还有在办单就被拒,与「启用不校验模板」是一对:进得松、出得紧。

4 四种结构如何分叉旅程

结构 核对检查对象后到哪 清单形态 结案条件 旅程上的差别
TRISTATE 任务页单对象清单 一页项列表 全部项有结论且无待送检 主线,无额外分支
SAMPLING 任务页清单加送检区 项列表加送检项 送检结论回填 提交后可能停在待结论,结案由回填触发
REGIONAL 任务页对象加点位列表 点位下各项 全部点位完成 先走点位,点位内逐项,点位编号必填
INCIDENT 任务页事件页 时间线加线索项 取证完成或移送 允许边查边录,先固定线索不等查清

页面布局与结构一一对应,不与场景对应。六个场景落在四种布局里,第七个场景进来先看它属于哪一种。

SAMPLING 这一支要在一期建出来,但不进现场验收。理由是 M03 是壳,没有任何真实送检单。布局、送检区块、待结论状态都要落,否则 M03 实装时要同时改页面、改状态机、改统计三处;验收只在开发环境用构造数据走。

5 用户故事

故事按交付板块分组,每条给验收条件。编号 US-<板块>-<序号>。

起单(板块 05)

编号 故事 验收条件
US-05-01 作为执法员,我在主页点一个可作业场景卡,进入核对检查对象 卡片标题显示场景名;点击带 moduleId 进 P02;占位卡点击只弹说明层,层内无起单按钮
US-05-02 作为执法员,对象识别成功时我只确认一次就进任务页 起单成功才跳转;同日同识别键已有在办单时不新建,跳既有单
US-05-03 作为执法员,识别不出来时我手输识别键,值被标为手输 手输值不进待复核清单;留痕记原值与录入值
US-05-04 作为执法员,我在眼镜上说「开始检查」,按上次完成的场景起单 有上次场景则播报场景名并识别对象;无上次场景或场景已停用则播报「请先在手机选择检查类型」,不猜场景
US-05-05 作为执法员,场景没有冻结模板时我被拒绝起单且知道该找谁 提示「该场景尚未配置检查项,请联系管理员」,不生成任务

判定与录入(板块 04)

编号 故事 验收条件
US-04-01 作为执法员,我听眼镜报当前项、依据条款号和下两项,说一句结论就推进 结论被记录后清单屏该行形状变化(1 秒内为设计值,不作验收判据);不符合项追加「是否录入数值」
US-04-02 作为执法员,我说不适用必须同时说原因 原因为空不落库;原因入库后该项状态为不适用,形状为斜纹
US-04-03 作为执法员,识别不出时我口述数值,值进待复核清单 值带语音来源;屏上有「重说」入口;连续两次失败提示「请用手机录入」
US-04-04 作为执法员,我说「重新核对」可以作废这次临时单 临时单作废并留痕记原因;已提交的单不允许该指令
US-04-05 作为执法员,断连时我能继续判定,但提交被拒 判定入本地队列,屏上该行标未同步;按提交播报「请先连上手机」;重连后按序补传,角标逐条消失

提交与复核(板块 05)

编号 故事 验收条件
US-05-06 作为执法员,我在眼镜上说提交,服务端校验通过后拿到回执 提交前复述识别键;通过后回执号后六位显示 3 秒,随后回待命屏
US-05-07 作为执法员,校验不过时我知道差哪几项 眼镜列最多三条,超出显示「还有 N 项」;手机 P06 显示完整校验清单;不生成回执
US-05-08 作为执法员,我可以在手机再提交一次,不会产生第二条记录 后到一路提示「本单已提交」并跳回执页
US-05-09 作为执法员,提交后我逐条核对机器与语音给的值 待复核清单只收识别、语音、转抄三类;逐条确认、可跳 P04 改值、可批量确认本单
US-05-10 作为执法员,改过的值回到待复核 改值后状态回待复核并留痕记前后值

平台口径(板块 06)

编号 故事 验收条件
US-06-01 作为平台管理员,我启用或停用一个场景 启用不校验模板,但弹提示该场景当前无模板、启用后只能查看不能起单;停用有在办单时被拒并显示在办单数
US-06-02 作为科室管理员,我冻结模板新版本,在办单不受影响 冻结后新起单用新版本;提示仍有 N 个在办单使用旧版本;旧版本不删除
US-06-03 作为科室管理员,我在任务列表筛场景、看汇总带 汇总带跟随筛选实时刷新;六个量口径与 §7 一致;识别键列头取模板标签
US-06-04 〔P1,不进一期现场验收〕作为科室管理员,我在任务详情回填送检结论 无送检回填权限不可见回填入口;回填后任务转已结案;核验不合格同时生成问题项
US-06-05 作为中队负责人,我复核本队的操作留痕 留痕只追加、不可改删;每条记人、时间、前后值、原因

授权(板块 07)

编号 故事 验收条件
US-07-01 作为平台管理员,我给角色配场景 × 动作 × 范围 角色固定五个不可新增;范围三级;保存后即时生效
US-07-02 作为平台管理员,我给某个人加授或撤授 实际权限 = 角色并集 ∪ 个人加授 − 个人撤授;撤授优先
US-07-03 作为平台管理员,我不能撤掉自己的授权与用户管理 两项置灰并说明原因,防自锁
US-07-04 作为科室管理员,我用平台管理员账号登手机被拦 提示「当前账号无现场作业权限」,不进入主页

问答(板块 08)

编号 故事 验收条件
US-08-01 作为执法员,我在现场问一句拿到带条款号的答案 答案含条款号与原文摘录;带不出条款号走固定兜底话术
US-08-02 作为执法员,我在眼镜上问,只听到结论与条款号 原文只在手机呈现;问答不挂任务、不进明细、不进导出

6 失败与恢复路径

失败 现场表现 系统行为 恢复
识别键取不到 眼镜播报识别失败 转手机手输或眼镜语音录入,值标人工录入 录入后继续,不阻断作业
复合键缺段 起单成功但提交被阻断 缺段列入校验清单 手机补齐后重新提交
同一对象同日有在办单 起了单但没新建 跳既有单并提示 继续原单
提交校验不过 眼镜列差项、手机出校验清单 不生成回执 逐项补查后重提
断连 屏上标未同步 判定入队,禁止提交 重连补传
队列丢失(眼镜重启) 无具体项可定位 不给补救入口 提交时服务端列缺项,逐项补查
存在待送检项 任务停在待结论 不计入结案,单列统计 科室管理员回填后转已结案
模板中途改版 无感知 提交校验与详情按锁定版本 无需处理,设计上不打断
场景被停用 主页卡片消失 在办单仍在,任务页顶部出停用提示 由管理员恢复启用
两路同时提交 后到一路提示 不产生第二条记录 看回执即可

7 时间与等待参数

位置 参数 含义 来源
启动页 动画上限 1.2 秒 就绪即走,不等播完 定型
启动页 5 秒 超时转兜底,给「重试」「先进入」 定型
登录态 8 小时 有效期,客户未表态可推翻 设计值
眼镜语音确认 1.5 秒静默窗 防抢话应声,超时才认定为用户发言 SPEC §6
眼镜判定的屏面反馈 1 秒内 说完结论到形状变化 设计值
核对检查对象 语音确认超时 20 秒 超时拉起手机界面确认 设计值
提交结果屏 成功 3 秒、失败 8 秒 自动跳转时长,失败也可说「继续」 定型
眼镜刷新 2 秒 低于此值不做加载指示,眼镜不渲染加载态 SPEC §4
主页 30 分钟 无操作不自动刷新,避免现场看到列表自己变 定型

数值为设计值,客户未表态的项在字段旁标了来源,可用反馈推翻。

8 验收口径

故事分两档。全篇 26 条,其中 P0 二十五条进一期验收,P1 一条(US-06-04)实现但不验收。

送检不进一期验收。M03 一期是壳,送检回填(US-06-04)降为 P1,只验三件事:回填入口按送检回填权限显隐、回填后任务从待结论转已结案、核验不合格同时生成问题项。三项都用构造数据在开发环境验证,不计入现场试运行验收。待结论这个状态本身仍要建,因为它决定统计口径与任务详情页的三段结构,M03 实装时不改表也不改页面。

验收以故事为最小单元,每个故事至少一条可复现的判定动作。不可判定的表述(系统应友好提示、体验流畅)不进验收表。