o2o-site-AEO/solution/backend/router/v1/local/protocol.py
김성경 01824a7a91 [feat] solution,admin,postgres-init: 주변정보를 업장 좌표 기준으로 — 시군구 캐시는 "가까운 곳"을 못 준다
지역 정보(맛집·관광지·축제)는 행정구역 코드(local_contents.region_code) 단위로 캐시돼
"그 시군구에 있는 것"을 줬다. 양양군 업장 옆 5km 속초 관광지는 빠지고 같은 군 반대편
30km 맛집이 붙는 구조라, 캔버스의 지역 정보 섹션은 늘 "준비 중"이었다. 업장 좌표로
TourAPI 를 직접 물어 업장 단위(place_contents)에 담고, 캔버스는 스크린샷으로 받은
형식(도보 시간 필터 + 카드 캐러셀)으로 통일했다.
2026-09-08 11:46:03 +09:00

103 lines
2.9 KiB
Python

import uuid
from datetime import datetime
from typing import Any
from pydantic import ConfigDict, Field
from common.enums import LocalContentStatus, LocalContentType, LocalSource
from common.models.gmodel import Res_WebPacketProtocol, WebPacketProtocol
class LocalContentData(WebPacketProtocol):
model_config = ConfigDict(from_attributes=True)
local_content_id: uuid.UUID
region_code: str
content_type: LocalContentType
source: LocalSource
external_id: str | None = None
title: str | None = None
body: dict[str, Any]
status: LocalContentStatus
collected_at: datetime | None = None
published_at: datetime | None = None
display_start_at: datetime | None = None
display_end_at: datetime | None = None
class PlaceContentData(WebPacketProtocol):
"""업장 반경 주변정보 1건(admin 목록용)."""
model_config = ConfigDict(from_attributes=True)
place_content_id: uuid.UUID
place_id: uuid.UUID
content_type: LocalContentType
external_id: str
title: str
body: dict[str, Any]
distance_m: int
has_image: bool
hidden: bool
display_end_at: datetime | None = None
collected_at: datetime | None = None
class ResPlaceContentList(Res_WebPacketProtocol):
contents: list[PlaceContentData] = []
class ReqHidePlaceContent(WebPacketProtocol):
hidden: bool
class ReqPublishLocalContent(WebPacketProtocol):
content_ids: list[uuid.UUID] = Field(min_length=1, max_length=100)
class ReqUpdateLocalContent(WebPacketProtocol):
title: str | None = Field(default=None, min_length=1, max_length=300)
body: dict[str, Any] | None = None
display_start_at: datetime | None = None
display_end_at: datetime | None = None
class ResLocalContentList(Res_WebPacketProtocol):
contents: list[LocalContentData] = []
class ResSyncPlace(Res_WebPacketProtocol):
"""업장 반경 동기화 결과 — 종류별로 **남긴** 건수(반경·기간 필터 뒤). changed 는 값이 바뀌었는지."""
festivals: int = 0
attractions: int = 0
restaurants: int = 0
courses: int = 0
changed: bool = False
class ResLocalGuide(Res_WebPacketProtocol):
"""에디터 캔버스가 그리는 지역 가이드. ★ 항목 모양은 발행 payload 의 LocalContents 와 **동일**하다
(services/site_payload._local 을 그대로 거친다) — 캔버스와 발행본이 다른 목록을 보이면 안 된다."""
attractions: list[dict[str, Any]] = []
restaurants: list[dict[str, Any]] = []
festivals: list[dict[str, Any]] = []
courses: list[dict[str, Any]] = []
synced_at: str | None = None
class WeatherData(WebPacketProtocol):
temperature: float
weather_code: int
wind_speed: float | None = None
observed_at: str
timezone: str | None = None
latitude: float
longitude: float
class ResWeather(Res_WebPacketProtocol):
weather: WeatherData | None = None
cached: bool = False
stale: bool = False