운영 배포 전 처리: Region 매핑 backfill + 마이그레이션 FK 분리 배포

[chanwoo7]

배경

인기 매장 리스트 릴리즈(릴리즈 PR #148 / 기능 PR #144~#147) 봇 재리뷰에서 지적된 운영 배포 전 처리 항목입니다. 현재 개발 단계라 즉각 영향은 없으나(배포 파이프라인 꺼짐, 시드 매장은 region 연결됨), 운영 배포 재개 전 반드시 처리해야 합니다.

항목

• Region 매핑 backfill — Codex P1 (PR feat(store): 인기 매장 리스트 API (popularStores·실시간 랭킹 집계) #145, store.repository.ts)

  • 기존 운영 매장은 마이그레이션 후에도 store.region_id = NULL 상태. popularStores의 지역 필터(region_id IN)에서 기존 매장이 전부 누락됨(주소가 매칭돼도).
  • 해결: ① seller 매장 등록/수정 시 주소(address_*) → region 자동 연결, ② 기존 데이터 backfill 마이그레이션(주소 기준 시군구 매핑).

• 마이그레이션 FK 분리 배포 — CodeRabbit (migration 20260617194530_add_region_and_store_region)

  • store.region_id 컬럼 + 인덱스 + FK를 한 변경 세트로 적용하면 운영 데이터량에서 메타데이터 락/검증 스캔으로 쓰기 지연 가능.
  • 해결: 컬럼·인덱스 선배포 → 데이터 검증 → 저부하 시간대 FK 적용으로 단계화.

수행 조건

운영 배포 파이프라인 재개 전.

참고

• 릴리즈 PR chore: 지역·인기매장·매장찜·픽업슬롯 기능 릴리즈 #148, 기능 PR feat(region): 지역 마스터(1·2차 시군구) 모델 + 조회/검색 API + 수도권 시드 #144 / feat(store): 인기 매장 리스트 API (popularStores·실시간 랭킹 집계) #145
• 이 항목들은 fix PR #149에서 "보류 → 후속"으로 분리됨

[chanwoo7]

운영 배포 전 확인 항목 추가 (2026-08-30 위생 점검):

• Swagger /rest-docs 프로덕션 노출은 의도된 임시 조치(main.ts if (!isProd) 주석 해제 상태)로 확인됨. 배포 재개 시 DOCS_ACCESS_TOKEN 설정이 필수임을 체크 — DocsAccessMiddleware는 토큰 env가 비어 있으면 전원 통과시킨다. 가드 복원 또는 '토큰 미설정 시 차단'으로 반전 여부도 그때 결정.