doc_id: DES-202607-001 feature_id: FEAT-202606-001-unified-entry-client type: design title: 统一入口客户端患者服务台移动端原型设计 status: reviewing owner: 医梦研发团队 created_at: 2026-07-02 updated_at: 2026-07-05 reviewers:

产品负责人
业务负责人
终端负责人 related_docs:
PRD-202606-001
ODS-202606-002
ADR-202606-001 related_modules:
emoon-terminal-client
emoon-openplatform
emoon-ai-agent
emoon-ai-command
emoon-ai-mcp
emoon-ai-device tags:
统一入口客户端
患者服务台
移动端
事件驱动
TaskState
Command Runtime source:
Open Design 统一入口客户端 v2 原型
蚂蚁阿福业务介绍与报告接入资料
生产级医疗智能体设计与医梦-FastGPT协作指南 ---

统一入口客户端患者服务台移动端原型设计

1. 文档定位

本文定义统一入口客户端从院内 16:9 三栏演示原型升级为患者手机端小程序/H5“患者服务台”的产品结构、页面范围、交互状态和方案演示主线。

本设计以已完成设计评审、正在开发的 FEAT-202606-006-agent-semantic-interaction 为中台设计依据：

服务端 TaskState 是单一前台业务任务事实源，同一会话最多一个 ACTIVE；
首页多事项使用只读 PatientWorkItem，就医时间线使用只读 JourneyProjection，二者均为患者服务台聚合投影，不是 TaskState；
FastGPT 与只读 MCP 负责查询、解释和推荐；
SemanticResponse 提供完整文本结论；
Presentation 是可选无状态展示；
Command Runtime 执行已由 FEAT-006 定义的受控副作用。

本文是纯前端方案演示原型设计，不进行后端联调，也不构成生产接口或事件契约。文中的事件、结果和命令对象均为 fixture/projection；客户端不得创建或修改服务端事实。

2. 产品定位

患者服务台是医院官方、事件驱动的患者服务入口。

它不以功能宫格或聊天窗口作为产品中心，而以患者当前就医任务为中心：

现在发生了什么
→ 患者需要做什么
→ 为什么需要处理
→ 是否可以立即办完
→ 完成后下一步是什么

产品由五类能力组成：

当前任务；
下一步行动；
医院服务；
AI 助手；
健康档案。

3. 设计目标

患者进入首页后，三秒内看懂当前最重要的事项。
报告、挂号、检查、缴费、签到、候诊和随访由事件主动触发。
用户点击和自然语言表达进入同一交互链路。
查询和解释不依赖 Card 渲染成功。
写操作按 L0-L3 风险分级治理：L1 明确交互即授权，L2 必须二次确认， L3 必须医护或人工确认，并具备执行状态和异常恢复。
保留医院品牌、入口、数据和服务运营主权。
原型能够向医院领导和客户完整演示“服务找人、即问即办”。

4. 非目标

不在移动端显示 BLE、NFC、L0/L1、traceId 等工程状态。
不以固定 Card 链定义业务流程。
不在原型中承诺无授权自动签到、自动支付或自动挂号。
不把原型私有事件、签到或报告授权流程表述为 FEAT-006 已承诺能力。
不把患者服务台设计成独立于医院品牌的公共医疗平台。
不在本轮覆盖完整住院、慢病和区域医疗业务。

5. 事件驱动产品模型

flowchart TD
    E["服务端 SSE / 业务事件投影 fixture"] --> W["PatientWorkItem / JourneyProjection"]
    U["用户提问或点击"] --> T["服务端 TaskState（最多一个 ACTIVE）"]
    T --> A["Agent + 只读 MCP"]
    A --> S["SemanticResponse"]
    S --> P["无状态 Presentation"]
    T --> C["Command Runtime"]
    C --> E2["服务端结果投影 fixture"]
    E2 --> W

5.1 事件原则

原型中的客户端事件仅模拟消费服务端 SSE/业务事件后的投影，不直接代表患者授权或业务执行，更不能由客户端据此创建或修改服务端 TaskState、ResultSnapshot 或 CommandInstance。

例如：

