feat: 复习总览分页、全局汇总与按标签复习 Tab

This commit is contained in:
2026-10-22 22:01:10 +08:00
parent 4c762647bb
commit ca89b74de1
19 changed files with 1727 additions and 280 deletions
+117 -7
View File
@@ -1,8 +1,18 @@
import { test, expect } from '@playwright/test';
/** 后端分页形状:列表接口都返回 { records, total, ... } */
const pageOf = (records: unknown[], total = records.length) => ({
records,
total,
size: records.length || 20,
current: 1,
pages: total === 0 ? 0 : 1,
});
const mockTasksData = {
code: 200,
data: [
data: pageOf(
[
{
taskNum: 'T001',
taskName: '学习 Vue3',
@@ -17,10 +27,19 @@ const mockTasksData = {
fragmentCount: 2,
effectiveTime: 4500,
},
],
],
45,
),
};
const mockTasksEmpty = { code: 200, data: [] };
const mockTasksEmpty = { code: 200, data: pageOf([]) };
const mockFeed = { code: 200, data: [] };
const mockTagMaps = { code: 200, data: pageOf([]) };
const mockEmptyList = { code: 200, data: [] };
const mockEmptyMap = { code: 200, data: {} };
const mockSortPreference = {
code: 200,
data: { preset: 'TIME_FIRST', description: '久未接触的更容易出现' },
};
test.describe('Review page', () => {
test.beforeEach(async ({ page }) => {
@@ -34,6 +53,34 @@ test.describe('Review page', () => {
await page.route('**/api/review/feed**', (route) =>
route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify(mockFeed) }),
);
await page.route('**/api/review/tag-mind-map/list**', (route) =>
route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify(mockTagMaps) }),
);
// 总览还会取排序偏好、任务标记与待归类;不拦住这些请求就会打到真实后端并 401,
// 401 处理会清掉登录标记并跳回 /login,用例与真实后端状态耦合。
await page.route('**/api/review/sort-preference**', (route) =>
route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify(mockSortPreference) }),
);
await page.route('**/api/markers/batch**', (route) =>
route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify(mockEmptyMap) }),
);
await page.route('**/api/report-fragments/pending-ownership**', (route) =>
route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify(mockEmptyList) }),
);
await page.route('**/api/review/summary**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 200, data: { taskTotal: 45, reportTotal: 4, fragmentTotal: 7 } }),
}),
);
await page.route('**/api/tasks/options**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 200, data: [{ taskNum: 'T001', taskName: '学习 Vue3' }] }),
}),
);
await page.goto('/login');
await page.evaluate(() => localStorage.setItem('isLoggedIn', 'true'));
@@ -42,16 +89,76 @@ test.describe('Review page', () => {
});
test('displays summary metrics and task list', async ({ page }) => {
await expect(page.locator('.metric-card')).toHaveCount(3);
// Check metric values
await expect(page.locator('.metric-card').first().locator('strong')).toContainText('2');
// 指标收成一行紧凑统计条,不再占三张卡片
// 汇总走独立接口:数字是全量口径(45 个任务),不是分页后本页的 2 条
const stats = page.locator('.page-stats');
await expect(stats).toContainText('任务 45');
await expect(stats).toContainText('学习报告 4');
await expect(stats).toContainText('学习残片 7');
// 两个模块同位置分 Tab,Tab 上带条数
await expect(page.getByRole('tab')).toHaveCount(2)
await expect(page.getByRole('tab', { name: /按任务复习/ })).toContainText('45')
await expect(page.getByRole('tab', { name: /按标签复习/ })).toBeVisible()
// 任务以卡片列表展示(不再是 el-table)
await expect(page.locator('.task-card')).toHaveCount(2);
await expect(page.getByText('学习 Vue3')).toBeVisible();
await expect(page.getByRole('button', { name: '回忆复习' })).toHaveCount(2);
});
test('切到按标签复习:写入 URL 并懒加载该 Tab 的内容', async ({ page }) => {
await page.getByRole('tab', { name: /按标签复习/ }).click()
await expect(page).toHaveURL(/tab=tag/)
await expect(page.getByText('已生成的标签导图')).toBeVisible()
// 刷新后仍落在标签 Tab(URL 即状态)
await page.reload()
await expect(page.getByText('已生成的标签导图')).toBeVisible()
});
test('任务超过一页时出现分页,翻页会带上页号', async ({ page }) => {
const requested: string[] = []
await page.route('**/api/review/tasks**', (route) => {
requested.push(route.request().url())
const isSecondPage = route.request().url().includes('pageNum=2')
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 200,
data: { ...pageOf(mockTasksData.data.records as unknown[], 45), current: isSecondPage ? 2 : 1 },
}),
})
})
await page.goto('/review')
await page.waitForSelector('.task-card')
const pagination = page.locator('.list-pagination')
await expect(pagination).toBeVisible()
await pagination.locator('.btn-next').click()
await expect.poll(() => requested.some((url) => url.includes('pageNum=2'))).toBe(true)
});
test('低频操作收进「更多」菜单', async ({ page }) => {
await expect(page.getByRole('button', { name: '更多操作' })).toBeVisible();
// 刷新已移除;导出与标签管理不在页面上平铺
await expect(page.getByRole('button', { name: '刷新' })).toHaveCount(0);
await expect(page.getByRole('button', { name: '导出数据' })).toHaveCount(0);
await page.getByRole('button', { name: '更多操作' }).click();
await expect(page.getByRole('menuitem', { name: '导出学习数据' })).toBeVisible();
await expect(page.getByRole('menuitem', { name: '标签管理' })).toBeVisible();
await expect(page.getByRole('menuitem', { name: '智能排序偏好' })).toBeVisible();
});
test('shows empty state when no tasks', async ({ page }) => {
await page.route('**/api/review/summary**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 200, data: { taskTotal: 0, reportTotal: 0, fragmentTotal: 0 } }),
}),
);
await page.route('**/api/review/tasks**', (route) =>
route.fulfill({
status: 200,
@@ -62,8 +169,11 @@ test.describe('Review page', () => {
await page.goto('/review');
await page.waitForSelector('.review-page', { timeout: 10_000 });
await expect(page.locator('.metric-card').first().locator('strong')).toContainText('0');
// 三个 0 不承载信息:统计条收起,而不是显示「任务 0」
await expect(page.locator('.page-stats')).toHaveCount(0);
await expect(page.getByText('暂无复习任务')).toBeVisible();
// 空态必须有下一步动作
await expect(page.getByRole('button', { name: '新建学习任务' })).toBeVisible();
});
test('接口失败时提示加载失败而不是显示空列表', async ({ page }) => {
+14 -3
View File
@@ -51,10 +51,21 @@ describe('review API', () => {
expect(mockedRequest.get).toHaveBeenCalledWith('/review/feed', { limit: 50, mode: 'random' })
})
it('getReviewTaskStats calls GET /review/tasks', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: [] })
it('getReviewTaskStats 分页请求 /review/tasks,并支持带标签筛选', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: { records: [], total: 0 } })
await getReviewTaskStats(2, 20, '英语')
// 筛选下推到服务端,否则客户端只能筛当前页、总数也不对
expect(mockedRequest.get).toHaveBeenCalledWith('/review/tasks', {
pageNum: 2,
pageSize: 20,
markerName: '英语',
})
})
it('getReviewTaskStats 默认第一页、不带筛选参数', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: { records: [], total: 0 } })
await getReviewTaskStats()
expect(mockedRequest.get).toHaveBeenCalledWith('/review/tasks')
expect(mockedRequest.get).toHaveBeenCalledWith('/review/tasks', { pageNum: 1, pageSize: 20 })
})
it('getReviewTaskStatsByTask calls GET /review/tasks/:taskNum', async () => {
+10 -1
View File
@@ -10,7 +10,7 @@ vi.mock('@/utils/request', () => ({
}))
import request from '@/utils/request'
import { listTagRecallRecords, queryTagMindMap, updateTagMindMap } from '@/api/tagMindMap'
import { listTagMindMaps, listTagRecallRecords, queryTagMindMap, updateTagMindMap } from '@/api/tagMindMap'
const mockedRequest = vi.mocked(request)
@@ -38,6 +38,15 @@ describe('tagMindMap API(闭环-04)', () => {
})
})
it('listTagMindMaps 分页拉取已有导图列表', async () => {
mockedRequest.get.mockResolvedValue({ code: 200, data: { records: [], total: 0 } })
await listTagMindMaps(3, 20)
expect(mockedRequest.get).toHaveBeenCalledWith('/review/tag-mind-map/list', {
pageNum: 3,
pageSize: 20,
})
})
it('listTagRecallRecords 按范围取回忆记录', async () => {
mockedRequest.post.mockResolvedValue({ code: 200, data: [] })
await listTagRecallRecords(['英语'], 'UNION')
+98 -12
View File
@@ -3,12 +3,16 @@ import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import Review from '@/components/Review.vue'
import { getReviewTaskStats } from '@/api/review'
import { getReviewSummary, getReviewTaskStats } from '@/api/review'
import { getPendingOwnershipFragments } from '@/api/reportFragments'
import { filterByMarker, getMarkersBatch, listDictionaryTags, createDictionaryTag, deleteDictionaryTag, renameDictionaryTag } from '@/api/markers'
import { listTagMindMaps } from '@/api/tagMindMap'
import { listTaskOptions } from '@/api/tasks'
import { pageOf } from '../support/page'
import { getMarkersBatch, listDictionaryTags, createDictionaryTag, deleteDictionaryTag, renameDictionaryTag } from '@/api/markers'
vi.mock('@/api/review', () => ({
getReviewTaskStats: vi.fn(),
getReviewSummary: vi.fn(),
getSortPreference: vi.fn(),
saveSortPreference: vi.fn(),
}))
@@ -36,6 +40,14 @@ vi.mock('@/api/export', () => ({
exportRange: vi.fn(),
}))
vi.mock('@/api/tagMindMap', () => ({
listTagMindMaps: vi.fn(),
}))
vi.mock('@/api/tasks', () => ({
listTaskOptions: vi.fn(),
}))
const task = (taskNum: string, taskName: string) => ({
taskNum,
taskName,
@@ -48,7 +60,10 @@ const task = (taskNum: string, taskName: string) => ({
const mountReview = async (query: Record<string, string> = {}) => {
const testRouter = createRouter({
history: createMemoryHistory(),
routes: [{ path: '/review', component: Review }],
routes: [
{ path: '/review', component: Review },
{ path: '/review/by-tag', component: { template: '<div />' } },
],
})
await testRouter.push({ path: '/review', query })
await testRouter.isReady()
@@ -63,22 +78,95 @@ beforeEach(() => {
vi.clearAllMocks()
vi.mocked(getReviewTaskStats).mockResolvedValue({
code: 200,
data: [task('T1', '英语任务'), task('T2', '数学任务')],
data: pageOf([task('T1', '英语任务'), task('T2', '数学任务')]),
} as never)
// 汇总走独立接口:全量口径,不由分页后的列表相加
vi.mocked(getReviewSummary).mockResolvedValue({
code: 200,
data: { taskTotal: 2, reportTotal: 2, fragmentTotal: 4 },
} as never)
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({ code: 200, data: [] } as never)
vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: {} } as never)
vi.mocked(listDictionaryTags).mockResolvedValue({ code: 200, data: [] } as never)
vi.mocked(listTagMindMaps).mockResolvedValue({ code: 200, data: pageOf([]) } as never)
vi.mocked(listTaskOptions).mockResolvedValue({ code: 200, data: [] } as never)
})
/**
* 「更多」是 el-dropdown:菜单渲染在 Teleport 的 popper 里,jsdom 下 VTU 拿不到
* (与 el-tag 同类的 EP 2.8 兼容问题),因此直接触发组件的 command 事件,
* 这仍然走 handleMoreCommand 的真实分支。
*/
const clickMoreItem = async (wrapper: any, command: string) => {
const dropdown = wrapper.findComponent({ name: 'ElDropdown' })
expect(dropdown.exists()).toBe(true)
dropdown.vm.$emit('command', command)
await flushPromises()
}
describe('Review 页面结构:按任务 / 按标签两个 Tab', () => {
it('两个模块同位置分 Tab,低频操作收进「更多」,不再有刷新按钮', async () => {
const { wrapper } = await mountReview()
const tabs = wrapper.findAll('[role="tab"]')
expect(tabs).toHaveLength(2)
expect(tabs[0].text()).toContain('按任务复习')
expect(tabs[1].text()).toContain('按标签复习')
// 刷新已移除:进入页面即加载,重载由空/错态的重试承担
expect(wrapper.findAll('button').some((b) => b.text().trim() === '刷新')).toBe(false)
// 导出与标签管理不再平铺在工具栏
expect(wrapper.findAll('button').some((b) => b.text().trim() === '导出数据')).toBe(false)
expect(wrapper.findAll('button').some((b) => b.text().includes('更多'))).toBe(true)
wrapper.unmount()
})
it('按标签复习 Tab 列出已生成的导图,点行进入该范围的复习(URL 即状态)', async () => {
vi.mocked(listTagMindMaps).mockResolvedValue({
code: 200,
data: pageOf([
{
id: 1,
scopeKey: 'S1',
tags: ['英语', '时态'],
mode: 'INTERSECT',
title: '英语时态',
generator: 'AI',
sourceFragmentCount: 4,
needsUpdate: true,
generatedTime: '2026-10-10T10:00:00',
},
]),
} as never)
const { wrapper, testRouter } = await mountReview()
// 切到标签 Tab 才会加载它的列表
const tagTab = wrapper.findAll('[role="tab"]').find((t) => t.text().includes('按标签复习'))
await tagTab!.trigger('click')
await flushPromises()
expect(wrapper.text()).toContain('英语时态')
expect(wrapper.text()).toContain('有新碎片待整理')
await wrapper.find('.map-row').trigger('click')
await flushPromises()
expect(testRouter.currentRoute.value.path).toBe('/review/by-tag')
expect(testRouter.currentRoute.value.query).toMatchObject({ tag: ['英语', '时态'], mode: 'INTERSECT' })
wrapper.unmount()
})
})
describe('Review 按标签筛选(闭环-01 跳转入口)', () => {
it('带 markerName 进入时按该标签筛选任务', async () => {
vi.mocked(filterByMarker).mockResolvedValue({ code: 200, data: ['T1'] } as never)
it('带 markerName 进入时把筛选下推给服务端', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf([task('T1', '英语任务')]) } as never)
const { wrapper } = await mountReview({ markerName: '英语' })
expect(filterByMarker).toHaveBeenCalledWith({ objectType: 'TASK', markerName: '英语', kind: 'USER' })
// 筛选在服务端做(否则只能筛当前页、total 也不对)
expect(getReviewTaskStats).toHaveBeenCalledWith(1, 20, '英语')
expect(wrapper.text()).toContain('正在按标签「英语」筛选任务')
expect(wrapper.text()).toContain('英语任务')
expect(wrapper.text()).not.toContain('数学任务')
wrapper.unmount()
})
@@ -86,7 +174,7 @@ describe('Review 按标签筛选(闭环-01 跳转入口)', () => {
it('不带 markerName 进入时不筛选', async () => {
const { wrapper } = await mountReview()
expect(filterByMarker).not.toHaveBeenCalled()
expect(getReviewTaskStats).toHaveBeenCalledWith(1, 20, undefined)
expect(wrapper.text()).toContain('数学任务')
wrapper.unmount()
@@ -95,9 +183,7 @@ describe('Review 按标签筛选(闭环-01 跳转入口)', () => {
describe('Review 标签管理:字典(闭环-03)', () => {
const openTagDialog = async (wrapper: any) => {
const button = wrapper.findAll('button').find((b: { text: () => string }) => b.text().includes('标签管理'))
await button!.trigger('click')
await flushPromises()
await clickMoreItem(wrapper, 'tags')
}
it('可提前新建空标签,并展示字典项', async () => {
+8 -3
View File
@@ -3,7 +3,8 @@ import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import Welcome from '@/components/Welcome.vue'
import { getReviewFeed, getReviewTaskStats, submitReviewFeedback, touchReviewFragment } from '@/api/review'
import { getReviewFeed, submitReviewFeedback, touchReviewFragment } from '@/api/review'
import { listTaskOptions } from '@/api/tasks'
import { getMarkersBatch } from '@/api/markers'
import { updateFragmentOwnership } from '@/api/reportFragments'
import appRouter from '@/router'
@@ -17,6 +18,10 @@ vi.mock('@/api/review', () => ({
touchReviewFragment: vi.fn(),
}))
vi.mock('@/api/tasks', () => ({
listTaskOptions: vi.fn(),
}))
vi.mock('@/api/markers', () => ({
getMarkersBatch: vi.fn(),
addUserTag: vi.fn(),
@@ -276,7 +281,7 @@ describe('Welcome Feed 待归类内容', () => {
beforeEach(() => {
vi.clearAllMocks()
stubLayout(4000, 1000)
vi.mocked(getReviewTaskStats).mockResolvedValue({
vi.mocked(listTaskOptions).mockResolvedValue({
code: 200,
data: [
{ taskNum: 'T002', taskName: 'TypeScript 类型体操' },
@@ -307,7 +312,7 @@ describe('Welcome Feed 待归类内容', () => {
await flushPromises()
expect(wrapper.text()).toContain('归类这条学习残片')
expect(getReviewTaskStats).toHaveBeenCalled()
expect(listTaskOptions).toHaveBeenCalled()
wrapper.findComponent({ name: 'ElSelect' }).vm.$emit('update:modelValue', 'T002')
await flushPromises()
@@ -0,0 +1,101 @@
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { defineComponent, h, ref, type Ref } from 'vue'
import { mount } from '@vue/test-utils'
import { useDelayedVisible } from '@/components/composables/useDelayedVisible'
/** 挂一个空组件,让 composable 有组件实例可挂 onUnmounted */
const mountProbe = (loading: Ref<boolean>, options?: { delayMs?: number; minVisibleMs?: number }) => {
const result: { visible: Ref<boolean> | null } = { visible: null }
const wrapper = mount(
defineComponent({
setup() {
result.visible = useDelayedVisible(loading, options)
return () => h('div')
},
}),
)
return { wrapper, visible: result.visible as unknown as Ref<boolean> }
}
describe('useDelayedVisible(骨架延迟显示 + 最短可见)', () => {
beforeEach(() => {
vi.useFakeTimers()
})
afterEach(() => {
vi.useRealTimers()
})
it('快响应(未到延迟)不显示,避免一闪而过', async () => {
const loading = ref(false)
const { wrapper, visible } = mountProbe(loading, { delayMs: 200, minVisibleMs: 400 })
loading.value = true
await vi.advanceTimersByTimeAsync(100)
loading.value = false
await vi.advanceTimersByTimeAsync(1000)
expect(visible.value).toBe(false)
wrapper.unmount()
})
it('加载超过延迟才显示', async () => {
const loading = ref(false)
const { wrapper, visible } = mountProbe(loading, { delayMs: 200, minVisibleMs: 400 })
loading.value = true
await vi.advanceTimersByTimeAsync(150)
expect(visible.value).toBe(false)
await vi.advanceTimersByTimeAsync(100)
expect(visible.value).toBe(true)
loading.value = false
await vi.advanceTimersByTimeAsync(400)
wrapper.unmount()
})
it('显示后哪怕马上下载完,也至少留够最短可见时间', async () => {
const loading = ref(false)
const { wrapper, visible } = mountProbe(loading, { delayMs: 200, minVisibleMs: 400 })
loading.value = true
await vi.advanceTimersByTimeAsync(250)
expect(visible.value).toBe(true)
// 刚显示 100ms 就结束:仍要保持显示
loading.value = false
await vi.advanceTimersByTimeAsync(100)
expect(visible.value).toBe(true)
await vi.advanceTimersByTimeAsync(400)
expect(visible.value).toBe(false)
wrapper.unmount()
})
it('最短可见期间又开始加载:保持显示,不重排', async () => {
const loading = ref(false)
const { wrapper, visible } = mountProbe(loading, { delayMs: 200, minVisibleMs: 400 })
loading.value = true
await vi.advanceTimersByTimeAsync(250)
loading.value = false
await vi.advanceTimersByTimeAsync(100)
loading.value = true
await vi.advanceTimersByTimeAsync(1000)
expect(visible.value).toBe(true)
wrapper.unmount()
})
it('卸载时清理定时器,不再改动状态', async () => {
const loading = ref(false)
const { wrapper, visible } = mountProbe(loading, { delayMs: 200, minVisibleMs: 400 })
loading.value = true
wrapper.unmount()
await vi.advanceTimersByTimeAsync(1000)
expect(visible.value).toBe(false)
})
})
@@ -3,14 +3,17 @@ 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 { getReviewSummary, getReviewTaskStats } from '@/api/review'
import { getMarkersBatch } from '@/api/markers'
import { getPendingOwnershipFragments } from '@/api/reportFragments'
import { listTagMindMaps } from '@/api/tagMindMap'
import { pageOf } from '../support/page'
import { exportRange } from '@/api/export'
import { downloadTextFile } from '@/utils/download'
vi.mock('@/api/review', () => ({
getReviewTaskStats: vi.fn(),
getReviewSummary: vi.fn(),
getReviewFeed: vi.fn(),
getTaskReview: vi.fn(),
getSortPreference: vi.fn(),
@@ -31,6 +34,10 @@ vi.mock('@/api/reportFragments', () => ({
updateFragmentOwnership: vi.fn(),
}))
vi.mock('@/api/tagMindMap', () => ({
listTagMindMaps: vi.fn(),
}))
vi.mock('@/api/export', () => ({
exportTask: vi.fn(),
exportRange: vi.fn(),
@@ -68,6 +75,11 @@ describe('Review 导出流程(集成)', () => {
vi.mocked(getMarkersBatch).mockResolvedValue({ code: 200, data: {} } as never)
vi.mocked(exportRange).mockResolvedValue({ code: 200, data: exportResult })
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({ code: 200, data: [] } as never)
vi.mocked(listTagMindMaps).mockResolvedValue({ code: 200, data: pageOf([]) } as never)
vi.mocked(getReviewSummary).mockResolvedValue({
code: 200,
data: { taskTotal: 1, reportTotal: 3, fragmentTotal: 5 },
} as never)
})
const mountReview = async () => {
@@ -93,10 +105,14 @@ describe('Review 导出流程(集成)', () => {
return { wrapper }
}
/**
* 导出已收进页面右上角的「更多」菜单。菜单渲染在 Teleport 的 popper 里,
* jsdom 下 VTU 拿不到(与 el-tag 同类的 EP 2.8 兼容问题),因此直接触发 command 事件。
*/
const openExportDialog = async (wrapper: ReturnType<typeof mount>) => {
const openButton = wrapper.findAll('button').find((b) => b.text().trim() === '导出数据')
expect(openButton).toBeTruthy()
await openButton!.trigger('click')
const dropdown = wrapper.findComponent({ name: 'ElDropdown' })
expect(dropdown.exists()).toBe(true)
dropdown.vm.$emit('command', 'export')
await flushPromises()
return wrapper.find('.export-confirm-button')
}
@@ -3,12 +3,16 @@ import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import Review from '@/components/Review.vue'
import { getReviewTaskStats, getSortPreference, saveSortPreference } from '@/api/review'
import { filterByMarker, getMarkersBatch, getUserTagUsage, renameUserTag } from '@/api/markers'
import { getReviewSummary, getReviewTaskStats, getSortPreference, saveSortPreference } from '@/api/review'
import { getMarkersBatch, getUserTagUsage, renameUserTag } from '@/api/markers'
import { getPendingOwnershipFragments, updateFragmentOwnership } from '@/api/reportFragments'
import { listTagMindMaps } from '@/api/tagMindMap'
import { listTaskOptions } from '@/api/tasks'
import { pageOf } from '../support/page'
vi.mock('@/api/review', () => ({
getReviewTaskStats: vi.fn(),
getReviewSummary: vi.fn(),
getReviewFeed: vi.fn(),
getTaskReview: vi.fn(),
getSortPreference: vi.fn(),
@@ -29,6 +33,14 @@ vi.mock('@/api/reportFragments', () => ({
updateFragmentOwnership: vi.fn(),
}))
vi.mock('@/api/tagMindMap', () => ({
listTagMindMaps: vi.fn(),
}))
vi.mock('@/api/tasks', () => ({
listTaskOptions: vi.fn(),
}))
const tasks = [
{
taskNum: 'T001',
@@ -61,18 +73,33 @@ describe('Review 交互流程(集成)', () => {
code: 200,
data: { preset: 'TIME_FIRST', description: '久未接触的更容易出现' },
} as never)
vi.mocked(listTagMindMaps).mockResolvedValue({ code: 200, data: pageOf([]) } as never)
vi.mocked(listTaskOptions).mockResolvedValue({ code: 200, data: [] } as never)
vi.mocked(getReviewSummary).mockResolvedValue({
code: 200,
data: { taskTotal: 2, reportTotal: 4, fragmentTotal: 7 },
} as never)
})
const mountReview = async () => {
/** 切 Tab:ElTabs 的 tab-change 由头部点击触发 */
const switchTab = async (wrapper: any, label: string) => {
const tab = wrapper.findAll('[role="tab"]').find((t: any) => t.text().includes(label))
expect(tab).toBeTruthy()
await tab!.trigger('click')
await flushPromises()
}
const mountReview = async (query: Record<string, string> = {}) => {
const router = createRouter({
history: createMemoryHistory(),
routes: [
{ path: '/review', name: 'review', component: Review },
{ path: '/review/by-tag', name: 'review-by-tag', component: { template: '<div />' } },
{ path: '/review/detail/task/:taskNum', name: 'review-detail', component: { template: '<div />' } },
{ path: '/review/recall/:taskNum', name: 'review-recall', component: { template: '<div />' } },
],
})
await router.push('/review')
await router.push({ path: '/review', query })
await router.isReady()
const wrapper = mount(Review, {
@@ -86,8 +113,138 @@ describe('Review 交互流程(集成)', () => {
return { wrapper, router }
}
/**
* 「更多」是 el-dropdown:菜单渲染在 Teleport 的 popper 里,jsdom 下 VTU 拿不到
* (与 el-tag 同类的 EP 2.8 兼容问题),因此直接触发组件的 command 事件,
* 这仍然走 handleMoreCommand 的真实分支。
*/
const clickMoreItem = async (wrapper: any, command: string) => {
const dropdown = wrapper.findComponent({ name: 'ElDropdown' })
expect(dropdown.exists()).toBe(true)
dropdown.vm.$emit('command', command)
await flushPromises()
}
it('首次加载超过延迟时先给同形状骨架,数据到达后替换为真实任务行', async () => {
// 用手动控制的 promise 模拟慢响应
let resolveTasks: (value: unknown) => void = () => {}
vi.mocked(getReviewTaskStats).mockReturnValue(
new Promise((resolve) => {
resolveTasks = resolve
}) as never,
)
// 汇总接口同样拖慢:统计条骨架也是延迟显示的
let resolveSummary: (value: unknown) => void = () => {}
vi.mocked(getReviewSummary).mockReturnValue(
new Promise((resolve) => {
resolveSummary = resolve
}) as never,
)
const { wrapper } = await mountReview()
// 延迟(200ms)未到:不显示骨架,避免本地快响应时闪一下
expect(wrapper.findAll('.task-card-skeleton')).toHaveLength(0)
expect(wrapper.find('.page-stats .skeleton-line').exists()).toBe(false)
// 超过延迟仍未返回:骨架出现,形状与任务行一致(3 行)
await new Promise((resolve) => setTimeout(resolve, 260))
expect(wrapper.findAll('.task-card-skeleton')).toHaveLength(3)
// 统计条也走骨架,避免数据到达后内容下移
expect(wrapper.findAll('.page-stats .skeleton-line')).toHaveLength(3)
resolveTasks({ code: 200, data: pageOf(tasks) })
resolveSummary({ code: 200, data: { taskTotal: 2, reportTotal: 4, fragmentTotal: 7 } })
await flushPromises()
expect(wrapper.findAll('.task-card-skeleton')).toHaveLength(0)
expect(wrapper.findAll('.task-card')).toHaveLength(2)
wrapper.unmount()
})
it('加载完成后才显示统计条真实数值,不再有「先无后有」的空白', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
const stats = wrapper.find('.page-stats')
expect(stats.text()).toContain('任务 2')
expect(stats.find('.skeleton-line').exists()).toBe(false)
wrapper.unmount()
})
it('两个模块同位置分 Tab,首屏只渲染当前 Tab 的列表', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
const tabs = wrapper.findAll('[role="tab"]')
expect(tabs).toHaveLength(2)
expect(tabs[0].text()).toContain('按任务复习')
expect(tabs[0].text()).toContain('2')
expect(tabs[1].text()).toContain('按标签复习')
// 任务列表在当前 Tab 里
expect(wrapper.findAll('.task-card')).toHaveLength(2)
// 另一个 Tab 只探一个条数,不把它的整页也拉下来
expect(listTagMindMaps).toHaveBeenCalledWith(1, 1)
wrapper.unmount()
})
it('任务列表分页:翻页只取该页,并带上页号', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({
code: 200,
data: { records: tasks, total: 45, size: 20, current: 1, pages: 3 },
})
const { wrapper } = await mountReview()
expect(getReviewTaskStats).toHaveBeenCalledWith(1, 20, undefined)
await wrapper.find('.list-pagination .btn-next').trigger('click')
await flushPromises()
expect(getReviewTaskStats).toHaveBeenLastCalledWith(2, 20, undefined)
wrapper.unmount()
})
it('URL 带 tab=tag 时首屏直接落在按标签复习', async () => {
vi.mocked(listTagMindMaps).mockResolvedValue({ code: 200, data: pageOf([]) })
const { wrapper } = await mountReview({ tab: 'tag' })
expect(wrapper.find('[role="tab"][aria-selected="true"]').text()).toContain('按标签复习')
// 任务侧只探一个 size=1 的条数,不拉它的列表页
expect(getReviewTaskStats).toHaveBeenCalledTimes(1)
expect(getReviewTaskStats).toHaveBeenCalledWith(1, 1)
expect(wrapper.findAll('.task-card')).toHaveLength(0)
wrapper.unmount()
})
it('切到按标签复习 Tab 才加载导图列表,点行带范围跳进按标签复习页', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(listTagMindMaps).mockResolvedValue({
code: 200,
data: pageOf([
{
id: 7,
scopeKey: 'S1',
tags: ['英语'],
mode: 'UNION',
title: '英语导图',
generator: 'AI',
sourceFragmentCount: 3,
needsUpdate: false,
generatedTime: '2026-10-10T10:00:00',
},
]),
} as never)
const { wrapper, router } = await mountReview()
await switchTab(wrapper, '按标签复习')
expect(wrapper.text()).toContain('英语导图')
await wrapper.find('.map-row').trigger('click')
await flushPromises()
expect(router.currentRoute.value.path).toBe('/review/by-tag')
expect(router.currentRoute.value.query).toMatchObject({ tag: ['英语'], mode: 'UNION' })
wrapper.unmount()
})
it('点击卡片空白处进入该任务的复习详情', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper, router } = await mountReview()
expect(wrapper.findAll('.task-card')).toHaveLength(2)
@@ -98,7 +255,7 @@ describe('Review 交互流程(集成)', () => {
})
it('键盘 Enter 与 Space 也能进入详情', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper, router } = await mountReview()
await wrapper.findAll('.task-card')[0].trigger('keydown', { key: 'Enter' })
@@ -113,7 +270,7 @@ describe('Review 交互流程(集成)', () => {
})
it('点击「回忆复习」进入回忆页,且不被卡片点击覆盖', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper, router } = await mountReview()
await wrapper.find('.recall-button').trigger('click')
@@ -123,7 +280,7 @@ describe('Review 交互流程(集成)', () => {
})
it('卡片暴露 role 与 aria-label,具备可访问语义', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
const card = wrapper.findAll('.task-card')[0]
@@ -133,7 +290,7 @@ describe('Review 交互流程(集成)', () => {
})
it('卡片并列展示累计有效学习时长与累计复习耗时', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
const text = wrapper.findAll('.task-card')[0].text()
@@ -150,10 +307,30 @@ describe('Review 交互流程(集成)', () => {
expect(wrapper.find('button').exists()).toBe(true)
})
it('已有导图加载失败时给出重试,不与空数据混淆', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(listTagMindMaps).mockRejectedValue({ code: 500, message: '服务异常' })
const { wrapper } = await mountReview()
await switchTab(wrapper, '按标签复习')
expect(wrapper.text()).toContain('已有导图加载失败')
expect(wrapper.text()).not.toContain('还没有标签导图')
vi.mocked(listTagMindMaps).mockResolvedValue({ code: 200, data: pageOf([]) } as never)
const retry = wrapper.findAll('button').find((b) => b.text().includes('重新加载'))
await retry!.trigger('click')
await flushPromises()
// 探条数 + 切 Tab 加载 + 重试
expect(listTagMindMaps).toHaveBeenCalledTimes(3)
expect(listTagMindMaps).toHaveBeenLastCalledWith(1, 20)
expect(wrapper.text()).toContain('还没有标签导图')
wrapper.unmount()
})
it('重试按钮会重新请求接口,成功后展示卡片列表', async () => {
vi.mocked(getReviewTaskStats)
.mockRejectedValueOnce({ code: 500, message: '服务异常' })
.mockResolvedValueOnce({ code: 200, data: tasks })
.mockResolvedValueOnce({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
expect(wrapper.text()).toContain('复习数据加载失败,请稍后重试')
@@ -169,7 +346,7 @@ describe('Review 交互流程(集成)', () => {
})
it('无任务时展示空列表文案,不显示失败提示', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: [] })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf([]) })
const { wrapper } = await mountReview()
expect(wrapper.text()).toContain('暂无复习任务')
@@ -177,7 +354,7 @@ describe('Review 交互流程(集成)', () => {
})
it('有待归类碎片时展示独立区块并标出条数', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({
code: 200,
data: [
@@ -187,19 +364,20 @@ describe('Review 交互流程(集成)', () => {
} as never)
const { wrapper } = await mountReview()
expect(wrapper.text()).toContain('待归类内容(2 条)')
expect(wrapper.find('.pending-head h3').text()).toBe('待归类内容')
expect(wrapper.find('.pending-count').text()).toBe('2 条')
expect(wrapper.text()).toContain('待归类内容 A')
})
it('无待归类碎片时不展示该区块', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
expect(wrapper.text()).not.toContain('待归类内容')
})
it('在总览待归类区块里选任务就地归类,成功后重新拉取待归类列表', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(getPendingOwnershipFragments)
.mockResolvedValueOnce({
code: 200,
@@ -209,7 +387,7 @@ describe('Review 交互流程(集成)', () => {
vi.mocked(updateFragmentOwnership).mockResolvedValue({ code: 200, data: null } as never)
const { wrapper } = await mountReview()
expect(wrapper.text()).toContain('待归类内容(1 条)')
expect(wrapper.find('.pending-count').text()).toBe('1 条')
wrapper.findAllComponents({ name: 'ElSelect' })[0].vm.$emit('update:modelValue', 'T002')
await flushPromises()
@@ -221,11 +399,39 @@ describe('Review 交互流程(集成)', () => {
expect(updateFragmentOwnership).toHaveBeenCalledWith(11, 'T002')
expect(getPendingOwnershipFragments).toHaveBeenCalledTimes(2)
expect(wrapper.text()).not.toContain('待归类内容(1 条)')
// 归类会改变任务的学习残片数量与顶部统计:任务列表也要重取,
// 否则数字与刚消失的这条待归类对不上(页面已不再提供手动刷新)
expect(getReviewTaskStats).toHaveBeenCalledTimes(2)
expect(wrapper.find('.pending-count').exists()).toBe(false)
})
it('归类后顶部统计与任务卡片数字重新拉取,保持自洽', async () => {
vi.mocked(getReviewTaskStats)
.mockResolvedValueOnce({ code: 200, data: pageOf(tasks) })
.mockResolvedValueOnce({
code: 200,
data: pageOf([{ ...tasks[0], fragmentCount: 6 }, tasks[1]]),
} as never)
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({
code: 200,
data: [{ id: 11, contextNum: 'S001', contextType: 'SESSION', ownerTaskNum: null, content: '待归类内容 A' }],
} as never)
vi.mocked(updateFragmentOwnership).mockResolvedValue({ code: 200, data: null } as never)
const { wrapper } = await mountReview()
expect(wrapper.find('.task-card').text()).toContain('学习残片数量:5')
wrapper.findAllComponents({ name: 'ElSelect' })[0].vm.$emit('update:modelValue', 'T001')
await flushPromises()
await wrapper.findAll('button').find((b) => b.text().trim() === '归类')!.trigger('click')
await flushPromises()
// 归类后碎片数从 5 变为 6,页面上的数字跟着更新
expect(wrapper.find('.task-card').text()).toContain('学习残片数量:6')
})
it('「升格为新任务」跳转到已有的新建任务流程并带上碎片编号', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(getPendingOwnershipFragments).mockResolvedValue({
code: 200,
data: [{ id: 11, contextNum: 'S001', contextType: 'SESSION', ownerTaskNum: null, content: '待归类内容 A' }],
@@ -241,32 +447,40 @@ describe('Review 交互流程(集成)', () => {
pushSpy.mockRestore()
})
it('任务卡片展示标记,点用户标签按单一标记筛选并可清除', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
it('点用户标签按单一标记筛选任务(筛选下推到服务端)', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(getMarkersBatch).mockResolvedValue({
code: 200,
data: { T001: [{ id: 21, objectType: 'TASK', objectNum: 'T001', kind: 'USER', markerName: '重点', markerValue: null }] },
} as never)
vi.mocked(filterByMarker).mockResolvedValue({ code: 200, data: ['T001'] } as never)
const { wrapper } = await mountReview()
expect(wrapper.find('.marker-user').text()).toContain('重点')
// 筛选后服务端只回带该标签的任务
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf([tasks[0]]) })
await wrapper.find('.marker-user').trigger('click')
await flushPromises()
expect(filterByMarker).toHaveBeenCalledWith({ objectType: 'TASK', markerName: '重点', kind: 'USER' })
// 回到第 1 页并带上 markerName;不再在客户端过滤当前页
expect(getReviewTaskStats).toHaveBeenLastCalledWith(1, 20, '重点')
expect(wrapper.text()).toContain('正在按标签「重点」筛选任务')
expect(wrapper.text()).not.toContain('TypeScript 类型体操')
// 只有服务端回的那一条了
expect(wrapper.findAll('.task-card')).toHaveLength(1)
expect(wrapper.text()).toContain('学习 Vue3 组合式 API')
// 清除筛选回到无筛选的第 1 页
await wrapper.findAll('button').find((b) => b.text().includes('清除筛选'))!.trigger('click')
await flushPromises()
expect(getReviewTaskStats).toHaveBeenLastCalledWith(1, 20, undefined)
})
it('打开智能排序偏好,展示三档语义选项与当前档位说明', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
const { wrapper } = await mountReview()
expect(getSortPreference).toHaveBeenCalled()
const open = wrapper.findAll('button').find((b) => b.text().trim() === '智能排序偏好')
await open!.trigger('click')
await flushPromises()
await clickMoreItem(wrapper, 'sort')
expect(wrapper.text()).toContain('时间为主')
expect(wrapper.text()).toContain('均衡')
@@ -275,15 +489,14 @@ describe('Review 交互流程(集成)', () => {
})
it('选择档位并保存时调用保存接口', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(saveSortPreference).mockResolvedValue({
code: 200,
data: { preset: 'MASTERY_FIRST', description: '回忆覆盖率低的更容易出现' },
} as never)
const { wrapper } = await mountReview()
await wrapper.findAll('button').find((b) => b.text().trim() === '智能排序偏好')!.trigger('click')
await flushPromises()
await clickMoreItem(wrapper, 'sort')
const radioGroup = wrapper.findAllComponents({ name: 'ElRadioGroup' })[0]
radioGroup.vm.$emit('update:modelValue', 'MASTERY_FIRST')
@@ -296,7 +509,7 @@ describe('Review 交互流程(集成)', () => {
})
it('标签管理列出标签与用量,并支持重命名', async () => {
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks })
vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: pageOf(tasks) })
vi.mocked(getUserTagUsage).mockResolvedValue({
code: 200,
data: [{ markerName: '英语', markerCount: 3, objectCount: 2 }],
@@ -304,8 +517,7 @@ describe('Review 交互流程(集成)', () => {
vi.mocked(renameUserTag).mockResolvedValue({ code: 200, data: 2 } as never)
const { wrapper } = await mountReview()
await wrapper.findAll('button').find((b) => b.text().trim() === '标签管理')!.trigger('click')
await flushPromises()
await clickMoreItem(wrapper, 'tags')
expect(wrapper.text()).toContain('英语')
expect(wrapper.text()).toContain('2 个内容 · 3 次使用')
+13
View File
@@ -0,0 +1,13 @@
import type { PageResult } from "@/utils/request";
/**
* 把数组包成后端分页形状(MyBatis-Plus Page 的序列化结果),供组件测试 mock 使用。
* 列表接口都改成 `{ records, total, ... }` 之后,直接 mock 数组会让组件读到空列表。
*/
export const pageOf = <T>(records: T[], total = records.length): PageResult<T> => ({
records,
total,
size: records.length || 20,
current: 1,
pages: total === 0 ? 0 : 1,
});
+30 -2
View File
@@ -1,4 +1,5 @@
import request from "@/utils/request";
import type { PageResult } from "@/utils/request";
import type { ReportFragment } from "./reportFragments";
/**
@@ -127,8 +128,35 @@ export const saveSortPreference = (preset: ReviewSortPreset) => {
return request.put<ReviewSortPreference>("/review/sort-preference", { preset });
};
export const getReviewTaskStats = () => {
return request.get<ReviewTaskStats[]>("/review/tasks");
/** 复习总览的全局汇总(全量口径,不受列表分页影响) */
export interface ReviewSummary {
taskTotal: number;
reportTotal: number;
fragmentTotal: number;
}
/**
* 取复习总览汇总。
*
* 不能用分页后的每页任务数字相加:那样得到的是「本页合计」而不是总数,
* 页面上会与 Tab 上的真实总数矛盾。
*/
export const getReviewSummary = () => {
return request.get<ReviewSummary>("/review/summary");
};
/**
* 分页取任务维度的复习统计。
*
* @param markerName 可选:只返回带该用户标签的任务(单个标记筛选)。
* 筛选在服务端做,否则客户端只能筛当前页、总数也不对。
*/
export const getReviewTaskStats = (pageNum = 1, pageSize = 20, markerName?: string) => {
return request.get<PageResult<ReviewTaskStats>>("/review/tasks", {
pageNum,
pageSize,
...(markerName ? { markerName } : {}),
});
};
export const getReviewTaskStatsByTask = (taskNum: string) => {
+27
View File
@@ -1,5 +1,6 @@
// src/api/tagMindMap.ts
import request from "@/utils/request";
import type { PageResult } from "@/utils/request";
/** 取数模式:UNION=并集(默认)/ INTERSECT=交集 */
export type TagCombineMode = "UNION" | "INTERSECT";
@@ -56,6 +57,32 @@ export interface TagMindMapView {
latestRecallRecord: TagRecallRecord | null;
}
/**
* 已有标签导图的摘要:「已生成的标签导图」列表用。
* 列表是按标签复习的主入口,导图生成后标签集合一般不再变化,因此这里直接给出
* 可复用的 tags + mode,前端拿它们就能复习或把新碎片补充进去。
*/
export interface TagMindMapSummary {
id: number;
scopeKey: string;
tags: string[];
mode: TagCombineMode;
title: string;
generator: TagMindMap["generator"];
sourceFragmentCount?: number;
/** 有新碎片待整理(素材变化后置位),补充由用户手动触发 */
needsUpdate?: boolean;
generatedTime?: string;
}
/** 列出已经生成过导图的标签范围(待更新优先,其次按生成时间倒序) */
export const listTagMindMaps = (pageNum = 1, pageSize = 20) => {
return request.get<PageResult<TagMindMapSummary>>("/review/tag-mind-map/list", {
pageNum,
pageSize,
});
};
/** 读取该范围的状态(不触发生成) */
export const queryTagMindMap = (tags: string[], mode: TagCombineMode) => {
return request.post<TagMindMapView>("/review/tag-mind-map/query", { tags, mode });
+15
View File
@@ -43,6 +43,21 @@ export const deleteTaskApplication = (id: number) => {
return request.del(`/tasks/applications/${id}`);
};
/** 任务下拉选项(全部任务的最小列表),用于「归类到已有任务」等选择场景 */
export interface TaskOption {
taskNum: string;
taskName: string;
}
/**
* 全部任务的最小选项。
* 不能拿 /review/tasks 当选项源:那条会做复习统计聚合且已分页;
* 也不能拿分页的 /tasks,否则任务多起来下拉会悄悄只显示第一页。
*/
export const listTaskOptions = () => {
return request.get<TaskOption[]>("/tasks/options");
};
// ============ 任务删除影响范围 ============
/** 删除任务前的预览:哪些会一并删除、哪些会保留并进入待归类 */
+83
View File
@@ -128,6 +128,89 @@ a:hover {
box-shadow: var(--shadow-soft);
}
/* 「点进去会去哪」的常显提示:不能只在 hover 出现,触屏没有 hover。
任务行与导图行共用(列表行右侧提示)。 */
.detail-hint {
font-size: 12px;
color: var(--text-secondary);
}
/* ------------------------------------------------------------------
* 骨架占位
*
* 口径(ui-review-checklist):骨架形状要与最终内容一致,且加载指示延迟
* ~200ms 才显示、显示后至少留 ~400ms(见 useDelayedVisible),避免快响应
* 时闪一下。用 token 上色,不要写死灰。
* ------------------------------------------------------------------ */
.skeleton-line {
display: block;
height: 12px;
border-radius: 4px;
background: linear-gradient(
90deg,
var(--green-100) 25%,
var(--surface) 37%,
var(--green-100) 63%
);
background-size: 400% 100%;
animation: skeleton-shimmer 1.4s ease infinite;
}
/* ------------------------------------------------------------------
* 列表分页
*
* 口径(design-system):列表超过一页就分页,页大小 20。
* EP 出厂的背景分页是灰底 + 2px 圆角 + #606266 文字,与本站 token 无关;
* 统一换成白底 1px 描边 + 4px 圆角、选中用主色。
* ------------------------------------------------------------------ */
.list-pagination {
justify-content: center;
margin-top: 12px;
}
/* 选择器要与 EP 的 `.el-pagination.is-background .el-pager li:not(.is-disabled)`
同级或更高,否则压不住它(main.css 在 element-plus 之后导入,同级时我们胜)。 */
.list-pagination.is-background .el-pager li:not(.is-disabled),
.list-pagination.is-background .btn-prev:not(:disabled),
.list-pagination.is-background .btn-next:not(:disabled) {
background-color: var(--surface-strong);
border: 1px solid var(--border-soft);
border-radius: 4px;
color: var(--text-secondary);
}
.list-pagination.is-background .el-pager li:not(.is-disabled):hover {
color: var(--green-700);
border-color: var(--green-500);
}
.list-pagination.is-background .el-pager li.is-active {
background-color: var(--green-700);
border-color: var(--green-700);
color: var(--text-on-accent);
}
.list-pagination.is-background .btn-prev:disabled,
.list-pagination.is-background .btn-next:disabled {
background-color: var(--surface);
color: var(--text-placeholder);
}
@keyframes skeleton-shimmer {
from {
background-position: 100% 50%;
}
to {
background-position: 0 50%;
}
}
@media (prefers-reduced-motion: reduce) {
.skeleton-line {
animation: none;
}
}
/* ------------------------------------------------------------------
* 按钮尺寸收敛
*
+591 -208
View File
File diff suppressed because it is too large Load Diff
+241
View File
@@ -0,0 +1,241 @@
<script setup lang="ts">
import { computed } from "vue";
import type { TagMindMapSummary } from "@/api/tagMindMap";
import { formatDateTime } from "@/utils/format";
import { useDelayedVisible } from "@/components/composables/useDelayedVisible";
/**
* 已生成标签导图的列表:复习总览的「按标签复习」模块与按标签复习页共用。
* 整行可点进入复习,行内提供「补充新碎片」(把新碎片整理进现有结构)。
*/
const props = withDefaults(
defineProps<{
maps: TagMindMapSummary[];
loading?: boolean;
/** 加载失败:与空数据分开呈现,失败时给重试 */
failed?: boolean;
emptyText?: string;
/** 正在补充新碎片的范围键:只禁用其它行,不禁用自己 */
supplementingKey?: string | null;
/** 当前正在复习的范围键,用于标出选中行 */
activeKey?: string;
}>(),
{ loading: false, failed: false, emptyText: "还没有生成过标签导图", supplementingKey: null, activeKey: "" },
);
/** 骨架延迟显示 + 最短可见,与复习总览的任务列表同一口径 */
const skeletonVisible = useDelayedVisible(computed(() => props.loading));
const emit = defineEmits<{
(e: "open", item: TagMindMapSummary): void;
(e: "supplement", item: TagMindMapSummary): void;
(e: "retry"): void;
}>();
const displayTitle = (item: TagMindMapSummary) => item.title || item.tags.join("、");
</script>
<template>
<div class="tag-map-list" :aria-busy="loading">
<div v-if="failed" class="tag-map-failed">
<span>已有导图加载失败</span>
<el-button type="success" plain size="small" @click="emit('retry')">重新加载</el-button>
</div>
<!-- 首次加载:骨架形状与导图行一致,避免空白后行「啪」地出现 -->
<template v-else-if="skeletonVisible && maps.length === 0">
<div v-for="n in 2" :key="n" class="map-row map-row-skeleton" aria-hidden="true">
<div class="map-row-main">
<span class="skeleton-line skeleton-row-title" />
<span class="skeleton-line" />
</div>
</div>
</template>
<el-empty v-else-if="!loading && maps.length === 0" :description="emptyText" :image-size="64" />
<template v-else>
<article
v-for="item in maps"
:key="item.scopeKey"
class="map-row"
:class="{ 'is-active': activeKey === item.scopeKey }"
role="link"
tabindex="0"
:aria-label="`复习标签导图:${item.tags.join('、')}`"
@click="emit('open', item)"
@keydown.enter.prevent="emit('open', item)"
@keydown.space.prevent="emit('open', item)"
>
<div class="map-row-main">
<div class="map-row-title">
<strong>{{ displayTitle(item) }}</strong>
<span v-if="item.mode === 'INTERSECT'" class="map-badge">交集</span>
<span v-if="item.needsUpdate" class="map-badge map-badge-warning">有新碎片待整理</span>
</div>
<div class="map-row-tags">
<span v-for="name in item.tags" :key="name" class="tag-chip">{{ name }}</span>
</div>
<div class="map-row-meta">
<span>取材 {{ item.sourceFragmentCount || 0 }} 条碎片</span>
<span v-if="item.generatedTime">生成于 {{ formatDateTime(item.generatedTime) }}</span>
<span>
{{ item.generator === "USER" || item.generator === "USER_MERGE" ? "含手动编辑" : "AI 生成" }}
</span>
</div>
</div>
<div class="map-row-actions" @click.stop>
<span class="detail-hint">进入复习 →</span>
<el-button
size="small"
type="success"
:plain="!item.needsUpdate"
:loading="supplementingKey === item.scopeKey"
:disabled="!!supplementingKey && supplementingKey !== item.scopeKey"
@click="emit('supplement', item)"
>补充新碎片</el-button>
</div>
</article>
</template>
</div>
</template>
<style scoped>
.tag-map-list {
display: flex;
flex-direction: column;
gap: 10px;
}
.tag-map-failed {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 12px 14px;
border: 1px solid var(--accent-warning-soft);
border-radius: 8px;
background: var(--accent-warning-soft);
font-size: 13px;
color: var(--accent-warning-text);
}
/* 整行可点:行内按钮不触发行的点击 */
.map-row {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 12px 14px;
border: 1px solid var(--border-soft);
border-radius: 8px;
background: var(--surface-strong);
cursor: pointer;
transition: border-color 0.18s ease, box-shadow 0.18s ease;
}
.map-row:hover {
border-color: var(--green-500);
box-shadow: var(--shadow-soft);
}
.map-row:focus-visible {
outline: 2px solid var(--green-700);
outline-offset: 2px;
}
.map-row.is-active {
border-color: var(--green-700);
}
.map-row-main {
display: flex;
flex-direction: column;
gap: 6px;
min-width: 0;
}
/* 骨架行:形状与导图行一致,不可点 */
.map-row-skeleton {
cursor: default;
}
.map-row-skeleton:hover {
border-color: var(--border-soft);
box-shadow: none;
}
.skeleton-row-title {
width: 38%;
height: 15px;
}
.map-row-title {
display: flex;
align-items: center;
flex-wrap: wrap;
gap: 8px;
font-size: 15px;
color: var(--text-primary);
}
.map-row-tags {
display: flex;
flex-wrap: wrap;
gap: 6px;
}
.tag-chip {
font-size: 12px;
line-height: 1.4;
padding: 1px 8px;
border-radius: 9999px;
background: var(--accent-success-soft);
color: var(--green-700);
white-space: nowrap;
}
.map-badge {
font-size: 12px;
font-weight: 700;
padding: 1px 8px;
border-radius: 9999px;
background: var(--surface);
border: 1px solid var(--border-soft);
color: var(--text-secondary);
}
.map-badge-warning {
background: var(--accent-warning-soft);
border-color: var(--accent-warning-soft);
color: var(--accent-warning-text);
}
.map-row-meta {
display: flex;
flex-wrap: wrap;
gap: 12px;
font-size: 12px;
color: var(--text-secondary);
font-variant-numeric: tabular-nums;
}
.map-row-actions {
display: flex;
align-items: center;
gap: 12px;
flex-shrink: 0;
}
@media (max-width: 768px) {
.map-row {
flex-direction: column;
align-items: stretch;
}
.map-row-actions {
justify-content: space-between;
}
.map-row-actions .el-button {
width: 100%;
}
}
</style>
+4 -7
View File
@@ -4,11 +4,11 @@ import { ElMessage } from "element-plus";
import router from "@/router";
import {
getReviewFeed,
getReviewTaskStats,
getTaskReview,
touchReviewFragment,
type ReviewFeedItem,
} from "@/api/review";
import { listTaskOptions, type TaskOption } from "@/api/tasks";
import { updateFragmentOwnership } from "@/api/reportFragments";
import {
clampAutoScrollTime,
@@ -67,17 +67,14 @@ const classify = ref<{ visible: boolean; fragment: FragmentChip | null; selected
selectedTaskNum: "",
loadingTasks: false,
});
const classifyTasks = ref<{ taskNum: string; taskName: string }[]>([]);
const classifyTasks = ref<TaskOption[]>([]);
const classifying = ref(false);
const openClassifyDialog = async (fragment: FragmentChip) => {
classify.value = { visible: true, fragment, selectedTaskNum: "", loadingTasks: true };
try {
const res = await getReviewTaskStats();
classifyTasks.value = (res?.data || []).map((task) => ({
taskNum: task.taskNum,
taskName: task.taskName,
}));
const res = await listTaskOptions();
classifyTasks.value = res?.data || [];
} catch {
classifyTasks.value = [];
} finally {
@@ -0,0 +1,74 @@
import { onUnmounted, ref, watch, type Ref } from "vue";
/**
* 骨架/加载指示的「延迟显示 + 最短可见」控制。
*
* 直接跟 loading 绑定会有两个毛病:
* - 请求很快(本地几百毫秒)时骨架一闪而过,比不显示更刺眼;
* - 请求很慢时骨架刚出现又被数据替换,同样在跳。
* 所以按 ui-review-checklist 的口径:加载超过 delayMs 才显示,显示后至少留 minVisibleMs。
* 真实的 loading 状态仍由调用方持有,这里只产出「该不该显示指示」。
*/
export function useDelayedVisible(
loading: Ref<boolean>,
options: { delayMs?: number; minVisibleMs?: number } = {},
): Ref<boolean> {
const delayMs = options.delayMs ?? 200;
const minVisibleMs = options.minVisibleMs ?? 400;
const visible = ref(false);
let showTimer: ReturnType<typeof setTimeout> | null = null;
let hideTimer: ReturnType<typeof setTimeout> | null = null;
let shownAt = 0;
const clearShow = () => {
if (showTimer !== null) {
clearTimeout(showTimer);
showTimer = null;
}
};
const clearHide = () => {
if (hideTimer !== null) {
clearTimeout(hideTimer);
hideTimer = null;
}
};
watch(
loading,
(isLoading) => {
if (isLoading) {
// 上一轮的最短可见还没到,又要开始加载:保持显示、不再重排
clearHide();
if (visible.value || showTimer !== null) return;
showTimer = setTimeout(() => {
showTimer = null;
shownAt = Date.now();
visible.value = true;
}, delayMs);
return;
}
clearShow();
if (!visible.value) return;
const remaining = minVisibleMs - (Date.now() - shownAt);
if (remaining <= 0) {
visible.value = false;
return;
}
clearHide();
hideTimer = setTimeout(() => {
hideTimer = null;
visible.value = false;
}, remaining);
},
{ immediate: true },
);
onUnmounted(() => {
clearShow();
clearHide();
});
return visible;
}
+23
View File
@@ -23,3 +23,26 @@ export const formatDurationSeconds = (seconds?: number | string | null): string
if (minutes > 0) return `${minutes}分钟${secs}秒`;
return `${secs}秒`;
};
/**
* 把后端返回的时间格式化为 `YYYY-MM-DD HH:mm`。
* 用 Intl 而不是字符串截取:后端字段可能是 `2026-10-10T10:00:00` 或
* `2026-10-10 10:00:00` 两种写法,截取会连带把 `T` 留在屏幕上;
* 按部件拼装则既尊重本地日历/数字习惯,又保持我们自己的显示口径。
* 空值与非法值返回 ""。
*/
export const formatDateTime = (value?: string | number | Date | null): string => {
if (value == null || value === "") return "";
const date = value instanceof Date ? value : new Date(typeof value === "string" ? value.replace(" ", "T") : value);
if (Number.isNaN(date.getTime())) return "";
const parts = new Intl.DateTimeFormat("zh-CN", {
year: "numeric",
month: "2-digit",
day: "2-digit",
hour: "2-digit",
minute: "2-digit",
hour12: false,
}).formatToParts(date);
const pick = (type: Intl.DateTimeFormatPartTypes) => parts.find((part) => part.type === type)?.value ?? "";
return `${pick("year")}-${pick("month")}-${pick("day")} ${pick("hour")}:${pick("minute")}`;
};
+13
View File
@@ -9,6 +9,19 @@ export interface ApiResponse<T = any> {
data: T;
}
/**
* 分页响应(与后端 MyBatis-Plus 的 Page 序列化形状一致)。
* 列表接口超过一定规模就必须分页:只取当前页、聚合也只算当前页,
* 避免页面变成一条超长列表、也避免服务端 `IN (全部 id)`。
*/
export interface PageResult<T> {
records: T[];
total: number;
size: number;
current: number;
pages: number;
}
const baseURL = import.meta.env.VITE_BASE_URL;
// 默认 30s:普通 CRUD 足够;AI 聚合等长耗时接口需在 api 层显式覆写 timeout