feat(签署文书): 通用文本项按出现位置独立成项并插入文本框占位符

2026-09-18 13:30:06 +08:00
parent d2cd3f2489
commit 11fe83d807
5 changed files with 184 additions and 47 deletions
@@ -129,11 +129,14 @@ ClinicalLayout

 科室在文档库的 Word 编辑器中维护文书，签署时需要交互化的内容按下面的写法即可，系统在签署和「签署预览」时自动转换：

- 占位符：`｛患者姓名｝`、`｛性别｝`、`｛年龄｝`、`｛就诊号｝`、`｛签署日期｝`、`｛患者签名｝`、`｛医师签名｝` 等，由签署任务的患者与就诊快照填充；
+- 占位符分两类，写法都是 `｛…｝`：
+  - **系统预填项**：`｛患者姓名｝`、`｛性别｝`、`｛年龄｝`、`｛就诊号｝`、`｛签署日期｝`、`｛患者签名｝`、`｛医师签名｝` 等，字段键与取值来源固定，由签署任务的患者与就诊快照填充，目录见 `utils/signing-fields.ts` 的 `SIGNING_FIELD_PRESETS`；
+  - **通用文本项**：现场手填的输入框，默认写 `｛文本框｝`，签署时渲染成一个空文本框。**每个占位符各自是一个填写项**，字段键按出现位置编号（`custom:名称`、第 2 个起是 `custom:名称#2`……），所以同一份文书里放几个文本框就是几份取值，不需要为了区分而改名字；名称只决定文书里显示的文字，直接把正文里的「文本框」改成「与患者关系」「受托人姓名」即可（仅为可读性，不影响取值归属）。
+  - 只有上面那类系统预填项按字段键去重、同名共用一份取值——页眉的患者姓名、每页的签名位反复出现，取值本来就该是同一个。
 - 勾选表：做成表格，第一行表头写「勾选」，另设一列写「项目」作为勾选条目名，签署时「勾选」列每个单元格变成复选框；
 - 行内选项：正文里直接写方框符号，如 `□否　□是`、`□同意　□不同意`。同一段落或同一单元格内出现两个及以上方框时按二选一（互斥单选）处理，只有一个方框时保持独立复选框语义。

-编辑器弹窗顶部提供「插入勾选框」「二选一」按钮，光标停在表格单元格内时插入内容会落进该单元格，不需要科室自己找符号面板。导入（.docx / 粘贴）阶段只做格式转换，不做勾选识别；识别统一在签署渲染时进行。
+编辑器弹窗顶部提供「插入勾选框」「二选一」按钮，以及插入通用文本项的「文本框」按钮（虚线圈出的那一个，点一下插入 `｛文本框｝`，把「文本框」三个字改成实际名称即可）。光标停在表格单元格内时插入内容会落进该单元格，不需要科室自己找符号面板。导入（.docx / 粘贴）阶段只做格式转换，不做勾选识别；识别统一在签署渲染时进行。

 识别规则集中在 `utils/signing-document.ts`，调整后签署端与「签署预览」会同步生效。