Clinical Documents 与模板 PRD
更新：2026-09-14 · 责任：Line B · 相关功能编号：CD-01～CD-05、CC-01～CC-05
功能地图
文档实例记录一次就诊的内容；模板提供可复用结构；打印是输出动作，不能替代签署或交付。
| 功能 | 使用者／业务对象 | 产品方案与阅读位置 |
|---|---|---|
| 创建与编辑文档 | 医生／获准协作者 · Document | §1–3：入口、字段、默认集、新增、AI 候选与移除 |
| 可靠保存与输出 | 当前编辑者 · Document Version | §4–5：版本、重试、编辑租约、打印与阻断 |
| 签署与交付 | 具相应资格的人员 · 生命周期 | §6：签署、签发、作废／重发和 Worklist 目标 |
| 模板与个人默认集 | 医生／模板管理者 · Template | §7：系统蓝本、个人版本、恢复默认与历史快照 |
1. 业务对象与两个入口
Clinical Document 是医生基于模板生成的证明、病假纸、转介信、入院信、医疗／保险报告、用药摘要或患者说明。每份必须属于一个 Patient + Encounter。文件类型选择当前已启用的模板目录，不承诺所有家族已配齐正式内容。
| 入口 | 谁使用 | 当前工作方式 | 共同数据 |
|---|---|---|---|
| Consultation 内嵌 | 当前就诊获授权医生 | 多文档页签、默认打开集、自动保存 | 模板、Document ID、版本、AI 与打印服务 |
| 独立 Clinical Document App | 需查看／处理特定就诊文档的授权人员 | 先选择 Encounter，保留当前布局和显式保存；Recipient 仍按该入口现有规则校验 | 不新建一份脱离 Encounter 的副本 |
| 跨就诊 Worklist 目标 | 文档处理岗位 | 待处理／待签发／历史筛选、按状态处理 | 只引用原文档；完整工作清单与签发链仍待实现 |
正式临床文档由负责医生管理。护士要查看文档，需要在来源诊所服务该位医生，并取得有效查看授权；编辑草稿还需单独的编辑授权。其他医生可以申请查看指定记录，签署及正式修订则由合资格医生执行，详见 权限矩阵。
上传附件和生成正式临床文档是两种工作。Attachment Management 用于上传、分类、预览文件和读取 OCR 结果；本篇负责模板、文档正文及签署。护士的本次附件管理权，不会开放正式文档正文，也不允许删除或撤销已签文档。历史文档即使在本次问诊中打开或复制，仍检查原记录授权。
以上权限范围于 2026-09-14 确认。本轮修改的是 PRD，尚未实施或验收对应权限代码。
2. 文档与模板字段
| 对象 | 字段 | 维护规则 |
|---|---|---|
| 文档实例 | 文档类型、Template 及快照、Patient／Encounter、Recipient、正文、Letterhead、Page size、版本、状态、作者 | 身份由当前上下文绑定；正文可编辑，状态转换不由打印推断 |
| 模板 | 模板名称、Family／Type、普通正文、Merge Fields、命名 AI Areas、版式 | 保存可复用结构，不保存某患者实际内容；临床事实来自文档实例 |
| 默认打开集 | 医生、最多六个不重复模板、有序列表 | 跨设备偏好，只影响新 Encounter；变更不增删当前文档 |
| 历史版本 | 上一版本、正文快照、模板快照、作者和时间 | 已保存修改追加后继版本，不原位覆盖；无变化重试不增版本 |
模板中的 Merge Field 从真实患者／Encounter 填值，缺值不编造；AI Area 只为命名区域生成文本；整篇 Improve draft 为独立候选，须明确确认后才替换编辑器正文，生成本身不保存。确认后的全文替换须能通过普通 Undo 恢复确认前正文；无法建立可撤销编辑时保留候选并明确报错，不能仍提示应用成功。模板已停用或无权限时不能用于新建，但历史快照保留。
3. 内嵌文档工作流程
功能目的： 让医生在本次问诊中完成一份或多份可追溯文档。
使用者与对象： 医生使用本人模板，获授权护士协作已有快照；每份文档绑定 Patient＋Encounter。
操作与结果： 恢复既有文档或打开默认集 → 编辑／核对 AI 候选 → 保存版本 → 打印或在临床完成时签署。
关键边界： 新建资格、编辑资格、打印及签署分别检查；文档缺值提示与保存失败分开。
2026-09-09 本地反馈修正： 文档区读取和创建资格必须与服务端既有规则一致。真实 Doctor 使用本人模板；服务端已确认的 Unrestricted Functional Test Doctor 会话，须显式选定有效目标 Provider，使用该目标医生模板。其他模拟模式不开放个人模板；真实操作者和目标医生分开留痕，不由 Doctor 标签自动授予资格。此前前端一律拒绝模拟身份，导致已获支持的功能测试医生也不加载默认文档；本轮修正这处前后端不一致，未新增服务端权限或改变签署规则。
已授权护士读取／编辑当前 Visit 已保存的文档快照，不能因为有草稿编辑授权便创建医生模板。没有已保存文档时说明实际原因，并提供 Refresh documents；只有能创建文档时才提示新增并提供对应按钮。加载中、无文档、读取失败、无模板资格和只读状态分别呈现；已有正文时保存／AI／打印错误也必须在页面可见，不能只写屏幕阅读器文本或控制台。获取编辑租约失败要显示实际原因并提供 Retry editing access，未成功前保持只读；不能把接口或锁等待错误误报为另一个工作台已接管。无维护权的模板设置齿轮隐藏，不能提供点击无效的入口。相关本地验证见 导航与文档回归。
- 第一次进入新 Encounter，打开医生默认集；有既有文档时恢复原文档，不重复创建。
- 点击
+搜索／按 Family 选择已启用模板，可用同一模板开多份独立文档。 - 编辑当前文档正文、Recipient 与版式；AI 卡片只处理当前页签。
- 切换文档页签保护当前浏览器草稿；离开整个模块保存所有仍存在页签。
- Print 先持久化当前文档，再输出该版本；不能顺带打印或改变其他文档。
- Review & Complete 检查文档可靠保存并签署相应当前版本；Signed／Completed 后只读。
没有文档时显示新增入口；最后一页删掉后不自动恢复默认文档。关闭
X 表示从本次就诊移除文档：尚未建立 Document ID
直接移除，已保存 Draft 需确认后软删除；已签署／已完成无 X。
4. 保存、失败及多窗口
| 场景 | 应如何处理 | 验收预期（非执行结果） |
|---|---|---|
| 首次保存 | 建 Document ID 与 Version 1 | 刷新可读同一文档 |
| 有变化再次保存 | 追加后继版本 | 旧正文仍可追溯 |
| 无变化或同请求重试 | 复用原结果 | 不重复建文档／版本 |
| 离开模块保存失败 | 保留当前标签页草稿，退避重试；最终失败标记错误并允许导航 | 不能最终完成问诊；恢复成功后清除错误 |
| Print 保存失败 | 说明无法可靠保存／打印 | 不宣称已打印该正式版本，不伪造成功审计 |
| 新工作台取得编辑权 | 旧工作台转只读，不让医生手工合并 | 同一 Encounter 不发生两处同时成功覆盖 |
| 关闭浏览器 | 只承诺当前浏览器存储能力范围内的恢复 | 不承诺关闭时异步保存一定完成或跨设备恢复本地草稿 |
5. 内容提示和真正阻断
内嵌工作台的 Recipient、正文、AI 区域或 Merge Field 不完整只提示，不阻断保存、AI、打印或完成问诊；医生承担内容、披露范围和临床事实责任。系统保存真实缺值，不制造机构、诊断或用药。
以下仍阻断：Patient／Encounter／Clinic／Doctor 不匹配、无权限、不是活动编辑者、已签署或不可编辑状态、安全 HTML／容量校验失败、当前内容未可靠保存，以及无法记录必要打印披露证据。内容不完整与保存失败必须用不同反馈。
6. 文档生命周期及跨就诊 Worklist
设计生命周期：Draft → Reviewed／Approved（按类型）→ Signed → Issued；需要纠正时 Voided 或 Reissued，保留旧版本及原因。当前代码已有草稿版本、原子完成时的签署与打印基础，完整独立审批／签发／作废／重发仍不能宣称完成。
Worklist 目标应能按患者、日期、文档类型、负责医生、状态和来源就诊筛选；详情显示文档版本、当前待处理动作、操作者及交付记录。Print／PDF 只是输出，实际发送／交付需单独记录接收方、方式、时间及结果；没有通信接口时记录人工交付，不能自动生成 Delivered。
具体哪些文档需要审批、谁可签发、签发时限、重发编号和披露审批仍待临床与营运确认。对应场景先标 Blocked，不临时设计成所有角色都可签发。
STG 与权限集成： 区域生成、整篇改善、确认／取消／撤回均复核具体 Visit 草稿权限、工作台租约及授权文档快照。护士只可操作医生已建立并授权的文档，不能因 AI 新接口绕过模板创建资格；模型返回后再次检查权限、租约、模板／文档版本，撤权或基线变化的迟到结果不得应用。候选或仍在生成的区域必须先明确处理，随后才可保存、打印、切换或 Review & Complete。无结构化主诊断的确认属于可签署医生的决策，不阻止只读或护士协作者浏览页签。
flowchart LR
A[系统基础蓝本] --> B[医生个人模板版本]
B --> C[本次文档的模板快照]
C --> D[文档正文与后继版本]
D --> E[签署版本]
D --> F[当前已保存版本的打印]修改个人模板只影响后续生成；原文档保留生成时快照。打印成功不自动改变签署／签发状态。
7. 模板管理
基础与个性化（2026-09-09 用户确认）： 系统 default 蓝本提供基础模板兜底。首次使用、没有个人配置或缺少基础模板时，服务端按稳定蓝本键幂等补齐；医生编辑的是自己的模板副本并追加版本，只对本人有效，不修改系统蓝本或其他医生配置。Restore default 从系统蓝本恢复，基础模板不可删除。已保存文档继续使用生成时的模板快照，不随个人模板改动。Personal Settings 和文档内嵌设置读取同一份医生默认集合；加载中或加载失败必须明确显示状态并禁用保存，失败提供重试，不能把尚未加载解释成空集合或覆盖已有配置。默认打开页签是另外一层有序偏好：未配置时初始化常用文档；主动保存空页签集合不删除基础模板库，仍可通过 + 使用基础模板。
Personal Settings → Document Templates 或文档页内的同一设置编辑器维护医生默认集、搜索模板、新建／编辑模板。默认模板使用 Restore／Preview／Save；个人模板使用 Delete／Preview／Save。模板管理可以在 Completed Consultation 中继续使用，但不能改当前已签文档。
个人模板所有权须基于稳定用户身份；历史仅按医生名字过滤的路径不能视为权限隔离已通过。正式 Letterhead、签名、打印机及文档内容批准另有上线依赖；预览版面不代表正式临床签发资格。