2222222

Tables (19)

activity_records

  • activity_record_id — UUID — Primary key — NOT NULL — 활동 기록 고유키 | UUID v4 자동생성
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • course_id — UUID — Foreign key → courses.course_id — 코스 고유키 | courses.course_id 참조. 자유 산책 시 NULL. 코스 삭제 시 NULL(SET NULL)
  • started_at — TIMESTAMPTZ — NOT NULL — 트래킹 시작일시 | UTC 기준 타임스탬프
  • ended_at — TIMESTAMPTZ — 트래킹 종료일시 | 완료 시 PATCH. 미완료 또는 진행 중이면 NULL
  • duration_seconds — INT — NOT NULL — 전체 경과 시간 (초) | 0 이상의 정수. 시작~종료 전체 경과
  • actual_distance_km — FLOAT — NOT NULL — 실제 이동 거리 (km) | 0 이상의 실수. Room DB 집계 후 업로드
  • step_count — INT — NOT NULL — 걸음 수 | 0 이상의 정수. 만보기 연동값
  • actual_route — GEOMETRY(LineString, 4326) — 실제 GPS 경로 | WGS84(SRID 4326) 순서 있는 좌표 배열. 완료 시 업로드
  • is_completed — BOOLEAN — NOT NULL — 완주 여부 | FALSE(미완료) / TRUE(완주). 완주 시 후기 작성 가능
  • status — VARCHAR(20) — NOT NULL — 트래킹 상태 | active(진행중) | paused(일시정지) | completed(완료)
  • pause_count — INT — NOT NULL — 일시정지 횟수 | 0 이상의 정수. 통계용
  • paused_seconds — INT — NOT NULL — 누적 정지 시간 (초) | 0 이상의 정수. 순수 이동시간 = duration_seconds - paused_seconds
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

bookmarks

  • bookmark_id — UUID — Primary key — NOT NULL — 북마크 고유키 | UUID v4 자동생성
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • course_id — UUID — Foreign key → courses.course_id — NOT NULL — 코스 고유키 | courses.course_id 참조. 코스 삭제 시 CASCADE 삭제
  • created_at — TIMESTAMPTZ — NOT NULL — 저장일시 | UTC 기준 타임스탬프

course_reviews

  • course_review_id — UUID — Primary key — NOT NULL — 후기 고유키 | UUID v4 자동생성
  • activity_id — UUID — Foreign key → activity_records.activity_record_id — NOT NULL — 활동 기록 고유키 | activity_records.activity_record_id 참조. UNIQUE - 활동당 후기 1개. 삭제 시 CASCADE
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 작성자 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • course_id — UUID — Foreign key → courses.course_id — NOT NULL — 대상 코스 고유키 | courses.course_id 참조. 코스 삭제 시 CASCADE 삭제
  • rating — SMALLINT — NOT NULL — 별점 | 1 이상 5 이하 정수. 필수 입력. 변경 시 트리거가 courses.avg_rating 자동 갱신
  • content — VARCHAR(500) — 후기 본문 | 500자 이하 자유 텍스트. 선택 입력
  • visibility — VARCHAR(10) — NOT NULL — 공개 여부 | public(피드 노출) | private(본인만 열람)
  • purpose — VARCHAR(20) — 방문 목적 | 운동 | 힐링 | 데이트 | 반려견 등 20자 이하. 선택 입력
  • congestion_level — SMALLINT — 혼잡도 | 1(한산) ~ 5(매우혼잡) 정수. 선택 입력
  • pleasantness_level — SMALLINT — 쾌적도 | 1 이상 5 이하 정수. 선택 입력
  • visit_time_slot — VARCHAR(20) — 방문 시간대 | 새벽 | 아침 | 낮 | 저녁 | 밤. 선택 입력
  • created_at — TIMESTAMPTZ — NOT NULL — 작성일시 | UTC 기준 타임스탬프
  • updated_at — TIMESTAMPTZ — NOT NULL — 최종 수정일시 | UTC 기준 타임스탬프. 후기 수정은 UPDATE로 처리하므로 추적 필요

