190 lines
13 KiB
Markdown
190 lines
13 KiB
Markdown
# 03 用户故事与旅程
|
||
|
||
| 项目 | 内容 |
|
||
| --- | --- |
|
||
| 版本 | v1.3,2026-11-03 |
|
||
| 依据 | `shaping/v1.3-多场景模块化/04-pages-and-flows.md`、`prototype/v1.3-多场景模块化/03-flows.md` |
|
||
| 状态 | G2 交付,已确认(confirmed) |
|
||
|
||
## 1 主旅程
|
||
|
||
一次现场检查从起单到留档,主线在眼镜与语音里走完,手机是五个介入点,平台在事后接手。
|
||
|
||
```mermaid
|
||
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 场景从授权到出卡
|
||
|
||
场景在手机上能不能看见、能不能起单,由三个条件串起来决定,不由角色写死。
|
||
|
||
```mermaid
|
||
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 实装时不改表也不改页面。
|
||
|
||
验收以故事为最小单元,每个故事至少一条可复现的判定动作。不可判定的表述(系统应友好提示、体验流畅)不进验收表。
|