API文档维护Agent
a43ddb4b63
## 主要变更 ### 1. 清理废弃代码（18个文件删除） - 删除 TaskModel/MilestoneModel/TaskIssueModel 及相关文件 - 删除 ProjectTitleModel/EditPlanModel/EditPlanClipModel 及相关文件 - 清理 domain/ports/adapters/application/api 各层引用 - 从 GenerationTaskModel 移除 edit_plan_id 字段 ### 2. 新建标题库 API（/api/v1/titles） - Domain: TitleLibraryItem 数据类 - Ports: TitleLibraryRepository 接口 - Adapters: SQLAlchemy 实现（软删除） - Application: CRUD Use Cases + 配额检查（max_titles: free=50, basic=500, premium=500） - API: GET/POST/PUT/DELETE 端点 - Schema: Pydantic 请求/响应模型 ### 3. 新建配音库 API（/api/v1/voices） - Domain: VoiceLibraryItem 数据类 - Ports: VoiceLibraryRepository 接口 - Adapters: SQLAlchemy 实现（软删除） - Application: CRUD Use Cases + 配额检查（max_voiceovers: free=10, basic=100, premium=100） - API: GET/POST/PUT/DELETE 端点 - Schema: Pydantic 请求/响应模型 ### 4. 去掉 Project 层依赖 - 修复 authenticated_user.id → authenticated_user.user.id bug - asset_libraries.py: project_id 改为可选查询参数 - generated_videos.py: project_id 改为可选查询参数 - 无 project_id 时通过 find_accessible_projects 获取用户可访问的所有项目 ### 5. 数据库迁移 - 创建 011_phase1_core_refactor.py - 删除 6 个废弃表：tasks, milestones, task_issues, project_titles, edit_plans, edit_plan_clips - 从 generation_tasks 表删除 edit_plan_id 列 ### 6. 其他改进 - 迁移 EditingMode 到独立模块 packages/domain/editing_mode.py - 注册 titles_router 和 voices_router - 添加 get_title_library_repository 和 get_voice_library_repository 依赖 - 更新 domain/ports __init__.py 导出新实体和仓储接口 ## 技术细节 - 遵循六边形架构模式 - 配额检查通过 QuotaRegistry 实现 - 软删除：标题库用 is_active=False，配音库用 status='deleted' - 配音库支持可选的 project_id 关联 ## 破坏性变更 - 删除 6 个废弃表（需先备份数据） - 删除 /api/v1/edit-plans, /api/v1/project-titles, /api/v1/project-management 端点 - generation_tasks API 不再包含 edit_plan_id 字段
68 lines
2.7 KiB
Python
68 lines
2.7 KiB
Python
from sqlalchemy.orm import Session
|
|
|
|
from packages.adapters.sqlalchemy_impl.models import GenerationTaskModel
|
|
from packages.domain import GenerationTask
|
|
|
|
|
|
class SQLAlchemyGenerationTaskRepository:
|
|
def __init__(self, session: Session):
|
|
self.session = session
|
|
|
|
def create(self, task: GenerationTask) -> GenerationTask:
|
|
model = GenerationTaskModel(
|
|
id=task.id,
|
|
project_id=task.project_id,
|
|
strategy_id=task.strategy_id,
|
|
asset_library_id=task.asset_library_id,
|
|
voice_library_id=task.voice_library_id,
|
|
status=task.status,
|
|
progress=task.progress,
|
|
result_count=task.result_count,
|
|
error_message=task.error_message,
|
|
started_at=task.started_at,
|
|
completed_at=task.completed_at,
|
|
created_by_user_id=task.created_by_user_id,
|
|
created_at=task.created_at,
|
|
)
|
|
self.session.add(model)
|
|
self.session.commit()
|
|
return task
|
|
|
|
def get(self, task_id: str) -> GenerationTask | None:
|
|
model = self.session.query(GenerationTaskModel).filter(GenerationTaskModel.id == task_id).first()
|
|
if model is None:
|
|
return None
|
|
return GenerationTask(
|
|
id=model.id,
|
|
project_id=model.project_id,
|
|
strategy_id=model.strategy_id,
|
|
asset_library_id=model.asset_library_id,
|
|
voice_library_id=model.voice_library_id,
|
|
status=model.status,
|
|
progress=model.progress,
|
|
result_count=int(model.result_count or 0),
|
|
error_message=model.error_message,
|
|
started_at=model.started_at,
|
|
completed_at=model.completed_at,
|
|
created_by_user_id=model.created_by_user_id,
|
|
created_at=model.created_at,
|
|
)
|
|
|
|
def list_by_project(self, project_id: str) -> list[GenerationTask]:
|
|
models = self.session.query(GenerationTaskModel).filter(GenerationTaskModel.project_id == project_id).all()
|
|
return [self.get(model.id) for model in models if self.get(model.id) is not None]
|
|
|
|
def update(self, task: GenerationTask) -> GenerationTask:
|
|
model = self.session.query(GenerationTaskModel).filter(GenerationTaskModel.id == task.id).first()
|
|
if model is None:
|
|
raise ValueError(f"GenerationTask {task.id} not found")
|
|
model.voice_library_id = task.voice_library_id
|
|
model.status = task.status
|
|
model.progress = task.progress
|
|
model.result_count = task.result_count
|
|
model.error_message = task.error_message
|
|
model.started_at = task.started_at
|
|
model.completed_at = task.completed_at
|
|
self.session.commit()
|
|
return task
|