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 字段
112 lines
3.8 KiB
Python
112 lines
3.8 KiB
Python
"""Title library use cases."""
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
from typing import List, Optional
|
|
|
|
from packages.adapters.sqlalchemy_impl.title_library_repository import SQLAlchemyTitleLibraryRepository
|
|
from packages.application.title_library.commands import (
|
|
CreateTitleLibraryCommand,
|
|
UpdateTitleLibraryCommand,
|
|
)
|
|
from packages.domain.quota import QuotaDimension, quota_checker
|
|
from packages.domain.title_library import TitleLibraryItem
|
|
|
|
|
|
class ListTitleLibraryUseCase:
|
|
def __init__(self, repository: SQLAlchemyTitleLibraryRepository) -> None:
|
|
self.repository = repository
|
|
|
|
def execute(
|
|
self,
|
|
user_id: str,
|
|
*,
|
|
category: Optional[str] = None,
|
|
skip: int = 0,
|
|
limit: int = 50,
|
|
) -> List[TitleLibraryItem]:
|
|
return self.repository.list_by_user(user_id, category=category, skip=skip, limit=limit)
|
|
|
|
|
|
class GetTitleLibraryUseCase:
|
|
def __init__(self, repository: SQLAlchemyTitleLibraryRepository) -> None:
|
|
self.repository = repository
|
|
|
|
def execute(self, title_id: str, user_id: str) -> Optional[TitleLibraryItem]:
|
|
return self.repository.get(title_id, user_id)
|
|
|
|
|
|
class CreateTitleLibraryUseCase:
|
|
def __init__(self, repository: SQLAlchemyTitleLibraryRepository) -> None:
|
|
self.repository = repository
|
|
|
|
def execute(self, command: CreateTitleLibraryCommand, plan_name: str = "free") -> TitleLibraryItem:
|
|
# Quota check
|
|
current_count = self.repository.count_by_user(command.user_id)
|
|
result = quota_checker.check(plan_name, QuotaDimension.MAX_TITLES.value, current_count)
|
|
if not result.allowed:
|
|
raise QuotaExceededError(
|
|
dimension=QuotaDimension.MAX_TITLES.value,
|
|
limit=result.limit,
|
|
used=result.used,
|
|
)
|
|
|
|
item = TitleLibraryItem(
|
|
id=uuid.uuid4().hex,
|
|
user_id=command.user_id,
|
|
name=command.name,
|
|
text=command.text,
|
|
category=command.category,
|
|
description=command.description,
|
|
tags=command.tags,
|
|
metadata_=command.metadata_,
|
|
)
|
|
return self.repository.create(item)
|
|
|
|
|
|
class UpdateTitleLibraryUseCase:
|
|
def __init__(self, repository: SQLAlchemyTitleLibraryRepository) -> None:
|
|
self.repository = repository
|
|
|
|
def execute(self, command: UpdateTitleLibraryCommand) -> TitleLibraryItem:
|
|
existing = self.repository.get(command.title_id, command.user_id)
|
|
if existing is None:
|
|
raise NotFoundError(f"Title {command.title_id} not found")
|
|
|
|
if command.name is not None:
|
|
existing.name = command.name
|
|
if command.text is not None:
|
|
existing.text = command.text
|
|
if command.category is not None:
|
|
existing.category = command.category
|
|
if command.description is not None:
|
|
existing.description = command.description
|
|
if command.tags is not None:
|
|
existing.tags = command.tags
|
|
if command.is_active is not None:
|
|
existing.is_active = command.is_active
|
|
if command.metadata_ is not None:
|
|
existing.metadata_ = command.metadata_
|
|
|
|
return self.repository.update(existing)
|
|
|
|
|
|
class DeleteTitleLibraryUseCase:
|
|
def __init__(self, repository: SQLAlchemyTitleLibraryRepository) -> None:
|
|
self.repository = repository
|
|
|
|
def execute(self, title_id: str, user_id: str) -> bool:
|
|
return self.repository.delete(title_id, user_id)
|
|
|
|
|
|
class QuotaExceededError(Exception):
|
|
def __init__(self, dimension: str, limit: float, used: float) -> None:
|
|
self.dimension = dimension
|
|
self.limit = limit
|
|
self.used = used
|
|
super().__init__(f"Quota exceeded for {dimension}: {used}/{limit}")
|
|
|
|
|
|
class NotFoundError(Exception):
|
|
pass
|