REPORT_ISSUED 表示报告已经出具，不表示患者同意 AI 解读；
CHECKIN_AVAILABLE 表示当前可以签到，不表示系统自动签到；
PAYMENT_PENDING 表示存在待缴费用，不表示允许自动支付；
QUEUE_UPDATED 表示候诊队列发生变化，不改变挂号事实。

MedicalEvent、REPORT_ISSUED、REPORT_CORRECTED、CHECKIN_AVAILABLE、 QUEUE_UPDATED、APPOINTMENT_CREATED、CHECKIN_COMPLETED、VISIT_STARTED、 VISIT_COMPLETED 等名称均为患者服务台原型私有场景事件假设，只用于 fixture。它们不是 FEAT-006 OpenAPI/SSE 契约或后端承诺；如需生产接入，必须另立专题定义和评审真实契约。

5.2 服务端任务与患者服务台投影原则

服务端 TaskState 仍是 Agent 单一前台业务任务事实源，同一会话最多一个 ACTIVE。患者服务台首页需要同时展示报告、缴费、签到、随访等事项，因此使用独立的只读聚合投影：

activeAgentTaskProjection：当前服务端 TaskState 的只读投影，单个或 null；
patientWorkItems：跨业务事项的只读 PatientWorkItem 列表；
journeyProjections：就医旅程节点的只读 JourneyProjection 列表。

首页、就医旅程和消息可引用同一批患者服务台聚合投影，但不得把多个 PatientWorkItem 写回成多个活动 TaskState。演示状态函数只把事件 fixture 转换为本地投影和消息，用于模拟客户端消费服务端事件后的 UI 变化。

5.3 Presentation 原则

医生、号源、报告摘要、费用和路线等 Card 只负责提高可读性。

Presentation：

不创建业务事实；
不推进服务端 TaskState；
不保存可信写参数；
失败时不阻塞文本或语音；
点击后以稳定引用重新提交 interaction，请求字段使用 interactionType。

文本和 Presentation 必须由同一 ResultSnapshot 生成。ResultSnapshot 由后端绑定租户、患者和会话；客户端只持有 resultRef、resultVersion 和候选稳定标识。版本冲突或过期时必须重新查询，原型展示“结果已更新，请重新查询”的恢复状态。

5.4 Command 原则

FEAT-006 已定义的挂号等副作用必须通过 Command Runtime。客户端中的 Command 均为服务端 Command 的只读 projection/fixture，不得由客户端创建或修改服务端事实。

移动端只允许：

查看确认摘要；
确认；
拒绝；
查询执行状态。

移动端不得自行构造金额、患者、号源或医院系统参数。

L2 Command 确认链严格使用：

PREPARED → AWAITING_CONFIRMATION → EXECUTING → SUCCEEDED | FAILED | UNKNOWN

L1 可逆临时动作在用户明确交互授权后可直接 PREPARED → EXECUTING → SUCCEEDED | FAILED | UNKNOWN，不额外二次确认。另有终态 REJECTED、EXPIRED；不得使用 COMPLETED 作为 Command 状态。

风险口径：

L0：只读查询；
L1：可逆临时动作，用户明确选择即授权；
L2：不可逆或收费动作，必须二次确认；
L3：必须由医护或人工确认。

签到、报告授权等尚未在 FEAT-006 中定级，本原型仅作流程假设，待后续专题定级，不得表述为已确定 Command。

6. 信息架构

底部使用五个一级导航：

导航	主要内容
首页	当前任务、今日旅程、常用服务和主动关怀
就医	门诊、检查、住院、随访任务总览
AI 助手	查询、解释、推荐和服务办理入口
健康档案	报告、处方、病历、过敏史和健康趋势
我的	就诊人、授权、消息、隐私和帮助

AI 助手位于底部中间，可提高识别度，但首页任务仍是首要入口。

7. 首页设计

首页按以下顺序组织。

7.1 身份与医院

医院 Logo 和名称；
当前院区；
当前就诊人；
家庭就诊人切换；
消息中心；
隐私模式。

7.2 AI 欢迎区

推荐文案：

张先生，上午好
今天有 2 项就医事项需要处理

提供轻量输入入口：

问病情、查报告、找医生、办就医服务

医生助手形象只作为头像或局部陪伴形象，不占据首页主要空间。

7.3 现在要做

任务按以下优先级排列：

立即处理；
今天处理；
进行中；
即将开始；
已完成。

