DB

Tables (18)

authors

  • author_id (Key) — Primary key — NOT NULL — 작가 ID
  • name — VARCHAR(100) — NOT NULL — 이름
  • created_at — DATETIME — NOT NULL — 생성 일시

book_api_cache

  • book_api_cache_id (Key) — Primary key — NOT NULL — 걍 pk
  • isbn — VARCHAR(20) — ISBN
  • description — TEXT — 소개글
  • author_bio — TEXT — 저자 소개
  • editorial_review — TEXT — 편집자 리뷰
  • keywords — JSON — 키워드 목록 (단어 + 가중치)
  • subject_names — JSON — 주제 분류명 목록
  • wiki_book_summary — TEXT — 위키 책 요약
  • wiki_author_summary — TEXT — 위키 저자 요약
  • wiki_extra_sections — JSON — 위키 추가 섹션 (등장인물, 시대배경 등)
  • cached_at — DATETIME — NOT NULL — 캐시 생성 일시
  • expires_at — DATETIME — NOT NULL — 캐시 만료 일시

book_authors

  • book_authors_id (Key3) — Primary key — NOT NULL — 걍 pk
  • author_id (Key2) — Foreign key → authors.author_id — NOT NULL — 작가 ID
  • book_id (Key) — Foreign key → books.book_id — NOT NULL — 도서 ID
  • role — VARCHAR(50) — NOT NULL — 역할 (저자, 역자, 감수 등)

book_user_states

  • book_user_states_id (Key3) — Primary key — NOT NULL — 걍 pk
  • user_id (Key2) — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • book_id (Key) — Foreign key → books.book_id — NOT NULL — 도서 ID
  • shelf_state — ENUM('LIST', 'READING', 'RATED_ONLY', 'REVIEW_POSTED') — NOT NULL — 서재 상태
  • reading_proof_url — VARCHAR(500) — 읽는 중 인증 이미지 URL
  • comment_prompted_at — DATETIME — 마지막 댓글 작성 유도 일시
  • context_tags — JSON — 맥락 태그 (STORE_DISCOVERED 등)
  • updated_at — DATETIME — NOT NULL — 수정 일시

book_vectors

  • book_vectors_id (Key) — Primary key — NOT NULL — 걍 pk
  • isbn — VARCHAR(20) — ISBN
  • title — VARCHAR(300) — NOT NULL — 제목
  • authors — VARCHAR(500) — 저자
  • vector — JSON — NOT NULL — 1536차원 임베딩 벡터
  • kdc_class — VARCHAR(50) — KDC 십진분류
  • is_cold_start — BOOLEAN — NOT NULL — 콜드스타트 여부 (정보 부족으로 LLM 태그 추론)
  • created_at — DATETIME — NOT NULL — 생성 일시
  • updated_at — DATETIME — NOT NULL — 수정 일시

books

  • book_id (Key) — Primary key — NOT NULL — 도서 ID
  • isbn — VARCHAR(20) — ISBN
  • title — VARCHAR(300) — NOT NULL — 제목
  • publication_year — INT — 제작 연도
  • pages — INT — 페이지 수
  • age_rating — VARCHAR(20) — 연령 등급
  • category — VARCHAR(100) — 카테고리
  • description — TEXT — 기본 정보(소개글)
  • cover_image_url — VARCHAR(500) — 표지 이미지
  • created_at — DATETIME — NOT NULL — 생성 일시

collection_books

  • collection_book_id (Key3) — Primary key — NOT NULL — 걍 pk
  • book_id (Key) — Foreign key → books.book_id — NOT NULL — 도서 ID
  • collection_id (Key2) — Foreign key → collections.collection_id — NOT NULL — 컬렉션 ID
  • order_index — INT — NOT NULL — 순서
  • added_at — DATETIME — NOT NULL — 추가 일시

