BookLog_DB(1)

Tables (26)

ai_book_insights

  • insight_id (Key) — BIGINT — Primary key — NOT NULL
  • insight_type (서재 기반 ai 추천) — VARCHAR(20) — NOT NULL
  • content (실제 결과 텍스트) — TEXT — NOT NULL
  • tags_json (결과에 대한 태그/키워드(필터/추천 고도화)) — JSON
  • created_at — DATETIME — NOT NULL
  • book_id (Key2) — BIGINT — Foreign key → books.book_id — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL

auth_accounts

  • auth_account_id (Key) — BIGINT — Primary key — NOT NULL
  • provider (구글/네이버/카카오/로컬) — VARCHAR(20) — NOT NULL
  • provider_user_id (소셜 서비스 내부 유저 식별자(로그인 매칭의 핵심)) — VARCHAR(100) — NOT NULL
  • email — VARCHAR(255)
  • display_name (소셜 표시 이름) — VARCHAR(100)
  • profile_image_url (소셜 프로필 이미지(초기값)) — VARCHAR(500)
  • created_at (연결된 시점) — DATETIME — NOT NULL
  • last_login_at (마지막 로그인 시점(보안/활동성 분석)) — DATETIME
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL

author_awards

  • award_id (Key) — BIGINT — Primary key — NOT NULL
  • award_year (연도(정렬/필터)) — INT
  • award_name (상 이름) — VARCHAR(255) — NOT NULL
  • work_title (수상작(있으면 표시)) — VARCHAR(255)
  • author_id (Key2) — BIGINT — Foreign key → authors.author_id — NOT NULL

authors (작가 정보 테이블 > 분할 가능성 많음(학력, 직업등등))

  • author_id (Key) — BIGINT — Primary key — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • profile_image_url — VARCHAR(500)
  • bio (긴 소개) — TEXT
  • birth_date (Field) — DATETIME
  • nationality (Field2) — VARCHAR(100)
  • short_intro (Field3) — VARCHAR(100)
  • debut_year (Field4) — DATETIME
  • debut_work_title (Field5) — VARCHAR(100)
  • wikidata_id (Field6) — VARCHAR(100)
  • wikidata_raw_json (Field7) — LONGTEXT

book_authors

  • book_id (PRIMARY KEY(book_id, author_id, role): 같은 사람/역할이 중복 연결되는 것 방지) — BIGINT — Foreign key → books.book_id — NOT NULL
  • author_id (Key2) — BIGINT — Foreign key → authors.author_id — NOT NULL
  • role (AUTHOR/TRANSLATOR (카카오가 authors[], translators[]로 분리 제공 → UI에 필요)) — VARCHAR(20)
  • sort_order (공저/역자 표시 순서 보장) — INT — NOT NULL

book_genres

  • book_id (PRIMARY KEY(book_id, genre_id): 중복 매핑 방지) — BIGINT — Foreign key → books.book_id — NOT NULL
  • genre_id (Key2) — BIGINT — Foreign key → genres.genre_id — NOT NULL

book_tags (도서_태그 매핑 테이블)

  • tag_id (UNIQUE(category, name): 같은 분류 내 같은 태그 중복 방지) — BIGINT — Foreign key → tags.tag_id — NOT NULL
  • book_id (Key) — BIGINT — Foreign key → books.book_id — NOT NULL

books

  • book_id (Key) — BIGINT — Primary key — NOT NULL
  • title (제목) — VARCHAR(255) — NOT NULL
  • contents (책 소개/요약 표시) — TEXT
  • kakao_url (책 상세 링크) — VARCHAR(500)
  • isbn_raw (원문 보관용) — VARCHAR(40)
  • isbn10 (외부 식별 기준10) — VARCHAR(20)
  • isbn13 (외부 식별 기준13) — VARCHAR(20)
  • published_date (발간일) — DATE
  • thumbnail_url (표지 이미지) — VARCHAR(500)
  • publisher_name (출판사 명) — VARCHAR(100)
  • source — VARCHAR(30) — NOT NULL
  • raw_json (카카오 응답 원본 보관) — JSON
  • synced_at (캐시 갱신 시점) — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

