import uuid from datetime import datetime from typing import Optional from pydantic import ConfigDict from common.enums import FactStatus, FactWriteOutcome, SourceType from common.models.gmodel import Res_WebPacketProtocol, WebPacketProtocol class FactProtocol(WebPacketProtocol): pass class Req_UpsertFact(FactProtocol): """fact 기록. key 는 사업장 업종의 스키마에 있는 것만 허용한다. ★ source_type 이 owner 가 아니면 source_url 이 필수다 — 출처 없는 사실은 받지 않는다.""" key: str = "" value: Optional[str] = None unit_id: Optional[uuid.UUID] = None source_type: SourceType = SourceType.OWNER source_url: Optional[str] = None expires_at: Optional[datetime] = None class Req_ExtractFacts(FactProtocol): """사장님이 붙여넣은 원문에서 fact 를 뽑는다. ★ 왜 이 입구가 필요한가 (2026-08-31) TourAPI 에 없고 네이버에도 요금표뿐인 업소가 흔하다(실측: 조이모텔 — 수집 fact 6건이 전부 대실·숙박 요금이었다). 그런 업소는 자동 수집만으로는 발행 근거가 영영 안 찬다. 폴백 3단계의 2번(사장님이 직접 붙여넣기)이 여기다. ★ 뽑은 값은 전부 **후보(UNVERIFIED)** 로 들어간다. 사장님이 확인해야 사이트에 나간다.""" text: str = "" class Res_ExtractedFact(WebPacketProtocol): key: str = "" label: str = "" value: str = "" unit_name: Optional[str] = None stored: bool = False reason: Optional[str] = None # 저장 못 한 이유(사람이 읽는 문장) class Res_ExtractFacts(Res_WebPacketProtocol): """뽑힌 것과 버려진 것을 **둘 다** 돌려준다. ★ 조용히 버리지 않는다 — 사장님이 "내가 쓴 체크인 시간이 왜 안 들어갔지" 를 화면에서 바로 확인할 수 있어야 한다.""" stored: int = 0 rejected: int = 0 facts: list[Res_ExtractedFact] = [] # (버린 항목, 사유). 모델이 지어낸 값·스키마 밖 key 가 여기로 온다. rejections: list[list[str]] = [] class Req_TransitionFact(FactProtocol): """검증 상태 전이. 허용 전이는 FACT_STATUS_TRANSITIONS 가 유일한 소스다.""" status: FactStatus = FactStatus.VERIFIED value: Optional[str] = None # CORRECTED 로 갈 때 고친 값(다른 전이에선 무시) class FactData(WebPacketProtocol): model_config = ConfigDict(from_attributes=True) fact_id: uuid.UUID place_id: uuid.UUID unit_id: Optional[uuid.UUID] = None key: str value: Optional[str] = None unit: Optional[str] = None source_type: SourceType source_url: Optional[str] = None collected_at: Optional[datetime] = None verified_by: Optional[uuid.UUID] = None verified_at: Optional[datetime] = None status: FactStatus expires_at: Optional[datetime] = None class FieldSpecData(WebPacketProtocol): """업종 스키마의 필드 정의 — 관리 화면이 입력 폼을 그리는 데 쓴다.""" key: str label: str type: str scope: str required: bool critical: bool # ★ 미검증 노출 금지 대상 allow_llm: bool unit: Optional[str] = None class Res_FactList(Res_WebPacketProtocol): facts: list[FactData] = [] publishable: int = 0 # ★ 사이트에 나갈 수 있는 fact 수(VERIFIED·CORRECTED) pending_review: int = 0 # 재수집이 올려놓은 확인 대기 후보 수(관리 화면 배지) class Res_Fact(Res_WebPacketProtocol): fact: Optional[FactData] = None # 기록/전이가 무엇을 했는지. PUBLISHED_REPLACED 면 사이트 재빌드 대상이다. outcome: Optional[FactWriteOutcome] = None class Res_CategorySchema(Res_WebPacketProtocol): category: Optional[str] = None label: Optional[str] = None fields: list[FieldSpecData] = []