o2o-site-AEO/solution/backend/router/v1/site/site.py

from uuid import UUID

from fastapi.responses import JSONResponse
from fastapi import APIRouter, Depends, Query

from common.models.gmodel import PageParams, UserInfo
from common.template_catalog import UnknownTemplate
from router.v1.validator.dependencies import IsValidAccessToken, RemoveNoneResponse
from services.site_service import SiteService
from .protocol import (
    Req_Rollback,
    Req_SiteSlug,
    Req_SiteStatus,
    Req_SiteTemplate,
    Req_SiteTheme,
    Req_StartBuild,
    Res_MySites,
    Res_PublishLogs,
    Res_Site,
    Res_SeoAudit,
    Res_SiteSlug,
    Res_SiteVersions,
    Res_SlugCheck,
    Res_StartBuild,
)

# 사이트/발행 라우터.
router = APIRouter(prefix="/v1/place/{place_id}/site", tags=["Site"], responses={404: {"description": "Not found"}})

# 내 사이트 목록은 사업장 하위가 아니라 계정 하위다 — 위 라우터는 접두어에 place_id 가 박혀 있어 "내 것 전부"가 들어갈 자리가 없다.
my_router = APIRouter(prefix="/v1/site", tags=["Site"], responses={404: {"description": "Not found"}})


@my_router.get(
    path="/list",
    response_model=Res_MySites,
    summary="내 사이트 목록",
    description="로그인한 계정(회사)이 가진 사이트 전부. 아직 사이트가 만들어지지 않은 사업장도 "
                "site_id=null 로 함께 내려간다 — 위저드를 걸어오다 만 것을 목록에서 잃지 않게 한다.",
)
async def list_my_sites(
    service: SiteService = Depends(),
    user_info: UserInfo = Depends(IsValidAccessToken),
    pg: PageParams = Depends(),
):
    return RemoveNoneResponse(await service.list_my_sites(user_info, pg))