任务卡必须回答：

发生了什么；
为什么需要处理；
建议做什么；
主操作；
次操作；
紧急程度或有效时间。

示例：

血常规报告已出
发现 3 项指标需要关注
[查看报告] [AI 解读]

神经内科可以签到
您已到达门诊三楼，距预约时间还有 20 分钟
[确认签到] [查看路线]

7.4 今日就医旅程

首页只显示当前节点及前后相邻节点：

09:10 到院
09:20 神经内科签到
09:30 候诊
10:05 医生接诊
10:30 检验检查
11:20 报告出具

点击后进入完整就医旅程。

7.5 常用服务

首屏最多展示八项：

预约挂号；
智能导诊；
报告查询；
门诊缴费；
检查预约；
住院服务；
院内导航；
在线问诊。

其余能力进入全部服务。

7.6 主动关怀

报告异常提示；
用药提醒；
检查准备；
复诊提醒；
出院随访；
慢病任务；
健康宣教。

8. 就医模块

8.1 总览

按任务状态组织：

待办理；
进行中；
已完成；
需要人工处理。

8.2 门诊

智能导诊；
科室、医生和号源查询；
挂号和支付；
到院提醒；
签到；
候诊动态；
院内导航；
诊后小结；
处方和取药；
复诊预约。

8.3 检查检验

检查预约；
检查须知；
检查准备提醒；
检查位置导航；
排队状态；
报告生成提醒；
报告查看；
AI 报告解读；
历史趋势对比。

8.4 住院与随访

作为后续扩展：

入院办理；
床位和病区信息；
住院待办；
医嘱和检查提醒；
住院费用；
出院办理；
出院小结解读；
出院随访。

9. AI 助手

9.1 场景入口

帮我看报告；
我该挂哪个科；
帮我找医生；
今天下一步做什么；
检查前需要准备什么；
这笔费用是什么。

9.2 对话规则

已知信息不重复询问；
可信结果来自只读 MCP；
无精确结果时提供受控替代方案；
插入普通问题不丢失当前任务；
切换任务时明确提示；
Card 失败不影响文本回答、服务端 TaskState 或患者服务台投影。

9.3 可选展示

医生候选；
号源候选；
报告摘要；
异常指标；
费用明细；
路线；
检查须知；
趋势图。

9.4 Command 确认

统一确认层包含：

操作名称；
医院业务对象；
患者；
金额；
有效期；
风险提示；
确认和拒绝。

必须覆盖以下状态：

准备中；
待确认；
执行中；
成功；
失败；
已过期；
结果确认中；
已拒绝。

UNKNOWN 状态显示“结果确认中，请勿重复操作”。

L2 确认链状态标识分别为 PREPARED、AWAITING_CONFIRMATION、EXECUTING、 SUCCEEDED、FAILED、UNKNOWN、REJECTED、EXPIRED，成功态不使用 COMPLETED。L1 明确交互授权后可从 PREPARED 直接进入 EXECUTING。

10. 检验检查报告闭环

移动端采用“统一报告服务、双报告族”的产品结构：

报告服务
├── 检验报告：指标、数值、单位、参考区间、异常和趋势
└── 检查报告：检查所见、报告结论、部位、建议和图文资料

两类报告共享事件、授权、AI处理、安全校验、反馈和失效机制，但详情页与解读结构分别设计，不使用一套指标模型强行表达影像、超声或病理报告。

P0采用方案B，完整演示一家医院、一个LIS厂商、结构化血常规的患者端深闭环。检查报告只展示统一入口和可扩展框架，不宣称已经具备生产解读能力。OCR仅作为后台候选解析能力；患者端只展示“需要人工核对”的降级状态，本轮不设计医护审核台。

10.1 报告事件到达

原型控制器注入私有 REPORT_ISSUED fixture、模拟客户端收到服务端投影后：

消息中心出现新消息；
首页新增报告 PatientWorkItem；
AI助手显示未处理提示；
不自动发起AI解读。

患者查看报告只更新已读状态，不代表患者授权AI解读，也不创建挂号或其他业务命令。

10.2 报告中心与入口

报告闭环复用现有四个入口，不新增一级导航：

