feat: 复习页支持导出学习数据

This commit is contained in:
2026-10-09 12:33:17 +08:00
parent 21af81f48c
commit 87e4ceab11
8 changed files with 631 additions and 0 deletions
+65
View File
@@ -0,0 +1,65 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
vi.mock('@/utils/request', () => ({
default: {
get: vi.fn(),
post: vi.fn(),
put: vi.fn(),
del: vi.fn(),
},
}))
import request from '@/utils/request'
import { exportRange, exportTask } from '@/api/export'
const mockedRequest = vi.mocked(request)
const sample = {
fileName: 'LPT-学习数据-20261009-1130.md',
contentType: 'text/markdown; charset=UTF-8',
content: '# 学习数据',
}
describe('export API', () => {
beforeEach(() => {
vi.clearAllMocks()
})
it('exportTask 请求 GET /export/task/:taskNum 并带上 markdown 格式', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: sample })
const result = await exportTask('T001', 'markdown')
expect(mockedRequest.get).toHaveBeenCalledWith('/export/task/T001', { format: 'markdown' })
expect(result).toEqual({ code: 200, data: sample })
})
it('exportTask 支持 json 格式', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: { ...sample, fileName: 'LPT-学习数据.json' } })
await exportTask('T002', 'json')
expect(mockedRequest.get).toHaveBeenCalledWith('/export/task/T002', { format: 'json' })
})
it('exportRange 带起止日期时把两个日期都拼进查询参数', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: sample })
await exportRange({ startDate: '2026-01-01', endDate: '2026-01-31', format: 'markdown' })
expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', {
format: 'markdown',
startDate: '2026-01-01',
endDate: '2026-01-31',
})
})
it('exportRange 省略起止日期时只传格式(导出全部)', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: sample })
await exportRange({ format: 'json' })
expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', { format: 'json' })
})
it('exportRange 只填一个日期时另一个不进入查询参数', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: sample })
await exportRange({ startDate: '2026-01-01', format: 'markdown' })
expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', {
format: 'markdown',
startDate: '2026-01-01',
})
})
})
@@ -0,0 +1,113 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus, { ElMessage } from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import ReviewDetail from '@/components/ReviewDetail.vue'
import { getReportDetail, getTaskReview } from '@/api/review'
import { getSessionDetail } from '@/api/studySessions'
import { exportTask } from '@/api/export'
import { downloadTextFile } from '@/utils/download'
vi.mock('@/api/review', () => ({
getFragmentDetail: vi.fn(),
getReportDetail: vi.fn(),
getTaskReview: vi.fn(),
}))
vi.mock('@/api/studySessions', () => ({
getSessionDetail: vi.fn(),
}))
vi.mock('@/api/reportFragments', () => ({
updateFragments: vi.fn(),
}))
vi.mock('@/api/export', () => ({
exportTask: vi.fn(),
exportRange: vi.fn(),
}))
vi.mock('@/utils/download', () => ({
downloadTextFile: vi.fn(),
}))
const taskReviewItem = {
id: 1,
sessionNum: 'S001',
taskNum: 'T001',
taskName: '学习 Vue3 组合式 API',
sourceType: 'REPORT',
content: '# 学习报告',
createdTime: '2026-01-01 10:00:00',
}
const exportResult = {
fileName: 'LPT-学习数据-20261009-1130.json',
contentType: 'application/json; charset=UTF-8',
content: '{"ok":true}',
}
/**
* 交互式集成测试:真实挂载任务复习详情页,
* 覆盖「导出该任务」入口与格式选择的导出流程。
*/
describe('ReviewDetail 任务导出流程(集成)', () => {
beforeEach(() => {
vi.clearAllMocks()
vi.mocked(getTaskReview).mockResolvedValue({ code: 200, data: [taskReviewItem] })
vi.mocked(getReportDetail).mockResolvedValue({
code: 200,
data: { content: '# 学习报告', sessionNum: 'S001' },
})
vi.mocked(getSessionDetail).mockResolvedValue({
code: 200,
data: {
sessionNum: 'S001',
sessionState: 'ENDED',
taskNum: 'T001',
taskId: 1,
taskName: '学习 Vue3 组合式 API',
actualTime: 600,
effectiveTime: 500,
effectivenessRatio: 0.8,
},
})
vi.mocked(exportTask).mockResolvedValue({ code: 200, data: exportResult })
})
const mountDetail = async () => {
const router = createRouter({
history: createMemoryHistory(),
routes: [{ path: '/review/detail/task/:taskNum', component: ReviewDetail }],
})
await router.push('/review/detail/task/T001')
await router.isReady()
const wrapper = mount(ReviewDetail, {
global: {
plugins: [ElementPlus, router],
stubs: { ElTag: true },
},
})
await flushPromises()
return wrapper
}
it('点击「导出该任务」并选择 JSON 后调用导出接口并触发下载', async () => {
const wrapper = await mountDetail()
const openButton = wrapper.findAll('button').find((b) => b.text().trim() === '导出该任务')
expect(openButton).toBeTruthy()
await openButton!.trigger('click')
await flushPromises()
await wrapper.find('input.el-radio__original[value="json"]').setChecked()
await flushPromises()
await wrapper.find('.export-confirm-button').trigger('click')
await flushPromises()
expect(exportTask).toHaveBeenCalledWith('T001', 'json')
expect(downloadTextFile).toHaveBeenCalledWith(exportResult)
expect(ElMessage.success).toHaveBeenCalledWith('导出完成,文件已开始下载')
})
})
@@ -0,0 +1,160 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus, { ElDatePicker, ElDialog, ElMessage } from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import Review from '@/components/Review.vue'
import { getReviewTaskStats } from '@/api/review'
import { exportRange } from '@/api/export'
import { downloadTextFile } from '@/utils/download'
vi.mock('@/api/review', () => ({
getReviewTaskStats: vi.fn(),
getReviewFeed: vi.fn(),
getTaskReview: vi.fn(),
}))
vi.mock('@/api/export', () => ({
exportTask: vi.fn(),
exportRange: vi.fn(),
}))
vi.mock('@/utils/download', () => ({
downloadTextFile: vi.fn(),
}))
const tasks = [
{
taskNum: 'T001',
taskName: '学习 Vue3 组合式 API',
reportCount: 3,
fragmentCount: 5,
effectiveTime: 9000,
reviewDurationSeconds: 1200,
},
]
const exportResult = {
fileName: 'LPT-学习数据-20261009-1130.md',
contentType: 'text/markdown; charset=UTF-8',
content: '# 学习数据',
}
/**
* 交互式集成测试:真实挂载 Review 总览页,覆盖导出弹窗主流程
* (打开弹窗 → 选格式 → 点导出 → 调用接口 → 触发下载)与未选时间段的拦截。
*/
describe('Review 导出流程(集成)', () => {
beforeEach(() => {
vi.clearAllMocks()
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(exportRange).mockResolvedValue({ code: 200, data: exportResult })
})
const mountReview = async () => {
const router = createRouter({
history: createMemoryHistory(),
routes: [
{ path: '/review', name: 'review', component: Review },
{ path: '/review/detail/task/:taskNum', component: { template: '<div />' } },
{ path: '/review/recall/:taskNum', component: { template: '<div />' } },
],
})
await router.push('/review')
await router.isReady()
const wrapper = mount(Review, {
global: {
plugins: [ElementPlus, router],
// el-tag 在 jsdom + VTU 下 vnode mounted 钩子崩溃(EP 2.8 已知问题),纯视觉组件,stub 掉
stubs: { ElTag: true },
},
})
await flushPromises()
return { wrapper }
}
const openExportDialog = async (wrapper: ReturnType<typeof mount>) => {
const openButton = wrapper.findAll('button').find((b) => b.text().trim() === '导出数据')
expect(openButton).toBeTruthy()
await openButton!.trigger('click')
await flushPromises()
return wrapper.find('.export-confirm-button')
}
it('默认导出全部时间的 Markdown,点击导出后调用接口并触发下载', async () => {
const { wrapper } = await mountReview()
const confirm = await openExportDialog(wrapper)
expect(confirm.exists()).toBe(true)
await confirm.trigger('click')
await flushPromises()
expect(exportRange).toHaveBeenCalledWith({ startDate: undefined, endDate: undefined, format: 'markdown' })
expect(downloadTextFile).toHaveBeenCalledWith(exportResult)
expect(ElMessage.success).toHaveBeenCalledWith('导出完成,文件已开始下载')
// 导出成功后弹窗关闭
expect(wrapper.findComponent(ElDialog).props('modelValue')).toBe(false)
})
it('选择 JSON 格式后按 json 调用导出接口', async () => {
const { wrapper } = await mountReview()
const confirm = await openExportDialog(wrapper)
await wrapper.find('input.el-radio__original[value="json"]').setChecked()
await flushPromises()
await confirm.trigger('click')
await flushPromises()
expect(exportRange).toHaveBeenCalledWith({ startDate: undefined, endDate: undefined, format: 'json' })
expect(downloadTextFile).toHaveBeenCalledWith(exportResult)
})
it('选择指定时间段并选定日期后按闭区间导出', async () => {
const { wrapper } = await mountReview()
const confirm = await openExportDialog(wrapper)
await wrapper.find('input.el-radio__original[value="range"]').setChecked()
await flushPromises()
// jsdom 下无法真实操作日期面板,通过日期选择器的 v-model 事件模拟用户选定区间
wrapper.findComponent(ElDatePicker).vm.$emit('update:modelValue', ['2026-01-01', '2026-01-31'])
await flushPromises()
await confirm.trigger('click')
await flushPromises()
expect(exportRange).toHaveBeenCalledWith({
startDate: '2026-01-01',
endDate: '2026-01-31',
format: 'markdown',
})
expect(downloadTextFile).toHaveBeenCalledWith(exportResult)
})
it('选了「指定时间段」但没选日期时提示并中止,不调用接口', async () => {
const { wrapper } = await mountReview()
const confirm = await openExportDialog(wrapper)
await wrapper.find('input.el-radio__original[value="range"]').setChecked()
await flushPromises()
// 选「指定时间段」后出现日期选择器
expect(wrapper.find('.export-date-picker').exists()).toBe(true)
await confirm.trigger('click')
await flushPromises()
expect(ElMessage.warning).toHaveBeenCalledWith('请先选择要导出的时间段')
expect(exportRange).not.toHaveBeenCalled()
expect(downloadTextFile).not.toHaveBeenCalled()
})
it('接口返回空数据时提示没有可导出的内容,不触发下载', async () => {
vi.mocked(exportRange).mockResolvedValue({ code: 200, data: undefined as never })
const { wrapper } = await mountReview()
const confirm = await openExportDialog(wrapper)
await confirm.trigger('click')
await flushPromises()
expect(downloadTextFile).not.toHaveBeenCalled()
expect(ElMessage.warning).toHaveBeenCalledWith('没有可导出的学习数据')
})
})
+64
View File
@@ -0,0 +1,64 @@
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { downloadTextFile } from '@/utils/download'
/**
* downloadTextFile 是唯一直接调用 DOM / URL 下载 API 的地方,
* 这里把 URL 与 <a> 的点击收敛到测试替身,验证 Blob 与下载文件名。
*/
describe('downloadTextFile', () => {
const originalCreateObjectURL = URL.createObjectURL
const originalRevokeObjectURL = URL.revokeObjectURL
let createObjectURL: ReturnType<typeof vi.fn>
let revokeObjectURL: ReturnType<typeof vi.fn>
let clickedLinks: HTMLAnchorElement[]
beforeEach(() => {
createObjectURL = vi.fn(() => 'blob:mock-url')
revokeObjectURL = vi.fn()
URL.createObjectURL = createObjectURL as unknown as typeof URL.createObjectURL
URL.revokeObjectURL = revokeObjectURL as unknown as typeof URL.revokeObjectURL
clickedLinks = []
// jsdom 未实现锚点导航,拦截 click 只记录被点击的临时链接
vi.spyOn(HTMLElement.prototype, 'click').mockImplementation(function (this: HTMLElement) {
if (this instanceof HTMLAnchorElement) {
clickedLinks.push(this)
}
})
})
afterEach(() => {
vi.restoreAllMocks()
URL.createObjectURL = originalCreateObjectURL
URL.revokeObjectURL = originalRevokeObjectURL
document.body.innerHTML = ''
})
it('把导出内容包成 Blob 并用接口返回的文件名触发下载', () => {
downloadTextFile({
fileName: 'LPT-学习数据-20261009-1130.md',
contentType: 'text/markdown; charset=UTF-8',
content: '# 学习数据',
})
expect(createObjectURL).toHaveBeenCalledTimes(1)
const blob = createObjectURL.mock.calls[0][0] as Blob
expect(blob).toBeInstanceOf(Blob)
// Blob 会把 charset 规整为小写,这里只校验类型与字符集语义
expect(blob.type.toLowerCase()).toBe('text/markdown; charset=utf-8')
expect(clickedLinks).toHaveLength(1)
expect(clickedLinks[0].download).toBe('LPT-学习数据-20261009-1130.md')
expect(clickedLinks[0].href).toBe('blob:mock-url')
})
it('下载触发后释放对象 URL 并移除临时链接', () => {
downloadTextFile({
fileName: 'LPT-学习数据.json',
contentType: 'application/json; charset=UTF-8',
content: '{"ok":true}',
})
expect(revokeObjectURL).toHaveBeenCalledWith('blob:mock-url')
expect(document.querySelector('a')).toBeNull()
})
})
+29
View File
@@ -0,0 +1,29 @@
import request from "@/utils/request";
export type ExportFormat = "markdown" | "json";
export interface ExportResult {
fileName: string;
contentType: string;
content: string;
}
/** 导出单个学习任务的全部学习数据 */
export const exportTask = (taskNum: string, format: ExportFormat) => {
return request.get<ExportResult>(`/export/task/${taskNum}`, { format });
};
/**
* 按时间范围导出学习数据;起止日期都可省略,都省略表示导出全部,日期为闭区间。
* 未填写的日期不进入 query,避免后端把空串当成筛选条件。
*/
export const exportRange = (params: {
startDate?: string;
endDate?: string;
format: ExportFormat;
}) => {
const query: Record<string, string> = { format: params.format };
if (params.startDate) query.startDate = params.startDate;
if (params.endDate) query.endDate = params.endDate;
return request.get<ExportResult>("/export/range", query);
};
+110
View File
@@ -1,10 +1,13 @@
<script setup lang="ts">
import { computed, onMounted, ref } from "vue";
import { useRouter } from "vue-router";
import { ElMessage } from "element-plus";
import {
getReviewTaskStats,
type ReviewTaskStats,
} from "@/api/review";
import { exportRange, type ExportFormat } from "@/api/export";
import { downloadTextFile } from "@/utils/download";
const router = useRouter();
@@ -12,6 +15,12 @@ const loading = ref(false);
const loadFailed = ref(false);
const tasks = ref<ReviewTaskStats[]>([]);
const exportDialogVisible = ref(false);
const exportScope = ref<"all" | "range">("all");
const exportDateRange = ref<[string, string] | null>(null);
const exportFormat = ref<ExportFormat>("markdown");
const exporting = ref(false);
const summary = computed(() => ({
totalTasks: tasks.value.length,
totalReports: tasks.value.reduce((acc, item) => acc + Number(item.reportCount || 0), 0),
@@ -46,6 +55,42 @@ const openTaskReview = (row: ReviewTaskStats) => {
router.push(`/review/detail/task/${encodeURIComponent(row.taskNum)}`);
};
const openExportDialog = () => {
exportScope.value = "all";
exportDateRange.value = null;
exportFormat.value = "markdown";
exportDialogVisible.value = true;
};
const confirmExport = async () => {
let startDate: string | undefined;
let endDate: string | undefined;
if (exportScope.value === "range") {
const range = exportDateRange.value;
if (!range || !range[0] || !range[1]) {
ElMessage.warning("请先选择要导出的时间段");
return;
}
[startDate, endDate] = range;
}
exporting.value = true;
try {
const res = await exportRange({ startDate, endDate, format: exportFormat.value });
const result = res?.data;
if (!result) {
ElMessage.warning("没有可导出的学习数据");
return;
}
downloadTextFile(result);
exportDialogVisible.value = false;
ElMessage.success("导出完成,文件已开始下载");
} catch {
// 请求层已提示具体错误,这里只结束 loading
} finally {
exporting.value = false;
}
};
onMounted(() => {
loadTasks();
});
@@ -55,6 +100,7 @@ onMounted(() => {
<section class="review-page">
<div class="page-toolbar">
<el-button :loading="loading" @click="loadTasks">刷新</el-button>
<el-button type="success" plain @click="openExportDialog">导出数据</el-button>
</div>
<div class="summary-grid">
@@ -116,6 +162,48 @@ onMounted(() => {
<el-button type="success" plain @click="loadTasks">重新加载</el-button>
</el-empty>
<el-empty v-else-if="!loading && tasks.length === 0" description="暂无复习任务" />
<el-dialog v-model="exportDialogVisible" title="导出学习数据" width="480px">
<div class="export-form">
<div class="export-field">
<span class="export-label">导出范围</span>
<el-radio-group v-model="exportScope">
<el-radio value="all">全部时间</el-radio>
<el-radio value="range">指定时间段</el-radio>
</el-radio-group>
</div>
<div v-if="exportScope === 'range'" class="export-field">
<span class="export-label">时间段</span>
<el-date-picker
v-model="exportDateRange"
class="export-date-picker"
type="daterange"
value-format="YYYY-MM-DD"
range-separator="至"
start-placeholder="开始日期"
end-placeholder="结束日期"
/>
</div>
<div class="export-field">
<span class="export-label">导出格式</span>
<el-radio-group v-model="exportFormat">
<el-radio value="markdown">Markdown</el-radio>
<el-radio value="json">JSON</el-radio>
</el-radio-group>
</div>
</div>
<template #footer>
<el-button @click="exportDialogVisible = false">取消</el-button>
<el-button
class="export-confirm-button"
type="success"
:loading="exporting"
@click="confirmExport"
>
{{ exporting ? "正在准备导出…" : "导出" }}
</el-button>
</template>
</el-dialog>
</section>
</template>
@@ -129,6 +217,28 @@ onMounted(() => {
.page-toolbar {
display: flex;
justify-content: flex-end;
gap: 8px;
}
.export-form {
display: flex;
flex-direction: column;
gap: 18px;
}
.export-field {
display: flex;
flex-direction: column;
gap: 8px;
}
.export-label {
font-size: 13px;
color: var(--text-secondary);
}
.export-date-picker {
width: 100%;
}
.summary-grid {
+76
View File
@@ -10,6 +10,8 @@ import {
import { getSessionDetail } from "@/api/studySessions";
import type { SessionDetail } from "@/api/studySessions";
import { updateFragments } from "@/api/reportFragments";
import { exportTask, type ExportFormat } from "@/api/export";
import { downloadTextFile } from "@/utils/download";
import { formatRatio } from "@/utils/format";
import { ElMessage } from "element-plus";
import MarkdownRenderer from "@/components/MarkdownRenderer.vue";
@@ -44,6 +46,10 @@ const isEditing = ref(false);
const editContent = ref("");
const saving = ref(false);
const exportDialogVisible = ref(false);
const exportFormat = ref<ExportFormat>("markdown");
const exporting = ref(false);
const sessionInfo = ref<SessionDetail | null>(null);
const taskSessions = ref<{
@@ -156,6 +162,35 @@ const enterEdit = () => {
isEditing.value = true;
};
const openExportDialog = () => {
exportFormat.value = "markdown";
exportDialogVisible.value = true;
};
const confirmExport = async () => {
const tn = taskNum.value;
if (!tn) {
ElMessage.warning("暂时无法确定要导出的任务");
return;
}
exporting.value = true;
try {
const res = await exportTask(tn, exportFormat.value);
const result = res?.data;
if (!result) {
ElMessage.warning("没有可导出的学习数据");
return;
}
downloadTextFile(result);
exportDialogVisible.value = false;
ElMessage.success("导出完成,文件已开始下载");
} catch {
// 请求层已提示具体错误,这里只结束 loading
} finally {
exporting.value = false;
}
};
const cancelEdit = () => {
isEditing.value = false;
editContent.value = "";
@@ -237,6 +272,15 @@ watch(
>
回忆复习
</el-button>
<el-button
v-if="taskNum"
type="success"
plain
size="small"
@click="openExportDialog"
>
导出该任务
</el-button>
</div>
<div v-if="sessionInfo" class="session-stats">
<span>实际:{{ formatDuration(sessionInfo.actualTime) }}</span>
@@ -307,6 +351,27 @@ watch(
</div>
</div>
</article>
<el-dialog v-model="exportDialogVisible" title="导出该任务" width="400px">
<div class="export-field">
<span class="export-label">导出格式</span>
<el-radio-group v-model="exportFormat">
<el-radio value="markdown">Markdown</el-radio>
<el-radio value="json">JSON</el-radio>
</el-radio-group>
</div>
<template #footer>
<el-button @click="exportDialogVisible = false">取消</el-button>
<el-button
class="export-confirm-button"
type="success"
:loading="exporting"
@click="confirmExport"
>
{{ exporting ? "正在准备导出…" : "导出" }}
</el-button>
</template>
</el-dialog>
</section>
</template>
@@ -474,6 +539,17 @@ watch(
margin-top: 12px;
}
.export-field {
display: flex;
flex-direction: column;
gap: 8px;
}
.export-label {
font-size: 13px;
color: var(--text-secondary);
}
.edit-actions {
display: flex;
justify-content: flex-end;
+14
View File
@@ -0,0 +1,14 @@
import type { ExportResult } from "@/api/export";
/** 触发浏览器下载导出结果:Blob + 临时 <a download>,下载触发后立即释放对象 URL */
export const downloadTextFile = (result: ExportResult): void => {
const blob = new Blob([result.content], { type: result.contentType });
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = result.fileName;
document.body.appendChild(link);
link.click();
document.body.removeChild(link);
URL.revokeObjectURL(url);
};