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 字段
225 lines
11 KiB
Python
Executable File
225 lines
11 KiB
Python
Executable File
from datetime import datetime, timezone
|
|
|
|
from sqlalchemy import Boolean, Column, DateTime, Float, Integer, String, Text, JSON, UniqueConstraint, create_engine
|
|
from sqlalchemy.orm import declarative_base
|
|
|
|
Base = declarative_base()
|
|
|
|
|
|
class UserModel(Base):
|
|
__tablename__ = "users"
|
|
|
|
id = Column(String(36), primary_key=True)
|
|
email = Column(String(255), nullable=False, unique=True, index=True)
|
|
username = Column(String(100), nullable=True, unique=True, index=True)
|
|
display_name = Column(String(255), nullable=False)
|
|
password_hash = Column(String(255), nullable=False)
|
|
email_verified = Column(Boolean, nullable=False, default=False)
|
|
email_verification_token = Column(String(255), nullable=True)
|
|
password_reset_token = Column(String(255), nullable=True)
|
|
password_reset_expires_at = Column(DateTime, nullable=True)
|
|
last_login_at = Column(DateTime, nullable=True)
|
|
last_login_ip = Column(String(50), nullable=True)
|
|
# 订阅相关字段 (移到 User 级别)
|
|
subscription_plan = Column(String(20), nullable=False, default="free")
|
|
subscription_status = Column(String(20), nullable=False, default="active")
|
|
subscription_expires_at = Column(DateTime, nullable=True)
|
|
# 配额限制 (移到 User 级别)
|
|
max_projects = Column(Integer, nullable=False, default=3)
|
|
max_storage_gb = Column(Integer, nullable=False, default=10)
|
|
used_storage_gb = Column(Integer, nullable=False, default=0)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class ProjectModel(Base):
|
|
__tablename__ = "projects"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
owner_user_id = Column(String(32), nullable=False, index=True)
|
|
name = Column(String(100), nullable=False)
|
|
description = Column(Text, nullable=False, default="")
|
|
shared_users = Column(JSON, nullable=False, default=list) # 被共享的用户 ID 列表
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class AssetLibraryModel(Base):
|
|
__tablename__ = "asset_libraries"
|
|
|
|
id = Column(String(36), primary_key=True)
|
|
project_id = Column(String(36), nullable=True, index=True)
|
|
name = Column(String(255), nullable=False)
|
|
kind = Column(String(20), nullable=False, index=True)
|
|
asset_count = Column(Float, nullable=False, default=0)
|
|
total_size = Column(Float, nullable=False, default=0)
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class AssetModel(Base):
|
|
__tablename__ = "assets"
|
|
|
|
id = Column(String(36), primary_key=True)
|
|
project_id = Column(String(36), nullable=False, index=True)
|
|
asset_library_id = Column(String(36), nullable=False, index=True)
|
|
name = Column(String(500), nullable=False)
|
|
file_type = Column(String(20), nullable=False, index=True)
|
|
# storage_key: OSS 对象键（相对路径），用于内部存储和操作
|
|
storage_key = Column(String(255), nullable=False)
|
|
# file_size: 文件大小（字节），使用 Integer 类型以确保精确性
|
|
file_size = Column(Integer, nullable=False)
|
|
# file_url: 完整可访问的 URL，用于客户端直接访问文件
|
|
file_url = Column(String(1000), nullable=False)
|
|
thumbnail_url = Column(String(1000), nullable=True)
|
|
duration = Column(Float, nullable=True)
|
|
width = Column(Float, nullable=True)
|
|
height = Column(Float, nullable=True)
|
|
fps = Column(Float, nullable=True)
|
|
codec = Column(String(50), nullable=True)
|
|
status = Column(String(20), nullable=False, default="uploading", index=True)
|
|
classification_status = Column(String(20), nullable=False, default="pending", index=True)
|
|
classification_result = Column(Text, nullable=True)
|
|
quality_score = Column(Float, nullable=True)
|
|
uploaded_by_user_id = Column(String(36), nullable=False)
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc), index=True)
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
|
|
class EditTemplateModel(Base):
|
|
__tablename__ = "edit_templates"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
project_id = Column(String(32), nullable=False, index=True)
|
|
name = Column(String(120), nullable=False)
|
|
description = Column(Text, nullable=False, default="")
|
|
target_duration = Column(Float, nullable=False, default=30)
|
|
clip_count = Column(Integer, nullable=False, default=3)
|
|
is_active = Column(Boolean, nullable=False, default=True)
|
|
created_by_user_id = Column(String(32), nullable=False, default="")
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
|
|
|
|
|
|
class IngestJobModel(Base):
|
|
__tablename__ = "ingest_jobs"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
project_id = Column(String(32), nullable=False, index=True)
|
|
library_id = Column(String(32), nullable=False, index=True)
|
|
storage_key = Column(String(255), nullable=False)
|
|
status = Column(String(20), nullable=False, default="pending")
|
|
error_message = Column(Text, nullable=False, default="")
|
|
result_asset_id = Column(String(32), nullable=False, default="")
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class ClassificationJobModel(Base):
|
|
__tablename__ = "classification_jobs"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
project_id = Column(String(32), nullable=False, index=True)
|
|
asset_id = Column(String(32), nullable=False, index=True)
|
|
status = Column(String(20), nullable=False, default="pending")
|
|
classification = Column(String(50), nullable=False, default="")
|
|
confidence = Column(Float, nullable=False, default=0.0)
|
|
error_message = Column(Text, nullable=False, default="")
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class GenerationTaskModel(Base):
|
|
__tablename__ = "generation_tasks"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
project_id = Column(String(32), nullable=False, index=True)
|
|
strategy_id = Column(String(32), nullable=False, default="")
|
|
asset_library_id = Column(String(32), nullable=False, index=True)
|
|
voice_library_id = Column(String(32), nullable=False, default="")
|
|
editing_mode = Column(String(20), nullable=False, default="one_take", index=True) # 剪辑模式: one_take, pip, voice_over, voice_pip
|
|
status = Column(String(20), nullable=False, default="pending", index=True)
|
|
progress = Column(Float, nullable=False, default=0.0)
|
|
result_count = Column(Float, nullable=False, default=0)
|
|
error_message = Column(Text, nullable=False, default="")
|
|
started_at = Column(DateTime, nullable=True)
|
|
completed_at = Column(DateTime, nullable=True)
|
|
created_by_user_id = Column(String(32), nullable=False, default="")
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class GeneratedVideoModel(Base):
|
|
__tablename__ = "generated_videos"
|
|
|
|
id = Column(String(32), primary_key=True)
|
|
project_id = Column(String(32), nullable=False, index=True)
|
|
generation_task_id = Column(String(32), nullable=False, index=True)
|
|
name = Column(String(255), nullable=False)
|
|
# file_url: 完整可访问的 URL，用于客户端直接访问视频
|
|
file_url = Column(String(1000), nullable=False)
|
|
# file_size: 文件大小（字节），使用 Integer 类型以确保精确性
|
|
file_size = Column(Integer, nullable=False)
|
|
duration = Column(Float, nullable=False)
|
|
thumbnail_url = Column(String(1000), nullable=True)
|
|
width = Column(Float, nullable=False)
|
|
height = Column(Float, nullable=False)
|
|
fps = Column(Float, nullable=False)
|
|
status = Column(String(20), nullable=False, default="completed", index=True)
|
|
review_status = Column(String(20), nullable=False, default="pending_review", index=True)
|
|
generation_params = Column(Text, nullable=False, default="{}")
|
|
generated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=True)
|
|
video_fingerprint = Column(Text, nullable=True)
|
|
is_duplicate = Column(Boolean, nullable=False, default=False)
|
|
duplicate_of = Column(String(32), nullable=True)
|
|
|
|
|
|
|
|
|
|
|
|
class TitleLibraryModel(Base):
|
|
__tablename__ = "title_libraries"
|
|
|
|
id = Column(String(36), primary_key=True)
|
|
user_id = Column(String(36), nullable=False, index=True)
|
|
name = Column(String(255), nullable=False)
|
|
description = Column(Text, nullable=False, default="")
|
|
category = Column(String(50), nullable=False, default="default", index=True)
|
|
text = Column(String(500), nullable=False)
|
|
tags = Column(JSON, nullable=False, default=list)
|
|
usage_count = Column(Integer, nullable=False, default=0)
|
|
is_active = Column(Boolean, nullable=False, default=True, index=True)
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|
|
|
|
class VoiceLibraryModel(Base):
|
|
__tablename__ = "voice_libraries"
|
|
|
|
id = Column(String(36), primary_key=True)
|
|
user_id = Column(String(36), nullable=False, index=True)
|
|
project_id = Column(String(36), nullable=True, index=True)
|
|
name = Column(String(255), nullable=False)
|
|
text = Column(Text, nullable=False, default="")
|
|
voice_provider = Column(String(50), nullable=False, default="")
|
|
voice_id = Column(String(100), nullable=False, default="")
|
|
voice_name = Column(String(100), nullable=False, default="")
|
|
audio_url = Column(String(1000), nullable=False, default="")
|
|
duration = Column(Float, nullable=False, default=0)
|
|
file_size = Column(Integer, nullable=False, default=0)
|
|
status = Column(String(20), nullable=False, default="completed", index=True)
|
|
tags = Column(JSON, nullable=False, default=list)
|
|
metadata = Column(JSON, nullable=False, default=dict)
|
|
created_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
updated_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
|
|
|