203671a7bf
Add the experience service with sites through analytics/AI hooks, migrations through 0011, and phase docs/manifests marking the track complete. Co-authored-by: Cursor <cursoragent@cursor.com>
138 lines
4.7 KiB
Python
138 lines
4.7 KiB
Python
"""Localization content APIs — Phase 11.5."""
|
|
from __future__ import annotations
|
|
|
|
from uuid import UUID
|
|
|
|
from fastapi import APIRouter, Depends, Query, status
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from app.api.deps import get_db, get_pagination, require_tenant
|
|
from app.api.permissions import require_permissions
|
|
from app.commands.localization import LocalizationCommands
|
|
from app.permissions.definitions import (
|
|
LOCALES_CREATE,
|
|
LOCALES_DELETE,
|
|
LOCALES_UPDATE,
|
|
LOCALES_VIEW,
|
|
)
|
|
from app.queries.localization import LocalizationQueries
|
|
from app.schemas.localization import (
|
|
ExperienceLocalizationListResponse,
|
|
ExperienceLocalizationRead,
|
|
ExperienceLocalizationUpdate,
|
|
ExperienceLocalizationUpsert,
|
|
)
|
|
from app.specifications.localization import (
|
|
LOCALIZATION_SORT_FIELDS,
|
|
LocalizationListSpec,
|
|
)
|
|
from shared.pagination import PaginationParams
|
|
from shared.security import CurrentUser
|
|
|
|
router = APIRouter()
|
|
|
|
_STATUSES = {"draft", "active", "archived"}
|
|
_TARGETS = {
|
|
"site",
|
|
"page",
|
|
"component_placement",
|
|
"template",
|
|
"theme",
|
|
"layout",
|
|
"media_ref",
|
|
}
|
|
_DIRECTIONS = {"rtl", "ltr"}
|
|
|
|
|
|
def _list_spec(
|
|
workspace_id: UUID | None = Query(default=None),
|
|
target_type: str | None = Query(default=None, max_length=50),
|
|
target_id: UUID | None = Query(default=None),
|
|
locale: str | None = Query(default=None, max_length=16),
|
|
text_direction: str | None = Query(default=None, max_length=3),
|
|
status_filter: str | None = Query(default=None, alias="status"),
|
|
q: str | None = Query(default=None, max_length=100),
|
|
sort_by: str = Query(default="created_at"),
|
|
sort_dir: str = Query(default="desc", pattern="^(?i)(asc|desc)$"),
|
|
) -> LocalizationListSpec:
|
|
if sort_by not in LOCALIZATION_SORT_FIELDS:
|
|
sort_by = "created_at"
|
|
return LocalizationListSpec(
|
|
workspace_id=workspace_id,
|
|
target_type=target_type if target_type in _TARGETS else None,
|
|
target_id=target_id,
|
|
locale=locale,
|
|
text_direction=text_direction if text_direction in _DIRECTIONS else None,
|
|
status=status_filter if status_filter in _STATUSES else None,
|
|
q=q,
|
|
sort_by=sort_by,
|
|
sort_dir=sort_dir.lower(),
|
|
)
|
|
|
|
|
|
@router.post(
|
|
"",
|
|
response_model=ExperienceLocalizationRead,
|
|
status_code=status.HTTP_201_CREATED,
|
|
)
|
|
async def upsert_localization(
|
|
body: ExperienceLocalizationUpsert,
|
|
tenant_id: UUID = Depends(require_tenant),
|
|
db: AsyncSession = Depends(get_db),
|
|
user: CurrentUser = Depends(require_permissions(LOCALES_CREATE)),
|
|
):
|
|
return await LocalizationCommands(db).upsert_localization(
|
|
tenant_id, body, actor=user
|
|
)
|
|
|
|
|
|
@router.get("", response_model=ExperienceLocalizationListResponse)
|
|
async def list_localizations(
|
|
tenant_id: UUID = Depends(require_tenant),
|
|
pagination: PaginationParams = Depends(get_pagination),
|
|
spec: LocalizationListSpec = Depends(_list_spec),
|
|
db: AsyncSession = Depends(get_db),
|
|
_user: CurrentUser = Depends(require_permissions(LOCALES_VIEW)),
|
|
):
|
|
items, total = await LocalizationQueries(db).list_localizations(
|
|
tenant_id, offset=pagination.offset, limit=pagination.page_size, spec=spec
|
|
)
|
|
return ExperienceLocalizationListResponse(
|
|
items=items, total=total, page=pagination.page, page_size=pagination.page_size
|
|
)
|
|
|
|
|
|
@router.get("/{localization_id}", response_model=ExperienceLocalizationRead)
|
|
async def get_localization(
|
|
localization_id: UUID,
|
|
tenant_id: UUID = Depends(require_tenant),
|
|
db: AsyncSession = Depends(get_db),
|
|
_user: CurrentUser = Depends(require_permissions(LOCALES_VIEW)),
|
|
):
|
|
return await LocalizationQueries(db).get_localization(tenant_id, localization_id)
|
|
|
|
|
|
@router.patch("/{localization_id}", response_model=ExperienceLocalizationRead)
|
|
async def update_localization(
|
|
localization_id: UUID,
|
|
body: ExperienceLocalizationUpdate,
|
|
tenant_id: UUID = Depends(require_tenant),
|
|
db: AsyncSession = Depends(get_db),
|
|
user: CurrentUser = Depends(require_permissions(LOCALES_UPDATE)),
|
|
):
|
|
return await LocalizationCommands(db).update_localization(
|
|
tenant_id, localization_id, body, actor=user
|
|
)
|
|
|
|
|
|
@router.delete("/{localization_id}", response_model=ExperienceLocalizationRead)
|
|
async def delete_localization(
|
|
localization_id: UUID,
|
|
tenant_id: UUID = Depends(require_tenant),
|
|
db: AsyncSession = Depends(get_db),
|
|
user: CurrentUser = Depends(require_permissions(LOCALES_DELETE)),
|
|
):
|
|
return await LocalizationCommands(db).soft_delete_localization(
|
|
tenant_id, localization_id, actor=user
|
|
)
|