Mina Choi
64ce467f21
도메인별 스키마(company·place·fact·local·site·job)를 걷어내고 public 한 벌로 폈다.
스키마 한정자가 붙은 순간부터 ORM·raw SQL·테스트 픽스처가 각자 그 이름을 들고 다녀야 했다.
- 공용 콘텐츠를 한 테이블로 되돌린다. spots·region_stories 를 따로 파 놓고 보니
같은 성격이 세 곳으로 갈라져 있었다 — `area_contents` 가 처음부터 content_type 으로
종류를 가르는 설계였고 그걸 쓰면 됐다. 관계(거리·숨김)만 `place_area_refs` 로 남긴다.
- migrations/ + scripts/migrate.py: `init.sql` 은 **DB 를 처음 만들 때만** 돈다. 파일에
컬럼을 더해도 이미 데이터가 든 DB 에는 반영되지 않는다 — 실제로 TourAPI 가 주변 정보를
받아 와도 저장할 곳이 없어 축제·맛집이 0건이었고, 화면에는 "그냥 안 나오는 것" 으로만 보였다.
DECISIONS.md 가 예고한 그대로다("운영 DB 가 생기는 순간 다시 필요해진다").
Alembic 을 쓰지 않는 이유는 스키마 정의가 이미 두 곳(ORM·init.sql)이라 세 번째를
더하면 어긋날 자리가 하나 더 생기기 때문이다.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
92 lines
4.7 KiB
Python
92 lines
4.7 KiB
Python
import uuid
|
|
|
|
from fastapi import Depends
|
|
|
|
from common.database.db_session_manager import DB_SESSION_MNG
|
|
from common.database.model.models import place_photos, places
|
|
from common.enums import DBWRType, ErrorType, MediaStatus, SourceType
|
|
from common.models.gmodel import UserInfo
|
|
from crud.media_crud import IMediaCRUD, MediaCRUD
|
|
from crud.place_crud import PlaceCRUD
|
|
from router.v1.media.protocol import MediaData, Res_MediaList
|
|
|
|
|
|
def _is_publishable(row) -> bool:
|
|
"""이 사진이 지금 사이트에 실릴 수 있는가.
|
|
|
|
★ 판단 기준을 services/snapshot.py 와 한 글자도 다르지 않게 맞춘다 —
|
|
관리 화면이 '나간다'고 표시한 사진이 발행에서 빠지면 그게 제일 설명하기 어려운 버그다.
|
|
승인(APPROVED)만으로는 부족하다. alt 가 빈 사진은 빌더가 렌더 자체를 하지 않는다."""
|
|
return row.status == MediaStatus.APPROVED.value and bool((row.alt_text or "").strip()) and bool((row.url or "").strip())
|
|
|
|
|
|
class MediaService:
|
|
"""사진 조회.
|
|
|
|
★ 이 서비스가 지키는 규칙은 둘이다.
|
|
1. 회사 스코프 — 사업장을 먼저 회사 스코프로 로드해서 남의 회사 사진에 닿지 못하게 한다.
|
|
(fact/site 와 같은 _load_place 패턴. 없는 것과 남의 것은 똑같이 PLACE_NOT_FOUND 로 답한다)
|
|
2. 출처 보존 — source_type / origin_url 을 절대 응답에서 빼지 않는다.
|
|
크롤링 이미지 재게시 권리가 미결이고(docs/DECISIONS.md 1-2), 결론이 '불가'면
|
|
발행에서 source_type = CRAWL 을 통째로 제외해야 한다. 그 필터를 화면이 미리
|
|
보여주려면 출처가 목록에 실려 있어야 한다.
|
|
"""
|
|
|
|
def __init__(self, crud: IMediaCRUD = Depends(MediaCRUD), place_crud: PlaceCRUD = Depends(PlaceCRUD)):
|
|
self.crud = crud
|
|
self.place_crud = place_crud
|
|
|
|
# ---- 사업장 로드(회사 스코프) ----
|
|
async def _load_place(self, user_info: UserInfo, place_id: str):
|
|
err_type, place = await DB_SESSION_MNG.execute_lambda(
|
|
places.DBType(),
|
|
DBWRType.DB_READ.value,
|
|
lambda s: self.place_crud.get_place(s, uuid.UUID(user_info.user_id), uuid.UUID(place_id)),
|
|
)
|
|
if err_type != ErrorType.SUCCESS:
|
|
return ErrorType.PLACE_NOT_FOUND, None
|
|
return ErrorType.SUCCESS, place
|
|
|
|
# ---- 조회 ----
|
|
async def list_media(self, user_info: UserInfo, place_id: str, unit_id=None, publishable_only: bool = False) -> Res_MediaList:
|
|
"""사진 목록. 관리자 빌더 캔버스와 사장님 확인 화면이 같은 엔드포인트를 쓴다.
|
|
|
|
publishable_only=True 는 '발행하면 실제로 실릴 것'만 — 승인 + alt 있음.
|
|
alt 조건을 여기서 같이 거는 게 중요하다. 승인만 보고 목록을 그리면 캔버스에는
|
|
사진이 보이는데 발행된 사이트엔 없는 상태가 되고, 원인을 찾는 데 반나절이 든다.
|
|
|
|
사진이 0장인 것은 오류가 아니다 — 수집 전이거나 Vision 이 아직 안 돌았을 뿐이라
|
|
빈 배열을 그대로 돌려준다(호출자가 '수집을 돌리세요'를 띄울 수 있게)."""
|
|
res = Res_MediaList()
|
|
err_type, _place = await self._load_place(user_info, place_id)
|
|
if err_type != ErrorType.SUCCESS:
|
|
res.result.SetResult(err_type)
|
|
return res
|
|
|
|
# publishable_only 의 승인 조건만 CRUD 에 넘기고, alt 조건은 목록 계산과 함께 아래에서 건다.
|
|
status = MediaStatus.APPROVED.value if publishable_only else None
|
|
list_err, rows = await DB_SESSION_MNG.execute_lambda(
|
|
place_photos.DBType(),
|
|
DBWRType.DB_READ.value,
|
|
lambda s: self.crud.list_media(
|
|
s, uuid.UUID(place_id), status, False, unit_id, publishable_only
|
|
),
|
|
)
|
|
if list_err != ErrorType.SUCCESS:
|
|
res.result.SetResult(list_err)
|
|
return res
|
|
|
|
items = []
|
|
for r in rows:
|
|
data = MediaData.model_validate(r)
|
|
data.publishable = _is_publishable(r)
|
|
items.append(data)
|
|
res.place_photos = items
|
|
res.publishable = sum(1 for x in items if x.publishable)
|
|
# 사람 확인 큐에 남은 수 — 관리 화면의 '검토할 것' 배지.
|
|
res.pending_review = sum(1 for r in rows if r.status == MediaStatus.PENDING_REVIEW.value)
|
|
# ★ 재게시 권리(1-2)가 '불가'로 결론나면 통째로 빠질 사진 수. 미리 보여줘야 사장님이
|
|
# 직접 올릴 사진을 몇 장 준비해야 하는지 안다.
|
|
res.crawled = sum(1 for r in rows if r.source_type == SourceType.CRAWL.value)
|
|
return res
|