CLIPROUTE ERD ver 0.15
테이블 (17)
멤버 (MEMBERS)
- Id — BIGINT — 기본 키 — NOT NULL
- 이메일 (email) — VARCHAR(50) — NOT NULL
- 비밀번호 (password) — VARCHAR(255) — NOT NULL
- 닉네임 (nickname) — VARCHAR(20) — NOT NULL — 1/10 미기재시 랜덤생성 방안
- 성별 (gender) — ENUM — NOT NULL — (FEMALE, MALE, OTHER)
- 연령대 (age_range) — ENUM — NOT NULL — (AGE_10s, AGE_20s, AGE_30s ... AGE_60_OVER, UNKNOWN)
- 상태 (status) — ENUM — NOT NULL — (ACTIVE, DELETED)
- 권한 (role) — ENUM — NOT NULL — (USER, ADMIN)
- 가입일시 (created_at) — DATETIME — NOT NULL — 기본값: 현재 시간
- 수정일시 (updated_at) — DATETIME
- 삭제일시 (deleted_at) — DATETIME — 삭제요청후 30일 뒤 완전 삭제되도록 로직 설정
멤버-알림 (MEMBER_NOTIFICATION)
- Id — 기본 키 — NOT NULL
- 멤버 ID (member_id) — BIGINT — 외래 키 → 멤버.Id — NOT NULL — 알람을 보낸 유저 ID
- 알림 ID (notification_id) — BIGINT — 외래 키 → 알림.알림 ID — NOT NULL
- 읽음 여부 (is_read) — BOOLEAN — NOT NULL
- 읽은 시간 (read_at) — DATETIME — NOT NULL
- 알림 발송 시간 (sent_at) — DATETIME — 알림 발송 일시
- 삭제 시간 (deleted_at) — DATETIME — 유저가 알림 목록에서 '삭제'했을 때의 일시 (Soft Delete용)
멤버-약관 (MEMBER_TERM)
- Id — BIGINT — 기본 키 — NOT NULL
- 멤버 ID (member_id) — BIGINT — 외래 키 → 멤버.Id — NOT NULL
- 약관 ID (term_id) — BIGINT — 외래 키 → 약관.약관 ID — NOT NULL
- 동의 여부 (is_agreed) — BOOLEAN — NOT NULL
- 동의 시점 (agreed_at) — DATETIME
- 생성일시 (created_at) — DATETIME
- 수정일시 (updated_at) — DATETIME
멤버-코스 (MEMBER_COURSE)
- Id — 기본 키 — NOT NULL
- 멤버ID (member_id) — BIGINT — 외래 키 → 멤버.Id — NOT NULL — 코스 저장 유저 ID
- 코스 ID (course_id) — BIGINT — 외래 키 → 코스.Id — NOT NULL — 코스 ID( 커스터마이징 여부 상관 x) , 멤버가 가지고 있는 코스
- 시작일 (start_date) — DATE — [일정] 예: 2026-01-15
- 종료일 (end_date) — DATE — [일정] 예: 2026-01-20
- 상태 (travel_status) — ENUM — NOT NULL — ( BEFORE(여행 전), AFTER(다녀옴))
- 스크랩 여부 (is_scrapped) — BOOLEAN — NOT NULL
- 생성일시 (created_at) — DATETIME — NOT NULL — 기존 코스를 스크랩한 시점
- 수정일시 (updated_at) — DATETIME — NOT NULL — 내용 변경 시 갱신
- 삭제일시 (deleted_at) — DATETIME — soft delete용
알림 (NOTIFICATIONS)
- 알림 ID (id) — BIGINT — 기본 키 — NOT NULL
- 제목 (title) — VARCHAR(50) — NOT NULL — 푸시 제목
- 내용 (content) — VARCHAR(255) — NOT NULL — 푸시 본문
- 이동 링크 (link_url) — VARCHAR(255) — NOT NULL — 클릭 시 이동할 화면 (예: course_id=5)
- 발송타겟 (target_group) — ENUM — NOT NULL — GLOBAL(유저 전체), PERSONAL(개인) / 연령별.. 등 추가가능
- 알림 유형 (type) — ENUM — NOT NULL — NOTICE(공지), EVENT(이벤트), ACTIVITY(활동) (1/10 enum타입으로 받기 가능)
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME — NOT NULL
알림 설정 (NOTI_SETTINGS)
- Id — BIGINT — 기본 키 — NOT NULL — (1/10 정규화된 테이블은 아니지만 개발하는 데에서 용이)
- 유저 ID (member_id) — BIGINT — 외래 키 → 멤버.Id — NOT NULL — 1:1 관계 (유저 1명당 설정 1개)
- 알림 여부 (is_push_enabled) — BOOLEAN — NOT NULL — 앱 푸시 자체를 받을지
- 마케팅 동의 여부 (is_marketing) — BOOLEAN — NOT NULL — 이벤트/광고성 정보 수신 여부
- 야간 알림 여부 (is_night_push_enabled) — BOOLEAN — NOT NULL — (선택) 야간(21시~08시) 수신 여부
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME — NOT NULL — 언제 설정을 바꿨는지 (법적 근거용)
약관 (TERMS)
- 약관 ID (Id) — BIGINT — 기본 키 — NOT NULL
- 약관명 (title) — VARCHAR(100) — NOT NULL — 화면에 보여줄 이름 (예: 서비스 이용약관)
- 약관 내용 (content) — VARCHAR(255) — 간단한 내용
- 약관 링크 (content_url) — VARCHAR(255) — NOT NULL — 노션 주소
- 필수 여부 (is_required) — BOOLEAN — NOT NULL — True(필수), False(선택)
- 약관 버전 (version) — STRING — NOT NULL — ex) ver 1.3.2
- 활성화 여부 (is_active) — BOOLEAN — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME
영상 (VIDEOS)
- Id — BIGINT — 기본 키 — NOT NULL
- 지역 ID (region_id) — BIGINT — 외래 키 → 지역.Id — NOT NULL — 외부 유튜브 영상 지역태그를 지역엔티티 명명규칙에 맞게 하는 서비스로직 필요
- 유튜브 영상 ID (yt_video_id) — VARCHAR(255) — NOT NULL — 유튜브 영상 고유 코드(링크 구분자) / UNIQUE
- 영상 제목 (title) — VARCHAR(255) — NOT NULL — 원본 제목
- 채널명 (channel_name) — VARCHAR(100) — NOT NULL — 유튜버 채널 이름
- 업로드일 (upload_date) — DATE — 원본 업로드 날짜
- 썸네일 URL (thumbnail_url) — VARCHAR(255) — NOT NULL — 이미지 파일 아님 (링크만 저장)
- 영상 길이 (duration) — INT — 초(Sec) 단위
- 자막 여부 (has_caption) — BOOLEAN — NOT NULL — True, False
- 영상 포맷 (video_format) — ENUM — NOT NULL — (NORMAL, SHORTS, LIVE) / 없어도 될지도
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME
- 삭제일시 (deleted_at) — DATETIME — 유튜브 영상에 삭제되거나 숨김처리 됐을때, 삭제하면 추출했떤 데이터들 꼬이므로 명시적으로 표현
영상-장소 (VIDEOS_PLACE)
- Id — BIGINT — 기본 키 — NOT NULL
- 영상 ID (video_id) — BIGINT — 외래 키 → 영상.Id — NOT NULL
- 장소 ID (place_id) — BIGINT — 외래 키 → 장소.Id — NOT NULL
- 타임 스탬프 (timestamp) — INT — NOT NULL — 영상에 장소가 나오는 시간
이미지 (IMAGES)
- Id — BIGINT — 기본 키 — NOT NULL
- 이미지 url (image_url) — VARCHAR(255) — NOT NULL — 이미지 경로
- 파일 이름 (original_name) — VARCHAR(100) — NOT NULL — 사용자지정 이름
- 등록일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME
- 삭제일시 (deleted_at) — DATETIME — 삭제요청후 30일 뒤 완전 삭제되도록 로직 설정
이미지-장소 (IMAGE_PLACE)
- Id — BIGINT — 기본 키 — NOT NULL
- 이미지 ID (image_id) — BIGINT — 외래 키 → 이미지.Id — NOT NULL
- 장소 ID (place_id) — BIGINT — 외래 키 → 장소.Id — NOT NULL
- 이미지 타입 (image_type) — ENUM — NOT NULL — 이미지 구분 (REPRESENTATIVE, MENU, INTERIOR, EXTERIOR 등)
- 순서 (sequence) — INT — 0번이 썸네일/대표사진
- 설명 (description) — VARCHAR
이미지-지역 (IMAGE_REGION)
- id — BIGINT — 기본 키 — NOT NULL
- 이미지 ID (image_id) — BIGINT — 외래 키 → 이미지.Id — NOT NULL
- 지역 ID (region_id) — BIGINT — 외래 키 → 지역.Id — NOT NULL
- 이미지 타입 (image_type) — ENUM — NOT NULL — 이미지 구분 (REPRESENTATIVE, MENU, INTERIOR, EXTERIOR 등)
- 설명 (description) — VARCHAR
이미지-코스 (IMAGE_COURSE)
- Id — BIGINT — 기본 키 — NOT NULL
- 이미지 ID (image_id) — BIGINT — 외래 키 → 이미지.Id — NOT NULL
- 코스 ID (course_id) — BIGINT — 외래 키 → 코스.Id — NOT NULL
- 이미지 타입 (image_type) — ENUM — NOT NULL — 이미지 구분 (REPRESENTATIVE, MENU, INTERIOR, EXTERIOR 등)
- 순서 (sequence) — INT — 같은 코스 id 일시 0번이 썸네일/대표사진 (null 이면 생성 순)
- 설명 (description) — VARCHAR
장소 (PLACES)
- Id — BIGINT — 기본 키 — NOT NULL
- 지역 ID (region_id) — BIGINT — 외래 키 → 지역.Id — NOT NULL — 장소의 지역
- 장소명 (place_name) — VARCHAR(100) — NOT NULL — 가게/명소 이름
- AI 태그 (ai_tag) — VARCHAR(20) — AI가 분석한 큰 분류 예 : 식당, 카페, 관광지, 액티비티
- 장소 카테고리 (place_category) — ENUM — 장소의 카테고리 (맛집,카페,숙소,관광지,기타)
- 주소 (address) — VARCHAR(255) — 지도 API 주소
- 위도 (lat) — DOUBLE — NOT NULL — 지도 마커용 (소수점 필수)
- 경도 (lng) — DOUBLE — NOT NULL — 지도 마커용 (소수점 필수)
- 외부 지도 ID (external_id) — VARCHAR(100) — 카카오/네이버 장소 고유 ID
- 외부 링크 (external_link) — VARCHAR(255) — 클릭 시 이동할 지도 URL
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME
- 삭제일시 (deleted_at) — DATETIME — 폐업 장소일시, 삭제하면 장소를 참조하는 코스 데이터 깨지므로 명시적으로 표현
지역 (REGIONS)
- Id — BIGINT — 기본 키 — NOT NULL
- 지역명 (region_name) — VARCHAR(50) — NOT NULL — 제주, 부산, 서울 등
- 검색 키워드 (search_keyword) — VARCHAR — 연관검색어.(사용자가 입력할 만한 단어들을 모아놓은 컬럼) ( ex, "구마모토, 쿠마모토, kumamoto, 아소산")
- 대표 이미지 (image_url) — VARCHAR — NOT NULL — 버튼 배경에 들어갈 사진
- 노출 순서 (order_index) — INT — 인기 지역을 맨 앞으로 (1, 2, 3... ) / null 이면 맨뒤에서 생성순 정렬
- 활성 여부 (is_active) — BOOLEAN — NOT NULL — True(노출), False(준비중)
- 생성일시 (created_at) — DATETIME
- 수정일시 (updated_at) — DATETIME
코스 (COURSES)
- Id — BIGINT — 기본 키 — NOT NULL
- 원본 영상 ID (source_video_id) — BIGINT — 외래 키 → 영상.Id — NOT NULL — 원본 영상 ID
- 원본 코스 Id (original_course_id) — BIGINT — 외래 키 → 코스.Id — 자기 테이블 참조/원본 영상일시 null/ 원본 코스 내 장소가 폐점or바뀌면 알림용 / 원본 코스 ID로 어느 코스를 많이 저장했는지 집계용 / 초기화 용
- 지역 (region_id) — BIGINT — 외래 키 → 지역.Id — NOT NULL — 지역 구분의 정도? (제주/부산 or 남구 대연동?)
- 만든사람 (author_id) — BIGINT — 외래 키 → 멤버.Id — NOT NULL — 기본은 서비스가 제공하지만 / 유저가 수정한 코스도 엔티티에 저장해야함
- 제목 (title) — VARCHAR(100) — NOT NULL — 유저가 수정 가능
- 설명 (description) — VARCHAR — 간단한 설명
- 여행 일수 (travel_days) — INT — NOT NULL — 날짜가 없어도 '1박2일'
- 커스텀 여부 (is_customized) — BOOLEAN — NOT NULL — 유저가 수정,스크랩 했을시 TRUE
- 대표코스 여부 (is_rep) — BOOLEAN — NOT NULL — 홈 화면에 조회될 대표영상 판단여부
- 생성일시 (created_at) — DATETIME — NOT NULL — 코스 생성(저장) 시점
- 수정일시 (updated_at) — DATETIME — 내용 변경 시 갱신
- 삭제일시 (deleted_at) — DATETIME — 삭제요청후 30일 뒤 완전 삭제되도록 로직 설정
코스-장소 (COURSE_PLACE)
- id — BIGINT — 기본 키 — NOT NULL
- 코스 ID (course_id) — BIGINT — 외래 키 → 코스.Id — NOT NULL — 어떤코스에?
- 장소 ID (place_id) — BIGINT — 외래 키 → 장소.Id — NOT NULL — 어떤 장소가 있는지
- 방문 일차 (visit_day) — INT — 며칠차에 갈지?
- 방문 순서 (visit_order) — INT — 몇번쨰 순선지?
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME
- 삭제일시 (deleted_at) — DATETIME