course_spots

  • course_spot_id — UUID — Primary key — NOT NULL — 매핑 고유키 | UUID v4 자동생성
  • course_id — UUID — Foreign key → courses.course_id — NOT NULL — 코스 고유키 | courses.course_id 참조. 코스 삭제 시 CASCADE 삭제
  • spot_id — UUID — Foreign key → spots.spot_id — NOT NULL — 스팟 고유키 | spots.spot_id 참조. 스팟 삭제 시 CASCADE 삭제
  • visit_order — NUMERIC(10, 4) — NOT NULL — 방문 순서 | 소수점 4자리 양수. 중간 삽입 최적화용 소수 순서값 (예: 1.0, 1.5, 1.25)
  • role — VARCHAR(10) — NOT NULL — 역할 | start(출발) | end(도착) | waypoint(경유)
  • memo — TEXT — 코스 내 스팟 메모 | 이 코스 한정 안내 텍스트. 길이 제한 없음

course_tags

  • course_tag_id — UUID — Primary key — NOT NULL — 매핑 고유키 | UUID v4 자동생성
  • course_id — UUID — Foreign key → courses.course_id — NOT NULL — 코스 고유키 | courses.course_id 참조. 코스 삭제 시 CASCADE 삭제
  • tag_id — UUID — Foreign key → master_tags.tag_id — NOT NULL — 태그 고유키 | master_tags.tag_id 참조. 태그 삭제 시 CASCADE 삭제

courses

  • course_id — UUID — Primary key — NOT NULL — 코스 고유키 | UUID v4 자동생성
  • creator_id — UUID — Foreign key → users.user_id — 작성자 고유키 | users.user_id 참조. 탈퇴 시 NULL(SET NULL), NULL=탈퇴 유저 코스
  • title — VARCHAR(100) — NOT NULL — 코스명 | 100자 이하 자유 텍스트
  • description — TEXT — 코스 설명 | 길이 제한 없는 자유 텍스트
  • creation_type — VARCHAR(10) — NOT NULL — 생성 유형 | manual(직접생성) | auto(트래킹 자동생성)
  • total_distance_km — FLOAT — NOT NULL — 총 거리 (km) | 0 이상의 실수. 앱에서 계산 후 저장
  • estimated_minutes — INT — NOT NULL — 예상 소요 시간 (분) | 0 이상의 정수. 거리/평균속도 기반 앱 계산값
  • difficulty — SMALLINT — NOT NULL — 난이도 | 1(산책하기 좋아요) / 2(조금 힘들어요) / 3(꽤 힘들어요)
  • visibility — VARCHAR(10) — NOT NULL — 공개 여부 | public(공개) | private(비공개)
  • is_deleted — BOOLEAN — NOT NULL — 삭제 여부 | FALSE(정상) / TRUE(소프트 삭제). 조회 시 WHERE is_deleted=FALSE 필수
  • is_hidden — BOOLEAN — NOT NULL — 숨김 여부 | FALSE(정상) / TRUE(신고 임계 초과 자동 숨김)
  • report_count — INT — NOT NULL — 신고 수 | 0 이상의 정수. 신고 접수 시 앱에서 증가 처리
  • start_point — GEOMETRY(Point, 4326) — 출발 좌표 | WGS84(SRID 4326) 경위도 좌표. 지도 마커 렌더링용
  • end_point — GEOMETRY(Point, 4326) — 도착 좌표 | WGS84(SRID 4326) 경위도 좌표. 지도 마커 렌더링용
  • full_route — GEOMETRY(LineString, 4326) — 전체 경로 | WGS84(SRID 4326) 순서 있는 좌표 배열(LineString). 경로 안내 폴리라인
  • bookmark_count — INT — NOT NULL — 북마크 수 | 0 이상의 정수. ⚠️ 직접 UPDATE 금지, 트리거 자동 갱신
  • avg_rating — FLOAT — NOT NULL — 평균 평점 | 0.0 이상 5.0 이하 실수. ⚠️ 직접 UPDATE 금지, 트리거 자동 갱신
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프
  • updated_at — TIMESTAMPTZ — NOT NULL — 최종 수정일시 | UTC 기준 타임스탬프, 트리거 자동 갱신