入口	作用
首页	展示最高优先级的新报告或待处理事项
消息	承载报告出具、解读完成、报告更正和失效通知
健康档案	提供全部、检验、检查、未读、已解读和已失效筛选
AI助手	处理“帮我看最近一次血常规”等请求，并由中台返回有权访问的候选

报告列表项至少显示报告名称、医院、科室、时间、审核状态、医院异常标记和AI解读状态。

10.3 血常规报告详情

报告详情先展示医院原始事实，再提供AI辅助入口：

医院、科室、报告时间和报告类型；
最终审核、已更正、已撤回或已作废状态；
医院标记的异常项目摘要；
异常指标优先列表；
全部指标；
原始值、原始单位和本次报告参考区间；
原始报告入口；
AI辅助解读入口。

患者默认看到医院原值。中台标准化值只用于内部映射、规则和校验，不直接覆盖原值。

10.4 患者授权

首次解读展示：

当前患者和当前报告；
数据用途；
使用范围；
有效期；
AI辅助性质；
风险说明；
撤回方式。

操作：

同意并继续；
暂不授权。

授权绑定当前患者、当前报告、用途和有效期，不能用一次授权覆盖全部历史报告。撤回授权后不再展示对应AI解读，但医院原始报告仍然可查看。

10.5 可信报告门禁

患者同意后，中台先确认报告是否允许进入AI解释：

最终审核
→ 患者关系和访问权限有效
→ 结构化字段完整
→ 单位和参考区间无冲突
→ 非危急值
→ 形成可信报告快照
→ 允许调用FastGPT

FastGPT不参与患者授权、报告状态、单位换算、参考区间、异常复核和危急值判断。 FastGPT完成运行不代表结果可以发布；只有中台校验通过后，患者端才进入解读完成态。

10.6 AI处理中

处理中页面只显示患者可理解的信息：

正在生成辅助解读
报告原文仍可正常查看

不得展示OCR、RAG、Prompt、Workflow节点、模型名称、traceId或工程进度。

10.7 AI解读结果

血常规结果分为六层：

一句话总结；
医院标记的关注项；
指标通俗解释；
常见相关因素；
安全行动；
知识依据和AI辅助说明。

“常见相关因素”必须明确不等于诊断。患者端不得输出确定性诊断、用药、治疗方案、 AI生成的推荐科室或具体复查周期。

患者端P0不开放围绕报告的自由追问，只提供审核过的安全行动和人工咨询入口。

10.8 安全行动与挂号边界

咨询开单医生；
在线咨询；
联系人工服务；
查看原始报告；
查看或撤回授权。

P0不把报告解读结果直接连接到挂号流程。只有中台存在医院审核过的路径规则时，后续版本才能显示确定性服务入口。患者主动提出挂号时，进入独立挂号任务，不把报告Card作为挂号流程节点。

10.9 无法自动解读

以下情况统一进入患者端降级状态，不硬生成AI内容：

报告未最终审核；
OCR或字段需要人工核对；
数值、单位或参考区间冲突；
危急值；
不支持的报告类型；
AI输出未通过结构、事实、引用或安全校验；
AI服务暂时不可用。

普通降级页面只提供查看原报告、稍后重试、联系医生或人工服务。

危急值不调用FastGPT生成个性化解释，只展示医院审核过的固定提示和医院指定联系入口。 AI不得生成科室、治疗或用药建议。

10.10 报告更正、撤回与失效

收到 REPORT_CORRECTED、撤回或作废事实后：

旧AI解读立即停止作为当前结果展示；
页面强提示报告已更新或已失效；
允许查看最新医院报告；
重新解读必须基于最新报告版本重新发起；
旧结果只保留审计，不允许患者继续当作当前有效内容。

10.11 结果反馈

患者端提供结构化反馈：

内容有帮助；
指标解释不准确；
内容难理解；
与医生说明不一致；
其他问题。

反馈进入医梦反馈体系，不直接训练FastGPT，也不直接修改知识、Prompt或Workflow。

10.12 报告闭环产品状态

移动端使用患者语言，不暴露中台技术状态：

