BLT ERD

테이블 (9)

PVT 세션 (pvt_sessions)

  • 세션 id (id) — BIGINT — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • 측정 식별자(UUID) (measurement_id) — UUID — NOT NULL — UNIQE, iOS가 측정 시작 시 생성한 고유 ID
  • 측정 시작 시간 (started_at) — DATETIME — NOT NULL
  • 측정 종료 시간 (ended_at) — DATETIME — NOT NULL
  • 전체 측정 소요 시간 (total_duration_ms) — INT — NOT NULL
  • 자극 시도 횟수 (total_count) — INT — NOT NULL — 정상 측정 완료된 시도 횟수
  • 원본 반응속도 배열 (raw_rt_ms) — INTEGER[] — NOT NULL — iOS에서 측정한 원본 반응속도 배열
  • 평균 반응 속도(ms) (avg_rt_ms) — DOUBLE — NOT NULL — iOS가 계산한 평균 RT (lapse 제외)
  • 중앙값 반응 속도(ms) (median_rt_ms) — DOUBLE
  • 가벼운 lapses (lapses_mild) — INTEGER — NOT NULL
  • 시간 초과 lapses (lapses_timeout) — INTEGER — NOT NULL
  • 조기 터치 시작 (false_starts) — INTEGER — NOT NULL
  • 측정 유효성 (is_valid) — BOOLEAN — NOT NULL — iOS+서버가 판단한 세션 유효성
  • 뮤효 사유 (invalid_reason) — VARCHAR(50)
  • 전체 trial 상세 데이터 (trials) — JSONB — NOT NULL — default '[]' , 자극의 raw/corrected RT 배열
  • 생성일 (created_at) — DATETIME — NOT NULL

ROI 점수 (brain_roi_scores)

  • 점수 id (id) — BIGINT — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • 세션 id (session_id) — BIGINT — 외래 키 → PVT 세션.세션 id — NOT NULL
  • 수면 id (sleep_id) — BIGINT — 외래 키 → 수면 데이터.수면 데이터 id — NOT NULL
  • 계산 시나리오 (calculation_scenario) — VARCHAR — NOT NULL — A/B/C/D
  • 최종 점수 (final_score) — INT — NOT NULL
  • 수면 점수 (sleep_score) — INT — NOT NULL
  • pvt 점수 (pvt_score) — INT — NOT NULL
  • 사분면 (quadrant) — VARCHAR — NOT NULL
  • 계산식 버전 (formula_version) — VARCHAR — NOT NULL
  • 계산식 분석 (breakdown) — JSONB — NOT NULL — 계산의 모든 과정을 저장하는 값이 JSON인 컬럼
  • 계산일시 (measured_at) — DATETIME — NOT NULL
  • 생성일 (created_at) — DATETIME — NOT NULL — now()