email_verifications

  • verification_id — UUID — Primary key — NOT NULL — 인증 고유키 | UUID v4 자동생성
  • email — VARCHAR(255) — NOT NULL — 인증 대상 이메일 | RFC 5321 이메일 형식
  • code — VARCHAR(6) — NOT NULL — 인증코드 | 6자리 숫자 문자열
  • is_verified — BOOLEAN — NOT NULL — 인증 완료 여부 | FALSE(미인증) / TRUE(인증완료)
  • expires_at — TIMESTAMPTZ — NOT NULL — 만료일시 | 발급 후 5분 뒤 UTC 타임스탬프
  • created_at — TIMESTAMPTZ — NOT NULL — 발급일시 | UTC 기준 타임스탬프

master_tags

  • tag_id — UUID — Primary key — NOT NULL — 태그 고유키 | UUID v4 자동생성
  • tag_name — VARCHAR(30) — NOT NULL — 태그명 | #야경처럼 # 포함 30자 이하 문자열
  • category — VARCHAR(20) — 태그 분류 | 관리자 정의 분류 그룹명 (예: 환경, 목적). NULL 허용
  • status — VARCHAR(20) — NOT NULL — 심사 상태 | pending(심사중) | approved(승인) | rejected(반려)
  • requested_by — UUID — Foreign key → users.user_id — 신청자 회원 고유키 | users.user_id 참조. 관리자 직접 등록 시 NULL, 탈퇴 시 NULL(SET NULL)
  • parent_tag_id — UUID — Foreign key → master_tags.tag_id — 유사 태그 부모 고유키 | master_tags.tag_id 자기참조. 유사 태그 묶음 대표 태그 ID
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

notifications

  • notification_id — UUID — Primary key — NOT NULL — 알림 고유키 | UUID v4 자동생성
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 수신 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • type — VARCHAR(30) — NOT NULL — 알림 유형 | report_resolved | tag_approved | tag_rejected | report_badge 등
  • target_type — VARCHAR(20) — 대상 타입 | course | spot | report | tag. 폴리모픽 참조용
  • target_id — UUID — 대상 고유키 | 각 타입 PK UUID. 폴리모픽 참조 (DB FK 없음, 앱 레이어 책임)
  • message — TEXT — 알림 메시지 | 길이 제한 없는 자유 텍스트
  • is_read — BOOLEAN — NOT NULL — 읽음 여부 | FALSE(미읽음) / TRUE(읽음). 알림 탭 진입 또는 개별 클릭 시 TRUE 업데이트
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

reports

  • report_id — UUID — Primary key — NOT NULL — 신고 고유키 | UUID v4 자동생성
  • reporter_id — UUID — Foreign key → users.user_id — NOT NULL — 신고자 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • course_id — UUID — Foreign key → courses.course_id — 대상 코스 고유키 | courses.course_id 참조. 스팟 신고 시 NULL. 코스 삭제 시 CASCADE
  • spot_id — UUID — Foreign key → spots.spot_id — 대상 스팟 고유키 | spots.spot_id 참조. 코스 신고 시 NULL. 스팟 삭제 시 CASCADE
  • activity_id — UUID — Foreign key → activity_records.activity_record_id — 관련 활동 기록 고유키 | activity_records.activity_record_id 참조. 선택값. 삭제 시 NULL(SET NULL)
  • location — GEOMETRY(Point, 4326) — NOT NULL — 신고 발생 좌표 | WGS84(SRID 4326) 경위도 좌표. 지도 마커 표시용
  • report_type — VARCHAR(20) — NOT NULL — 신고 유형 | 공사중 | 통행불가 | 위험구간 | 정보오류 | 기타
  • description — TEXT — 신고 상세 내용 | 길이 제한 없는 자유 텍스트
  • status — VARCHAR(20) — NOT NULL — 처리 상태 | active(접수) | reviewed(확인중) | resolved(처리완료)
  • created_at — TIMESTAMPTZ — NOT NULL — 신고일시 | UTC 기준 타임스탬프

review_likes

  • review_like_id — UUID — Primary key — NOT NULL — 좋아요 고유키 | UUID v4 자동생성
  • review_id — UUID — Foreign key → course_reviews.course_review_id — NOT NULL — 후기 고유키 | course_reviews.course_review_id 참조. 후기 삭제 시 CASCADE 삭제
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • is_like — BOOLEAN — NOT NULL — 좋아요 여부 | TRUE(좋아요👍) / FALSE(싫어요👎)
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