bookshelf_items (서재 and 유저 북 매핑 테이블)

  • added_at (폴더에 담은 시점(“최근 추가” 정렬 근거)) — DATETIME — NOT NULL
  • shelf_id (Key) — BIGINT — Foreign key → bookshelves.shelf_id — NOT NULL
  • user_book_id (Key2) — BIGINT — Foreign key → user_books.user_book_id — NOT NULL

bookshelves (서재)

  • shelf_id (동일 이름 서재 여러 개 생성 방지) — BIGINT — Primary key — NOT NULL
  • name (서재 이름) — VARCHAR(50) — NOT NULL
  • is_public (서재 공개 여부) — TINYINT(1) — NOT NULL
  • sort_order (정렬 방법) — VARCHAR(20) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL
  • user_id (유저 고유 식별자2) — Foreign key → users.user_id — NOT NULL

follows (유저가 다른 유저를 팔로우(다시 확인))

  • follower_id (팔로우 하는 사람) — BIGINT — Primary key — NOT NULL
  • followee_id (팔로우 당하는 사람) — BIGINT — Primary key — NOT NULL
  • created_at (팔로우한 시점) — DATETIME — NOT NULL
  • user_id (PRIMARY KEY(follower_id, followee_id): 중복 팔로우 방지) — Foreign key → users.user_id — NOT NULL

genres

  • genre_id (장르 식별) — BIGINT — Primary key — NOT NULL
  • name (장르명 사전화/중복 방지) — VARCHAR(50) — NOT NULL

onboarding_options (질문의 보기(차분한/따뜻한…))

  • option_id (어떤 질문의 보기인지(분위기, 문체, 몰입도)) — BIGINT — Primary key — NOT NULL
  • code (선택지의 안정 키) — VARCHAR(50) — NOT NULL
  • label (화면에 보여줄 짧은 텍스트) — VARCHAR(50) — NOT NULL
  • description (부가 설명(선택 UI에 자주 필요)) — VARCHAR(255)
  • image_url (이미지형 선택지) — VARCHAR(500)
  • sort_order (보기 표시 순서) — INT — NOT NULL
  • is_active (보기 비활성(운영에서 항목 제거/교체 가능)) — TINYINT(1) — NOT NULL
  • question_id (Key) — Foreign key → onboarding_questions.question_id — NOT NULL

onboarding_questions (온보딩(취향 테스트) 도메인)

  • question_id (Key) — Primary key — NOT NULL
  • code (질문 식별 코드) — VARCHAR(50) — NOT NULL
  • title (질문 그룹 제목/헤더(선택)) — VARCHAR(100)
  • question_text (실제 질문 문장) — VARCHAR(255) — NOT NULL
  • answer_type (SINGLE/MULTI) — VARCHAR(20) — NOT NULL
  • max_select (MULTI일 때 최대 선택 개수 제한) — INT — NOT NULL
  • sort_order (질문 표시 순서) — INT — NOT NULL
  • is_active (운영 중/비활성 질문 관리) — TINYINT(1) — NOT NULL

post_bookmarks

  • created_at (북마크 시점) — DATETIME — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL
  • post_id (PRIMARY KEY(post_id, user_id): 중복 북마크 방지) — BIGINT — Foreign key → posts.post_id — NOT NULL

post_images

  • image_id (Key) — BIGINT — Primary key — NOT NULL
  • post_id — BIGINT — NOT NULL
  • image_url (이미지 주소) — VARCHAR(500) — NOT NULL
  • sort_order (이미지 표시 순서) — INT — NOT NULL
  • created_at (업로드/연결 시점) — DATETIME — NOT NULL
  • post_id (Key2) — BIGINT — Foreign key → posts.post_id — NOT NULL

post_tags (매핑테이블에 책의 태그 저장)

  • post_id (PRIMARY KEY(post_id, tag_id): 중복 태그 연결 방지) — BIGINT — Foreign key → posts.post_id — NOT NULL
  • tag_id (Key2) — BIGINT — Foreign key → tags.tag_id — NOT NULL

posts

  • post_id (Key) — BIGINT — Primary key — NOT NULL
  • status (DRAFT/PUBLISHED (임시저장/발행 플로우)) — VARCHAR(20) — NOT NULL
  • content (글 본문) — TEXT — NOT NULL
  • published_at (발행 시각(피드 기준/정렬)) — DATETIME
  • view_count (조회수(빠른 표시용 캐시)) — INT — NOT NULL
  • bookmark_count (북마크 수(빠른 표시용 캐시)) — INT — NOT NULL
  • created_at (생성 시각(정렬/이력)) — DATETIME — NOT NULL
  • updated_at (수정 시각(정렬/이력)) — DATETIME — NOT NULL
  • book_id (Key2) — BIGINT — Foreign key → books.book_id — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL

reading_logs

  • log_id (Key) — BIGINT — Primary key — NOT NULL
  • read_date (캘린더 날짜 키) — DATE — NOT NULL
  • pages_read (그 날 읽은 페이지(랭킹/연속 독서/통계 산출)) — INT
  • status (기록 시점 상태 스냅샷(선택: “그날은 읽는중이었음” 같은 이력)) — VARCHAR(20)
  • created_at — DATETIME — NOT NULL
  • user_book_id (특정 “내 책(user_books)”에 대한 기록) — BIGINT — Foreign key → user_books.user_book_id — NOT NULL

tags

  • tag_id (UNIQUE(category, name): 같은 분류 내 같은 태그 중복 방지) — BIGINT — Primary key — NOT NULL
  • category (MOOD/STYLE/IMMERSION (태그 필터)) — VARCHAR(20) — NOT NULL
  • name (태그 이름) — VARCHAR(50) — NOT NULL

user_books (내 서재/독서 기록 도메인)

  • user_book_id (UNIQUE(user_id, book_id): 같은 책 중복 담기 방지(기본 UX)) — BIGINT — Primary key — NOT NULL
  • status (읽을 예정/읽는 중/완독/중단) — VARCHAR(20) — NOT NULL
  • progress_percent (진행률) — INT — NOT NULL
  • current_page (현재 페이지) — INT
  • start_date (시작일) — DATE
  • end_date (완독일) — DATE
  • format (종이책/전자책/오디오) — VARCHAR(20)
  • page_count_snapshot (당시 기준 페이지 수(외부 데이터 변동/누락 대비)) — INT
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL
  • book_id (Key2) — BIGINT — Foreign key → books.book_id — NOT NULL

user_onboarding_answers

  • created_at (답변 저장 시점(온보딩 흐름 분석)) — DATETIME — NOT NULL
  • option_id (어떤 선택지를 골랐는지(실제 답)) — BIGINT — Foreign key → onboarding_options.option_id — NOT NULL
  • question_id (어떤 질문에 대한 답인지(검증/조회 편의)) — Foreign key → onboarding_questions.question_id — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL

user_onboarding_status

  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL
  • is_completed (완료 여부(온보딩 재진입/스킵 처리에 필요)) — TINYINT(1) — NOT NULL
  • is_skipped (스킵 여부(추천 품질/UX 분기)) — TINYINT(1) — NOT NULL
  • completed_at (완료 시점(추천 알고리즘/통계)) — DATETIME
  • updated_at (상태 변화 시점 추적) — DATETIME — NOT NULL

user_recent_searches (프론트 처리 가능성 있음)

  • search_id (Key) — BIGINT — Primary key — NOT NULL
  • search_id — BIGINT
  • user_id — BIGINT — NOT NULL
  • keyword (검색어 문자열) — VARCHAR(100) — NOT NULL
  • created_at (최근 검색어 정렬/표시 근거(최신순)) — DATETIME — NOT NULL
  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL

user_settings

  • user_id (유저 고유 식별자) — Foreign key → users.user_id — NOT NULL
  • is_shelf_public (서재 공개 토글) — TINYINT(1) — NOT NULL
  • is_blog_public (북로그 공개 토글) — TINYINT(1) — NOT NULL
  • updated_at (설정 변경 시점 추적) — DATETIME — NOT NULL

users

  • user_id (유저 고유 식별자) — Primary key — NOT NULL
  • nickname (닉네임) — VARCHAR(50)
  • profile_image_url (프로필 이미지) — VARCHAR(500)
  • status (활성/비활성/탈퇴 등 상태 관리) — VARCHAR(20) — NOT NULL
  • created_at (생성 시각) — DATETIME — NOT NULL
  • updated_at (수정 시각) — DATETIME — NOT NULL
  • user_id (유저 고유 식별자2) — Foreign key → users.user_id — NOT NULL
  • follower_id — BIGINT — Foreign key → follows.follower_id — NOT NULL
  • followee_id — BIGINT — Foreign key → follows.followee_id — NOT NULL