import { computed, inject, ref, watch, type InjectionKey, type Ref } from 'vue' import { useQuery } from '../../composables/useQuery' import { projectsApi } from './api' /** 页面需要回读完整记录的工作流。 */ export type CheckpointWorkflow = 'create-drama' | 'breakdown' /** 项目布局共享轻量读取,完整记录只有消费者进入时才加载。 */ export function useProjectData(id: Ref) { /** 正式项目正文与导航条件分别读取。 */ const projectQuery = useQuery(id, (projectId, signal) => projectId ? projectsApi.detail(projectId, signal) : Promise.resolve(null) ) const readinessQuery = useQuery(id, (projectId, signal) => projectId ? projectsApi.stageReadiness(projectId, signal) : Promise.resolve(null) ) /** 摘要失败会阻断写操作,但不阻塞工作区浏览。 */ const summaryQuery = useQuery(id, (projectId, signal) => projectId ? projectsApi.checkpointSummaries(projectId, signal) : Promise.resolve(null) ) /** 当前项目已请求过的工作流,页面卸载时保留。 */ const requested = ref>>({}) /** 页面与布局可能同时观察到同一个终态,只处理一次。 */ const handledExecutions = new Map>() watch( id, () => { requested.value = {} handledExecutions.clear() }, { flush: 'sync' } ) /** * 用项目编号作为查询键;离开项目会取消旧请求并清除旧结果。 * @param workflow 当前工作流 * @returns 完整记录及其独立查询状态 */ function createCheckpointQuery(workflow: CheckpointWorkflow) { const key = computed(() => (requested.value[workflow] === id.value ? id.value : '')) return useQuery(key, (projectId, signal) => projectId ? projectsApi.checkpoints(projectId, signal, workflow) : Promise.resolve(null) ) } /** 两个查询在布局生命周期内存活,同项目切页直接复用。 */ const checkpointQueries = { 'create-drama': createCheckpointQuery('create-drama'), breakdown: createCheckpointQuery('breakdown') } /** 只发布当前项目的正式数据。 */ const project = computed(() => (projectQuery.data.value?.id === id.value ? projectQuery.data.value : null)) const stageReadiness = computed(() => project.value && readinessQuery.data.value?.projectId === id.value ? readinessQuery.data.value : null ) /** 摘要未取得或刷新失败时禁止依赖其作出写入判断。 */ const summaryBlocked = computed( () => !project.value || summaryQuery.data.value === null || summaryQuery.loading.value || !!summaryQuery.error.value ) /** 页面外壳加载与错误不包含按需正文。 */ const loading = computed(() => projectQuery.loading.value || readinessQuery.loading.value) const error = computed(() => projectQuery.error.value || readinessQuery.error.value || summaryQuery.error.value) /** * 声明页面需要某个工作流的正文;重复声明不会发出新请求。 * @param workflow 当前工作流 * @returns 完整记录查询 */ function useWorkflowCheckpoints(workflow: CheckpointWorkflow) { if (requested.value[workflow] !== id.value) requested.value[workflow] = id.value return checkpointQueries[workflow] } /** * 写入或任务终态后只刷新摘要和受影响的已加载正文。 * @param workflow 受影响的工作流,没有对应正文时仅刷新摘要 * @param projectId 操作开始时绑定的项目 * @param executionKey 共享观察器使用的终态标识 * @returns 本次刷新结束 */ async function refreshWorkflow(workflow: CheckpointWorkflow | null, projectId = id.value, executionKey?: string) { if (!projectId || id.value !== projectId) return const existing = executionKey ? handledExecutions.get(executionKey) : undefined if (existing) return existing const update = Promise.all([ summaryQuery.refresh(), workflow && requested.value[workflow] === projectId ? checkpointQueries[workflow].refresh() : Promise.resolve() ]).then(() => {}) if (executionKey) handledExecutions.set(executionKey, update) await update } /** 刷新工作区入口数据,不读取完整工作流历史。 */ async function refresh() { await Promise.all([projectQuery.refresh(), readinessQuery.refresh(), summaryQuery.refresh()]) } return { project, projectQuery, stageReadiness, readinessQuery, summaryQuery, summaryBlocked, loading, error, refresh, refreshProject: projectQuery.refresh, refreshStageReadiness: readinessQuery.refresh, useWorkflowCheckpoints, refreshWorkflow } } /** 项目布局向子页面提供的类型安全上下文。 */ export const projectContextKey: InjectionKey> = Symbol('project-context') /** 读取项目上下文,错误布局在开发阶段立即暴露。 */ export function useProjectContext() { const context = inject(projectContextKey) if (!context) throw new Error('项目页面必须位于 ProjectLayout 中') return context }