From f14dd3435ea40fba3965fa6af406bbadb45a6904 Mon Sep 17 00:00:00 2001
From: hmo <staymo7777@gmail.com>
Date: Tue, 28 Apr 2026 13:00:34 +0800
Subject: [PATCH] feat: add export preview centering fix and scroll fix

---
 app/templates/plan_detail.html |  2 +-
 docs/DEPLOYMENT_SOP.md         | 31 +++++++++++++++++++++++++++++--
 2 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/app/templates/plan_detail.html b/app/templates/plan_detail.html
index f053294..e315f9d 100644
--- a/app/templates/plan_detail.html
+++ b/app/templates/plan_detail.html
@@ -357,7 +357,7 @@ loadPlan();
                 <h5 class="modal-title" id="previewModalLabel">导出预览</h5>
                 <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="关闭"></button>
             </div>
-            <div class="modal-body" style="position: relative; overflow: hidden;">
+            <div class="modal-body" style="position: relative; overflow: auto;">
                 <div id="previewWatermark" class="preview-watermark-overlay"></div>
                 <div id="previewContent" class="preview-content"></div>
             </div>
diff --git a/docs/DEPLOYMENT_SOP.md b/docs/DEPLOYMENT_SOP.md
index cc9fd28..4c427f1 100644
--- a/docs/DEPLOYMENT_SOP.md
+++ b/docs/DEPLOYMENT_SOP.md
@@ -1,11 +1,35 @@
 # 钢琴练习方案系统 - 部署 SOP
 
-> 版本：v1.5.1
+> 版本：v1.5.2
 > 日期：2026-04-28
 > 核心原则：**不删除，只备份后新增/替换**
 
 ---
 
+## 重要更新（v1.5.2）
+
+### ✨ 导出预览功能
+
+在方案详情页新增「预览」按钮，点击弹出模态框展示套用模板导出后的最终效果（所见即所得）。
+
+**功能特点：**
+- 预览内容与 PDF 导出效果一致（字体、标题层级、表格样式）
+- 支持水印预览（如已配置）
+- 内容超出时可滚动查看
+- 支持 `<para alignment="center">` 居中语法（预览和 PDF 导出均支持）
+
+**模板居中写法：**
+```html
+<para alignment="center">【{generated_by} 撰写于 {generated_at}】</para>
+```
+
+**技术实现：**
+- 后端：`GET /api/plans/<id>/preview` 返回渲染后的 HTML
+- 前端：Bootstrap 模态框 + CSS 镜像 PDF 样式
+- 新增依赖：`markdown` Python 包（Markdown → HTML 转换）
+
+---
+
 ## 重要更新（v1.5.1）
 
 ### ⚠️ 问题文件已迁移到数据库
@@ -409,6 +433,8 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本，该脚本创建 stud
 [ ] PDF 水印功能正常（配置后导出可见）
 [ ] 数据统计页面正常显示
 [ ] 导出PDF时 {student_goals} 正常显示学员目标
+[ ] 导出预览功能正常：预览按钮、模态框、水印显示
+[ ] 模板支持 <para alignment="center"> 居中语法（预览和PDF均有效）
 ```
 
 ---
@@ -417,6 +443,7 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本，该脚本创建 stud
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| v1.5.2 | 2026-04-28 | 导出预览功能（预览按钮+模态框+水印）；目标内容换行修复；支持<para alignment="center">居中语法；隐藏MD下载按钮 |
 | v1.5.1 | 2026-04-28 | PDF水印配置保存修复（3处漏改）；{student_goals}占位符修复；移除目标导出时的"内容："标签 |
 | v1.5.0 | 2026-04-27 | 数据统计页面（问题/级别分布可视化）；PDF水印配置（可自定义文本）；编辑页按钮吸底；侧边栏顺序调整；Linux中文字体路径修复 |
 | v1.4.0 | 2026-04-27 | 典型方案采纳；推荐方案列表；方案编辑/详情页导航优化（bfcache处理）；审计字段完善（created_by/updated_by/updated_at）；方案列表支持删除；学员列表"暂无方案/问题"样式统一 |
@@ -434,4 +461,4 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本，该脚本创建 stud
 ---
 
 > **最后更新**：2026-04-28
-> **更新原因**：v1.5.1 补丁；PDF水印保存漏改；{student_goals}占位符修复；清理重复检查清单
+> **更新原因**：v1.5.2 - 导出预览功能；目标换行修复；居中语法支持