ktb final 8

테이블 (21)

그룹 (groups)

  • 그룹 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 그룹명 (name) — varchar(100) — NOT NULL — 2자 이상, 10자 이하, 특수문자 및 이모지 사용가능
  • 그룹 소개글 (introduction) — varchar(30) — 최대 30자까지 작성 가능, 특수문자 및 공백 허용, 줄바꿈 입력 금지
  • 그룹 총 참여자 수 (total_members) — int — NOT NULL — 그룹장을 포함하여 그룹에 속한 사용자 수. QR을 통해 참석자가 생기면 1씩 증가
  • 그룹 생성 날짜 (created_at) — timestamp — NOT NULL — jpa auditing 설정
  • 그룹 위도 (latitude) — double — NOT NULL
  • 그룹 경도 (longitude) — double — NOT NULL

리뷰 만족도 카테고리 (reviews_satisfaction_categories)

  • 리뷰 키워드 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 리뷰 PK (reviews_id) — bigint — 외래 키 → 식당 리뷰.리뷰 PK — NOT NULL — 리뷰의 키워드 목록 조회 성능 향상을 위해 해당 컬럼을 인덱스로 설정
  • 카테고리 PK (satisfaction_categories_id) — tinyint — 외래 키 → 만족도 카테고리.카테고리 PK — NOT NULL — AUTO_INCREMENT

만족도 카테고리 (satisfaction_categories)

  • 카테고리 PK (id) — tinyint — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 카테고리 (type) — varchar(50) — NOT NULL — UNIQUE 제약 조건 | 맛있는 음식(TASTE), 즐거운 분위기(ATMOSPHERE), 친절한 서비스(SERVICE), 최적 위치(LOCATION), 그룹 궁합도(GROUP_COMPATIBILITY), 회식 성…
  • 카테고리 설명 (description) — varchar(100) — NOT NULL — 사용자가 카테고리의 이름만 보고 선택하기 어렵기 때문에 카테고리에 대한 자세한 설명을 추가

번개 모임 (lightning)

  • 번개 모임 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 식당 PK (restaurants_id) — bigint — 외래 키 → 식당.식당 PK — NOT NULL — 번개 모임 추천 식당
  • 모집 인원 (max_participants) — tinyint — NOT NULL — 정책상 모집 최대 인원은 4명으로 제한. 최소 2명 이상 4명 이하
  • 번개 소개 (description) — varchar(30) — 번개 소개는 최대 30자까지 작성 가능
  • 생성 날짜 (created_at) — timestamp — NOT NULL — jpa auditing 설정

번개 모임 참석자 (impromptu_gathering_participants)

  • 번개 모임 참석자 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 번개 모임 PK (lightning_id) — bigint — 외래 키 → 번개 모임.번개 모임 PK — NOT NULL
  • 역할 (role) — enum — NOT NULL — 번개 모임에서 사용자의 역할 [모임장(LEADER), 참석자(PARTICIPANT)] | 번개 모임을 생성하는 사용자는 자동으로 모임장 역할 부여
  • 마지막으로 읽은 채팅 PK (last_chat_messages_id) — bigint — NOT NULL