collections

  • collection_id (Key) — Primary key — NOT NULL — 컬렉션 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 생성한 유저 ID
  • title — VARCHAR(200) — NOT NULL — 컬렉션 제목
  • description — TEXT — 컬렉션 설명
  • is_public — BOOLEAN — NOT NULL — 공개 여부
  • created_at — DATETIME — NOT NULL — 생성 일시

comments

  • comment_id (Key) — Primary key — NOT NULL — 코멘트 ID
  • review_id — BIGINT — Foreign key — NOT NULL — 리뷰 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 작성한 유저 ID
  • content — TEXT — NOT NULL — 댓글 내용
  • created_at — DATETIME — NOT NULL — 작성 일시

conversation

  • conversation_id (Key) — Primary key — NOT NULL — 대화방 ID
  • user_id (Key2) — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • book_id (Key3) — Foreign key → books.book_id — NOT NULL — 도서 ID(book__detail일때)
  • created_at (Field4) — 생성 일시
  • type (Field) — agent | book_detail

conversationMessage

  • message_id (Key) — Primary key — NOT NULL — 메시지 id
  • conversation_id (Key2) — Foreign key → conversation.conversation_id — NOT NULL — 대화방 ID
  • role (Field) — user | ai
  • conent (Field2) — 내용
  • intent (Field3) — agent 사용일때만
  • created_at (Field4) — 생성 일시

ratings

  • ratings_id (Key3) — Primary key — NOT NULL — 걍 pk
  • user_id (Key) — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • book_id (Key2) — Foreign key → books.book_id — NOT NULL — 도서 ID
  • score — DECIMAL(2, 1) — NOT NULL — 별점
  • registered_at — DATETIME — NOT NULL — 등록 일시

review_likes

  • review_likes_id (Key3) — Primary key — NOT NULL — 걍 pk
  • user_id (Key) — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • review_id (Key2) — Foreign key → reviews.review_id — NOT NULL — 리뷰 ID
  • created_at — DATETIME — NOT NULL — 생성 일시

reviews

  • review_id (Key) — Primary key — NOT NULL — 리뷰 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 사용자 ID
  • book_id — BIGINT — Foreign key — NOT NULL — 도서 ID
  • content — TEXT — NOT NULL — 리뷰 내용
  • created_at — DATETIME — NOT NULL — 작성 일시

shelf_books

  • shelf_books_id (Key3) — Primary key — NOT NULL — 걍 pk
  • book_id (Key) — Foreign key → books.book_id — NOT NULL — 도서 ID
  • shelf_id (Key2) — Foreign key → shelves.shelf_id — NOT NULL — 보관함 ID
  • added_at — DATETIME — NOT NULL — 추가 일시

shelves

  • shelf_id (Key) — Primary key — NOT NULL — 보관함 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 생성한 유저 ID
  • shelf_type — ENUM('평가한', '읽은', '읽는중', '쇼핑리스트') — NOT NULL — 보관함 타입
  • created_at — DATETIME — NOT NULL — 생성 일시

stores

  • store_id (Key) — Primary key — NOT NULL — 서점 ID
  • name — VARCHAR(200) — NOT NULL — 서점 이름
  • address — VARCHAR(500) — 주소
  • latitude — DECIMAL(10, 7) — 위도
  • longitude — DECIMAL(10, 7) — 경도
  • phone — VARCHAR(20) — 전화번호
  • business_hours — VARCHAR(200) — 영업 시간
  • created_at — DATETIME — NOT NULL — 생성 일시

users

  • user_id (Key) — Primary key — NOT NULL — 사용자 ID
  • username — VARCHAR(50) — NOT NULL — 아이디
  • password — VARCHAR(255) — NOT NULL — 비밀번호
  • nickname — VARCHAR(50) — NOT NULL — 닉네임
  • profile_image_url — VARCHAR(500) — 프로필 이미지 URL
  • bio — TEXT — 자기소개
  • preferred_genres — VARCHAR(500) — 선호 장르/태그
  • created_at — DATETIME — NOT NULL — 생성 일시