From cc228765f1314482aebb159126864bd5cfc7ee31 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 4 May 2026 14:33:40 +0800
Subject: [PATCH] =?UTF-8?q?frontend-notice:=2012301=20PDF=20=E7=AD=BE?=
 =?UTF-8?q?=E5=90=8D=E6=AE=B5=E6=9C=AA=E7=AD=BE=E7=BD=B2=E4=B8=BA=E7=A9=BA?=
 =?UTF-8?q?=E5=B1=9E=E9=A2=84=E6=9C=9F,=20=E5=BB=BA=E8=AE=AE=E5=8A=A0=20UI?=
 =?UTF-8?q?=20=E6=8F=90=E7=A4=BA=20(@mmg)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...tice_contract_signature_only_after_sign.md | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 changelogs/2026-05/04_frontend_notice_contract_signature_only_after_sign.md

diff --git a/changelogs/2026-05/04_frontend_notice_contract_signature_only_after_sign.md b/changelogs/2026-05/04_frontend_notice_contract_signature_only_after_sign.md
new file mode 100644
index 0000000..6bb458f
--- /dev/null
+++ b/changelogs/2026-05/04_frontend_notice_contract_signature_only_after_sign.md
@@ -0,0 +1,38 @@
+---
+date: 2026-05-04
+type: frontend-notice
+module: contract-detail
+priority: low
+notify: ["@mmg"]
+status: pending
+---
+
+# 12301 合同 PDF "旅游者签名(盖章)" 段未签署时为空 — UI 加提示
+
+## 现象
+
+合同详情页 admin 下载 12301 PDF，附件1 旅游报名表底部的"旅游者签名（盖章）"格子为空。
+
+## 根因（非 BUG）
+
+12301 平台模板：旅游者**完成短信签署**后才把签名图渲染到 PDF。如果合同状态是"待签署"/"未完成签署"就下载 PDF，签名格子本就是空的——这是**预期行为**。
+
+## 后端零改动
+
+签名渲染由 12301 平台控制，我们入参没字段触发。
+
+## 前端建议
+
+合同详情页 admin 下载/预览 PDF 按钮旁，根据合同状态加提示：
+
+```vue
+<n-button @click="downloadPdf">下载 PDF</n-button>
+<span v-if="contract.status !== 'SIGNED' && contract.status !== 'COMPLETED'"
+      class="text-warning text-xs ml-2">
+  ⚠️ 旅游者尚未完成签署，PDF 中"签名（盖章）"段会为空
+</span>
+```
+
+或者下载前用 modal 二次确认，避免运营误以为合同 BUG。
+
+@mmg 看下，这个 UI 提示挺重要 — 之前用户反馈的 BUG 实际就是误以为后端漏字段。