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