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()