实现状态、待确认事项与需求来源
更新：2026-09-14 · 本次权限修订仅更新 PRD；此前 09-10 PRD
评审核对开发分支 69dd540 与STG
4808516；历史证据按各自版本理解。本轮仅文档评审及规则修订，未运行业务UAT。
本页服务于开发和测试准备。业务主线及各板块正文只保留功能、流程和判断条件，代码位置、实现差距及历史冲突集中在这里。
1. 文档覆盖范围
| 当前已设计板块 | 本轮 PRD 落点 | 覆盖内容 |
|---|---|---|
| 患者主档与纵向 eMR | 前台 PRD | 身份、安全、持卡、诊所关系、历史、附件与返回 |
| 患者 H5 与人工审核 | 前台 PRD | 预填、48 小时令牌、六步填报、保障、重复匹配与批准 |
| 预约、医生排班与资源 | 前台 PRD／目录及平台 PRD | 新建、确认、改约、取消、Block-out、多资源与冲突目标 |
| 到诊与护理 | 前台 PRD | Check-in、准备门禁、队列、回退及服务分流 |
| Consultation | Consultation PRD | 当前代码五模块、Note／AI Scribe、诊断、药品、Service、文档、收费／完成 |
| Clinical Reference／Anatomy | Consultation PRD | 患者资料、历史、附件、教学画布、Chit activity、布局 |
| Clinical Documents／独立 Worklist／模板 | 文档 PRD | 内嵌与独立入口、自动／显式保存、版本、签署、签发目标、模板 |
| Pharmacy | Pharmacy／V-Lab PRD | 签署即审核，整张审核及预留后才能统一结算；Cashier 确认后备药、实物复核和整单领取；退回／重审门禁 |
| 诊所库存、CP 药品与 WDL 边界 | Pharmacy／V-Lab PRD；Central Pharmacy PRD | Pharmacy 维护临床交接；CP 维护采购、数量／单位、收发回收与权限设计，不改变原合同范围 |
| V-Lab／Imaging／外部 Vendor | Pharmacy／V-Lab PRD | 开单、承接、执行、结果、医生确认、人工外部收件 |
| Cashier／AR／保险回款 | Cashier／诊后 PRD | 费用、折扣、分摊、开票、付款、收据、冲正、回款分配、关闭 |
| Service Packages／Wallet | Pharmacy／V-Lab 及 Cashier PRD | 权益、预留／扣减／冲回、下游顺序及未决事项 |
| Tasks／Follow-up／Communication | Cashier／诊后 PRD | 回访、复诊、来源任务、负责人、结果及延期 SLA |
| Catalogue／价格／Coupon／Insurance Card | Catalogue PRD | 三个 App 的功能归属、价格与成本、来源互斥、批量导入与发布 |
| AI／知识库 | 平台与 AI PRD | 辅助输出、人工确认、失败、来源与治理 |
| 用户／组织／配置／Consent | 平台与 AI PRD | 上下文、职责、模拟、资源、模板、已确认的数据类别／读写矩阵及个别未决边界 |
| Audit／Access Review | 平台与 AI PRD | 事件、前后版本、复核与导出设计 |
| Integration Monitor／移动／迁移 | 平台与 AI PRD | 已有设计及延期界限、外部服务、历史只读与上线验证 |
2026-08-09 的 13 App 是旧信息架构建议，不作为当前 App 数量或所有功能已交付的证据。后续七种类型、患者级历史 Tab、Catalogue 独立管理与延期决策已纳入本版。
2. 当前实现分类
“已有基础”表示存在可核对代码；“部分实现”表示一部分目标缺失；“待开发”表示完整链路尚不足；“待业务确认”表示不能先定测试通过口径。所有分类均不表示已部署或 UAT。
| 范围 | 当前分类 | 测试可做什么／缺什么 |
|---|---|---|
| 患者搜索／三项建档／重复校验 | 已有基础 | 可安排 API 与业务回归；完整误匹配／合并 SOP 未定 |
| 主档修正／历史／诊所关系 | 已有基础＋部分实现 | 自动关系／版本有基础；手工关系治理、跨诊所矩阵与迁移完整度待验 |
| H5／审核 | 已有前后端基础，完整契约待验证 | 当前已有令牌、公开提交、员工审核及关联患者写入服务；重新确认／拒绝／待澄清、新建批准、Patient ID一致性及并发仍需专项核对，不能整体标为纯前端，也不能因此升级为闭环已验收 |
| Appointment／Check-in／回退 | 已有基础 | 需目标库迁移、并发与跨岗位实测 |
| 完整资源／多 Assignment／容量 | 部分实现／待开发 | 不能用 Room 名称多选代表完整资源模型 |
| 准备门禁／共享队列顺序 | 部分实现 | 身份门禁有基础；可配置准备项、跨终端手工顺序未完成 |
| Consultation 五模块／草稿／Note 版本 | 已有基础 | 当前源代码具备模块保存／后台保存与专用 Note 聚合；旧 WS2“缺持久化草稿”不宜再笼统套用全部 Note |
| 双标识主动核验／完整类型差异 | 部分实现／待开发 | 当前 trusted handoff 推断；原子完成只普通门诊 |
| Prescription／Pharmacy Handoff／Settlement | 已有基础＋部分实现 | 当前已有整张审核、库存证据、结算门禁及护士确认退回；真实库存分配、完整五阶段、逐药品审方与自动释放仍有缺口，见药房实现矩阵 |
| Pharmacy 角色分离／库存扣减 | 部分实现 | Checker 例外、权威库存／FEFO 与联动未完整验证 |
| Central Pharmacy 采购／库存／数量对账 | 部分基础；完整目标待开发 | 现有药品目录、PO 单级审批和查询不等于真实库存闭环；PIC → Finance、强制批次／效期、单位换算、来源层台账及收发回收、受限诊所数量视图、Finance 数量确认均见 CP PRD §8／§12。09-09另补诊所自采PIC单审→直接采购→本诊所自行入库及后续独立退CP例外，设计已确认、尚待开发；全内部范围召回／冻结权限暂缓，基础召回及其余规则见CP PRD §6／§9；SOP、数据核对及代码实施仍待完成 |
| Service Selection | 已有基础 | 搜索、建议、复制、保存／签署；不代表内部检查执行 |
| V-Lab 结果闭环 | 待开发／未充分实现 | 完整接单→医生确认不可按已完成验收 |
| Clinical Documents | 已有基础＋部分实现 | 多页签、自动版本、草稿租约与原子签署路径；完整签发／作废／重发未完成 |
| Billing & Finish | 普通门诊已有基础 | 医生／Provider／coverage、版本、价格及事务校验；特殊类型、无收费跳过与目标复诊流程缺失 |
| Invoice／多笔付款 | 已有基础 | 实付余额及 Paid 更新可回归；跨模块联调待验 |
| 退款／Remittance／Allocation | 部分实现／待开发 | 完整财务更正、到账分配及审批待验／待定 |
| Catalogue／Insurance Card | 已有基础＋部分实现 | 现有表卡种与 Policy 可核对；新资源可用范围／Cost／Consultation Pricing 底表及 Resolver 待开发 |
| Package／统一任务 | 部分实现 | 有权益台账与专用任务基础，完整 Checkout／通用任务与通信待接通 |
| AI／权限／审计 | 部分实现；09-14 分类与岗位契约已确认、待实施核验 | 基础身份投影仍含敏感字段、公共疫苗读取仍复用 patient.read；新字段隐藏／申请审计、独立公共医疗角色授权、前台基础字段限制、本次／历史附件及护士 Cashier 范围需逐接口对照。见 权限正文 与 修订证据；本轮未运行应用验收 |
| 用户配置与医生护士授权整合 | 已实现并通过本地定向集成验证；UAT 待验 | 用户配置与医生护士授权：用户详情、主体上限、护士医生关联原子保存、医生独立授权、管理员只读及 Element Plus／用户搜索已实现；完整权限诊断和处方草稿协作仍保留边界；持续记录覆盖已确认、待实施，见Platform §5.2，应用发布与 UAT 另计 |
| 自动 Closed／超时审批 | 待开发／未证明可运行 | Closed 拒绝重开有代码；不能据此声称定时关闭／24小时完整策略已通过 |
| Integration SLA／复杂 WDL／看板／现金盘点关账 | 延期／排除 | 不作为本期新交付承诺 |
| 诊所／医生 Day-end Revenue Report | 已实现，完整本地服务验证通过 | 规范见 Cashier §6.1；部署、验证与发布见 执行记录 |
3. Consultation 逐项代码依据
以下位置均相对于代码仓库；用于研发复核，不要求业务人员阅读。
| 结论 | 代码证据 |
|---|---|
| 五模块、后台保存、Review 清单 | varclip_vue/src/components/desktop/apps/ConsultationFormPanel.vue：tabs、saveBeforeLeaving、selectTab、openReviewAndSign、confirmClinicalSignOff |
| 当前以可信上游代替主动核验 | ClinicalWorkspaceApp.vue：requestOpenVisit／enterVisit；utils/clinicalWorkspaceRules.mjs：isTrustedConsultationHandoff |
| Note 模板、服务端保存与 Consent 门禁 | consultation-workspace/ConsultationNotePanel.vue：saveNote、runWithAiScribeConsent、startRecording、generateDraft |
| eMMS 非阻断、空处方／空 Selection 必须保存 | utils/clinicalWorkspaceRules.mjs：buildSignOffChecks；services/billing_finish.py：_lock_prescription、_lock_service_selection |
| 药品字段／Remark／修改版本 | consultation-workspace/PrescriptionPanel.vue；varclip_flask/src/services/prescriptions.py |
| Service 搜索／建议／复制／版本 | consultation-workspace/ServiceSelectionPanel.vue；varclip_flask/src/services/service_selections.py |
| 文档自动保存／活动工作台 | ClinicalDocumentWorkspace.vue；clinical-documents-embedded-tab-workspace-refactor-prd_20260901.md
及其 ADR |
| 普通类型与医生／Provider／coverage 门禁 | varclip_flask/src/services/billing_finish.py：SUPPORTED_CONSULTATION_TYPES、_doctor_context、_visit_context、_active_provider_snapshot |
| 同事务完成／固定复诊时间 | 同上：review_complete、_create_follow_up（09:00，30
分钟，Booked）；前端成功后 return-to-queue |
| 未确认结算／旧版本禁止发药 | varclip_flask/src/services/clinic_workflow.py：dispensing
状态变更检查；prescriptions.py：Payment
exception／Superseded |
| Reference 与 Anatomy | consultation-workspace/ConsultationInsightRail.vue；ClinicalWorkspaceApp.vue |
4. 冲突收口
| 旧说法／历史资料 | 本版如何处理 |
|---|---|
| 付款前可 Label／Pack／Verify、药房退回 Encounter 不回退 | 2026-09-06 最终确认覆盖：先整单审方并预留，才能统一结算；Cashier 确认后才开始备药；药房退回先阻断 Cashier，护士在 Cashier 手动恢复 In Consultation，重新签署后再次审核及预留通过才解锁；局部门禁已开发，完整流程待联调 |
| 四类流程含 Telemedicine；Day Procedure 直接术前流程 | 使用七类 Type 与医生共享主干目标；当前特殊类型差距另标 |
| 新患者只需姓名和电话 | 当前基线／代码要求姓名＋主手机＋证件三项 |
| 统一诊所静态 QR | 2026-09-03 源 PRD 与 WS1 为预填 Intake Draft 绑定的患者专属48小时令牌，无 OTP；长期记忆旧条目不覆盖它 |
| 离开模块必须停住等待保存 | 当前 Consultation 非文档模块保护草稿并后台保存，不因失败阻断导航；最终完成仍检查同步 |
| eMMS 警示自动阻断完成 | 当前代码非阻断，临床安全规则需确认；不自动认定代码现状为已批准政策 |
| 不新增 AI Scribe Consent 门禁 | 当前存在显式门禁；如实记录，保留待确认决定 |
| Handoff 失败保留临床已签状态 | 当前原子 Review Complete 全部回滚；目标中间态未实现 |
| 完成后打开复诊表单 | 当前原子流程自动建 09:00／30 分钟 Booked 预约；明确登记与目标不符 |
| 已具备 Provider Delegation／一键 STG Test Run | 相关增量已回滚；不作为当前功能说明 |
| Lab 四页、Doctor + Clinic + Type 定价、Group Default Cost | 使用最新单页 Test Catalogue 与两套明确价格／成本优先级 |
| 保险未回款不能 Closed | 已确认 AR 独立，Cashier 可确认付款安排后放行备药；未领取仍阻止 Closed，其他条件满足后按首次签署 24 小时时钟关闭 |
5. 真正还需要决定的问题
| 编号 | 待确认内容 | 负责人角色 | 影响／确认前怎么测 |
|---|---|---|---|
| Q01 | 保留或修改当前 AI Scribe Consent 门禁 | 产品／临床／隐私 | 当前回归按代码；新政策验收 Blocked |
| Q02 | eMMS 严重程度、非阻断边界、Override 与数据覆盖 | 临床／药房 | 验证实际非阻断；临床放行验收 Blocked |
| Q03 | 已付后更正／差额执行与底层库存适配 | 医生／药房／Finance | 普通状态不增加付款后审方；已发后退换人工记录。全部取消免重审、部分取消重审、整单领取、代领备注及无配送已确认 |
| Q04 · 已确认 | 第三方责任存在时明确确认；患者自付已结清或全部余款已登记欠款，再由 Cashier 显式确认结算后备药 | Finance／药房 | 患者与第三方 AR 分开；零额结算亦需 Cashier 确认，不虚记实际到账；源码、完整本地验证及发布见 Cashier 本轮记录，目标环境与 UAT 独立验收 |
| Q05 | 无 Charge Event、No Consultation 的 Checkout／自动关闭触发 | 产品／营运／临床 | 不使用不存在的临床签署时间；对应闭环 Blocked |
| Q06 | 体检报告签署人、结果等待与异常转诊；各 Type delta | 临床／体检营运 | 特殊类型逐类验收，不能都用普通 Consultation |
| Q07 | V-Lab 首项检查、必要字段、危急阈值及责任时限 | V-Lab／医生 | 普通状态链可设计，阈值／SLA 不编造 |
| Q08 | 迟到／No-show、Walk-in 链接、资源容量与例外 | 前台／营运 | 不设自动取消分钟数；无资源后台不报通过 |
| Q09 | 退款／冲正审批、套餐／Benefit／自付应用顺序 | Finance／营运 | 基础记账可回归；复杂结算 Blocked |
| Q10 | 单角色整改、临时代诊职责、Consent 撤回及审计导出剩余边界 | 临床／业务／隐私 | 按现有授权回归，最终矩阵单独验收 |
| Q11 | 文档审批／签发／作废／重发与正式模板 | 临床／营运 | 草稿／打印／当前签署可回归，完整签发 Blocked |
| Q12 | 统一任务 Owner、完成口径和消息记录 | 营运／各 Line | 引用源对象；通用 SLA 按已决定延期 |
| Q13 · 已确认 | Staff保持唯一角色，按限定诊所采购动作代办；不授患者发药权 | Line C／WS6 | 目标见CP §4.1，新授权和入口待开发，不沿用旧切角色验收 |
| Q14 · 已确认 | 医生明确选择持续覆盖本人指定诊所新增记录，查看和草稿编辑分别授权 | Line B／WS6 | 固定及持续模式见Platform §5.2；旧固定授权不自动升级，新模式待开发 |
Q 项不是要求本轮用户逐一回答。它们使测试可以继续执行已明确部分，并将无法判定的场景准确交给相应负责人。
6. 来源与维护方式
业务规范来自已确认项目基线及领域PRD；代码与实际执行证据按领域核对，不再用单个旧提交代表所有当前功能。旧
agent_docs/p0_mvp_workstream/ 已迁移至
dev_working/workstreams/phase_0/。当前职责、字段及规则在对应领域就地维护；历史决策与测试分别经仓库入口和执行证据追溯。
7. Cashier 与 Pharmacy 实现边界
本节保留影响跨模块集成的工程边界；完整产品规则在 Cashier／Pharmacy PRD 维护。
| 范围 | 当前实现与边界 |
|---|---|
| 日常导航、票据设置与单次 Checkout | Checkout Queue、Billing History、Day-end Report 为日常入口；模板维护移至右上角 Settings，复用现有存储及权限，规则见 Cashier §2。队列按诊所分页，不再限当天／40条；Invoice 与 Payment 均从原 Visit 进入，收入报表见 Cashier §6.1 |
| 费用与结算 | 使用首次签署非药品收费快照及当前签署处方／药房价格版本；服务器核对版本、整单审核、预留证据与余额，原子处理拆分实收、零额确认、第三方责任安排 |
| 票据 | 新增诊所模板、版本及打印请求审计；Post／Payment 冻结模板；旧票据首次快照注明来源；配置不会改金额。打印机出纸、税务正式版式和外部支付通道未验证 |
| 历史／AR／纠正 | 关联原交易补收、退款记录、Credit Note、无实收 Void；跨诊所与权限检查；原临床 Closed 保持不可重开。第三方批量 Remittance／Allocation、第三方 Credit、正式退款审批尚不完整 |
| Consultation 回退 | 只有护士明确确认可退回；无实收发票受控作废；原签署快照保留。原医生处理处方 Amendment 后重新送审核。完整五模块重开、已付款处方差额变更尚未实现 |
| Pharmacy 交接 | 新审核版本、失败／Hold／到期阻断收款；结算确认才 Label／Pack，整单备好及实物核对后整单交付。成功收银不会自动标为已发药 |
| 库存 | 当前无与诊所处方对应的自动库存分配／扣减台账。人工预留证据能力仅供明确启用的场景；默认关闭，生产采用方式待用户确认。测试中的人工预留是合成事实，不证明实际库存被预留 |
| Package／Coupon／Eligibility | 本次读取已有权益资料；Cashier 核销、预留／扣减／冲回及复杂优惠叠加仍未形成完整事务，不以支付方式伪造兑换；第三方责任确认不是保险实时核赔 |
| 收尾 | 用户明确确认 Checkout Completed；自动满24小时 Closed 调度和后续任务仍有缺口。现金盘点关账／Period Close 继续排除；收入报告见 Cashier §6.1 |
真实 PostgreSQL／Flask
与浏览器脚本已纳入隔离测试流水线；实际执行结果写入
agent_docs/test_cases/cashier/，不能以已编写脚本或合成界面等同于通过。应用预览发布、后台环境部署、集成测试和业务
UAT 分别记录。
8. 近期变化的验证入口
| 范围 | 当前判断 | 详细证据 |
|---|---|---|
| Cashier 界面与本次改价 | 单次价格调整、作废未付款旧票再Post已有实现；不代表药房独立改价／管理队列已交付 | Cashier验证 |
| Patient自填审核 | 响应式审核、患者确认关联、完整保障字段及带原因护士修正已有界面；当前已有正式令牌／提交／审核服务基础；完整重新确认及持久审计覆盖需按最新代码逐项验证 | Patient验证 |
| Clinic与后台Finance | Clinic六现场角色、后台Finance、WDL Staff/PIC及旧membership兼容已有本地完整服务验证；价格写入、独立附件最小权限及完整跨单位授权仍有缺口 | 角色验证；组织与权限产品方案 |
| 默认问诊费 | 后端默认HKD1,000且保留有效已有价（包括零）和签署历史 | 收费验证 |
| 医生访问 | 查询与操作均校验当前Visit医生归属；正式限时代诊授权边界保留 | 访问验证 |
| 附件与OCR | 10MiB逐文件上传、保存与识别分开、完整结果及重试已有本地完整链路；外部OCR服务验收独立 | 附件验证 |
以上不提升STG部署或UAT状态。文档治理规则和恢复来源见维护规则。