Skip to content

Data Operations

Jump to bottom
ClarusIubar edited this page May 3, 2026 · 4 revisions

데이터 운영

목적

장소, 이미지, 공공데이터, 이벤트 데이터를 운영 중 안전하게 수정하기 위한 기준입니다.

운영 원칙

  • 운영 기준 데이터는 Supabase에 저장된 데이터입니다.
  • 단순 데이터 수정은 일반적으로 Pages/Worker 재배포가 필요하지 않습니다.
  • 자동 동기화가 수동 수정값을 덮어쓰지 않도록 override 플래그를 확인합니다.
  • 대량 수정 전에는 영향 테이블과 롤백 방법을 먼저 기록합니다.

주요 데이터 영역

영역 설명
장소 지도 마커, 상세 정보, 카테고리, 좌표
이미지 장소 이미지, storage path, 대표 이미지
공공데이터 공공 API import 결과
이벤트 행사/축제/공연 데이터
사용자 데이터 리뷰, 댓글, 스탬프, 좋아요, 알림

장소 수정

장소 수정 시 확인할 항목:

  • 장소명
  • 카테고리
  • 위도/경도
  • 주소
  • 대표 이미지
  • 활성 여부
  • 수동 override 여부

운영 중 삭제보다 is_active = false를 우선 검토합니다.

이미지 교체

이미지는 Supabase Storage의 place-images 버킷과 연결됩니다.

확인 순서:

  1. 새 이미지 업로드
  2. image_url 또는 storage path 갱신
  3. 지도/상세/카드 화면 확인
  4. 기존 이미지 참조 여부 확인

공공데이터 동기화

관련 endpoint:

  • POST /api/admin/import/public-data
  • POST /api/internal/public-events/import

내부 import endpoint는 보호 token 없이 호출되면 안 됩니다.

운영 확인 endpoint

  • GET /api/map-bootstrap
  • GET /api/review-feed
  • GET /api/community-routes
  • GET /api/my/summary

관련 문서

상세 운영 절차: 장소 데이터

신규 장소 추가

필수 입력:

  • 장소명
  • 카테고리
  • 주소
  • 위도/경도
  • 표시 여부
  • 대표 이미지
  • 설명 또는 요약

검증:

  • 지도에서 마커가 올바른 위치에 표시되는지 확인
  • 카테고리 필터에 포함되는지 확인
  • 상세 화면에서 이미지가 깨지지 않는지 확인
  • bootstrap 응답에서 shape가 유지되는지 확인

장소 수정

수정 전 확인:

  • 자동 import가 다시 덮어쓸 수 있는 데이터인지
  • 수동 override가 필요한지
  • 연결된 review/feed/comment/stamp가 있는지
  • public map link가 있는지

위험 수정:

  • primary key 변경
  • 좌표 대량 수정
  • 카테고리 명칭 변경
  • 이미지 storage path 일괄 변경

장소 비활성화

삭제보다 비활성화를 우선합니다.

이유:

  • 기존 review/stamp 참조를 보존해야 합니다.
  • 사용자 활동 기록이 사라지면 안 됩니다.
  • 복구 가능성이 있어야 합니다.

상세 운영 절차: 이미지

이미지 교체 체크리스트:

  • 새 파일 업로드 완료
  • 파일명 충돌 없음
  • 공개 URL 또는 storage path 확인
  • 지도 카드 확인
  • 상세 화면 확인
  • 모바일 네트워크에서 로딩 확인
  • 기존 이미지 제거 여부 판단

이미지 삭제 전 확인:

  • 다른 장소가 같은 이미지를 참조하지 않는지
  • 캐시된 URL이 필요한지
  • release note 또는 운영 기록이 필요한지

상세 운영 절차: 공공데이터

공공데이터 import 전 확인:

  • API key 또는 import token 유효성
  • import 대상 기간
  • 중복 기준
  • 수동 override 보존 여부
  • 실패 시 재시도 가능 여부

공공데이터 import 후 확인:

  • 신규/수정/스킵 건수
  • 좌표 누락 건수
  • 이미지 누락 건수
  • 중복 의심 데이터
  • 운영 화면 노출 여부

데이터 품질 기준

기준 설명
좌표 정확성 지도 마커가 실제 장소와 크게 어긋나지 않아야 합니다.
이미지 유효성 깨진 이미지, 권한 없는 이미지 URL이 없어야 합니다.
카테고리 일관성 같은 성격의 장소는 같은 카테고리를 사용해야 합니다.
사용자 데이터 보존 리뷰, 댓글, 스탬프는 장소 수정으로 사라지면 안 됩니다.
import 재현성 같은 입력으로 반복 실행해도 중복 폭증이 없어야 합니다.

전체 리셋과 재적재

전체 리셋은 운영 중 일반 절차가 아닙니다.

필수 조건:

  • 영향 테이블 목록 작성
  • 백업 또는 export 확보
  • rollback 방법 명시
  • 운영 중단 여부 판단
  • PR 또는 issue에 승인 근거 기록

영향 가능 테이블:

  • map/place 계열
  • public event 계열
  • feed/review 계열
  • comment 계열
  • stamp 계열
  • route 계열
  • notification 계열

운영 기록 양식

## 데이터 변경 기록

- 일시:
- 담당:
- 변경 대상:
- 변경 이유:
- 변경 방식:
- 영향 범위:
- 검증 endpoint:
- 롤백 방법:
- 관련 issue/PR:

Clone this wiki locally