fix(sign): 补齐模板查询院区参数

2026-09-28 21:04:03 +08:00
parent b6775a66c7
commit f7804d476d
5 changed files with 45 additions and 12 deletions
@@ -91,7 +91,7 @@ medical-sign/
 ## 签署接口契约

 - 模板版本的 `formFields` 保存文书字段定义，`signatureFields` 单独保存患者签名在 PDF 中的页码、坐标、宽高和坐标系；编辑器中的坐标单位为 PDF point。发布模板前必须配置 `signature` 字段的位置。
- `GET /api/v1/templates/available-versions` 返回 `formFields` 和 `needConfirm`。创建任务时将人工填写值放入 `staffAnswers`，并传入 `signerType`、`signerName`、`signerRelation`；患者、性别、年龄、就诊号和电话等已知字段仍由后端快照覆盖。
+- `GET /api/v1/templates/available-versions` 必须传入当前选择的 `campusId`，并返回 `formFields` 和 `needConfirm`。创建任务时将人工填写值放入 `staffAnswers`，并传入 `signerType`、`signerName`、`signerRelation`；患者、性别、年龄、就诊号和电话等已知字段仍由后端快照覆盖。
 - H5 先调用 `POST /api/v1/sign-deliveries/token/consume`，再用返回的 `taskId`、`deliveryId`、`uploadToken` 调用 `POST /api/v1/sign-deliveries/token/context`。上传使用 `POST /api/v1/sign-deliveries/{taskId}/signature` multipart，包含 `file`、`metadata` 和 `signer` JSON 部分，并复用 `Idempotency-Key` 安全重试。
 - 患者签署后，任务可能处于 `GENERATING`、`WAITING_CONFIRM` 或 `SIGNED`。刷新结果页时 H5 使用只读 context 查询恢复服务端状态，不能将这些状态退回为可重复签署。