@router.get(
    path="",
    response_model=Res_Site,
    summary="사이트 상태",
    description="현재 발행 버전과 재빌드 필요 여부(needs_rebuild). "
                "노출값이 바뀐 뒤 다시 빌드하지 않았으면 true — 이 사업장만 재빌드하면 된다.",
)
async def get_site(place_id: UUID, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
    return RemoveNoneResponse(await service.get_site(user_info, str(place_id)))


@router.get(
    path="/audit",
    response_model=Res_SeoAudit,
    summary="SEO/AEO 준비도 진단",
    description="현재 확인된 콘텐츠와 최신 빌드를 SEO·AEO 각각 100점으로 채점하고 개선 항목을 반환한다. "
                "준비도 점수이며 실제 검색 순위나 AI 인용을 보장하지 않는다.",
)
async def get_seo_audit(
    place_id: UUID, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
):
    return RemoveNoneResponse(await service.get_seo_audit(user_info, str(place_id)))


@router.get(
    path="/slug/check",
    response_model=Res_SlugCheck,
    summary="사이트 주소 사용 가능 확인",
    description="쓰고 싶은 주소를 미리 본다. 소문자 영문·숫자·하이픈 3~50자만 되고, 예약어와 남이 쓰는 주소는 막힌다. "
                "★ 서버가 상호명으로 자동 확정하지 않는다 — 사람이 고른다. "
                "못 쓰면 reason(INVALID_LENGTH·INVALID_FORMAT·RESERVED·TAKEN)과 대안 하나(suggestion)를 준다. "
                "지금 자기가 쓰는 주소면 available=true 다.",
)
async def check_slug(
    place_id: UUID,
    service: SiteService = Depends(),
    user_info: UserInfo = Depends(IsValidAccessToken),
    slug: str = Query(..., description="쓰고 싶은 주소(예: doflo)"),
):
    return RemoveNoneResponse(await service.check_slug(user_info, str(place_id), slug))


@router.post(
    path="/slug",
    response_model=Res_SiteSlug,
    summary="사이트 주소 확정",
    description="주소를 sites.domain 에 저장한다(사이트 행이 없으면 만든다). "
                "검증은 check 와 같은 규칙으로 서버가 다시 한다 — 클라이언트 검증을 믿지 않는다. "
                "★ 이미 발행된 사이트의 주소는 바꿀 수 없다(SITE_SLUG_LOCKED) — "
                "색인된 주소가 바뀌면 AI 검색이 잡아 둔 페이지가 404 가 된다.",
)
async def set_slug(
    place_id: UUID, req: Req_SiteSlug, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
):
    return RemoveNoneResponse(await service.set_slug(user_info, str(place_id), req))


@router.post(
    path="/template",
    response_model=Res_Site,
    summary="템플릿(디자인) 선택 저장",
    description="sites.template_id 에 저장한다(사이트 행이 없으면 만든다). 업종 허용 목록에 없는 id는 거절한다. "
                "이미 발행된 사이트면 재빌드 표시(content_updated_at)를 찍는다.",
)
async def set_template(
    place_id: UUID,
    req: Req_SiteTemplate,
    service: SiteService = Depends(),
    user_info: UserInfo = Depends(IsValidAccessToken),
):
    return RemoveNoneResponse(await service.set_template(user_info, str(place_id), req))


@router.post(
    path="/theme",
    response_model=Res_Site,
    summary="디자인(색·섹션) 저장",
    description="sites.theme 에 저장한다(사이트 행이 없으면 만든다). body: "
                "{\"theme\":{\"colors\",\"look\",\"colorPaletteId\",\"sections\":[{\"id\",\"name\",\"enabled\",\"locked\",\"body\",\"data\"}]}}. "
                "배열 순서가 곧 섹션 순서다. 크기(64KB)만 막는다. 빈 값({})이면 업종 기본으로 되돌린다.",
)
async def set_theme(
    place_id: UUID,
    req: Req_SiteTheme,
    service: SiteService = Depends(),
    user_info: UserInfo = Depends(IsValidAccessToken),
):
    return RemoveNoneResponse(await service.set_theme(user_info, str(place_id), req))


@router.post(
    path="/build",
    response_model=Res_StartBuild,
    summary="정적 빌드(비동기)",
    description="스냅샷을 박제해 HTML + JSON-LD 를 만들고 발행 검수 게이트를 돌린다. "
                "publish=true 면 통과 시 바로 발행한다. ★ 게이트를 우회하는 옵션은 없다.",
)
async def start_build(
    place_id: UUID, req: Req_StartBuild, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
):
    return RemoveNoneResponse(await service.start_build(user_info, str(place_id), req))


@router.get(
    path="/preview",
    summary="에디터 미리보기 payload — 발행본과 같은 것",
    description="발행이 굽는 것과 **같은 함수**로 만든 SitePayload 를 그대로 준다. "
                "미리보기가 이 하나만 먹으면 캔버스와 발행본이 갈릴 자리가 없다. "
                "★ DB 도 파일도 건드리지 않는다 — 버전을 만들지 않으므로 눌러도 발행 이력이 안 쌓인다.",
)
async def site_preview(
    place_id: UUID,
    service: SiteService = Depends(),
    user_info: UserInfo = Depends(IsValidAccessToken),
):
    try:
        payload = await service.preview_payload(user_info, str(place_id))
    except UnknownTemplate as ex:
        return JSONResponse(status_code=422, content={"detail": str(ex)})
    if payload is None:
        return JSONResponse(status_code=404, content={"detail": "사업장을 찾지 못했습니다"})
    return JSONResponse(content=payload)


@router.post(
    path="/version/rollback",
    response_model=Res_StartBuild,
    summary="예전 버전으로 되돌리기(비동기)",
    description="target_version 을 다시 공개 주소로 내보낸다. 재수집·재생성을 하지 않는다 — "
                "그 버전이 발행될 때 박제된 snapshot 을 그대로 다시 굽는다. 렌더러가 그 사이 "
                "바뀌었을 수 있어 게이트는 다시 통과해야 한다. 실패하면 지금 공개된 버전은 그대로다.",
)
async def rollback_version(
    place_id: UUID, req: Req_Rollback, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
):
    return RemoveNoneResponse(await service.start_rollback(user_info, str(place_id), req))


@router.get(path="/version/list", response_model=Res_SiteVersions, summary="빌드 버전 목록")
async def list_versions(place_id: UUID, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
    return RemoveNoneResponse(await service.list_versions(user_info, str(place_id)))


@router.get(
    path="/log/list",
    response_model=Res_PublishLogs,
    summary="발행 기록",
    description="발행 시도와 거부 사유. 게이트가 막았으면 무엇이 문제였는지 detail 에 남는다.",
)
async def list_logs(place_id: UUID, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
    return RemoveNoneResponse(await service.list_logs(user_info, str(place_id)))


@router.post(
    path="/status",
    response_model=Res_Site,
    summary="발행 상태 전이(중지·재개·내림)",
    description="★ 해지는 삭제가 아니라 상태 전이다. 색인된 페이지를 갑자기 404 로 만들면 "
                "AI 검색이 그 자리를 다시 OTA 로 채운다.",
)
async def change_status(
    place_id: UUID, req: Req_SiteStatus, service: SiteService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
):
    return RemoveNoneResponse(await service.change_status(user_info, str(place_id), req))