frontend-notice: 12301 PDF 签名段未签署为空属预期, 建议加 UI 提示 (@mmg)

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 实际就是误以为后端漏字段。