DB_base

테이블 (12)

AI 추천 이력 (ai_recommendations)

  • 추천 결과 ID (recommendation_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 추천 유형 (recommendation_type) — VARCHAR(50) — NOT NULL — CHECK (recommendation_type IN ('workout', 'diet', 'sleep', 'general'))
  • 추천 내용 (content) — TEXT — NOT NULL
  • 기준 날짜 (based_on_date) — DATE — NOT NULL
  • LLM 버전 (model_name) — VARCHAR(50) — NOT NULL — 어떤 모델 엔진이 만들었는지 추적
  • 생성 시각 (created_at) — TIMESTAMPTZ

개인정보 관리 (consents)

  • 동의 이력 ID (consent_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 동의 항목 유형 (consent_type) — VARCHAR(50) — NOT NULL — CHECK (consent_type IN ('privacy_policy', 'health_data_usage', 'ai_analysis', 'marketing')) 등등
  • 동의 여부 (agreed) — BOOLEAN — NOT NULL
  • 동의/거부 시각 (agreed_at) — TIMESTAMPTZ — NOT NULL
  • 약관 버전 (version) — VARCHAR(20) — NOT NULL

비식별화 매핑 (deidentification_map)

  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 비식별화 id (subject_id) — UUID — unique
  • 생성 시각 (created_at) — TIMESTAMPTZ

사용자 계정 (users)

  • 사용자 ID (user_id) — UUID — 기본 키 — NOT NULL — pk
  • 이메일 (email) — VARCHAR(100) — NOT NULL — UNIQUE, NOT NULL
  • 닉네임 (nickname) — VARCHAR(50) — UNIQUE, NOT NULL
  • 가입일 (created_at) — TIMESTAMPTZ — DEFAULT NOW()
  • 업데이트 날짜 (updated_at) — TIMESTAMPTZ — 트리거 추가
  • 삭제일 (deleted_at) — TIMESTAMPTZ

식단 정보 (meal_logs)

  • 식단 고유 ID (meal_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL
  • 아침/점심/저녁/간식 (meal_type) — VARCHAR(20)
  • 기록 시점 (recorded_at) — TIMESTAMPTZ
  • AWS S3 이미지 (image_url) — TEXT
  • 총 칼로리 (total_calories_kcal) — INT
  • 단백질(g) (protein_g) — DECIMAL(5,2)
  • 지방(g) (fat_g) — DECIMAL(5,2)
  • 탄수화물(g) (carb_g) — DECIMAL(5,2)
  • 데이터 입력 출처 (source) — VARCHAR(50)
  • 측정 시각 (created_at) — TIMESTAMPTZ
  • 업데이트 시각 (updated_at) — TIMESTAMPTZ

음식별 항목 (meal_items)

  • 음식 고유 ID (meal_item_id) — BIGINT — 기본 키 — NOT NULL
  • 식단 고유 ID (meal_id) — BIGINT — 외래 키 → 식단 정보.식단 고유 ID — NOT NULL
  • 음식 종류 (food_name) — VARCHAR(100)
  • 음식별 칼로리 (food_colories_kcal) — INT
  • 음식별 단백질 (protein_g) — DECIMAL(5,2)
  • 음식별 지방 (fat_g) — DECIMAL(5,2)
  • 음식별 탄수화물 (carb_g) — DECIMAL(5,2)

일일 대시보드 요약 (daily_summaries)

  • 생체 데이터 ID (summary_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 해당 날짜 (summary_date) — DATE — NOT NULL
  • 총 걸음 수 (step_count) — INT
  • 총 수면 시간 (sleep_minutes) — INT
  • 회복 탄력성 점수 (resilience_score) — INT
  • 평균 심박 (bpm_avg) — INT
  • 안정 시 심박수 (resting_bpm) — INT
  • 소모 칼로리 (burned_kcal) — INT
  • 데이터 출처 (source) — VARCHAR(50) — NOT NULL — 데이터가 어디서 계산되어 들어왔는지... galaxy_fit3_sync, system_aggregated 등
  • DB 저장 시간 (created_at) — TIMESTAMPTZ
  • 마지막으로 수정된 시간 (updated_at) — TIMESTAMPTZ

정규화 시계열 데이터(TimescaleDB 적용) (health_samples)

  • 시계열 데이터 ID (sample_id) — BIGINT — 기본 키 — NOT NULL — GENERATED ALWAYS AS IDENTITY
  • 측정 시각 (measured_at) — TIMESTAMPTZ — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 데이터 타입 (metric_type) — VARCHAR(50) — ex)metric_type = heart_rate_bpm
  • 데이터 측정값 (metric_value) — DECIMAL(10,2) — NOT NULL
  • 측정 단위 (unit) — VARCHAR(20) — NOT NULL — 심박수인지 걸음수인지 등 구분 위한 단위 설정
  • 출처 (source) — VARCHAR(50)
  • 원본 데이터 (raw_payload) — JSONB — 필요X데이터 저장 공간
  • 측정 시각 (created_at) — TIMESTAMPTZ

정적 프로필 (user_profiles)

  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 성별 (gender) — VARCHAR(10) — CHECK (gender IN ('male', 'female', 'other'))
  • 생년월일 (birth_date) — DATE — CHECK (birth_date <= CURRENT_DATE)
  • 현재 키 (height_cm) — DECIMAL(5,2) — CHECK(height_cm>0)
  • 목표 체중 (target_weight) — DECIMAL(5,2) — CHECK (target_weight_kg>0)
  • 평균 생리 주기 (menstrual_cycle) — INT — CHECK (menstrual_cycle_days > 0)

채팅 메세지 (chat_messages)

  • 메세지 ID (message_id) — BIGINT — 기본 키 — NOT NULL
  • 세션 ID (session_id) — UUID — 외래 키 → 채팅 세션.세션 ID — NOT NULL
  • 발화자 구분 (role) — VARCHAR(20) — 사용자: user AI: assistant prompt: system CHECK (role IN ('user', 'assistant', 'system'))
  • 메세지 내용 (content) — TEXT — NOT NULL
  • 메세지 생성 시각 (created_at) — TIMESTAMPTZ
  • LLM 버전 (model_name) — VARCHAR(50) — 모델 버전ex gpt-4o

채팅 세션 (chat_sessions)

  • 세션 ID (session_id) — UUID — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 대화 시작 시간 (started_at) — TIMESTAMPTZ

체성분 변화 이력 (body_measurements)

  • 체성분 ID (measurement_id) — BIGINT — 기본 키 — NOT NULL — PRIMARY KEY, GENERATED ALWAYS AS IDENTITY
  • 사용자 ID (user_id) — UUID — 외래 키 → 사용자 계정.사용자 ID — NOT NULL — pk
  • 측정 시각 (measured_at) — TIMESTAMPTZ — NOT NULL
  • 몸무게 (weight_kg) — DECIMAL(5,2) — CHECK (weight_kg > 0)
  • 체지방량 (body_fat_pct) — DECIMAL(5,2) — CHECK (body_fat_pct >= 0 AND body_fat_pct <= 100)
  • 골격근량 (muscle_kg) — DECIMAL(5,2) — CHECK (skeletal_muscle_kg >= 0)
  • 데이터 입력 방법 (source) — VARCHAR(50) — NOT NULL — 직접 손으로 입력(manual)/ 갤럭시 핏에서(galaxy_fit3)/사진(photo)
  • DB 저장 시각 (created_at) — TIMESTAMPTZ — 서버에 저장된 시간