사용자 (users)

  • 사용자 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 이메일 (email) — varchar(100) — NOT NULL — 회원가입 과정에서 수집한 사용자의 소셜 가입 계정 이메일 | 동일 계정으로 중복 가입 방지를 위한 UNIQUE 제약 조건 설정
  • 비밀번호 (password) — varchar(255) — 알파벳 대, 소문자 사용, 8자 이상 20자 이하, 특수문자(~, !, @, #, &) 1개 이상 포함 SHA256 암호화| 현재는 소셜 로그인만 구현할 예정이지만 서비스 자체 로그인도 염려하여 nullable로…
  • 닉네임 (nickname) — varchar(10) — NOT NULL — 1자 이상 10자 이하, 공백 및 특수문자 금지 | 닉네임 중복 방지를 위한 UNIQUE 제약 조건 설정
  • 성별 (gender) — varchar(10) — NOT NULL — MALE. FEMALE enum으로 분류
  • 연령대 (age_group) — enum — NOT NULL — 사용자 연령대 [20대(TWENTIES), 30대(THIRTIES), 40대(FORTIES), 50대 이상(FIFTIES_PLUS)]
  • 푸시 알림 허용 여부 (is_push_notification_allowed) — tinyint(1) — NOT NULL — 0(false), 1(true)
  • 온보딩 단계 (onboarding_step) — enum — NOT NULL — 사용자 온보딩 단계 [기본 정보 수집(BASIC), 개인 특성 수집(CHARACTERISTIC), 완료(DONE)]
  • FCM 푸시 토큰 (fcm_token) — varchar(100) — 사용자가 최초로 푸시 알림을 허용하는 시점에 FCM으로 부터 토큰을 발급받아 저장
  • 기타 특성 정보 (otherCharacteristics) — varchar(100) — NOT NULL — 100자 이하
  • 가입 날짜 (created_at) — timestamp — NOT NULL — jpa auditing 설정
  • 수정 날짜 (updated_at) — timestamp — NOT NULL — jpa auditing 설정
  • 탈퇴 날짜 (withdraw_at) — timestamp — 사용자 탈퇴 전까지 NULL
  • 탈퇴 여부 (is_withdraw) — tinyint(1) — NOT NULL — 0(false), 1(true) | true는 탈퇴 상태

사용자 그룹 (users_groups)

  • 사용자_그룹 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL — 사용자가 속한 그룹 목록 조회 성능 향상을 위해 해당 컬럼을 인덱스로 설정
  • 그룹 PK (groups_id) — bigint — 외래 키 → 그룹.그룹 PK — NOT NULL
  • 역할 (role) — enum — NOT NULL — 그룹에서 사용자의 역할 [그룹장(LEADER), 참석자(PARTICIPANT)] | 그룹을 생성하는 사용자는 자동으로 그룹장 역할 부여
  • 그룹에 참가한 날짜 (participation_at) — timestamp — NOT NULL — jpa auditing 설정

사용자 선호 식재료 (users_like_ingredient)

  • 사용자 선호 식재료 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 카테고리 PK (categories_id) — tinyint — 외래 키 → 선호 식재료.카테고리 PK — NOT NULL

사용자 선호 음식 (users_like_foods)

  • 사용자 선호 음식 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 카테고리 PK (like_food_categories_id) — tinyint — 외래 키 → 선호 음식 카테고리.카테고리 PK — NOT NULL

사용자 알레르기 (users_allergies)

  • 사용자 알레르기 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 카테고리 PK (allergy_categories_id) — tinyint — 외래 키 → 알레르기 카테고리.카테고리 PK — NOT NULL

선호 식재료 (like_ingredient_categories)

  • 카테고리 PK (id) — tinyint — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 선호 식재료 종류 (type) — enum — NOT NULL — ["MEAT", "POULTRY", "SEAFOOD", "VEGETABLE", "GRAIN", "DAIRY"]

선호 음식 카테고리 (like_food_categories)

  • 카테고리 PK (id) — tinyint — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 선호 음식 종류 (type) — enum — NOT NULL — ["KOREAN", "CHINESE", "JAPANESE", "WESTERN", "INTERNATIONAL"]

식당 (restaurants)

  • 식당 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 식당 이름 (name) — varchar(100) — NOT NULL — 카카오맵API로 수집한 식당 이름
  • 식당 설명 (description) — varchar(500) — 네이버지도 크롤링을 통해 수집한 식당 설명
  • 연락처 (phone_number) — varchar(50) — 전화 예약을 위한 식당 전화번호
  • 위도 (latitude) — double — NOT NULL — 카카오맵에 표시하기 위한 식당의 위도 값
  • 경도 (longitude) — double — NOT NULL — 카카오맵에 표시하기 위한 식당의 경도 값

식당 레이팅 (restaurants_rating)

  • 식당 레이팅 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 식당 PK (restaurants_id) — bigint — 외래 키 → 식당.식당 PK — NOT NULL
  • 순추천수 (net_like_count) — int — NOT NULL — 추천 식당 테이블의 (추천수 - 비추천수) 값
  • 리뷰 평점 (avg_review_rating) — double — NOT NULL — 7일간 리뷰 평균 평점
  • AI 추천 횟수 (ai_recommend_count) — int — NOT NULL — 7일간 회식에 추천된 횟수
  • 계산 수행 날짜 (calculated_at) — timestamp — NOT NULL
  • 레이팅 점수 (rating_score) — double — NOT NULL — (순추천수 * 3) + (평균 평점 * 2) + AI 추천 횟수

식당 리뷰 (reviews)

  • 리뷰 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 식당 PK (restaurants_id) — bigint — 외래 키 → 식당.식당 PK — NOT NULL
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 별점 (rating) — double — NOT NULL — 별점은 최소 1개 부터 최대 5개 까지 선택 가능
  • 리뷰 상세 내용 (comment) — text — 선택사항이므로 비어있으면 NULL 처리
  • 리뷰 작성 날짜 (created_at) — timestamp — NOT NULL — jpa auditing 설정

알레르기 카테고리 (allergy_categories)

  • 카테고리 PK (id) — tinyint — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 알레르기 종류 (type) — enum — NOT NULL — 콩류(LEGUMES), 견과류(NUTS), 갑각류(SHELLFISH), 생선(FISH), 곡류(GRAINS), 우유(MILK)

채팅 메시지 (chat_messages)

  • 채팅 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 번개 모임 PK (lightning_id) — bigint — 외래 키 → 번개 모임.번개 모임 PK — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 내용 (content) — text — NOT NULL

추천 식당 선호도 투표 (recommend_restaurants_vote)

  • 선호도 투표 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 추천 식당 PK (recommend_restaurants_id) — bigint — 외래 키 → 회식 추천 식당.추천 식당 PK — NOT NULL
  • 추천 상태 (status) — enum — NOT NULL — 추천 식당에 대한 투표 상태 [LIKE(추천), DISLIKE(비추천)]

회식 (dining)

  • 회식 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 그룹 PK (groups_id) — bigint — 외래 키 → 그룹.그룹 PK — NOT NULL — 그룹의 회식 목록 조회 성능 향상을 위해 해당 컬럼을 인덱스로 설정
  • 회식 진행 날짜 (dining_date) — timestamp — NOT NULL — 클라이언트에서 yyyy-MM-dd HH:mm 형식으로 전달
  • 투표 마감 날짜 (vote_due_date) — timestamp — NOT NULL — 클라이언트에서 yyyy-MM-dd HH:mm 형식으로 전달
  • 예산 (budget) — int — NOT NULL — 예산을 가지고 계산하는 작업이 없기 때문에 decimal 사용하지 않고 int 사용 | 음수 금지
  • 회식 상태 (status) — enum — NOT NULL — 회식의 진행 상태 [참석 투표(ATTENDANCE_VOTING), 식당 투표(RESTAURANT_VOTING), 회식 확정(CONFIRMED), 회식 완료(COMPLETE)]
  • 회식 생성 날짜 (created_at) — timestamp — NOT NULL — jap auditing 설정

회식 참석자 (dining_participants)

  • 회식 참석자 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 회식 PK (dining_id) — bigint — 외래 키 → 회식.회식 PK — NOT NULL — 회식에 참석한 사용자 목록 조회 성능 향상을 위해 해당 컬럼을 인덱스 설정
  • 사용자 PK (users_id) — bigint — 외래 키 → 사용자.사용자 PK — NOT NULL
  • 투표 상태 (vote_status) — enum — NOT NULL — 참석 투표 진행 여부 [투표 전(PENDING), 불참석(NON_ATTEND), 참석(ATTEND)]
  • 투표 상태 변경 날짜 (vote_status_modified_at) — timestamp — NOT NULL — 투표 상태가 변경되면 날짜를 변경

회식 추천 식당 (recommend_restaurants)

  • 추천 식당 PK (id) — bigint — 기본 키 — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 회식 PK (dining_id) — bigint — 외래 키 → 회식.회식 PK — NOT NULL — 회식의 추천 식당 목록 조회 성능 향상을 위해 해당 컬럼을 인덱스로 설정
  • 식당 PK (restaurants_id) — bigint — 외래 키 → 식당.식당 PK — NOT NULL — snowflake 알고리즘으로 애플리케이션에서 키 생성
  • 확정 여부 (confirmed_status) — tinyint(1) — NOT NULL — 0(false), 1(true) | false는 식당 확정이 되지 않은 상태
  • 추천수 (like_count) — int — NOT NULL — 실시간 추천수는 redis로 관리하고 해당 컬럼은 백업용으로 사용
  • 비추천수 (unlike_count) — int — NOT NULL — 실시간 비추천수는 redis로 관리하고 해당 컬럼은 백업용으로 사용
  • 점수 (point) — int — NOT NULL
  • 추천 이유 (resoning_description) — varchar(500) — NOT NULL — AI에서 받은 해당 식당 추천 이유
  • 생성 날짜 (created_at) — timestamp — NOT NULL — jpa auditing 설정