동의 이력 (consent_logs)

  • 동의 이력 id (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • 동의 타입 (consent_type) — VARCHAR(30) — NOT NULL
  • 정책 버전 (policy_version) — VARCHAR(10) — NOT NULL
  • 동의여부 (agreed) — BOOLEAN — NOT NULL
  • 동의 일시 (agreed_at) — DATETIME — NOT NULL
  • 클라이언트 ip (client_ip) — INET
  • 생성일 (created_at) — TIMESTAMPZ — NOT NULL
  • 수정일 (updated_at) — TIMESTAMPZ — NOT NULL
  • 삭제일 (deleted_at) — TIMESTAMPZ

리프레시 토큰 (refresh_tokens)

  • 토큰 id (id) — BIGINT — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • 토큰 해시 (token_hash) — VARCHAR(64) — NOT NULL — UNIQE
  • 만료일시 (expires_at) — DATETIME — NOT NULL
  • 무효화일시 (revoked_at) — DATETIME
  • 생성일 (created_at) — DATETIME — NOT NULL

수면 데이터 (sleep_records)

  • 수면 데이터 id (id) — BIGINT — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL — (user_id, sleep_date) UNIQUE
  • 수면 일자 (sleep_date) — DATE — NOT NULL — 수면이 끝난 날짜
  • 총 수면시간(분) (total_minutes) — INT — NOT NULL — totalSleepMinutes
  • 깊은 수면시간(분) (deep_minutes) — INT
  • 렘 수면시간(분) (rem_minutes) — INT
  • 코어 수면시간(분) (core_minutes) — INT
  • 비수면 시간(분) (awake_minutes) — INT
  • 침대에 있던 시간(분) (in_bed_minutes) — INT
  • 분류 미상 수면시간(분) (unspecified_minutes) — INT
  • 측정 샘플 개수 (sample_count) — INT — HealthKit이 해당 날짜에 수집한 raw 샘플 수
  • 당일 수면 중 평균 HRV(ms) (night_hrv_ms) — FLOAT
  • 최근 7일 HRV 평균(ms) (weekly_hrv_baseline_ms) — FLOAT
  • 데이터 완전성 (data_completeness) — VARCHAR(20) — FULL/PARTIAL_STAGES/TOTAL_ONLY
  • 원본 데이터 (raw_payload) — JSONB — HealthKit이 보낸 원본 JSON 보관
  • 생성일 (created_at) — DATETIME — NOT NULL
  • 수정일 (updated_at) — DATETIME — NOT NULL

알림 기록 (notification_logs)

  • 로그 id (log_id) — BIGSERIAL — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • 디바이스 id (user_device_id) — BIGINT — 외래 키 → 회원 기기.디바이스 id — nullable
  • 알림 필터링 (filter_category) — VARCHAR(30) — NOT NULL — MEASUREMENT(측정), SYSTEM(기타)
  • 알림 타입 (notification_type) — VARCHAR(50) — NOT NULL — BEDTIME_REMINDER, PVT_REMINDER ...
  • 제목 (title) — VARCHAR(255) — NOT NULL
  • 본문 (body) — TEXT — NOT NULL
  • 부가 데이터 (payload) — JSONB — NOT NULL — DEFAULT '{}'::jsonb, 딥링크 및 상세 정보용
  • FCM 메세지 id (fcm_message_id) — VARCHAR — NOT NULL — FCM 응답으로 받음
  • 발송 상태 (status) — VARCHAR(20) — NOT NULL — SENT, OPENED, FAILED
  • 발송 예정 시각 (scheduled_at) — TIMESTAMPZ — NOT NULL
  • FCM 전달 시각 (sent_at) — TIMESTAMPZ — 실제 발송 시각
  • 열람 일시 (opened_at) — TIMESTAMPZ
  • 생성 일시 (created_at) — TIMESTAMPZ — NOT NULL
  • 수정 일시 (updated_at) — TIMESTAMPZ — NOT NULL
  • 삭제 일시 (deleted_at) — TIMESTAMPZ — 개별 알림 내역 삭제(Soft Delete)

추천 (recommendations)

  • 추천 id (id) — BIGINT — 기본 키 — NOT NULL
  • ROI 점수 id (roi_score_id) — BIGINT — 외래 키 → ROI 점수.점수 id — NOT NULL
  • 사분면 (quadrant_key) — VARCHAR — NOT NULL
  • 제목 (title) — VARCHAR(100) — NOT NULL
  • 메세지 (message) — TEXT — NOT NULL
  • 제안된 업무 (suggested_tasks) — JSONB — NOT NULL — DEFAULT '[]'
  • 생성일 (created_at) — DATETIME — NOT NULL — DEFAULT now()

회원 (users)

  • 회원 id (id) — BIGSERIAL — 기본 키 — NOT NULL
  • Apple sub 해시 (apple_sub_hash) — VARCHAR(64) — NOT NULL — UNIQE, SHA-256 해시 후 저장
  • 이메일 (email) — VARCHAR(255)
  • 이름 (name) — VARCHAR(50)
  • 상태 (status) — VARCHAR(20) — NOT NULL — ACTIVE → WITHDRAW_PENDING → WITHDRAWN
  • 인증 타입 (auth_type) — VARCHAR(20) — NOT NULL — APPLE
  • 출생년도 (birth_year) — SMALLINT
  • 성별 (gender) — VARCHAR(10) — MALE/FEMALE
  • 직업군 (occupation) — VARCHAR(30) — KNOWLEDGE, FIELD, STUDENT, ETC
  • 온보딩 완료여부 (onboarding_completed) — BOOLEAN — NOT NULL — default false
  • APNs 발송 토큰 (apns_device_token) — VARCHAR(64)
  • 알림 활성화 여부 (notification_enabled) — BOOLEAN — NOT NULL — default true
  • 취침 알림 시간 (sleep_reminder_time) — TIME — NOT NULL — DEFAULT '22:30:00'
  • PVT 리마인더 알림 시간 (pvt_reminder_time) — TIME — NOT NULL — DEFAULT '07:30:00'
  • 기타 알림 설정 (custom_notification_options) — JSONB — NOT NULL — 시간 설정이 없는 기타 알림들의 ON/OFF 상태를 보관
  • 알림 발송 기준 타임존 (notification_timezone) — VARCHAR(40) — NOT NULL — DEFAULT 'Asia/Seoul'
  • 생성일 (created_at) — TIMESTAMPZ — NOT NULL
  • 수정일 (updated_at) — TIMESTAMPZ — NOT NULL
  • 삭제일 (deleted_at) — TIMESTAMPZ

회원 기기 (user_devices)

  • 디바이스 id (id) — BIGINT — 기본 키 — NOT NULL
  • 회원 id (user_id) — BIGINT — 외래 키 → 회원.회원 id — NOT NULL
  • FCM 토큰 (fcm_token) — VARCHAR(255) — NOT NULL — 푸시 발송에 사용
  • 플랫폼 (platform) — VARCHAR(10) — NOT NULL — 'iOS', 'Android' -> Android 추가 대비
  • 마지막 활동 시각 (last_active_at) — DATETIME — NOT NULL — 비활성 디바이스 토큰 정리용
  • 토큰 무효화 시각 (revoked_at) — DATETIME — 로그아웃 / FCM이 invalid token 반환 시
  • 생성일 (created_at) — DATETIME — NOT NULL — now()