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 — 서버에 저장된 시간