产品状态	患者端表达	允许操作
报告已出	新报告可查看	查看报告
等待授权	授权后可生成辅助解读	同意、暂不授权
正在处理	正在生成辅助解读	查看原报告
解读完成	AI辅助解读已生成	查看、反馈、撤回授权
需要人工核对	当前报告暂不适合自动解读	原报告、医生、人工
危急值提示	请按医院提示及时联系	医院指定入口
AI暂不可用	原报告仍可正常查看	稍后重试、人工
解读已失效	报告已更新，旧解读不可继续使用	查看最新报告

10.13 挂号选择、锁号与确认链

自然语言“选第一个”和点击候选必须统一映射为：

{
  "interactionType": "SELECT_CANDIDATE",
  "resultRef": "result-slot-001",
  "resultVersion": 1,
  "candidateId": "candidate-slot-0930"
}

完整链路：

候选选择
→ 后端校验 ResultSnapshot version / expiry
→ 实时复核号源
→ L1 LOCK_APPOINTMENT_SLOT（明确选择即授权，不额外二次确认）
→ 锁号成功写入服务端 TaskState
→ 后端准备 L2 REGISTER_APPOINTMENT
→ 患者二次确认
→ 执行最终挂号

客户端只展示 ResultSnapshot、TaskState 和 Command 的投影。版本冲突、快照过期或实时复核失败时，原型回到查询恢复态并提示重新查询，不允许使用旧候选继续锁号或挂号。

11. 健康档案

检验报告；
检查报告；
门诊记录；
住院记录；
处方与用药；
过敏史；
慢病指标；
健康趋势；
授权记录。

报告支持：

时间和类型筛选；
未读和已解读状态；
异常优先；
历史趋势比较。

12. 我的

就诊人管理；
家庭关系；
授权中心；
数据使用记录；
消息设置；
常用医院和院区；
医保和支付；
电子票据；
人工客服；
意见反馈；
关于 AI；
演示控制台。

13. 原型私有事件 fixture 与客户端投影响应

以下事件名均为患者服务台原型私有场景假设，不是 FEAT-006 OpenAPI/SSE 或后端承诺。

fixture	患者服务台投影变化	客户端响应
`REPORT_ISSUED`	新增报告 `PatientWorkItem`	首页事项和消息
`REPORT_CORRECTED`	原解读制品失效	强提醒查看最新报告
`REPORT_WITHDRAWN`	报告与解读停止作为当前结果展示	展示撤回或作废说明
`APPOINTMENT_CREATED`	新增待到院旅程投影	今日旅程和提醒
`ARRIVAL_DETECTED`	更新院内服务投影	路线和签到建议
`CHECKIN_AVAILABLE`	新增待签到事项投影	签到提示（定级待专题确认）
`QUEUE_UPDATED`	更新候诊投影	人数和预计时间
`PAYMENT_PENDING`	新增缴费事项投影	费用和支付入口
支付状态未知	Command UNKNOWN	禁止重复支付
`PRESCRIPTION_READY`	新增取药事项投影	药房路线和提醒
`DISCHARGE_COMPLETED`	新增诊后事项投影	小结和随访
`FOLLOWUP_DUE`	新增随访事项投影	首页待办和问卷

14. 视觉设计

14.1 保留

深蓝 #2B1F99；
青色 #3AD4D8；
医生助手形象；
圆角卡片；
成功、异常、加载和断连状态。

14.2 重构

现有原型	新版患者服务台
16:9 三栏	单列手机布局
中央聊天主导	首页任务主导
技术感知矩阵	患者可理解的主动服务
底部通知条	消息中心
六步 Card 链	单一活动 TaskState + 患者服务台聚合投影 + Presentation + Command
多区域同时展示	一屏一个主要行动
Emoji 图标	统一医疗线性图标
工程错误信息	患者语言和可展开详情

14.3 风格

采用“医院可信感 + AI 轻智能感”：

白色和极浅蓝背景；
深蓝表达可信和关键操作；
青色表达 AI、进行中和服务提醒；
红色只用于真正高风险；
不使用大面积科技渐变和发光；
任务行动优先于装饰。

15. 原型页面范围

完整方案按两个演示场景组组织。

15.1 报告闭环

报告中心；
报告到达；
血常规报告详情；
报告授权；
AI解读处理中；
AI解读结果；
结构化反馈；
需要人工核对；
危急值固定提示；
AI不可用；
报告更正与解读失效；
检查报告扩展框架。

15.2 就医闭环

