Naily ERD

테이블 (13)

3D 미리보기 (preview_3d)

  • 미리보기 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 네일 디자인.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 네일 디자인.스캔 ID — NOT NULL — FK -> hand_scans.id, 손 모양과 피부색 반영
  • 세션 ID (session_id) — bigint(20) — 외래 키 → 네일 디자인.세션 ID — NOT NULL — FK -> design_sessions.id
  • 디자인 ID (nail_design_id) — bigint(20) — 외래 키 → 네일 디자인.디자인 ID — NOT NULL — FK -> nail_designs.id
  • 3D 모델 URL (model_file_url) — varchar(50) — NOT NULL — 3D 렌더링 파일 경로
  • 썸네일 URL (thumbnail_url) — varchar(50) — 미리보기 썸네일 이미지, 메인페이지의 '둘러보기'(다른 유저들의 생성 디자인 구경)에 활용
  • 렌더 상태 (render_status) — enum('PENDING', 'RENDERING', 'DONE', 'FAILED') — NOT NULL — 렌더링 진행 상태 (대기 중/렌더링 중/완료/실패)
  • 렌더 완료 일시 (rendered_at) — datetime — 렌더링 완료 시각

3D 프린터 (printers)

  • 프린터 ID (id) — int — 기본 키 — NOT NULL — PK, 현재는 1대 고정, 향후 확장 가능성 대비
  • 3d 프린터 이름 (name) — varchar(100) — NOT NULL — 관리용 이름, 현재 'printerFilament'로 고정
  • 3d 프린터 상태 (status) — enum('IDLE', 'PRINTING', 'ERROR', 'MAINTENANCE') — NOT NULL — 프린터 상태 (대기 중/출력 중/오류/점검 중)
  • 마지막 점검 일시 (last_maintained_at) — datetime — 마지막 유지보수 시각
  • 현재 제작요청 ID (current_request_id) — bigint(20) — FK -> production_requests.id, 현재 출력 중인 요청 ID

네일 디자인 (nail_designs)

  • 디자인 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).스캔 ID — NOT NULL — FK -> hand_scans.id
  • 세션 ID (session_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).세션 ID — NOT NULL — FK -> design_sessions.id
  • 이미지 URL (image_url) — varchar(50) — NOT NULL — AI 생성 이미지 저장 경로
  • 프롬프트 요약 (prompt_summary) — text — 생성에 사용된 프롬프트 요약
  • AI 모델명 (ai_model) — varchar(100) — NOT NULL — 사용된 생성형 AI 모델 식별자
  • 디자인 상태 (status) — enum('DRAFT', 'CONFIRMED', 'IN_PRODUCTION', 'COMPLETED') — NOT NULL — 임시저장/확정/제작중/제작완료
  • 생성 일시 (generated_at) — datetime — NOT NULL

네일팁 제작 (3D 프린팅) (production_requests)

  • 제작 요청 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 3D 미리보기.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 3D 미리보기.스캔 ID — NOT NULL — FK -> hand_scans.id, 사이즈 기준이 되는 손 스캔
  • 세션 ID (session_id) — bigint(20) — 외래 키 → 3D 미리보기.세션 ID — NOT NULL — FK -> design_sessions.id
  • 디자인 ID (nail_design_id) — bigint(20) — 외래 키 → 3D 미리보기.디자인 ID — NOT NULL — FK -> nail_designs.id, 제작할 디자인
  • 미리보기 ID (preview_3d_id) — bigint(20) — 외래 키 → 3D 미리보기.미리보기 ID — NOT NULL — FK -> preview_3d.id
  • 프린터 ID (printer_id) — int(1) — 외래 키 → 3D 프린터.프린터 ID — NOT NULL — FK -> printers.id
  • 출력 파일 URL (print_file_url) — varchar(500) — 3d 프린터 전용 출력 파일 경로 (.stl), 제작 요청 시점엔 아직 파일이 생성 중일 수 있으므로 default값: NULL
  • 제작 요청 일시 (requested_at) — datetime — NOT NULL — 사용자가 제작 확정(요청) 버튼을 누른 시각
  • 제작 상태 (status) — enum('PENDING', 'PRINTING', 'DONE', 'FAILED') — NOT NULL — PENDING->PRINTING->DONE 순서로 진행
  • 제작 시작 일시 (started_at) — datetime — 프린터가 실제로 출력을 시작한 시각
  • 제작 완료 일시 (finished_At) — datetime — 출력 완료 시각

