import uuid
from datetime import datetime
from decimal import Decimal
from typing import Optional

from pydantic import ConfigDict

from common.enums import MediaStatus, SourceType
from common.models.gmodel import Res_WebPacketProtocol, WebPacketProtocol


# 라우터 폴더마다 protocol.py 를 두고 Req_/Res_ 를 정의한다 (protocol 규약).
class MediaProtocol(WebPacketProtocol):
    pass


class MediaData(WebPacketProtocol):
    """사진 1건.

    ★ source_type 과 origin_url 을 반드시 함께 내려보낸다 — 크롤링 이미지의 재게시 권리가
      아직 미결이라(docs/DECISIONS.md 1-2), 결론이 '불가'로 나면 발행에서 source_type = CRAWL 을
      통째로 제외해야 한다. 화면이 출처를 모르면 무엇이 빠질지도 미리 보여줄 수 없다.
      origin_url 은 그때 '이 사진은 어디서 왔는가'를 증명하는 유일한 근거다."""

    model_config = ConfigDict(from_attributes=True)

    media_id: uuid.UUID
    place_id: uuid.UUID
    unit_id: Optional[uuid.UUID] = None          # 객실·메뉴 사진이면 연결
    url: str                                     # 우리가 보관하는 접근 URL
    origin_url: Optional[str] = None             # ★ 수집 원본 이미지 URL — 권리 판단의 근거
    source_type: SourceType                      # ★ OWNER 업로드 / CRAWL 수집 — 발행 필터 키
    source_url: Optional[str] = None             # 수집한 페이지 URL
    label: Optional[str] = None                  # Vision 분류 라벨 (예: "A동 침실")
    alt_text: Optional[str] = None               # Vision 생성 alt
    vision_confidence: Optional[Decimal] = None  # 0.000~1.000
    status: MediaStatus                          # PENDING_REVIEW 는 사람 확인 큐에 남아 있다는 뜻
    width: Optional[int] = None
    height: Optional[int] = None
    sort_order: int = 0
    created_at: Optional[datetime] = None
    # DB 컬럼이 아니라 계산값이다 — '지금 발행하면 이 사진이 사이트에 실리는가'.
    # 판단 기준을 services/snapshot.py 와 똑같이 맞춘다(승인 + alt 있음). 화면이 "왜 이 사진은
    # 안 나오나"를 사장님에게 설명할 수 있어야 하는데, 그 답이 상태 하나로는 안 나오기 때문이다.
    publishable: bool = False


class Res_MediaList(Res_WebPacketProtocol):
    media: list[MediaData] = []
    publishable: int = 0     # ★ 실제로 사이트에 나갈 수 있는 사진 수(승인 + alt 있음)
    pending_review: int = 0  # 사람 확인 큐에 남은 사진 수(관리 화면 배지)
    crawled: int = 0         # ★ 재게시 권리 미결(1-2) — 결론이 '불가'면 통째로 빠질 사진 수