From 87e4ceab118284cb2e2bdb2dd524f0982886b8b3 Mon Sep 17 00:00:00 2001 From: cat-shark <1716967236@qq.com> Date: Fri, 9 Oct 2026 12:33:17 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A4=8D=E4=B9=A0=E9=A1=B5=E6=94=AF?= =?UTF-8?q?=E6=8C=81=E5=AF=BC=E5=87=BA=E5=AD=A6=E4=B9=A0=E6=95=B0=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/__tests__/api/export.spec.ts | 65 +++++++ .../review-detail-export-flow.spec.ts | 113 +++++++++++++ .../integration/review-export-flow.spec.ts | 160 ++++++++++++++++++ src/__tests__/utils/download.spec.ts | 64 +++++++ src/api/export.ts | 29 ++++ src/components/Review.vue | 110 ++++++++++++ src/components/ReviewDetail.vue | 76 +++++++++ src/utils/download.ts | 14 ++ 8 files changed, 631 insertions(+) create mode 100644 src/__tests__/api/export.spec.ts create mode 100644 src/__tests__/integration/review-detail-export-flow.spec.ts create mode 100644 src/__tests__/integration/review-export-flow.spec.ts create mode 100644 src/__tests__/utils/download.spec.ts create mode 100644 src/api/export.ts create mode 100644 src/utils/download.ts diff --git a/src/__tests__/api/export.spec.ts b/src/__tests__/api/export.spec.ts new file mode 100644 index 0000000..f461e7d --- /dev/null +++ b/src/__tests__/api/export.spec.ts @@ -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', + }) + }) +}) diff --git a/src/__tests__/integration/review-detail-export-flow.spec.ts b/src/__tests__/integration/review-detail-export-flow.spec.ts new file mode 100644 index 0000000..e91fb15 --- /dev/null +++ b/src/__tests__/integration/review-detail-export-flow.spec.ts @@ -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('导出完成,文件已开始下载') + }) +}) diff --git a/src/__tests__/integration/review-export-flow.spec.ts b/src/__tests__/integration/review-export-flow.spec.ts new file mode 100644 index 0000000..c1c2150 --- /dev/null +++ b/src/__tests__/integration/review-export-flow.spec.ts @@ -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: '
' } }, + { path: '/review/recall/:taskNum', component: { template: '
' } }, + ], + }) + 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) => { + 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('没有可导出的学习数据') + }) +}) diff --git a/src/__tests__/utils/download.spec.ts b/src/__tests__/utils/download.spec.ts new file mode 100644 index 0000000..0e9cd59 --- /dev/null +++ b/src/__tests__/utils/download.spec.ts @@ -0,0 +1,64 @@ +import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest' +import { downloadTextFile } from '@/utils/download' + +/** + * downloadTextFile 是唯一直接调用 DOM / URL 下载 API 的地方, + * 这里把 URL 与 的点击收敛到测试替身,验证 Blob 与下载文件名。 + */ +describe('downloadTextFile', () => { + const originalCreateObjectURL = URL.createObjectURL + const originalRevokeObjectURL = URL.revokeObjectURL + let createObjectURL: ReturnType + let revokeObjectURL: ReturnType + 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() + }) +}) diff --git a/src/api/export.ts b/src/api/export.ts new file mode 100644 index 0000000..d81547c --- /dev/null +++ b/src/api/export.ts @@ -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(`/export/task/${taskNum}`, { format }); +}; + +/** + * 按时间范围导出学习数据;起止日期都可省略,都省略表示导出全部,日期为闭区间。 + * 未填写的日期不进入 query,避免后端把空串当成筛选条件。 + */ +export const exportRange = (params: { + startDate?: string; + endDate?: string; + format: ExportFormat; +}) => { + const query: Record = { format: params.format }; + if (params.startDate) query.startDate = params.startDate; + if (params.endDate) query.endDate = params.endDate; + return request.get("/export/range", query); +}; diff --git a/src/components/Review.vue b/src/components/Review.vue index 648ef2a..0ba8545 100644 --- a/src/components/Review.vue +++ b/src/components/Review.vue @@ -1,10 +1,13 @@