maodo-project

定位与判断

项目、素材节点、生成轮次和项目交付的业务域。

当前实现

• 项目与节点管理、访问检查、多种生成与报价、回忆录业务。
• ProjectTaskService 创建并绑定任务，使用 generationNo 防止旧轮次覆盖新轮次。
• 任务结果同步、自动补帧、人工处置及旧链路兼容。

问题与差距

• 模块依赖新 Task/Gateway，也依赖旧 capability、ai-video、供应商模块。
• ephemeral-portraits.service.ts 等仍引用旧 Replicate 和 lib 客户端，需逐路径核对实际调用。
• 人工处置引用 Task 仓储、状态机和 Gateway 预测匹配内部文件，并读写任务数据。
• 多处服务保留大量相同依赖，不能仅靠服务文件拆分判定职责已拆清。

目标能力（建议）

保留项目业务域，但明确项目操作、生成编排、结果投影三类职责。Task 掌握执行状态，Project 掌握节点归属和轮次；供应商协议收归 Gateway。人工处置由 Project 协调任务、计费和节点，通过公开命令实现。

迁移与验收

先收紧人工处置边界，再选一条旧生成链迁移，不批量替换。保留旧任务识别与兼容。验收覆盖新旧任务共存、节点删除、轮次替换、结果重复同步、退款重复执行和中途失败补偿。

源码依据

• backend/src/maodo-project/maodo-project.module.ts
• backend/src/maodo-project/generation/project-task.service.ts
• backend/src/maodo-project/generation/project-result-sync.service.ts
• backend/src/maodo-project/generation/project-attention-disposition.service.ts
• backend/src/maodo-project/generation/ephemeral-portraits.service.ts