feat(plan): 支持学案文件下载功能

- 新增 DownLoadLessonPlanReqVO 请求类用于下载请求封装
- 在前端学案列表增加“下载”按钮，支持单条学案下载操作
- 实现前端下载接口，处理后端返回的 Blob 文件流并触发文件保存
- 后端新增下载接口，根据学案 ID 生成对应的 Word 文档并作为附件响应
- WordExportUtil 中新增按模板生成学案 Word 文档方法，支持工作日和周末模板切换
- LessonPlansService 新增根据 ID 查询学案的方法及对应 Mapper 实现
- 修改学案列表中“学案ID”标签为“计划ID”，提升表述准确性
- 下载过程中添加加载状态和错误信息提示，提升用户体验

enlish-vue/src/api/plan.js

@@ -5,4 +5,65 @@ export function generateLessonPlan(studentId, unitId) {
         studentId: studentId,
         unitId: unitId
     })
-}
+}
+
+export function downloadLessonPlan(data) {
+    return axios.post('/plan/download', data, {
+        // 1. 重要：必须指定响应类型为 blob，否则下载的文件会损坏（乱码）
+        responseType: 'blob',
+        headers: {
+            'Content-Type': 'application/json; application/octet-stream' // 根据需要调整
+        }
+    }).then(response => {
+        // 2. 提取文件名 (处理后端设置的 Content-Disposition)
+        // 后端示例: header("Content-Disposition", "attachment; filename*=UTF-8''" + fileName)
+        let fileName = 'download.zip'; // 默认兜底文件名
+
+        const contentDisposition = response.headers['content-disposition'];
+        if (contentDisposition) {
+            // 正则提取 filename*=utf-8''xxx.zip 或 filename="xxx.zip"
+            const fileNameMatch = contentDisposition.match(/filename\*?=['"]?(?:UTF-\d['"]*)?([^;\r\n"']*)['"]?;?/);
+            if (fileNameMatch && fileNameMatch[1]) {
+                // 后端如果用了 URLEncoder，这里需要 decode
+                fileName = decodeURIComponent(fileNameMatch[1]);
+            }
+        }
+
+        // 3. 开始下载流程
+        resolveBlob(response.data, fileName);
+    }).catch(error => {
+        console.error('下载失败', error);
+        showMessage('下载失败' + error, 'error');
+        // 注意：如果后端报错返回 JSON，因为 responseType 是 blob，
+        // 这里看到的 error.response.data 也是 blob，需要转回文本才能看到错误信息
+        const reader = new FileReader();
+        reader.readAsText(error.response.data);
+        reader.onload = () => {
+            console.log(JSON.parse(reader.result)); // 打印后端实际报错
+        }
+    });
+}
+
+const resolveBlob = (res, fileName) => {
+    // 创建 Blob 对象，可以指定 type，也可以让浏览器自动推断
+    const blob = new Blob([res], { type: 'application/octet-stream' });
+
+    // 兼容 IE/Edge (虽然现在很少用了)
+    if (window.navigator.msSaveOrOpenBlob) {
+        navigator.msSaveBlob(blob, fileName);
+    } else {
+        // 创建一个临时的 URL 指向 Blob
+        const link = document.createElement('a');
+        link.href = window.URL.createObjectURL(blob);
+        link.download = fileName;
+
+        // 触发点击
+        link.style.display = 'none';
+        document.body.appendChild(link);
+        link.click();
+
+        // 清理资源
+        document.body.removeChild(link);
+        window.URL.revokeObjectURL(link.href);
+    }
+};

enlish-vue/src/pages/LearningPlan.vue

@@ -19,16 +19,25 @@
                                 <div class="p-3">
                                     <div class="text-sm font-semibold mb-2">学案</div>
                                     <el-table :data="row.plans || []" size="small" border>
-                                        <el-table-column prop="id" label="学案ID" width="100" />
+                                        <el-table-column prop="id" label="计划ID" width="100" />
                                         <el-table-column prop="title" label="标题" min-width="280" />
                                         <el-table-column label="状态" width="120">
                                             <template #default="{ row: plan }">
-                                                <el-tag :type="plan.isFinished === 1 ? 'success' : 'info'"
-                                                    effect="plain">
+                                                <el-tag :type="plan.isFinished === 1 ? 'success' : 'info'" effect="plain">
                                                     {{ plan.isFinished === 1 ? '已完成' : '未完成' }}
                                                 </el-tag>
                                             </template>
                                         </el-table-column>
+                                        <el-table-column label="操作" width="120" fixed="right">
+                                            <template #default="{ row: plan }">
+                                                <el-button
+                                                    type="primary"
+                                                    size="small"
+                                                    :loading="downloadingIds.includes(plan.id)"
+                                                    @click="onDownload(plan)"
+                                                >下载</el-button>
+                                            </template>
+                                        </el-table-column>
                                     </el-table>
                                 </div>
                             </template>
@@ -54,6 +63,8 @@
 import Header from '@/layouts/components/Header.vue'
 import { ref, onMounted } from 'vue'
 import { findStudentLessonPlans } from '@/api/studentLessonPlans'
+import { downloadLessonPlan } from '@/api/plan'
+import { showMessage } from '@/composables/util'
 
 const rows = ref([])
 const loading = ref(false)
@@ -62,6 +73,7 @@ const pageSize = ref(10)
 const totalCount = ref(0)
 const searchName = ref('')
 const tableRef = ref(null)
+const downloadingIds = ref([])
 
 async function fetchLessonPlans() {
     loading.value = true
@@ -96,6 +108,22 @@ function onReset() {
     fetchLessonPlans()
 }
 
+async function onDownload(plan) {
+    if (!plan?.id) {
+        showMessage('无效的计划ID', 'error')
+        return
+    }
+    if (!downloadingIds.value.includes(plan.id)) {
+        downloadingIds.value = [...downloadingIds.value, plan.id]
+    }
+    try {
+        await downloadLessonPlan({ id: plan.id })
+        showMessage('开始下载', 'success')
+    } finally {
+        downloadingIds.value = downloadingIds.value.filter(id => id !== plan.id)
+    }
+}
+
 onMounted(() => {
     fetchLessonPlans()
 })