Consultation 业务与功能 PRD
更新:2026-09-14 · 业务角色:医生及获授权临床支持人员 · 实施状态见 WS2
本文覆盖从队列进入、五个临床模块、辅助资料到完成问诊。“当前行为”用于版本回归,“待实现设计”用于需求验收;两者不能互相代替。 此前医生跨诊所本人记录、护士授权协作及统一历史边界按 组织、数据权限与授权方案 完成实现及本地完整服务回归;本文不把本地验证、开发或预览发布当作 STG/UAT 已通过。2026-09-14 的数据分类、角色共享读取、本次附件和岗位边界为新确认契约,本轮只更新 PRD,不能沿用旧验证认定已实现。
功能地图
每个临床功能按操作目的、数据对象和处理结果展开;代码现状用于说明差距,不替代已确认产品目标。
| 功能 | 使用者/业务对象 | 产品方案与阅读位置 |
|---|---|---|
| 进入与恢复问诊 | 医生/护士 · Visit | §1–2:队列、上下文、开始/恢复及协作资格 |
| 病历与诊断 | 医生/获准护士 · Note | §3:模板、诊断、转写与保存 |
| 处方与修订 | 医生 · Prescription | §4:开药、提示、签署、退回和 Amendment |
| 检查项目 | 医生/获准护士 · Selection | §5:选项目、复制、推荐、保存与正式开单边界 |
| 临床文档 | 医生/获准护士 · Document | §6:内嵌文档与独立 PRD 交接 |
| 临床完成与收费交接 | 医生 · 签署版本 | §7:收费、检查清单、事务结果与复诊差距 |
| 临床参考 | 医生/护士 · 历史与附件 | §8:公共摘要、受限详情、OCR、Anatomy 与布局 |
1. 页面职责及入口
医生在本次 Encounter 内完成临床记录、结构化诊断、处方、检查选择、临床文档及收费交接。Patient & eMR 是患者主档与历史查询入口;关联护士在 Cashier 实际收款;Pharmacy 实际配药和发药。问诊工作台不替下游完成这些动作。
入口为 Consultation Queue;也可从携带患者/Visit 的授权业务入口进入。初始未选患者,只显示队列。选中后同一 Patient + Visit + Clinic 贯穿所有模块;不能仅按患者姓名建立问诊。
队列只承接身份、来源诊所、预约/到达/等待时间、流程状态和当前可执行动作,不预载每人的完整病史、订单、附件与账单。Active 保留授权范围内当天及跨日未处理记录;History 承接只读记录,状态口径见 §2.1。打开记录时重新取得该 Visit 的权限与完整详情;队列可见不代替详情授权,撤权后旧队列行不能继续打开病历。
1.1 当前界面结构
| 区域 | 当前内容 | 操作效果 |
|---|---|---|
| Queue / Workspace | 全宽队列与选定患者工作区切换 | Start、Resume、只读打开或返回 Queue |
| 安全栏 | 姓名、生日/年龄/性别、状态/计时、Allergy/ADR 及真实护理交接 | 保持患者上下文;返回、布局和 Clinical Reference 工具在此 |
| 左侧模块栏 | Consultation Note、Prescriptions、Service、Clinical Documents;具备签署能力者显示 Billing & Finish,获授权协作护士显示 Nursing handoff | 按服务端逐项能力及记录状态决定读写;展开显示名称,状态点表示未保存或阻断 |
| Clinical Reference | Patient 360、Records、Attachments、Anatomy、More | 查阅历史或打开工具,不能修改当前患者选择 |
| 布局 | 预设、区域宽度/位置/密度、显示切换及 Reset | 按用户与诊所保存非临床偏好;不保存病历或患者身份 |
没有全局 Save Draft、Pause Consultation 或底部常驻操作栏。Review & Complete 位于 Billing & Finish 末尾。Clinical Documents 内嵌实例自动保存;模板编辑仍有 Save。
离开已成功读取的 Prescriptions/Service 时,首次尚未保存的空集合也须自动保存为“本次没有项目”的草稿结果;只有保存成功才标为就绪。正在加载、加载失败或上下文已改变时,不能将默认空列表写回服务器。保存失败保留未就绪状态和重试路径,不代替医生最终确认或签署。
2. 队列与患者进入
| 编号 | 当前功能及条件 | 操作结果 | 不能据此声称 |
|---|---|---|---|
| CQ-01 | Active 显示同集团内本人负责或明确获准读取的原生 Ready for consultation/In consultation/Procedure consent Visit,保留来源诊所 | 以实际到达时间展示;搜索和刷新作用于队列,Start/Resume/只读打开另按动作能力判断 | 可见行均属于当前诊所,或读取授权自动包含编辑/签署 |
| CQ-02 | 原生跨日未结束 Visit | 放在 Carry-over,不计作今日等待 | 跨日记录已完成或已自动关闭 |
| CQ-03 | History 按本轮候选规则提供本人对应诊所的本人记录及已明确获批的原生/迁移只读记录 | 保留来源诊所,先检查原记录权限再按日期、排序和分页返回;最终验收另行记录 | 只因同一患者或新预约便读取其他医生历史,或打开历史就重开问诊 |
| CQ-04 | 等待中的合法行 Start;进行中的行 Resume | Start 请求服务端转换状态;Resume 读取最新 Visit;成功后各模块绑定同一 Visit | 当前已具备额外的双标识人工确认弹窗 |
| CQ-05 | 首次进入失败或切换失败 | 首次失败停留队列;已有工作区时保留原患者,不跳入错误 Visit | 失败仍能写新患者数据 |
| CQ-06 | Return to Queue 或选择另一 Visit | 暂停当前 Note 录音,保护草稿并启动后台保存,再切换;返回来源 eMR 有上下文 | 后台保存失败必须把医生锁在原页面 |
当前重要差距: 代码以 Ready/In Consultation 等上游状态推断 Patient and encounter verified,尚无独立的首次开始/跨 Encounter 双标识主动核验流程。首次医生接诊是否复用护士核验仍有已记录的来源冲突,须业务定案;当前回归记录实际行为,不能把进入成功当成已完成独立核验。2026-09-08 恢复服务端稳定医生归属校验;沿用已有显式代诊授权记录,不表示完整 Delegation 管理流程已交付。
2.1 医生工作队列与跨诊所历史
2026-09-13 权限补充: 医生的 Calendar、Active Consultation Queue 和 History 均按本人稳定 Provider、当前有效 Clinic 归属及记录来源返回。医生不能无授权查看其他医生的日程、当前问诊病人或受限历史记录;明确记录读取授权仍保留,但不开放日程管理或代诊动作;同一患者、同集团、姓名筛选、直接 Visit ID、旧链接和只读模式都不能绕过该边界。护士在当前 Clinic context 下按服务关系处理日程、签到、本次附件及付款,受限问诊正文和历史附件再检查医生明确授权、数据类别及状态条件;只有切换到本人另一个有效 Clinic 归属后,才重新加载该诊所对应数据。Clinic/Provider 切换必须清除旧患者、队列、历史抽屉、角标和迟到响应,服务端详情接口再次校验来源与授权。
医生的 Active 与 History 只按全局 Context Selector 当前主体返回;查看另一诊所必须先切换到本人有效主体。Calendar 的跨诊所模式仅允许排班元数据,不得扩展到 Active、History 或患者详情。记录始终保留来源诊所,读取、编辑和代诊职责分别检查;不能用只读模式跳过批准,也不能把来源诊所改成当前工作诊所。本人跨有效诊所历史读取能力保留;业务页面按当前有效主体加载,查看另一诊所先切换主体,不混合未授权来源。最终验收另行记录。
- Active、Carry-over、相应 Workspace 侧栏及 Consultation 角标使用当前主体授权范围;History 按当前主体及日期过滤后排序、分页。Calendar 汇总视图不得复用这些详情数据。
- History 包含 Consultation completed、Ready for billing、Ready for cashier、Checkout completed、Completed、Closed,以及获授权的迁移只读记录;状态的大小写、下划线、连字符和多余空白写法按同一口径识别。队列统一显示 Completed,原流程状态保持不变,不能据此认定已收款或财务关账。
- 原生 Visit 经 Cashier 退回 In consultation 后重新进入 Active,不因保留旧签署版本而同时进入 History。History 行只读打开,不自动重开问诊;受控更正仍按现有独立流程处理。
- 后端按稳定 User / Provider 归属判断,不以医生姓名、浏览器筛选参数或宽泛临床权限判断。缺少绑定或归属不明时返回空队列并拒绝详情访问;明确主诊 User 优先于冲突的 Provider 记录。
- Workspace 直接链接、跨应用跳转、Patient eMR 问诊历史及各模块适用同一对象边界和各自动作权限;护士协作按下节改造,不再以既有全诊所临床读取作为目标。
- 功能测试模拟 Doctor 必须使用选定的真实 Provider;“无限制功能测试”不再放宽医生数据归属。保留真实操作者审计身份。
- 医生界面显示 My patients,不提供 All doctors。切换医生、模拟对象、角色或诊所时清空旧工作区、历史和角标,同步关闭患者资料编辑器、历史抽屉和修订弹窗,清除其中的旧输入,并丢弃旧请求的迟到响应;真实医生的空队列或请求失败不自动变成合成患者。
- “姓名可选筛选”和“历史无视负责医生只读打开”均不能作为授权。代码完成、自动回归、应用部署和 UAT 必须分别记录。
2.2 护士获授权的临床协作
问诊记录由负责医生管理,包括本次和历史问诊笔记、诊断详情、检查结果及正式临床文档。护士获得医生授权后,可以进入相应记录协作;诊断和药物等公共摘要则按角色读取权限提供。
尚未取得临床查看权时,护士仍可处理本人有权限的预约和护理工作。队列只显示必要的工作信息;点击临床记录后打开申请窗口,默认申请当前选定的就诊,不提前加载正文或代选患者的旧记录。
医生在 Settings 管理护士授权。查看与编辑分别申请,批准后系统重新读取权限,页面显示“只读”或“可编辑”、允许模块、实际操作者及授权状态。服务关系、固定记录、持续覆盖、有效期和撤销统一见 权限方案。
本轮联动范围为:具备本 Visit 草稿编辑授权的护士可修改医生已初始化的 Consultation Note/已保存模板快照、Service Selection、护理交接及已有临床文档。护理交接只保存 procedure note,不覆盖保险或收费行。处方可按读取权限查阅,药品新增/修改、检查最终开单、Billing & Finish 和 Review & Complete 均按独立医生能力控制;护士不请求医生专用 Billing Draft 或私人模板库。
护理交接资料成功加载后才开放获授权的编辑与保存;加载失败显示原因和重试入口,不能将空白默认值保存为已有内容。较早的读取响应不得覆盖后续编辑;切换 Visit 后不得将前次读取或保存结果写入新 Visit 的界面。
首次 Start、建立临床生命周期及选择私人模板仍由医生完成。尚无 Consultation 或可用 Note/Document 快照时,界面指引医生先开始问诊、选模板或创建文档;不会替护士创建私人模板,也不会因一项草稿授权开放全页面写入。已有不可编辑版本、迁移记录和 Closed 状态继续独立生效。医生复核护士实际保存的版本并最终签署,保留双方真实操作记录。
活动 Visit 当前仅有临床读取权时,患者锁定页头下方显示只读授权状态条,提供 Request editing 和 Check approval status。操作留在正常页面布局中,不浮盖录音、SOAP 或其他模块编辑区。本人或已获授权可编辑的记录不显示这组操作;预览、History 及已由临床状态锁定的记录也不显示,完成态继续使用既有只读/受控更正规则。检查授权状态由使用者手动触发,先暂停当前 Note 采集,再重新读取该 Visit 的服务端能力;不自动轮询、不重新生成 SOAP,也不把检查结果直接当作批准。获批后按实际能力开放编辑;读取权失效时撤下内容并转到队列或申请入口。
授权、账号或服务关系失效后,后续服务端请求拒绝旧权限。切换账号、角色、诊所或有效身份清除旧临床草稿和窗口上下文,旧请求、录音与 AI 的迟到结果不能重新出现。跨诊所读取始终保留来源 Visit,不修改当前工作诊所或原作者;患者安全资料编辑携带选定 Visit,仍由服务端检查其是否为合格来源。既有合法保存及真实作者保留。本轮申请、批准、临床入口、草稿保存及撤销已在真实角色浏览器通过;医生完成问诊后可从 History 只读打开。具体覆盖及发布见权限验证,不代表正式 UAT。
3. Consultation Note
功能目的: 形成可签署的本次病历及诊断。
使用者与对象: 负责医生、获准草稿协作的护士;Note、诊断与模板快照。
操作与结果: 选用模板 → 书写或使用转写草稿 → 人工核对 → 保存版本与诊断。
关键边界: AI 输出不自动成为正式事实;护士协作不包括最终签署。
3.1 病历、模板与诊断
| 编号 | 功能 | 当前规则 | 预期结果 |
|---|---|---|---|
| CN-01 | 选择病历模板并编辑字段 | 模板定义字段;保存模板快照与字段内容。默认 SOAP 和个人模板分开;新医生首次并发读取也只创建一份包含完整初始字段的私有默认 SOAP,不覆盖医生后续修改;不能只按旧 PRD 假设始终四个固定文本框 | 换患者后恢复该 Visit 的模板及内容,不套错模板 |
| CN-02 | 保存 Note | 保存当前 Note、结构化诊断与版本;当前完成检查要求 Note 已保存且无本地变化 | 保存后可重新读取;失败保留本地内容并提示 |
| CN-03 | 新增/修改个人模板 | 名称及字段 key、label、description;字段可排序,当前界面至少 1 项、最多 20 项 | 保存后更新可选模板;默认 SOAP 可 Restore,不能普通删除 |
| CN-04 | ICD 建议和手工搜索 | AI/ICD 结果为候选;医生选择正式诊断并设 Main/次诊断;完成时必须恰好一个已保存 Main | 没有 Main 或多个 Main 都不能完成问诊 |
| CN-05 | 历史病历及转换 | 迁移来源只读;合法转换不得把历史原记录覆盖 | 原记录及新内容的来源可区分,不把迁移患者送进当天 Active |
3.2 AI Scribe 与 Transcript
CN-06 当前顺序: 选择识别语言和麦克风 → 启动录音前读取本 Visit 的 AI Scribe Consent → 缺少同意时医生明确确认并保存 → 申请麦克风及启动 → 暂停/查看和修正 Transcript → 生成当前模板的 Draft → 医生检查、修改及保存。
- 支持 English (HK)、English (US)、廣東話、普通話输入选项;界面语言与识别语言不同。
- 同意查询失败不启动录音/AI;取消同意弹窗不写同意、不申请麦克风、不调用模型。
- 生成草稿要求有 Transcript、已选模板且不处于录音中;生成结果不直接签署。
- 预览患者录音入口禁用;真实服务配置、麦克风权限及网络是执行此项的前提。
- 模型响应或保存失败要保留医生已有文字;切换 Visit 停止上一位患者的录音和临时状态。
文档差异: 旧设计写过“不新增 AI Scribe Consent 阻断”,但当前代码明确存在上述门禁。本版如实记录当前行为;是否保留这一产品门禁需业务/临床确认,不能由本次文档整理擅自移除。
4. Prescriptions
功能目的: 形成明确药品、用法与数量的处方并交药房执行。
使用者与对象: 医生;Prescription 草稿、签署版本及 Pharmacy Handoff。
操作与结果: 选药填用法 → 保存草稿 → 医生签署 → 药房审核;更正从原处方发起 Amendment。
关键边界: 药房不改临床处方;历史结算后的改方与差额须走受控更正。
4.1 开药与字段
CP-01: 按药名搜索或 BNF 层级选择当前诊所可用药品。被选药品保存稳定药品引用与名称来源快照;不能从历史自由文字拼出一条可签药品。
| 字段 | 用途与规则 |
|---|---|
| Drug | 目录药品、名称/规格及来源;选定后才录入处方明细 |
| Dose / Unit | 单次剂量及单位;不能把总发药量当单次剂量 |
| Route / Frequency | 用药途径及频率;频率选项来自可维护的 Prescription Frequency Dictionary,默认包含 OD、BD、TDS、SOS;当前新行 Route 默认 oral,必须按实际用法核对 |
| Duration | 固定疗程数值与单位或适用的其他疗程模式 |
| Calculated quantity / Dispense quantity | 显示计算建议和医生最终确认数量,两者不混写 |
| Patient instruction | 给患者的用药说明;用于患者方向的输出 |
| Line Remark / Prescription Remark | 行级和整张处方内部备注,各最多 2,000 字符;传药房但不当患者说明打印 |
| Start / End date | 适用时记录起止;仍须与本次药品用法一致 |
CP-02: 新增、编辑、删除草稿药品后保存当前处方;空处方也须保存为“本次没有药品”的明确模块结果。已有本地变更未同步时,Review & Complete 被阻断。签署后不可原位修改,只能从原 Prescriptions 发起 Amendment。
4.2 eMMS 的实际边界
CP-03: 连接状态与临床建议分开。每次进入模块检查连接;药品变化后保存/检查当前快照,旧响应不得覆盖新药单。显示重复、相互作用、Allergy/ADR 或映射覆盖信息时,医生仍负责判断。
当前代码中 eMMS 和 Allergy/ADR 均是非阻断建议。 连接不可用、未检查或警示不会单独阻止处方保存或最终签署;保存失败、陈旧版本与本地未同步会阻止完成。测试必须分别记录这两类结果。严重警示、Override、覆盖率及临床正式放行政策尚待确认,不能把现状描述为已通过医疗安全验收。
4.3 签署与药房修订
CP-04 当前代码: 普通门诊 Review & Complete 在签署处方的同时建立 Pharmacy Handoff。2026-09-06 最终规则为付款前仅审核、审核通过且 Cashier 确认结算后才备药;药房退回整张处方时先建立 Pharmacy exception 并阻断结算,Encounter 暂留 Ready for Cashier。护士在 Cashier 明确确认 Return to Consultation 后才恢复 In Consultation;重新签署后仍须药房对当前新版本再次审核通过才解锁。Cashier 手动回退和基础服务端发票/收款门禁已开发,库存预留等完整目标待联调,详见药房 PRD。
CP-05: Amend Prescription 记录原因并签署新版本。有药品生成 Cancel/Replace,无药品生成医生授权 Cancel;旧版本 Superseded。已付款后的新版本进入 Payment exception,不能继承 Paid。已发药后的退换和价格差额处理不能按普通草稿修改测试。
4.4 收费退回后的处方修订
护士从 Cashier 发起的退回保存原处方版本、原因、护士身份和独立审计事件;仅修改 Visit metadata 或主流程状态不能伪造这次授权。
医生在原 Consultation 的 Prescriptions 使用 Amend Prescription。该按钮在已签署但已退回
In Consultation的就诊中可用;非医生、迁移只读记录和Closed不显示此操作,服务端另行验证权限与 Closed 不可修改规则。医生保存 Amendment 时签署新的不可变处方版本。系统检查退回审计和被替换版本一致,核对原 Note、Service Selection 和 Clinical Documents 的签署及版本未变,并验证新药品的数量和权威价格。全部成功后,原子将本次就诊送回
Ready for Cashier,界面更新为当前状态;无需第二次对原临床文档执行完整 Review & Complete。原 Signed Charge Snapshot、签署记录、Invoice 和实际付款不覆盖。Cashier 以原非药品收费及当前签署药品版本形成当前费用核对依据;旧付款不能自动授权新处方备药。有药新版本仍须药房重新审核;医生取消全部药品时旧药单标记已取消,无需药房重审,Cashier 核对剩余费用。
若患者返回后还修改了 Note、Service Selection 或 Clinical Documents,Prescription Amendment 不能代签这些变化;系统保留原记录并提示需要相应受控临床更正。此处仅交付处方退回及重签闭环,不声称原有完整临床重开与第二次全模块签署已完成。
本轮提供独立规则测试和可在隔离 PostgreSQL 执行的公开 API 测试。自动化结果、真实后端部署、库存/打印等外部联调和 UAT 必须分别登记,详见Cashier 隔离集成验证。
上述护士操作用于将完整 Encounter 退回
In Consultation;尚无任何结算/实收历史时,医生仍可独立修订已签署处方,不必为了处方子流程更正先退回整个 Encounter。直接修订保留主流程状态,有药的新版本仍须药房重新审核及有效预留;已有未付款发票若费用版本变化,必须先处理旧单再继续结算。一旦该 Encounter 曾确认过任何结算(含零额、第三方安排,及后来撤销的结算),或曾记录实际付款,普通 Prescription Amendment 在修改前即被阻断;退款、净实收归零或撤销结算不清除这一历史边界。停药、改方及差额处理仍需另行受控临床/财务更正,本轮不提供这一完整流程。
5. Service
功能目的: 选择本次检查项目并形成后续执行及收费来源。
使用者与对象: 医生及获准的草稿协作者;Service Selection 与正式 Order。
操作与结果: 检索/参考推荐/复制历史项目 → 确认当前可用项 → 保存 → 医生最终确认。
关键边界: 选择或签署不代表 V-Lab 已接单、执行或出结果。
当前 Service 是本次 Consultation 的 Lab/Imaging 项目选择。它不等于 V-Lab 已接单或已执行。
| 编号 | 功能及前提 | 当前行为与结果 |
|---|---|---|
| CS-01 | 进入 Service 前已有保存的 Note/Consultation | 读取项目目录、当前 Selection 与建议;缺少已保存 Note 时提示先保存 |
| CS-02 | 搜索与筛选、添加/移除 | 按项目身份去重;记录 searched/recommended/copied 等来源;手工不能把 Vendor 或 Price 当权威事实写回 |
| CS-03 | Recommended Services | 根据已保存 Note 请求建议,人工点选才加入;Unavailable 时仍可搜索、复制、保存和签署 |
| CS-04 | Copy Previous | 查看上次项目,选择当前仍可复制项;失效或不满足条件的项目不能盲目复制 |
| CS-05 | 保存 Selection,包括空集合 | 保存项目、来源及版本;本地未保存时不允许完成问诊 |
| CS-06 | 签署前服务或价格变化 | 服务端重检;价格变化需重新核对,Vendor 改变或 Offering 不可用需重选,不能默换 |
签署 Selection 只是临床选择与收费来源的固定版本。完整样本/侧别、内部承接、结果、危急值和医生结果确认按照 V-Lab 需求另行验收。
6. Clinical Documents
功能目的: 在当前就诊内生成和保存多份临床文档。
使用者与对象: 医生与获授权协作者;Document、模板快照与版本。
操作与结果: 使用默认集或新增文档 → 编辑 → 保存/打印 → 完成时签署。
关键边界: 独立文档的生命周期和模板管理由 Clinical Documents PRD 统一定义。
CC-01: 内嵌模块用多文档页签,默认集按医生保存、最多六项。同模板可开多份独立文档;新增不是立刻创建正式已签文档。正文、Recipient、AI 输入和版本按页签隔离。
CC-02: 离开模块保存所有仍存在页签,Print 只保存当前文档;普通文档页签切换只保护浏览器草稿。未变化内容不新增版本,首次成功保存才建立 Document ID。
CC-03: 当前模板有 AI 区域时可打开 AI 卡片,医生输入需求并复核输出;Recipient/正文缺失只提示,不代造事实。身份/权限、安全内容、未持久化和不可编辑状态仍阻断相应动作。
CC-04: 关闭未保存页签直接移除,关闭已保存 Draft 需确认并软删除;签署/已完成文档只读。新活动工作台获得编辑权后旧工作台只读。
CC-05: 自动保存最终失败不阻断导航,但保留草稿并阻止最终完成;Print 必须先保存当前版本,不能打印后假称已签发。独立 App 仍有显式保存且保留它自己的 Recipient 校验。详细文档规则见Clinical Documents PRD。
CC-06 本轮权限联动: 获本 Visit 草稿授权的协作者仅编辑已有文档所保存的模板快照;不读取医生私人模板库,不新增无医生快照的文档。AI 请求携带既有 Document ID 并复用该快照,打印/版本读取继续校验确切 Visit 的读取权,最终签署仍由医生完成。文档窗口在身份、授权或来源 Visit 改变时丢弃旧响应;临床授权和文档自身只读/编辑租约分别校验。 已持有编辑租约的员工被撤销相应授权后,续租返回不可编辑状态并终止该员工/工作台自己的租约;页面停止续租、保留只读状态提示,不把正常撤权显示为系统加载错误。新的租约申请、实际保存及完整病历读取仍执行各自授权检查,不允许释放他人的租约;迟到的续租响应不得影响另一个 Visit。当前接线与自动化验证进行中,尚未完成跨角色浏览器验收。
7. Billing & Finish
功能目的: 完成临床复核并把一致的签署版本交给收费与药房。
使用者与对象: 负责医生;当前 Visit、各模块版本及 Charge Snapshot。
操作与结果: 核对收费与复诊 → Review & Complete 检查 → 原子签署与交接 → 返回队列。
关键边界: 任何版本或保存检查失败均不完成;护士不执行最终确认。
7.1 当前可执行条件
当前新流程只接受普通 Consultation,并要求真实医生角色、当前诊所、本人的稳定 User/Provider 归属、活动 Provider 及登记编号、Visit 为 In Consultation。旧 Visit coverage 和他人记录只读授权均不授予临床完成权。护士即使获准编辑草稿,也不能执行最终临床确认、开单或签署;医生应复核所签版本中的协作修改。跨诊所本人历史读取不取消本次完成操作的条件。申请、批准和撤销沿用 Platform 的固定 Visit 授权模型。
签署身份预检: 打开 Review & Complete 时按当前有效医生身份检查 Provider 状态和注册号;缺身份、已停用、缺号或检查失败分别显示可操作原因,完成按钮保持禁用,补录后可重新检查。该检查不读取全量历史权限,不增加本次 Visit 首屏历史加载。最终提交仍在事务中重检,防止预检通过后资料被停用或改动;Assume Doctor 使用目标医生身份。独立处方及旧问诊最终签署遵循相同条件,草稿保存不因单纯缺注册号受阻。
CB-01: 每次进入同步收费来源和权威价格;缺价显示 Price unavailable。来源、数量、gross、discount、net 和版本形成 Billing Draft;草稿可保存但缺价不能完成。
CB-01a 默认问诊费(2026-09-08 确认): 普通
Consultation 未绑定专属 Consultation Service Offering 时,服务端采用
HKD 1,000.00,收费行显示
Default consultation price。有效绑定价优先,明确为零的价格保持零;已绑定但失效、跨诊所或非
HKD
的价格继续要求修正。默认价不适用于药品、检查或其他服务的缺价,也不扩大当前支持的
Consultation Type 范围。
默认价与专属价采用相同的 Billing Draft、医生折扣、签署快照及 Cashier
交接流程,保留 DEFAULT-CONSULT
来源和价格版本。旧活动缺价草稿在重新读取时自动恢复为默认价并递增版本;之后绑定专属价需重新确认。已签署/已完成收费不因默认价或目录变更重新计价。医生标准价及
Policy/Clinic 例外维护仍以 Catalogue 后端适配进度为准。
CB-02: 负责医生可按行做 Percentage 或 Fixed Amount 折扣;百分比 0–100,固定减额不超过该行 gross;要求原因并保存医生、时间和原价。清除/修改折扣后旧收费确认失效。
7.2 当前 Review & Complete 检查清单
| 检查 | 通过条件 | 失败时去哪里 |
|---|---|---|
| Patient and encounter verified | 当前代码认为是可信上游交接状态 | Note/上下文;主动双标识仍为差距 |
| Note and diagnoses saved | Note 已保存且无本地变化 | Consultation Note |
| Exactly one main diagnosis | 恰好一个已保存 Main | Consultation Note |
| Prescriptions saved | 已保存且无本地变化,包括空处方 | Prescriptions |
| Service Selection saved | 已保存且无本地变化,包括空集合 | Service |
| Required clinical documents completed | 当前文档无待保存变化,服务端版本可签 | Clinical Documents |
| Authoritative pricing available | 所有收费行已有权威价格且查询结束 | Billing & Finish |
| Follow-up confirmed | 明确 No follow-up 或日期+原因 | Billing & Finish |
| Billing confirmed | 当前收费草稿有效并同步完成 | Billing & Finish |
| AI content reviewed | 使用过 AI 内容时已复核 | Consultation Note |
CB-03 当前操作: 点击 Review & Complete 先打开清单并保存 Billing Draft;有失败项仍可打开清单,通过 Go to section 修正。后台保存 pending/failed 时不能确认完成。
CB-04 当前成功结果: 在同一个事务中验证各模块版本、签署 Note/Prescription/Service/Clinical Documents、保存签署收费快照、处理复诊记录、创建药房交接并把 Visit 置为 Ready for Cashier,然后返回 Queue。重复请求不重复生成业务记录;任一步失败整体回滚。
这与旧目标“临床签署成功但收费 Handoff 失败时保留半成功状态”不同:当前原子完成流程是全部成功或全部回滚。 失败后按当前状态重试,不能期待代码产生尚未实现的 Handoff failed 中间态。
7.3 当前复诊行为与设计差距
CB-05: No follow-up 不建预约。Book follow-up 要求日期与原因,当前后端会在完成事务里创建一条 Booked 复诊预约,固定为所选日期的 09:00、30 分钟 ,记录原 Visit 来源;前端随后返回 Queue。
目标设计是完成后打开统一预约流程,再选择真实可用时段与资源。两者存在实质差异。当前回归要检查重复完成不重复建复诊,同时将固定时段及缺少人工时段确认登记为待修差距;不能把 09:00 当正式业务默认值。
8. Clinical Reference 与布局
功能目的: 在不丢失本次工作上下文的情况下查阅历史和辅助资料。
使用者与对象: 已获相应资料权限的医生/护士;公共摘要、历史详情、附件及临时工具。
操作与结果: 按需打开参考资料 → 校验具体内容权限 → 查阅或显式保存工具结果 → 返回本次工作。
关键边界: 公共摘要不等于完整 Note;未保存的 Anatomy 内容不进入病历。
| 编号 | 入口 | 能做什么 | 不能做什么 |
|---|---|---|---|
| CR-01 | Patient 360 | 看当前患者摘要及已有资料,打开 Full eMR 后返回原任务 | 创建另一份患者或丢失当前 Visit |
| CR-02 | Records | 查 Consultation、Medication、Vaccine、Vitals 等原始历史 | 将历史行改成当前正式记录,或把空数据理解成无病史 |
| CR-03 | Attachments | This Chit 由当前 Clinic/Provider 关联护士按权限上传、查看、删除;Past services 按原记录医生授权读取;统一查看器保留来源 | 无授权读历史、借本次权限删除历史或将 OCR 自动当正式病历 |
| CR-04 | Anatomy | 打开独立人体结构教学画布,查看器官与临时标注 | 当患者特异影像或诊断结果;未保存标注切患者/关窗口清除,显式截图可保存至当前就诊附件 |
| CR-05 | More | 当前 Chit activity;Copilot 配置未就绪时明确 Disabled | 用示例事件或未批准的 AI 服务冒充真实结果 |
| CR-06 | 布局及响应式 | 调整布局与密度、重置;空间不足时辅助资料用 Overlay | 隐藏必需安全信息、把患者/草稿写入布局偏好 |
上述入口、Copy Previous、历史版本和 AI 上下文均按资料类别检查权限;本次 Visit 可访问不自动开放详细历史。最小安全摘要共享及疫苗公共读取按 组织、数据权限与授权方案 的已确认规则处理:同集团且具有独立公共医疗信息角色读取授权的医生/护士可跨诊所读取疫苗,包括尚无来源 Visit 的旧记录;疫苗写入仍检查来源医生权限。受限 Note、诊断详情、检查结果、正式临床文档和完整处方按来源医生或明确记录授权读取,患者详情确认及审计不代替授权。关联护士按本次附件操作权限上传、查看、删除;历史附件须有效原记录授权,不能因处方可读而放开附件。来源缺失或冲突保留待修复标记,不能把未获权限展示为无病史。
8.1 Anatomy 标注与截图
Anatomy 新增 Screenshot 和 Library(弹窗标题 Anatomy Library)。截图含当前模型视图与手绘标注,先预览,再由用户点击 Save to this encounter 保存到当前患者/就诊附件;在 Anatomy 或 Patient & eMR 附件中查看,支持复制 PNG 图片与下载。复制不删除记录;通用解剖参考属性及来源许可保留在图片中。
保存必须验证当前患者、就诊、诊所与上传权限;只读就诊按既有重开/修订流程处理,不绕过关闭规则。没有就诊上下文只可预览/复制/下载。切患者清理未保存内容;已保存附件保留在原记录。错误时保留草稿重试。接口、数据范围和验收详见 Consultation Workspace PRD 的 2026-09-05 章节;当前仅本地验证,不等于真实后端联调或 UAT。
- 2026-09-05 文本标注:Explain 增加 Text,点击模型位置后键入多行中英文,支持再次编辑、撤销和取消;文字随截图进入原就诊附件,并在 Library 查看或复制。未保存文字仍在切换患者/就诊或关闭窗口时清除。
8.2 附件查阅与 OCR
- 医生工作台 Attachments → This Chit 展示当前 Visit 的已保存附件;面板打开时和停留期间重新读取当前问诊附件,护士随后上传的文件无需重新开始问诊即可出现。读取仅更新附件,不覆盖医生未保存的临床草稿。
- 点开附件时读取完整 OCR 详情;原件使用受鉴权的统一文件地址。授权 PDF 支持在本系统同源窗口内嵌预览,包括浏览器分段读取;禁止其他站点嵌入。预览仍执行原文访问权限,强制下载与其他响应不放开嵌入。Header fields、置信度、Tables 和可复制文本来自同一附件的最新有效识别记录,列表字段数来自服务端汇总。
- 原文、OCR 详情及识别重试按 Platform 的来源记录与动作权限校验;本人跨诊所读取与护士授权已接入统一来源门禁,实际回归及发布范围见权限验证。已知附件 ID、下载地址或原上传者身份不构成绕过授权的例外。
- 识别中自动刷新详情;失败/配置缺失/任务中断明确显示。持有原有上传权限的角色可 Retry recognition,重用同一原件与附件关联;不新增临床记录,不自动采纳 OCR 到已签署内容。
- 同一附件重复请求不能并发创建多个有效识别任务;超过三分钟无终态的任务显示中断并允许重试,旧任务迟到结果不能覆盖新任务。切换患者、就诊或身份、关闭窗口后取消旧响应展示和轮询。
- 本轮代码、专项验证、预览发布及 STG/UAT
分开记录:
agent_docs/test_cases/attachments/validation-20260908.md。
9. 本版必须明确的待实现设计
| 目标 | 当前证据与验收处理 |
|---|---|
| 主动双标识核验 | 当前由上游状态推断;安全验收 Blocked,不能按旧文档记 Pass |
| 六类医生流程共用类型差异规则 | 当前原子 Billing & Finish 仅普通 Consultation;其他类型返回不支持,不自动降级为普通门诊 |
| No Cashier Required | 当前完成服务统一写 Ready for Cashier;完全无 Charge Event 分支尚未交付 |
| 药房退回后的 Consultation/Cashier | 药房整单退回先保持 Ready for Cashier 并建立异常阻断;护士在 Cashier 手动确认后才回 In Consultation;医生在 Prescriptions 签署 Amendment 后经原临床签署版本校验原子送回 Cashier;有药新版本仍需重审,全部取消只核对剩余费用。应用已开发;真实数据联调/UAT 分别记录 |
| Handoff 部分成功恢复态 | 当前为原子回滚;目标若保留需单独设计与实现 |
| 完成后统一预约选择 | 当前直接建 09:00/30 分钟 Booked 预约;需改为已确认目标 |
| 24 小时自动关闭与超时审批 | Closed 拒绝重开已见代码;完整计时、审批和自动关闭未证明可运行 |
| eMMS 高风险放行规则 | 当前非阻断建议;临床正式门禁/Override 政策未定 |
| AI Scribe Consent | 当前有门禁,与部分旧需求相反,需确认保留口径 |
10. 测试使用方式
按测试用例中 CQ、CN、CP、CS、CC、CB、CR 用例回归当前行为;按本节待实现清单验收目标差距。执行前提供普通门诊测试 Visit、授权医生、有效 Provider 登记信息、至少一套可保存 Note 模板、药品与 Service 目录及权威价格。界面成功提示之后还要重新读取记录检查版本与状态。
源代码定位与核对日期集中在实现记录,正文不要求业务或测试人员阅读源文件。
当前主体、Provider 与护理授权门禁(已确认)
Consultation、Clinical Documents、患者历史和问诊队列只读取全局 Context Selector 当前主体,App 内不提供跨诊所混合筛选。Doctor 仅可查看当前主体中本人 Provider 的日程、当前问诊患者和历史问诊记录;Nurse 按当前 Clinic 与医生服务关系读取运营队列并处理本次附件;受限记录和临床协作再检查有效医生授权。主体切换后重新请求授权上下文并重新加载数据,同时清理旧患者、队列、历史、角标、未保存草稿及迟到请求。详情、附件、保存、完成和签署均由服务端再次校验主体、Provider/服务关系、授权期限和 Visit 状态。