spot_images

  • spot_image_id — UUID — Primary key — NOT NULL — 이미지 고유키 | UUID v4 자동생성
  • spot_id — UUID — Foreign key → spots.spot_id — NOT NULL — 스팟 고유키 | spots.spot_id 참조. 스팟 삭제 시 CASCADE 삭제
  • image_url — TEXT — NOT NULL — 이미지 URL | S3 presigned URL 또는 public URL 문자열
  • display_order — SMALLINT — NOT NULL — 표시 순서 | 0-based 음수 불가 정수. 앱에서 순서 변경 시 전체 재계산 후 PATCH. 최대 5장 제한은 앱 레이어 책임
  • uploaded_by — UUID — Foreign key → users.user_id — 업로더 회원 고유키 | users.user_id 참조. 탈퇴 시 NULL(SET NULL)
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

spot_reviews

  • spot_review_id — UUID — Primary key — NOT NULL — 스팟 평가 고유키 | UUID v4 자동생성
  • review_id — UUID — Foreign key → course_reviews.course_review_id — NOT NULL — 코스 후기 고유키 | course_reviews.course_review_id 참조. 후기 삭제 시 CASCADE 삭제
  • spot_id — UUID — Foreign key → spots.spot_id — NOT NULL — 스팟 고유키 | spots.spot_id 참조. 스팟 삭제 시 CASCADE 삭제
  • is_recommended — BOOLEAN — NOT NULL — 추천 여부 | TRUE(추천👍) / FALSE(비추천👎)

spot_tags

  • spot_tag_id — UUID — Primary key — NOT NULL — 매핑 고유키 | UUID v4 자동생성
  • spot_id — UUID — Foreign key → spots.spot_id — NOT NULL — 스팟 고유키 | spots.spot_id 참조. 스팟 삭제 시 CASCADE 삭제
  • tag_id — UUID — Foreign key → master_tags.tag_id — NOT NULL — 태그 고유키 | master_tags.tag_id 참조. 태그 삭제 시 CASCADE 삭제

spots

  • spot_id — UUID — Primary key — NOT NULL — 스팟 고유키 | UUID v4 자동생성
  • creator_id — UUID — Foreign key → users.user_id — 작성자 고유키 | users.user_id 참조. 탈퇴 시 NULL(SET NULL), NULL=탈퇴 유저 스팟
  • name — VARCHAR(100) — NOT NULL — 스팟명 | 100자 이하 자유 텍스트
  • description — TEXT — 스팟 설명 | AI 도슨트 원문. TTS API 변환 소스. 길이 제한 없음
  • category — VARCHAR(20) — NOT NULL — 스팟 분류 | 명소 | 먹거리 | 포토존 | 역사 | 기타
  • location — GEOMETRY(Point, 4326) — NOT NULL — 스팟 위치 좌표 | WGS84(SRID 4326) 경위도 좌표. 지도 핀 표시용
  • is_deleted — BOOLEAN — NOT NULL — 삭제 여부 | FALSE(정상) / TRUE(소프트 삭제)
  • is_hidden — BOOLEAN — NOT NULL — 숨김 여부 | FALSE(정상) / TRUE(신고 임계 초과 자동 숨김)
  • report_count — INT — NOT NULL — 신고 수 | 0 이상의 정수. 신고 접수 시 앱에서 증가 처리
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프
  • updated_at — TIMESTAMPTZ — NOT NULL — 최종 수정일시 | UTC 기준 타임스탬프, 트리거 자동 갱신

tts_audio_files

  • tts_audio_file_id — UUID — Primary key — NOT NULL — TTS 파일 고유키 | UUID v4 자동생성
  • cache_key — VARCHAR(64) — NOT NULL — 캐시 키 | SHA256(source_text + voice_type) 해시 문자열 64자 고정. 중복 생성 방지
  • content_type — VARCHAR(20) — NOT NULL — 콘텐츠 유형 | course | spot | weather
  • content_id — UUID — 콘텐츠 고유키 | 각 타입 PK UUID. 폴리모픽 참조 (DB FK 없음, 앱 레이어 책임)
  • voice_type — VARCHAR(50) — NOT NULL — 음성 유형 | default | male | female
  • source_text — TEXT — NOT NULL — 원본 텍스트 | TTS 변환 입력 텍스트. 길이 제한 없음
  • spoken_text — TEXT — AI 구어체 변환 텍스트 | AI가 가공한 구어체 텍스트. 길이 제한 없음
  • audio_url — TEXT — 음성 파일 URL | S3 음성 파일 URL. status=done 시 채워짐
  • status — VARCHAR(20) — NOT NULL — 생성 상태 | pending → processing → done(정상) | failed(오류, 재시도 가능)
  • expires_at — TIMESTAMPTZ — 만료일시 | NULL=영구 보관. 날씨 TTS 등 시한성 오디오는 만료 시각 설정
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프

