Skip to content

PRINTFILM: AI short-video marketing and AI short-drama creation platform

9.2 KB
Raw Blame
"""团队项目列表、个人项目迁入与团队资产副本接口。"""
from typing import Literal

from fastapi import APIRouter, Depends, Query, Request
from pydantic import BaseModel, ConfigDict, Field
from sqlalchemy.ext.asyncio import AsyncSession

from app.database import get_db
from app.deps import get_current_user
from app.models import User
from app.schemas_drama import DramaAssetOut, DramaProjectCreate, DramaProjectOut
from app.services.drama.asset_reference_views import asset_reference_view
from app.services.teams import content

router = APIRouter(prefix="/teams/{team_id}", tags=["team-content"])
personal_router = APIRouter(prefix="/drama", tags=["drama-assets"])


class TeamProjectCreate(BaseModel):
    """真实项目创意由用户提供,不以占位文本冒充。"""
    model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
    title: str = Field(min_length=1, max_length=200)
    description: str = Field(default="", max_length=512)
    source: str = Field(min_length=20, max_length=100000)
    episode_count: int = Field(default=1, strict=True, ge=1, le=120, description="初始集数,支持 1 至 120 集,后续可在项目中增加分集")
    workflow: Literal["script", "canvas"] = "script"


class TeamAssetCopy(BaseModel):
    """只接收目标项目,源内容和来源标记完全由数据库取得。"""
    model_config = ConfigDict(extra="forbid")
    project_id: int = Field(strict=True, gt=0)