首页空闲态；
首页多任务态；
AI助手首页；
自然语言挂号；
号源候选；
挂号确认；
挂号执行中；
挂号成功；
到院可签到；
候诊动态；
支付结果确认中；
网络异常和恢复。

16. 方案演示脚本

报告闭环主故事线：

患者进入首页
→ 报告事件到达
→ 查看医院原始报告
→ 患者授权
→ 可信报告校验
→ AI辅助解读
→ 安全行动
→ 结构化反馈
→ 报告更正后旧解读失效

就医闭环保持独立：

患者主动提出挂号
→ 自然语言查询号源
→ 确认挂号
→ 到院主动提示签到
→ 候诊状态更新

演示重点：

首页随事件变化，而不是静态宫格；
查看报告、授权和AI解读是三个独立动作；
无法自动解读、危急值和报告更正均安全降级；
报告解读不直接生成挂号任务；
挂号不再重复走科室、医生、时间Card链；
写操作进入统一Command确认；
挂号成功继续产生到院和签到任务；
展示Card关闭后，文本和任务仍能工作。

17. 现有原型迁移

17.1 保留

医生助手视觉资产；
品牌色；
对话气泡；
加载、失败、成功和断连；
挂号确认摘要；
就医旅程概念。

17.2 重构

idle-v2.html 重构为患者服务台首页；
chat-card-v2.html 重构为单一活动 TaskState 投影驱动的 AI 助手；
card-confirm-v2.html 重构为通用 Command 确认层；
成功页重构为任务结果和下一任务；
右侧动线重构为移动端今日旅程。

17.3 删除或隐藏

Card 链进度；
BLE、NFC、L0/L1 技术标签；
手表连接作为主要内容；
患者可见 Mock 和 traceId；
自动代替患者签到的表述；
CSS 模拟二维码；
固定头痛挂号线性流程。

v1/v2 文件仅保留用于历史对比，不代表生产环境存在双轨协议或双轨运行。

18. 迭代优先级

P0 方案演示

移动端首页；
当前任务；
报告中心和血常规详情；
报告事件、授权和可信门禁；
血常规AI辅助解读；
人工核对、危急值、AI不可用和更正失效状态；
报告反馈；
AI 助手；
自然语言挂号；
Command 确认；
主动签到提示。

P1 完整门诊

缴费；
检查预约；
候诊；
处方取药；
导航；
消息中心；
家庭就诊人。

P2 住院和健康管理

住院服务；
出院小结；
随访；
慢病；
健康趋势；
多报告联合分析。

19. 原型验收标准

首页第一屏清晰展示最高优先级任务和下一步。
报告 fixture 能够驱动首页 PatientWorkItem 投影变化，且不创建 TaskState。
查看报告不自动授权或启动AI解读。
报告授权绑定当前患者、当前报告、用途和有效期。
AI解读结果不输出确定性诊断、用药、治疗、AI推荐科室或具体复查周期。
OCR待确认、来源冲突、危急值和安全校验失败不会硬生成患者解读。
报告更正、撤回或作废后，旧解读立即失效。
报告反馈结构化记录在医梦，不直接修改FastGPT资产。
完整挂号条件不再重复选择已知信息。
号源候选是无状态展示，不作为任务事实。
挂号链完整覆盖快照校验、实时复核、L1锁号和L2最终挂号确认。
Command UNKNOWN明确禁止重复操作。
挂号完成后出现新的到院和签到投影；签到风险定级明确标记为原型假设。
Card隐藏或失败不影响文本结论、服务端TaskState或患者服务台投影。
页面不向患者暴露BLE、NFC、traceId和Mock等工程信息。
手机端关键操作可单手完成，主按钮不依赖横向布局。
文本和Presentation同源于ResultSnapshot；版本冲突或过期进入重新查询恢复态。
首页多事项不冒充多个活动TaskState，同一会话最多一个 activeAgentTaskProjection。

20. 生命周期说明

FEAT-202606-006-agent-semantic-interaction 已完成设计评审并进入开发，本设计可以采用其目标协议作为原型依据。

本设计仍为患者服务台原型 draft。完成页面线框、视觉稿和交互走查后，再更新为 reviewing；不得仅凭方案演示稿声明移动端已经实现。

患者服务台移动端原型设计.md 26 KB History Raw