user_preferences

  • user_preference_id — UUID — Primary key — NOT NULL — 선호도 고유키 | UUID v4 자동생성
  • user_id — UUID — Foreign key → users.user_id — NOT NULL — 회원 고유키 | users.user_id 참조. 탈퇴 시 CASCADE 삭제
  • tag_id — UUID — Foreign key → master_tags.tag_id — NOT NULL — 태그 고유키 | master_tags.tag_id 참조. 태그 삭제 시 CASCADE 삭제
  • preference_score — SMALLINT — NOT NULL — 선호도 점수 | 1(비선호) ~ 5(강선호) 정수. 추천 알고리즘 가중치로 활용
  • created_at — TIMESTAMPTZ — NOT NULL — 등록일시 | UTC 기준 타임스탬프
  • updated_at — TIMESTAMPTZ — NOT NULL — 최종 수정일시 | UTC 기준 타임스탬프, 트리거 자동 갱신

users

  • user_id — UUID — Primary key — NOT NULL — 회원 고유키 | UUID v4 자동생성
  • username — VARCHAR(20) — NOT NULL — 아이디 | 영문+숫자 6~20자, 가입 후 변경 불가
  • email — VARCHAR(255) — NOT NULL — 이메일 | RFC 5321 이메일 형식
  • password_hash — VARCHAR(255) — 비밀번호 해시 | bcrypt 해시 문자열, 로컬 로그인만 사용. 소셜 로그인 시 NULL
  • login_type — VARCHAR(20) — NOT NULL — 로그인 유형 | local(이메일) | kakao(소셜)
  • oauth_provider_id — VARCHAR(255) — 소셜 로그인 제공자 UID | 소셜 provider 고유 UID. 로컬 로그인 시 NULL
  • nickname — VARCHAR(12) — NOT NULL — 닉네임 | 2~12자, 영문·숫자·한글, 특수문자 불가
  • profile_image_url — TEXT — 프로필 이미지 URL | S3 URL 문자열. 원형 크롭은 클라이언트 처리
  • bio — VARCHAR(200) — 자기소개 | 200자 이하 자유 텍스트
  • settings_json — JSONB — NOT NULL — 앱 설정 JSON | push_enabled·theme·tts_voice 등 JSON 객체
  • is_active — BOOLEAN — NOT NULL — 활성 여부 | TRUE(정상) / FALSE(탈퇴 대기, 30일 후 배치 삭제)
  • created_at — TIMESTAMPTZ — NOT NULL — 가입일시 | UTC 기준 타임스탬프
  • updated_at — TIMESTAMPTZ — NOT NULL — 최종 수정일시 | UTC 기준 타임스탬프, 트리거 자동 갱신

weather_cache

  • weather_cache_id — UUID — Primary key — NOT NULL — 날씨 캐시 고유키 | UUID v4 자동생성
  • location — GEOMETRY(Point, 4326) — NOT NULL — 날씨 조회 기준 좌표 | WGS84(SRID 4326) 경위도 좌표. ST_DWithin으로 500m 이내 캐시 재사용
  • weather_condition — VARCHAR(50) — 날씨 상태 | 맑음 | 흐림 | 비 | 눈 등 50자 이하 문자열
  • temperature — FLOAT — 기온 (°C) | 실수. 소수점 1자리 권장
  • description — TEXT — AI 날씨 추천 문구 | AI 생성 자유 텍스트. TTS 변환 소스 (예: 오늘은 맑아요, 야경 코스 어떠세요?)
  • fetched_at — TIMESTAMPTZ — NOT NULL — API 호출일시 | UTC 기준 타임스탬프
  • expires_at — TIMESTAMPTZ — NOT NULL — 캐시 만료일시 | fetched_at 이후 UTC 타임스탬프. 보통 +30~60분