import { flushPromises } from '@vue/test-utils' import { effectScope, ref } from 'vue' import { describe, expect, it, vi } from 'vitest' import { projectsApi } from '@/features/projects/api' import { useProjectData } from '@/features/projects/context' import type { Checkpoint, CheckpointSummary } from '@/features/workflows/types' import { testProjectContext } from '@/testing/project-context' /** * 构造可观察版本的完整保存记录。 * @param workflowName 所属工作流 * @param id 测试版本 * @returns 一条完整记录 */ function record(workflowName: string, id: string): Checkpoint { return { checkpointId: id, workflowName, createdAt: '2026-11-06T00:00:00.000Z', state: {} } } /** 测试上下文使用独立的轻量接口替身。 */ function setup() { const summaries = vi.spyOn(projectsApi, 'checkpointSummaries').mockResolvedValue([]) vi.spyOn(projectsApi, 'detail').mockImplementation( async projectId => testProjectContext(projectId).data.value.project ) vi.spyOn(projectsApi, 'stageReadiness').mockImplementation( async projectId => testProjectContext(projectId).data.value.stageReadiness ) const full = vi .spyOn(projectsApi, 'checkpoints') .mockImplementation(async (id, _signal, workflow) => [record(workflow!, id + '-initial')]) const id = ref('project-a') const scope = effectScope() const context = scope.run(() => useProjectData(id))! return { id, scope, context, summaries, full } } describe('项目工作流摘要与正文缓存', () => { it('普通入口只读摘要,同工作流的并发消费者复用一次请求', async () => { const { scope, context, summaries, full } = setup() try { await flushPromises() expect(summaries).toHaveBeenCalledTimes(1) expect(full).not.toHaveBeenCalled() expect(context.summaryBlocked.value).toBe(false) const first = context.useWorkflowCheckpoints('create-drama') const second = context.useWorkflowCheckpoints('create-drama') expect(second).toBe(first) await flushPromises() expect(full).toHaveBeenCalledTimes(1) expect(full).toHaveBeenCalledWith('project-a', expect.any(AbortSignal), 'create-drama') expect(first.data.value?.[0]?.checkpointId).toBe('project-a-initial') const breakdown = context.useWorkflowCheckpoints('breakdown') await flushPromises() expect(full).toHaveBeenCalledTimes(2) expect(context.useWorkflowCheckpoints('create-drama').data.value).toBe(first.data.value) full.mockResolvedValueOnce([record('breakdown', 'updated')]) await Promise.all([ context.refreshWorkflow('breakdown', 'project-a', 'run-1:completed'), context.refreshWorkflow('breakdown', 'project-a', 'run-1:completed') ]) expect(full).toHaveBeenCalledTimes(3) expect(summaries).toHaveBeenCalledTimes(2) expect(breakdown.data.value?.[0]?.checkpointId).toBe('updated') expect(first.data.value?.[0]?.checkpointId).toBe('project-a-initial') } finally { scope.stop() } }) it('跨项目取消旧请求,迟到的旧正文和旧摘要不会回填', async () => { const { scope, context, id, summaries, full } = setup() try { let resolveOld!: (rows: Checkpoint[]) => void full.mockImplementationOnce( () => new Promise(resolve => { resolveOld = resolve }) ) await flushPromises() let resolveOldSummary!: (rows: CheckpointSummary[]) => void summaries.mockImplementationOnce( () => new Promise(resolve => { resolveOldSummary = resolve }) ) const refreshing = context.summaryQuery.refresh() const records = context.useWorkflowCheckpoints('breakdown') await flushPromises() const oldSignal = full.mock.calls[0]?.[1] const oldSummarySignal = summaries.mock.calls[1]?.[1] id.value = 'project-b' expect(context.summaryBlocked.value).toBe(true) await flushPromises() expect(oldSignal?.aborted).toBe(true) expect(oldSummarySignal?.aborted).toBe(true) expect(records.data.value).toBeNull() expect(full).toHaveBeenCalledTimes(1) expect(context.project.value?.id).toBe('project-b') context.useWorkflowCheckpoints('breakdown') await flushPromises() resolveOld([record('breakdown', 'late-a')]) resolveOldSummary([ { checkpointId: 'late-summary', workflowName: 'breakdown', createdAt: '2026-11-06T00:00:00.000Z', updatedAt: '2026-11-06T00:00:00.000Z', state: { workflowExecution: { status: 'running' } } } ]) await refreshing await flushPromises() expect(records.data.value?.[0]?.checkpointId).toBe('project-b-initial') expect(context.summaryQuery.data.value).toEqual([]) expect(context.summaryBlocked.value).toBe(false) } finally { scope.stop() } }) it('摘要失败暂停写入,正文读取失败只影响对应工作流且可重试', async () => { const { scope, context, summaries, full } = setup() try { await flushPromises() summaries.mockRejectedValueOnce(new Error('任务摘要暂不可用')) await context.summaryQuery.refresh() expect(context.summaryBlocked.value).toBe(true) expect(context.project.value?.id).toBe('project-a') expect(context.stageReadiness.value?.storyboard.ready).toBe(true) full.mockRejectedValueOnce(new Error('分镜保存记录读取失败')) const breakdown = context.useWorkflowCheckpoints('breakdown') const drama = context.useWorkflowCheckpoints('create-drama') await flushPromises() expect(breakdown.error.value).toBe('分镜保存记录读取失败') expect(drama.data.value?.[0]?.workflowName).toBe('create-drama') await context.refreshWorkflow('breakdown') expect(breakdown.error.value).toBe('') expect(context.summaryBlocked.value).toBe(false) } finally { scope.stop() } }) })