디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할) (design_sessions)

  • 세션 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 손 스캔.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 손 스캔.스캔 ID — NOT NULL — FK -> hand_scans.id, 어떤 손 스캔을 기준으로 디자인하는지, 스캔 이력 있다면 스캔 단계 생략 후 바로 시작 가능
  • 세션 상태 (status) — enum('IN_PROGRESS', 'COMPLETED', 'CANCELLED') — NOT NULL — 세션 진행 상태, 지금 작업이 진행 중인지/완료됐는지/취소됐는지
  • 생성 일시 (created_at) — datetime — NOT NULL — 세션을 언제 시작했는지
  • 추출한 사용자 선호 정보 (extracted_preferences) — JSON — AI 채팅을 통해 추출한 사용자 선호 정보(색상, 스타일 등)를 별도 저장 (예: extractedPreferences: { likes: [ ], dislikes: })

디자인 저장 폴더 (saved_folders)

  • 폴더 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 회원정보.회원 ID — NOT NULL — FK -> users.id
  • 폴더명 (name) — varchar(50) — NOT NULL — 사용자가 직접 지정한 폴더 이름 (예: 봄, 연말)
  • 생성 일시 (created_at) — datetime — NOT NULL

손 스캔 (hand_scans)

  • 스캔 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 회원정보.회원 ID — NOT NULL — FK -> users.id
  • 스캔 파일 URL (scan_file_url) — varchar(500) — NOT NULL — 원본 스캔 파일 저장 경로
  • 손 방향 (hand_side) — enum('LEFT', 'RIGHT') — NOT NULL — 왼손/오른손 구분
  • 스캔 일시 (scanned_at) — datetime — NOT NULL — 스캔 완료 일시 (YYYY-MM-DD HH:MM:SS)

손 스캔 이미지 (hand_scan_images)

  • 스캔 이미지 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 손 스캔.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 손 스캔.스캔 ID — NOT NULL — FK -> hand_scans.id
  • 이미지 URL (image_url) — varchar(500) — NOT NULL — 촬영된 사진 파일 저장 경로
  • 촬영 각도 (angle) — enum('FRONT', 'LEFT', 'RIGHT', 'TOP') — 측정 목적에 따라 각도 구분, 선택값
  • 촬영 순서 (sequence) — int(20) — NOT NULL — 동일 스캔 내 촬영 순서 (1부터 시작)
  • 대표이미지 여부 (is_primary) — boolean — NOT NULL — true인 사진이 측정 및 마이페이지 대표 이미지로 사용
  • 촬영 일시 (captured_at) — datetime — NOT NULL — 사진 촬영 일시

