34333
Tables (19)
activity_records
- 활동 — 기록 — Primary key — NOT NULL — UUID v4 자동생성
- 회원 — 고유키` — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 코스 — 고유키` — courses 참조. 자유 산책 시 NULL. 코스 삭제 시 NULL(SET NULL)
- 트래킹 — 시작일시` — NOT NULL — UTC 기준 타임스탬프
- 트래킹 — 종료일시` — 완료 시 PATCH. 미완료·진행 중이면 NULL
- 전체 — 경과 — NOT NULL — 0 이상의 정수. 시작~종료 전체 경과
- 실제 — 이동 — NOT NULL — 0 이상의 실수. Room DB 집계 후 업로드
- 걸음 — 수` — NOT NULL — 0 이상의 정수. 만보기 연동값
- 실제 — GPS — WGS84(SRID 4326) 순서 있는 좌표 배열. 완료 시 업로드
- 완주 — 여부` — NOT NULL — FALSE(미완료) / TRUE(완주). 완주 시 후기 작성 가능
- 트래킹 — 상태` — NOT NULL — active(진행중) | paused(일시정지) | completed(완료)
- 일시정지 — 횟수` — NOT NULL — 0 이상의 정수. 통계용
- 누적 — 정지 — NOT NULL — 0 이상의 정수. 순수 이동시간 = 전체 경과 - 누적 정지
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
bookmarks
- 북마크 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 회원 — 고유키` — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 코스 — 고유키` — NOT NULL — courses 참조. 코스 삭제 시 CASCADE 삭제
- 저장일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
course_reviews
- 후기 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 활동 — 기록 — NOT NULL — activity_records 참조. 활동당 후기 1개(UNIQUE). 삭제 시 CASCADE
- 작성자 — 회원 — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 대상 — 코스 — NOT NULL — courses 참조. 코스 삭제 시 CASCADE 삭제
- 별점 — SMALLINT — NOT NULL — 1 이상 5 이하 정수. 필수 입력. 변경 시 트리거가 평균 평점 자동 갱신
- 후기 — 본문` — 500자 이하 자유 텍스트. 선택 입력
- 공개 — 여부` — NOT NULL — public(피드 노출) | private(본인만 열람)
- 방문 — 목적` — 운동 | 힐링 | 데이트 | 반려견 등 20자 이하. 선택 입력
- 혼잡도 — SMALLINT — 1(한산) ~ 5(매우혼잡) 정수. 선택 입력
- 쾌적도 — SMALLINT — 1 이상 5 이하 정수. 선택 입력
- 방문 — 시간대` — 새벽 | 아침 | 낮 | 저녁 | 밤. 선택 입력
- 작성일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
- 최종 — 수정일시` — NOT NULL — UTC 기준 타임스탬프. 후기 수정은 UPDATE로 처리, 트리거 자동 갱신
course_spots
- 매핑 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 코스 — 고유키` — NOT NULL — courses 참조. 코스 삭제 시 CASCADE
- 스팟 — 고유키` — NOT NULL — spots 참조. 스팟 삭제 시 CASCADE
- 방문 — 순서` — NOT NULL — 소수점 4자리 양수. 중간 삽입 최적화용 소수 순서값 (예: 1.0→1.5→1.25). ORDER BY ASC 필수
- 역할 — VARCHAR(10) — NOT NULL — start(출발) | end(도착) | waypoint(경유)
- 코스 — 내 — 이 코스 한정 안내 텍스트. 길이 제한 없음
course_tags
- 매핑 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 코스 — 고유키` — NOT NULL — courses 참조. 코스 삭제 시 CASCADE
- 태그 — 고유키` — NOT NULL — master_tags 참조. 태그 삭제 시 CASCADE
courses
- 코스 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 작성자 — 고유키` — users 참조. 탈퇴 시 NULL(SET NULL), 코스는 공개 유지
- 코스명 — VARCHAR(100) — NOT NULL — 100자 이하 자유 텍스트
- 코스 — 설명` — 길이 제한 없는 자유 텍스트
- 생성 — 유형` — NOT NULL — manual(직접생성) | auto(트래킹 자동생성)
- 총 — 거리 — NOT NULL — 0 이상의 실수. 앱에서 계산 후 저장
- 예상 — 소요 — NOT NULL — 0 이상의 정수. 거리/평균속도 기반 앱 계산값
- 난이도 — SMALLINT — NOT NULL — 1(산책하기 좋아요) / 2(조금 힘들어요) / 3(꽤 힘들어요)
- 공개 — 여부` — NOT NULL — public(공개) | private(비공개)
- 삭제 — 여부` — NOT NULL — FALSE(정상) / TRUE(소프트 삭제). 조회 시 WHERE is_deleted=FALSE 필수
- 숨김 — 여부` — NOT NULL — FALSE(정상) / TRUE(신고 임계 초과 자동 숨김)
- 신고 — 수` — NOT NULL — 0 이상의 정수. 신고 배지 표시용
- 출발 — 좌표` — WGS84(SRID 4326) 경위도 좌표. 지도 마커 렌더링용
- 도착 — 좌표` — WGS84(SRID 4326) 경위도 좌표. 지도 마커 렌더링용
- 전체 — 경로` — WGS84(SRID 4326) 순서 있는 좌표 배열(LineString). 경로 안내 폴리라인
- 북마크 — 수` — NOT NULL — 0 이상의 정수. 직접 UPDATE 금지, 트리거 자동 갱신
- 평균 — 평점` — NOT NULL — 0.0 이상 5.0 이하 실수. 직접 UPDATE 금지, 트리거 자동 갱신
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
- 최종 — 수정일시` — NOT NULL — UTC 기준 타임스탬프, 트리거 자동 갱신
email_verifications
- 인증 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 인증 — 대상 — NOT NULL — RFC 5321 이메일 형식
- 인증코드 — VARCHAR(6) — NOT NULL — 6자리 숫자 문자열
- 인증 — 완료 — NOT NULL — FALSE(미인증) / TRUE(인증완료)
- 만료일시 — TIMESTAMPTZ — NOT NULL — 발급 후 5분 뒤 UTC 타임스탬프. 배치로 만료 레코드 주기 삭제
- 발급일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
master_tags
- 태그 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 태그명 — VARCHAR(30) — NOT NULL — #야경처럼 # 포함 30자 이하 문자열
- 태그 — 분류` — 관리자 정의 분류 그룹명 (예: 환경, 목적)
- 심사 — 상태` — NOT NULL — pending(심사중) | approved(승인) | rejected(반려)
- 신청자 — 회원 — users 참조. 관리자 직접 등록 시 NULL, 탈퇴 시 NULL(SET NULL)
- 유사 — 태그 — master_tags 자기참조. 유사 태그 묶음 대표 태그 ID(SET NULL)
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
notifications
- 알림 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 수신 — 회원 — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 알림 — 유형` — NOT NULL — report_resolved | tag_approved | tag_rejected | report_badge 등
- 대상 — 타입` — course | spot | report | tag. 폴리모픽 참조용
- 대상 — 고유키` — 각 타입 PK UUID. 폴리모픽 참조 (DB FK 없음, 앱 레이어 책임)
- 알림 — 메시지` — 길이 제한 없는 자유 텍스트
- 읽음 — 여부` — NOT NULL — FALSE(미읽음) / TRUE(읽음). 알림 탭 진입 또는 개별 클릭 시 TRUE 업데이트
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
reports
- 신고 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 신고자 — 회원 — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 대상 — 코스 — courses 참조. 스팟 신고 시 NULL. 코스 삭제 시 CASCADE
- 대상 — 스팟 — spots 참조. 코스 신고 시 NULL. 스팟 삭제 시 CASCADE. 코스/스팟 중 하나 필수
- 관련 — 활동 — activity_records 참조. 선택값. 삭제 시 NULL(SET NULL)
- 신고 — 발생 — NOT NULL — WGS84(SRID 4326) 경위도 좌표. 지도 마커 표시용
- 신고 — 유형` — NOT NULL — 공사중 | 통행불가 | 위험구간 | 정보오류 | 기타
- 신고 — 상세 — 길이 제한 없는 자유 텍스트
- 처리 — 상태` — NOT NULL — active(접수) | reviewed(확인중) | resolved(처리완료)
- 신고일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
review_likes
- 좋아요 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 후기 — 고유키` — NOT NULL — course_reviews 참조. 후기 삭제 시 CASCADE
- 회원 — 고유키` — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 좋아요 — 여부` — NOT NULL — TRUE(좋아요) / FALSE(싫어요)
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
spot_images
- 이미지 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 스팟 — 고유키` — NOT NULL — spots 참조. 스팟 삭제 시 CASCADE
- 이미지 — URL` — NOT NULL — S3 presigned URL 또는 public URL 문자열
- 표시 — 순서` — NOT NULL — 0-based 음수 불가 정수. 앱에서 순서 변경 시 전체 재계산 후 PATCH. 최대 5장 제한은 앱 레이어 책임
- 업로더 — 회원 — users 참조. 탈퇴 시 NULL(SET NULL)
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
spot_reviews
- 스팟 — 평가 — Primary key — NOT NULL — UUID v4 자동생성
- 코스 — 후기 — NOT NULL — course_reviews 참조. 후기 삭제 시 CASCADE
- 스팟 — 고유키` — NOT NULL — spots 참조. 스팟 삭제 시 CASCADE
- 추천 — 여부` — NOT NULL — TRUE(추천) / FALSE(비추천)
spot_tags
- 매핑 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 스팟 — 고유키` — NOT NULL — spots 참조. 스팟 삭제 시 CASCADE
- 태그 — 고유키` — NOT NULL — master_tags 참조. 태그 삭제 시 CASCADE
spots
- 스팟 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 작성자 — 고유키` — users 참조. 탈퇴 시 NULL(SET NULL), 스팟 공개 유지
- 스팟명 — VARCHAR(100) — NOT NULL — 100자 이하 자유 텍스트
- 스팟 — 설명` — AI 도슨트 원문. TTS API 변환 소스. 길이 제한 없음
- 스팟 — 분류` — NOT NULL — 명소 | 먹거리 | 포토존 | 역사 | 기타
- 스팟 — 위치 — NOT NULL — WGS84(SRID 4326) 경위도 좌표. 지도 핀 표시용
- 삭제 — 여부` — NOT NULL — FALSE(정상) / TRUE(소프트 삭제)
- 숨김 — 여부` — NOT NULL — FALSE(정상) / TRUE(신고 임계 초과 자동 숨김)
- 신고 — 수` — NOT NULL — 0 이상의 정수. 신고 배지 표시용
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
- 최종 — 수정일시` — NOT NULL — UTC 기준 타임스탬프, 트리거 자동 갱신
tts_audio_files
- TTS — 파일 — Primary key — NOT NULL — UUID v4 자동생성
- 캐시 — 키` — NOT NULL — SHA256(source_text + voice_type) 해시 문자열 64자 고정. 중복 생성 방지
- 콘텐츠 — 유형` — NOT NULL — course | spot | weather
- 콘텐츠 — 고유키` — 각 타입 PK UUID. 폴리모픽 참조 (DB FK 없음, 앱 레이어 책임)
- 음성 — 유형` — NOT NULL — default | male | female
- 원본 — 텍스트` — NOT NULL — TTS 변환 입력 텍스트. 길이 제한 없음
- AI — 구어체 — AI가 가공한 구어체 텍스트. 길이 제한 없음
- 음성 — 파일 — S3 음성 파일 URL. 생성 상태가 done일 때 채워짐
- 생성 — 상태` — NOT NULL — pending → processing → done(정상) | failed(오류, 재시도 가능)
- 만료일시 — TIMESTAMPTZ — NULL=영구 보관. 날씨 TTS 등 시한성 오디오는 만료 시각 설정
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
user_preferences
- 선호도 — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- 회원 — 고유키` — NOT NULL — users 참조. 탈퇴 시 CASCADE 삭제
- 태그 — 고유키` — NOT NULL — master_tags 참조. 태그 삭제 시 CASCADE 삭제
- 선호도 — 점수` — NOT NULL — 1(비선호) ~ 5(강선호) 정수. 추천 알고리즘 가중치
- 등록일시 — TIMESTAMPTZ — NOT NULL — UTC 기준 타임스탬프
- 최종 — 수정일시` — NOT NULL — UTC 기준 타임스탬프, 트리거 자동 갱신
users
- user (회원) — 고유키` — Primary key — NOT NULL — UUID v4 자동생성
- id (아이디) — VARCHAR(20) — NOT NULL — 영문+숫자 6~20자, 가입 후 변경 불가
- email (이메일) — VARCHAR(255) — NOT NULL — RFC 5321 이메일 형식
- password (비밀번호) — 해시` — bcrypt 해시 문자열. 로컬 로그인만 사용, 소셜 로그인 시 NULL
weather_cache
- 날씨 — 캐시 — Primary key — NOT NULL — UUID v4 자동생성
- 날씨 — 조회 — NOT NULL — WGS84(SRID 4326) 경위도 좌표. ST_DWithin으로 500m 이내 유효 캐시 재사용
- 날씨 — 상태` — 맑음 | 흐림 | 비 | 눈 등 50자 이하 문자열
- 기온 — (°C)` — 실수. 소수점 1자리 권장
- AI — 날씨 — AI 생성 자유 텍스트. TTS 변환 소스
- API — 호출일시` — NOT NULL — UTC 기준 타임스탬프
- 캐시 — 만료일시` — NOT NULL — API 호출일시 이후 UTC 타임스탬프. 보통 +30~60분