@router.get(
    "/projects",
    summary="分页查询团队漫剧项目",
    description="需要登录且为团队有效成员,按标题或描述关键词、项目状态筛选当前团队项目,返回项目卡片、协作者、编辑占用和分页信息。",
    response_description="团队项目卡片及分页信息",
)
async def list_projects(team_id: int, page: int = Query(1, ge=1, description="页码,从 1 开始"), page_size: int = Query(20, ge=1, le=100, description="每页返回的记录数"), q: str = Query("", max_length=200, description="项目标题或描述搜索关键词"), status: Literal["draft", "producing", "completed"] | None = None, db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> dict:
    """需要登录且为团队有效成员,按标题或描述关键词、项目状态筛选当前团队项目,返回项目卡片、协作者、编辑占用和分页信息。"""
    return await content.list_projects(db, team_id, user.id, page, page_size, q, status)


@router.get(
    "/assets",
    summary="分页查询团队资产",
    description="需要登录且为团队有效成员,分页查询本团队可访问项目中的角色、场景、道具和音色,支持名称、资产类型及项目筛选。",
    response_description="团队资产及分页信息",
)
async def list_assets(team_id: int, page: int = Query(1, ge=1, description="页码,从 1 开始"), page_size: int = Query(20, ge=1, le=100, description="每页返回的记录数"), q: str = Query("", max_length=200, description="资产名称搜索关键词"), type: Literal["character", "scene", "prop", "voice"] | None = None, project_id: int | None = Query(None, gt=0, description="项目编号"), db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> dict:
    """需要登录且为团队有效成员,分页查询本团队可访问项目中的角色、场景、道具和音色,支持名称、资产类型及项目筛选。"""
    return await content.list_assets(db, team_id, user.id, page, page_size, q, type, project_id)


@router.post(
    "/projects",
    response_model=DramaProjectOut,
    status_code=201,
    summary="创建团队漫剧项目",
    description="需要登录且为团队有效成员,根据用户提供的真实创意创建绑定团队的漫剧项目,支持剧本或画布工作流。创建时不自动提交收费生成任务。",
    response_description="新建团队漫剧项目",
)
async def create_project(team_id: int, body: TeamProjectCreate, db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> DramaProjectOut:
    """需要登录且为团队有效成员,根据用户提供的真实创意创建绑定团队的漫剧项目,支持剧本或画布工作流。创建时不自动提交收费生成任务。"""
    from app.api.drama.projects import create_project as create_drama_project
    return await create_drama_project(DramaProjectCreate(team_id=team_id, **body.model_dump()), db=db, user=user, scope_team_id=team_id)


@router.get(
    "/transferable-projects",
    summary="查询可迁入团队的个人项目",
    description="需要登录且为团队有效成员,分页列出本人的个人漫剧项目及可迁入标志;存在生成任务或编辑占用时返回不可迁入原因。",
    response_description="个人项目及迁入可用性",
)
async def transferable_projects(team_id: int, page: int = Query(1, ge=1, description="页码,从 1 开始"), page_size: int = Query(20, ge=1, le=100, description="每页返回的记录数"), db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> dict:
    """需要登录且为团队有效成员,分页列出本人的个人漫剧项目及可迁入标志;存在生成任务或编辑占用时返回不可迁入原因。"""
    return await content.transferable_projects(db, team_id, user.id, page, page_size)


@router.post(
    "/projects/{project_id}/transfer",
    response_model=DramaProjectOut,
    summary="迁入个人漫剧项目",
    description=(
        "需要登录且为团队有效成员,将本人无活动任务、无有效编辑占用的个人项目整体迁入指定团队。"
        "保留项目编号与历史计费归属;已在同一团队时可重复请求,其他团队项目不可迁入。"
    ),
    response_description="迁入后的漫剧项目详情",
)
async def transfer_project(team_id: int, project_id: int, db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> DramaProjectOut:
    """需要登录且为团队有效成员,将本人无活动任务、无有效编辑占用的个人项目整体迁入指定团队。保留项目编号与历史计费归属;已在同一团队时可重复请求,其他团队项目不可迁入。"""
    from app.api.drama.projects import get_project
    project, copier = await content.transfer_project(db, team_id, user.id, project_id)
    try:
        await db.commit()
    except Exception:
        await db.rollback()
        if copier:
            copier.cleanup()
        raise
    return await get_project(project.id, db=db, user=user)


@router.post(
    "/assets/{asset_id}/copy",
    response_model=DramaAssetOut,
    status_code=201,
    summary="复制团队资产到项目",
    description=(
        "需要登录且为团队有效成员,源资产和目标项目必须属于当前团队。"
        "需提供目标项目 asset:0 的编辑租约请求头 X-Edit-Session、X-Edit-Token、X-Edit-Version,创建资产和媒体的独立副本,保留来源标记。"
    ),
    response_description="新建的独立资产副本",
)
async def copy_asset(team_id: int, asset_id: int, body: TeamAssetCopy, request: Request, db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> DramaAssetOut:
    """需要登录且为团队有效成员,源资产和目标项目必须属于当前团队。需提供目标项目 asset:0 的编辑租约请求头 X-Edit-Session、X-Edit-Token、X-Edit-Version,创建资产和媒体的独立副本,保留来源标记。"""
    from fastapi import HTTPException
    try:
        version = int(request.headers.get("X-Edit-Version", "0"))
    except ValueError as exc:
        raise HTTPException(422, "无效的编辑版本") from exc
    asset, copier = await content.copy_asset(db, team_id, user.id, asset_id, body.project_id, request.headers.get("X-Edit-Session", ""), request.headers.get("X-Edit-Token", ""), version)
    try:
        await db.commit()
    except Exception:
        await db.rollback()
        copier.cleanup()
        raise
    return await asset_reference_view(db, asset, user_id=user.id)


@personal_router.post(
    "/assets/{asset_id}/copy",
    response_model=DramaAssetOut,
    status_code=201,
    summary="复制个人空间资产",
    description=(
        "需要登录,将可访问资产复制到指定目标项目。个人空间只允许复制本人的资产;"
        "目标为团队项目时,源目标必须同队且需提供目标 asset:0 的 X-Edit-Session、X-Edit-Token、X-Edit-Version 租约请求头。"
    ),
    response_description="新建的独立资产副本",
)
async def copy_owned_asset(asset_id: int, body: TeamAssetCopy, request: Request, db: AsyncSession = Depends(get_db), user: User = Depends(get_current_user)) -> DramaAssetOut:
    """需要登录,将可访问资产复制到指定目标项目。个人空间只允许复制本人的资产;目标为团队项目时,源目标必须同队且需提供目标 asset:0 的 X-Edit-Session、X-Edit-Token、X-Edit-Version 租约请求头。"""
    from fastapi import HTTPException
    from app.models_drama import DramaProject

    target = await db.get(DramaProject, body.project_id)
    if not target:
        raise HTTPException(404, "目标项目不存在")
    return await copy_asset(target.team_id, asset_id, body, request, db=db, user=user)