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 字段
115 lines
3.9 KiB
Python
115 lines
3.9 KiB
Python
"""SQLAlchemy implementation of TitleLibraryRepository."""
|
|
from __future__ import annotations
|
|
|
|
from typing import List, Optional
|
|
|
|
from sqlalchemy.orm import Session
|
|
|
|
from packages.adapters.sqlalchemy_impl.models import TitleLibraryModel
|
|
from packages.domain.title_library import TitleLibraryItem
|
|
|
|
|
|
class SQLAlchemyTitleLibraryRepository:
|
|
"""SQLAlchemy 标题库仓储"""
|
|
|
|
def __init__(self, session: Session) -> None:
|
|
self.session = session
|
|
|
|
def list_by_user(
|
|
self,
|
|
user_id: str,
|
|
*,
|
|
category: Optional[str] = None,
|
|
is_active: bool = True,
|
|
skip: int = 0,
|
|
limit: int = 50,
|
|
) -> List[TitleLibraryItem]:
|
|
query = self.session.query(TitleLibraryModel).filter(
|
|
TitleLibraryModel.user_id == user_id,
|
|
TitleLibraryModel.is_active == is_active,
|
|
)
|
|
if category:
|
|
query = query.filter(TitleLibraryModel.category == category)
|
|
query = query.order_by(TitleLibraryModel.created_at.desc())
|
|
models = query.offset(skip).limit(limit).all()
|
|
return [self._model_to_entity(m) for m in models]
|
|
|
|
def get(self, title_id: str, user_id: str) -> Optional[TitleLibraryItem]:
|
|
model = self.session.query(TitleLibraryModel).filter(
|
|
TitleLibraryModel.id == title_id,
|
|
TitleLibraryModel.user_id == user_id,
|
|
).first()
|
|
if model is None:
|
|
return None
|
|
return self._model_to_entity(model)
|
|
|
|
def create(self, item: TitleLibraryItem) -> TitleLibraryItem:
|
|
model = TitleLibraryModel(
|
|
id=item.id,
|
|
user_id=item.user_id,
|
|
name=item.name,
|
|
description=item.description,
|
|
category=item.category,
|
|
text=item.text,
|
|
tags=item.tags,
|
|
usage_count=item.usage_count,
|
|
is_active=item.is_active,
|
|
metadata=item.metadata_,
|
|
)
|
|
self.session.add(model)
|
|
self.session.commit()
|
|
self.session.refresh(model)
|
|
return self._model_to_entity(model)
|
|
|
|
def update(self, item: TitleLibraryItem) -> TitleLibraryItem:
|
|
model = self.session.query(TitleLibraryModel).filter(
|
|
TitleLibraryModel.id == item.id,
|
|
TitleLibraryModel.user_id == item.user_id,
|
|
).first()
|
|
if model is None:
|
|
raise ValueError(f"TitleLibraryItem {item.id} not found")
|
|
model.name = item.name
|
|
model.description = item.description
|
|
model.category = item.category
|
|
model.text = item.text
|
|
model.tags = item.tags
|
|
model.is_active = item.is_active
|
|
model.metadata = item.metadata_
|
|
self.session.commit()
|
|
self.session.refresh(model)
|
|
return self._model_to_entity(model)
|
|
|
|
def delete(self, title_id: str, user_id: str) -> bool:
|
|
model = self.session.query(TitleLibraryModel).filter(
|
|
TitleLibraryModel.id == title_id,
|
|
TitleLibraryModel.user_id == user_id,
|
|
).first()
|
|
if model is None:
|
|
return False
|
|
model.is_active = False
|
|
self.session.commit()
|
|
return True
|
|
|
|
def count_by_user(self, user_id: str, is_active: bool = True) -> int:
|
|
return self.session.query(TitleLibraryModel).filter(
|
|
TitleLibraryModel.user_id == user_id,
|
|
TitleLibraryModel.is_active == is_active,
|
|
).count()
|
|
|
|
@staticmethod
|
|
def _model_to_entity(model: TitleLibraryModel) -> TitleLibraryItem:
|
|
return TitleLibraryItem(
|
|
id=model.id,
|
|
user_id=model.user_id,
|
|
name=model.name,
|
|
description=model.description,
|
|
category=model.category,
|
|
text=model.text,
|
|
tags=model.tags or [],
|
|
usage_count=model.usage_count or 0,
|
|
is_active=model.is_active,
|
|
metadata_=model.metadata or {},
|
|
created_at=model.created_at,
|
|
updated_at=model.updated_at,
|
|
)
|