손 측정값 (hand_measurements)

  • 측정 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 손 스캔.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 손 스캔.스캔 ID — NOT NULL — FK -> hand_scans.id
  • 피부 색 (skin_color_hex) — char(7) — NOT NULL — HEX 색상 코드로 저장 (#nnnnnn), 3d 렌더링 등에 활용
  • 손가락 이름 (finger_name) — enum('thumb', 'index', 'middle', 'ring', 'little') — NOT NULL — 엄지 ~ 소지 5개
  • 손가락 두께 (finger_thickness) — float — NOT NULL — 큐티클 라인 기준 손가락 두께, 손톱이 넓은지 좁은지 측정 비교할 때 활용(손가락 두께 대비 손톱 너비 측정)
  • 손톱 길이 (nail_length_mm) — float — NOT NULL — 단위: mm
  • 손톱 너비 (nail_width_mm) — float — NOT NULL — 단위: mm
  • 손톱 곡률 (nail_curvature) — float — NOT NULL — 곡률 반경값, 3d 프린팅 사이즈 계산에 활용
  • 손 측정 일시 (created_at) — datetime — NOT NULL — 측정 완료 일시 (YYYY-MM-DD HH:MM:SS)
  • 퍼스널컬러 ID (personal_color_id) — int — 외래 키 → 퍼스널 컬러.퍼스널컬러 ID — FK -> personal_colors.id, 측정값 먼저 저장 후 퍼스널 컬러 분석이므로 NULL 허용

저장 디자인 (saved_designs)

  • 저장 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 네일 디자인.회원 ID — NOT NULL — FK -> users.id
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 네일 디자인.스캔 ID — NOT NULL — FK -> hand_scans.id *중복, 실제 구현X*
  • 세션 ID (session_id) — bigint(20) — 외래 키 → 네일 디자인.세션 ID — NOT NULL — FK -> design_sessions.id *중복, 실제 구현X*
  • 디자인 ID (nail_design_id) — bigint(20) — 외래 키 → 네일 디자인.디자인 ID — NOT NULL — FK -> nail_designs.id
  • 메모 (memo) — text — 사용자가 직접 남기는 메모 (선택 사항
  • 저장 일시 (saved_at) — datetime — NOT NULL
  • 폴더 ID (saved_folder_id) — bigint(20) — 외래 키 → 디자인 저장 폴더.폴더 ID — NOT NULL — FK -> saved_folders.id, NULL이면 폴더 미지정 (전체 저장 목록에만 표시)
  • 회원 ID (user_id2) — bigint(20) — 외래 키 → 디자인 저장 폴더.회원 ID — NOT NULL — FK -> users.id *중복, 실제 구현X*

채팅 메시지 (chat_messages)

  • 메시지 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK
  • 회원 ID (user_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).회원 ID — NOT NULL — FK -> users.id *중복, 실제 구현X*
  • 스캔 ID (hand_scan_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).스캔 ID — NOT NULL — FK -> hand_scans.id *중복, 실제 구현X*
  • 세션 ID (session_id) — bigint(20) — 외래 키 → 디자인 세션(채팅 내역(chat_messages)과 생성된 디자인(nail_designs)을 하나의 작업으로 묶어주는 그룹장 역할).세션 ID — NOT NULL — FK -> design_sessions.id
  • 발신자 구분 (role) — enum('user', 'assistant') — NOT NULL — 사용자 메시지/AI 응답 구분
  • 메시지 내용 (content) — text — NOT NULL — 채팅 텍스트 본문
  • 전송 일시 (sent_at) — datetime — NOT NULL

퍼스널 컬러 (personal_colors)

  • 퍼스널컬러 ID (id) — int — 기본 키 — NOT NULL — PK
  • 퍼스널 컬러명 (name) — varchar(50) — NOT NULL — 퍼스널컬러 종류 (예: springWarm, summerCool)
  • 퍼스널 컬러 설명 (description) — text — NOT NULL — 설명용 컬럼, 사용자 화면에 보여줄 출력 문구 및 디자인 생성에 활용 (예: 밝고 따뜻한 느낌의 색상이 잘 어울림. 코랄, 피치, 골드 계열 추천)
  • 퍼스널 컬러 팔레트 이미지 URL (palette_image_url) — varchar(255) — NOT NULL — 컬러 팔레트 이미지 경로 저장, 실제 이미지 저장 위치: 클라우드(AWS)
  • 퍼스널 컬러 팔레트 색 데이터 (palette_colors) — JSON — NOT NULL — 실제 색 데이터 (예: ["#FFB6C1", "#FFD700", "#FF7F50"])

회원정보 (users)

  • 회원 ID (id) — bigint(20) — 기본 키 — NOT NULL — PK, 회원 고유 식별자
  • 이메일 (email) — varchar(255) — NOT NULL — 로그인 ID로 사용, UNIQUE
  • 비밀번호 해시 (password_hash) — varchar(255) — NOT NULL — 비밀번호 해시: 비밀번호를 복구 불가능한 형태로 변환해서 저장하는 보안 방식, bcrypt 알고리즘 사용
  • 이름 (name) — varchar(50) — NOT NULL — 실명
  • 닉네임 (nickname) — varchar(50) — NOT NULL