puppyrus

테이블 (28)

Audit 로그 (audit_log)

  • 로그 ID (id) — BIGSERIAL — 내부 PK.
  • Actor 종류 (actor_type) — VARCHAR(15) — NOT NULL — USER / ADMIN / SYSTEM(서버 cron) / AI_WORKER.
  • Actor ID (actor_id) — VARCHAR(64) — user_id 또는 admin_id 등. 자유 텍스트.
  • 동작 (action) — VARCHAR(50) — NOT NULL — 동작명 (CREATE_PET, DELETE_USER, REFRESH_BASELINE 등).
  • 대상 타입 (resource_type) — VARCHAR(30) — 대상 리소스 타입.
  • 대상 ID (resource_id) — VARCHAR(64) — 대상 리소스 식별자.
  • 변경 요약 (change_summary) — JSONB — JSONB.
  • 요청 ID (request_id) — VARCHAR(64) — X-Request-Id 헤더와 동기.
  • IP 주소 (ip_inet) — INET — 요청 IP. 90일 후 마스킹.
  • 발생 시점 (occurred_at) — TIMESTAMPTZ — NOT NULL — 이벤트 시점 (파티션 키).

Bedrock 토큰 사용 (bedrock_token_usage)

  • 레코드 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — 대상 사용자 (cron 호출 시 NULL).
  • 용도 (purpose) — VARCHAR(20) — NOT NULL — REPORT_SUMMARY(리포트 요약) / CHAT(챗봇 응답).
  • 모델 (model) — VARCHAR(30) — NOT NULL — 모델 식별자 (claude-3-haiku 등).
  • 입력 토큰 (input_tokens) — INTEGER — NOT NULL — 입력 토큰 수.
  • 출력 토큰 (output_tokens) — INTEGER — NOT NULL — 출력 토큰 수.
  • 캐시 히트 토큰 (cache_hit_tokens) — INTEGER — NOT NULL — Bedrock 프롬프트 캐시 히트 토큰 수.
  • 호출 시점 (occurred_at) — TIMESTAMPTZ — NOT NULL — Bedrock 호출 시각.

FCM 발송 로그 (fcm_dispatch_log)

  • 로그 ID (id) — BIGSERIAL — 내부 PK.
  • 디바이스 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 대상 디바이스.
  • 알림 FK (notification_id) — BIGINT — 외래 키 → 인앱 알림함.알림 ID — 연결된 인앱 알림 (nullable).
  • 발송 시점 (dispatched_at) — TIMESTAMPTZ — NOT NULL — 발송 시도 시각.
  • FCM 응답코드 (fcm_response_code) — VARCHAR(50) — UNREGISTERED / SENDER_ID_MISMATCH / OK 등.
  • 재시도 횟수 (retry_count) — SMALLINT — NOT NULL — 실패 후 재시도.
  • 다음 재시도 (next_retry_at) — TIMESTAMPTZ — 재시도 예정 시각.

Idempotency 캐시 (idempotency_records)

  • 레코드 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 요청 사용자.
  • Idempotency Key (idempotency_key) — VARCHAR(100) — NOT NULL — 클라이언트 발급 키 (UUID 등).
  • Payload 해시 (payload_hash) — VARCHAR(64) — NOT NULL — 요청 페이로드 SHA-256. 불일치 시 409 Conflict.
  • 응답 envelope (response_payload) — JSONB — NOT NULL — 최초 응답을 그대로 저장. 재요청 시 재현.
  • 최초 기록 (created_at) — TIMESTAMPTZ — NOT NULL — 최초 기록 시점.

개보법 요청 (data_subject_requests)

  • 요청 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 요청 사용자.
  • 요청 종류 (request_type) — VARCHAR(15) — NOT NULL — EXPORT(데이터 다운로드) / DELETION(영구 삭제).
  • 요청 시점 (requested_at) — TIMESTAMPTZ — NOT NULL — 요청 시각.
  • Grace 기한 (grace_until) — TIMESTAMPTZ — DELETION은 requested_at + 30일. EXPORT는 NULL.
  • 처리 상태 (status) — VARCHAR(20) — NOT NULL — 7단계. MVP는 RECEIVED → IN_PROGRESS → EXECUTED/DELIVERED 수동.
  • 결과 S3 키 (result_s3_key) — TEXT — EXPORT 결과 zip의 S3 키.
  • 완료 시점 (completed_at) — TIMESTAMPTZ — 처리 완료 시각.

디바이스 (devices)

  • 디바이스 ID (id) — UUID — 클라이언트 발급 UUID. X-Device-Id 헤더와 동기.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 소유 사용자.
  • 페어링 그룹 FK (pairing_group_id) — BIGINT — 외래 키 → 페어링 그룹.그룹 ID — 소속 페어링 그룹. NULL=미페어링. 순환 FK이므로 ALTER TABLE로 추가.
  • 디바이스 역할 (device_role) — VARCHAR(10) — NOT NULL — A_HOST(카메라) / B_VIEWER(보호자).
  • 플랫폼 (platform) — VARCHAR(10) — NOT NULL — ANDROID / IOS. A_HOST는 ANDROID 한정.
  • FCM 토큰 (fcm_token) — TEXT — Firebase Cloud Messaging 토큰. 재발급 시 UPDATE.
  • FCM 무효화 시점 (fcm_invalidated_at) — TIMESTAMPTZ — fcm_token이 UNREGISTERED 응답 받은 시점.
  • 설정값 (settings) — JSONB — NOT NULL — A_HOST 설정 JSONB. cameraEnabled / samplingIntervalSec / nightMode / lastEditedBy.
  • 최신 상태 (status_snapshot) — JSONB — 최신 상태 1개 JSONB (battery_pct / thermal_state / online / reported_at). 시계열은 device_status_history.
  • 등록 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 디바이스 최초 등록 시각.
  • 해제 시점 (unpaired_at) — TIMESTAMPTZ — 페어링 해제 시점 soft signal.

디바이스 상태 이력 (device_status_history)

  • 레코드 ID (id) — BIGSERIAL — 내부 PK.
  • A폰 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 보고 디바이스.
  • 보고 시각 (reported_at) — TIMESTAMPTZ — NOT NULL — heartbeat 시각.
  • 배터리 % (battery_pct) — SMALLINT — 0-100.
  • 발열 상태 (thermal_state) — VARCHAR(10) — Android ThermalStatus. NORMAL / WARM / HOT / CRITICAL.
  • 온라인 여부 (online) — BOOLEAN — NOT NULL — heartbeat 성공 여부.

라이브뷰 세션 (live_view_sessions)

  • 세션 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 요청 사용자.
  • B폰 FK (viewer_device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 시청 디바이스.
  • A폰 FK (publisher_device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 송출 디바이스.
  • SFU Room (sfu_room_id) — VARCHAR(100) — NOT NULL — SFU(Cloudflare Realtime) room 식별자. 벤더 중립 컬럼명.
  • 발급 시점 (issued_at) — TIMESTAMPTZ — NOT NULL — 세션 발급 시각.
  • 종료 시점 (ended_at) — TIMESTAMPTZ — 세션 종료 시각.
  • 종료 사유 (end_reason) — VARCHAR(20) — NORMAL / TIMEOUT / ERROR.

모니터링 세션 (monitoring_sessions)

  • 세션 ID (id) — BIGSERIAL — 내부 PK.
  • A폰 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 캡처 디바이스 (A_HOST).
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 촬영 대상 펫.
  • 시작 시각 (started_at) — TIMESTAMPTZ — NOT NULL — 세션 시작.
  • 종료 시각 (ended_at) — TIMESTAMPTZ — 세션 종료.
  • 종료 사유 (end_reason) — VARCHAR(20) — MANUAL(B폰 종료) / HEAT(발열 자동) / UNPAIR / CRASH / TIMEOUT.
  • 리포트 대상 여부 (report_eligible) — BOOLEAN — NOT NULL — 30분 이상 시 TRUE. 서비스 레이어가 ended_at UPDATE 시 같이 세팅.

반려견 프로필 (pets)

  • 펫 ID (id) — BIGSERIAL — 내부 PK.
  • 보호자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 소유 사용자.
  • 펫 이름 (name) — VARCHAR(50) — NOT NULL — 응답·푸시·챗봇에 노출되는 이름.
  • 견종 (breed) — VARCHAR(50) — NOT NULL — 자유 입력.
  • 생년월일 (birth_date) — DATE — 생일 기준 나이 계산용.
  • 체중 kg (weight_kg) — NUMERIC(4,1) — 소수 1자리.
  • 프로필 이미지 키 (profile_image_key) — TEXT — S3 object key (presigned 업로드).
  • 평소 패턴 캐시 (analytics_baseline) — JSONB — JSONB. poseRatio / hourlyActivity / refreshedAt. 일일 리포트 cron 직후 갱신.
  • 등록 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 펫 최초 등록 시각.
  • 삭제 시점 (deleted_at) — TIMESTAMPTZ — soft delete.

사용자 (users)

  • 사용자 ID (id) — BIGSERIAL — 내부 PK (BIGSERIAL).
  • 닉네임 (nickname) — VARCHAR(50) — NOT NULL — 표시 이름. 소셜 응답에서 1차 수집 후 수정 가능 (1-50자).
  • 프로필 이미지 키 (profile_image_key) — TEXT — S3 object key. media_upload_tickets로 presigned 업로드한 결과.
  • 알림 환경설정 (notification_preferences) — JSONB — NOT NULL — JSONB. quiet_hours, dailyReportPushTime, weeklyReportEnabled, dndOnLiveView.
  • 가입 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 계정 생성 시각.
  • 탈퇴 시점 (deleted_at) — TIMESTAMPTZ — NULL=활성. NOT NULL 후 30일 grace → data_subject_requests로 hard delete.

사용자 피드백 (user_feedbacks)

  • 피드백 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 제보 사용자.
  • 피드백 종류 (feedback_type) — VARCHAR(20) — NOT NULL — BUG / POSE_ERROR / BARK_ERROR / CHATBOT_ERROR / OTHER.
  • 본문 (body) — TEXT — NOT NULL — 피드백 본문.
  • 스크린샷 키 (screenshot_s3_key) — TEXT — S3 키 (선택).
  • 관련 리소스 (related_resource) — JSONB — JSONB 예: {"type":"DAILY_REPORT","id":123}.
  • 처리 상태 (status) — VARCHAR(15) — NOT NULL — RECEIVED → IN_REVIEW → RESOLVED.
  • 제출 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 피드백 제출 시각.

소셜 ID 매핑 (social_identities)

  • 소셜 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 연결된 사용자.
  • Provider (provider) — VARCHAR(10) — NOT NULL — KAKAO / APPLE / GOOGLE.
  • Provider 해시 (provider_subject_hash) — VARCHAR(64) — NOT NULL — provider sub 클레임의 SHA-256. 원본 노출 방지.
  • 연결 시점 (linked_at) — TIMESTAMPTZ — NOT NULL — 소셜 계정 연동 시각.

앱 전역 설정 (app_config)

  • Config ID (id) — SMALLINT — 항상 1 (CHECK 강제).
  • 안드로이드 최소 버전 (min_app_version_android) — VARCHAR(20) — NOT NULL — 이하 버전은 강제 업데이트 안내.
  • iOS 최소 버전 (min_app_version_ios) — VARCHAR(20) — NOT NULL — iOS 최소 지원 버전.
  • 점검 모드 (maintenance_mode) — BOOLEAN — NOT NULL — 점검 모드 on/off.
  • 점검 메시지 (maintenance_message) — TEXT — 점검 시 사용자 노출 메시지.
  • 수정 시점 (updated_at) — TIMESTAMPTZ — NOT NULL — 최종 변경 시각.
  • 수정자 (updated_by) — VARCHAR(64) — 변경 admin 식별자.

약관 동의 이력 (consents)

  • 동의 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 동의 사용자.
  • 약관 종류 (consent_type) — VARCHAR(30) — NOT NULL — TOS(이용약관) / PRIVACY(개인정보) / DISCLAIMER(챗봇 면책) / MARKETING.
  • 약관 버전 (version) — VARCHAR(20) — NOT NULL — 약관 문구 버전 (예: 2026-05-01). 버전 변경 시 재동의 요구.
  • 동의 시점 (agreed_at) — TIMESTAMPTZ — NOT NULL — 약관 동의 시각.
  • 철회 시점 (withdrawn_at) — TIMESTAMPTZ — G1.3 동의 철회. NULL=유효.
  • IP 주소 (ip_inet) — INET — 동의 시 IP. 90일 후 last octet 마스킹.
  • User Agent (user_agent) — TEXT — 동의 시 브라우저/앱 정보.

업로드 티켓 (media_upload_tickets)

  • 티켓 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 발급 요청 사용자.
  • 디바이스 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — 발급 디바이스.
  • S3 키 (s3_object_key) — TEXT — NOT NULL — 발급된 S3 키 (UNIQUE).
  • Content-Type (content_type) — VARCHAR(50) — NOT NULL — MIME (image/jpeg, audio/mp4).
  • 용도 (purpose) — VARCHAR(20) — NOT NULL — FRAME / AUDIO / PET_PROFILE / FEEDBACK_SCREENSHOT.
  • 발급 시점 (issued_at) — TIMESTAMPTZ — NOT NULL — ticket 발급 시각.
  • 만료 시점 (expires_at) — TIMESTAMPTZ — NOT NULL — cleanup 인덱스 키.
  • 소비 시점 (consumed_at) — TIMESTAMPTZ — 실제 업로드 완료 시점.

월간 리포트 (monthly_reports)

  • 리포트 ID (id) — BIGSERIAL — 내부 PK.
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 대상 펫.
  • 월 시작일 (month_start_date) — DATE — NOT NULL — 해당 월 1일.
  • 월 종료일 (month_end_date) — DATE — NOT NULL — 해당 월 마지막 일.
  • 자세 비율 (pose_breakdown) — JSONB — NOT NULL — 자세별 시간 비율 (4종, sum=1).
  • 시간대별 활동 (hourly_activity) — JSONB — NOT NULL — 24-bucket motion_intensity 평균.
  • 월간 트렌드 (trend_summary) — JSONB — NOT NULL — 주별 4~5건 요약 + 전체 추세 라벨.
  • 평소 대비 변화율 (baseline_delta) — JSONB — NOT NULL — JSONB.
  • 자연어 요약 (narrative) — TEXT — NOT NULL — Bedrock 생성.
  • 생성 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 리포트 생성 시각.

인앱 알림함 (notifications)

  • 알림 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 수신 사용자.
  • 알림 종류 (notification_type) — VARCHAR(30) — NOT NULL — MVP 7종: REPORT_READY / BARK_30MIN / CAMERA_OFFLINE / HEAT_WARNING / LIVE_VIEW_AVAILABLE / LOW_BATTERY / MONITORING_AUTO…
  • 제목 (title) — VARCHAR(100) — NOT NULL — 알림 제목.
  • 본문 (body) — TEXT — NOT NULL — 알림 본문.
  • Deep Link (resource_ref) — JSONB — JSONB 예: {"type":"DAILY_REPORT","id":123}.
  • 읽음 시점 (read_at) — TIMESTAMPTZ — E2.2 사용자가 읽은 시점.
  • 생성 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 알림 생성 시각.

인증 세션 (Refresh) (auth_sessions)

  • 세션 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 소유 사용자.
  • 디바이스 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — 발급 디바이스 (nullable).
  • Refresh JTI (refresh_jti) — VARCHAR(64) — NOT NULL — Refresh JWT의 jti 클레임. UNIQUE.
  • 발급 시점 (issued_at) — TIMESTAMPTZ — NOT NULL — 토큰 발급 시각.
  • 마지막 사용 (last_used_at) — TIMESTAMPTZ — refresh 회전 시 갱신.
  • 만료 시점 (expires_at) — TIMESTAMPTZ — NOT NULL — 토큰 만료 시각.
  • 무효화 시점 (revoked_at) — TIMESTAMPTZ — 토큰 무효화 시각.
  • 무효화 사유 (revoke_reason) — VARCHAR(20) — LOGOUT(명시적 로그아웃) / REUSE_DETECTED(재사용 감지) / WITHDRAWAL(탈퇴).

일일 리포트 (daily_reports)

  • 리포트 ID (id) — BIGSERIAL — 내부 PK.
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 대상 펫.
  • 리포트 일자 (report_date) — DATE — NOT NULL — 사용자 timezone 기준.
  • 자세 비율 (pose_breakdown) — JSONB — NOT NULL — 자세별 시간 비율 JSONB.
  • 시간대별 활동 (hourly_activity) — JSONB — NOT NULL — 24-bucket JSONB.
  • 평소 대비 변화율 (baseline_delta) — JSONB — NOT NULL — 평소(analytics_baseline) 대비 (E1.7) JSONB.
  • 자연어 요약 (narrative) — TEXT — NOT NULL — Bedrock 생성.
  • 생성 시점 (created_at) — TIMESTAMPTZ — NOT NULL — cron 실행 시점.
  • 푸시 시점 (pushed_at) — TIMESTAMPTZ — dailyReportPushTime 발송 후 채움.

주간 리포트 (weekly_reports)

  • 리포트 ID (id) — BIGSERIAL — 내부 PK.
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 대상 펫.
  • 주 시작일 (week_start_date) — DATE — NOT NULL — 월요일.
  • 주 종료일 (week_end_date) — DATE — NOT NULL — 일요일.
  • 주간 트렌드 (trend_summary) — JSONB — NOT NULL — 요일별 변화·이상치 JSONB.
  • 평소 대비 변화율 (baseline_delta) — JSONB — NOT NULL — JSONB.
  • 자연어 요약 (narrative) — TEXT — NOT NULL — Bedrock 생성.
  • 생성 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 리포트 생성 시각.

지식 청크 (RAG) (knowledge_chunks)

  • 청크 ID (id) — BIGSERIAL — 내부 PK.
  • 본문 (body) — TEXT — NOT NULL — chunk 본문. RAG 컨텍스트로 LLM에 주입.
  • 임베딩 (embedding) — BYTEA — NOT NULL — 실제 vector(1024). BGE-M3 또는 KURE-v1. 시각화 호환 위해 BYTEA로 표기.
  • 출처 메타 (source_meta) — JSONB — NOT NULL — JSONB {title, url, publisher, sourceType}. 응답 citations에 노출.
  • 임베딩 모델 (embedding_model) — VARCHAR(30) — NOT NULL — 식별자 (예: bge-m3-2024-05). 재임베딩 마이그레이션 분기.
  • 적재 시점 (created_at) — TIMESTAMPTZ — NOT NULL — chunk 등록 시각.

짖음 이벤트 (audio_events)

  • 이벤트 ID (id) — BIGSERIAL — 내부 PK.
  • 세션 FK (session_id) — BIGINT — 외래 키 → 모니터링 세션.세션 ID — NOT NULL — 소속 모니터링 세션.
  • A폰 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 캡처 디바이스.
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 대상 펫 (denormalize, 집계 효율).
  • 캡처 시각 (captured_at) — TIMESTAMPTZ — NOT NULL — 클립 시작 시각 (파티션 키).
  • 클립 길이 ms (duration_ms) — INTEGER — NOT NULL — 사전 buffer 1초 + 본 클립 5초 ≈ 6000ms.
  • S3 키 (s3_object_key) — TEXT — NOT NULL — 오디오 클립 S3 키.
  • AI 상태 (ai_status) — VARCHAR(10) — NOT NULL — QUEUED → PROCESSING → DONE / FAILED.
  • YAMNet 분류 (yamnet_class) — VARCHAR(20) — Bark / Howl / Whimper / Growl (dog-class만 영속).
  • 신뢰도 (confidence) — NUMERIC(4,3) — YAMNet softmax 0.000-1.000.
  • 처리 완료 시점 (yamnet_processed_at) — TIMESTAMPTZ — Worker UPDATE 시점.

챗봇 메시지 (chat_messages)

  • 메시지 ID (id) — BIGSERIAL — 내부 PK.
  • 세션 FK (chat_session_id) — BIGINT — 외래 키 → 챗봇 세션.세션 ID — NOT NULL — 소속 세션.
  • 역할 (role) — VARCHAR(10) — NOT NULL — USER(사용자 질문) / ASSISTANT(챗봇 응답).
  • 본문 (body) — TEXT — NOT NULL — 메시지 본문.
  • 응급 분기 (emergency_branch) — BOOLEAN — NOT NULL — F.3 응급 키워드 사전 스캔에서 분기된 경우 TRUE. 24h 동물병원 안내.
  • Low-similarity Fallback (low_similarity_fallback) — BOOLEAN — NOT NULL — F.6 RAG Top-5 similarity 임계값 미만 → 수의사 권유 응답 TRUE.
  • 출처 스냅샷 (citations) — JSONB — F.9 출처 inline JSONB. [{chunkId, title, url, publisher}]. N+1 회피.
  • 메시지 시점 (created_at) — TIMESTAMPTZ — NOT NULL — 메시지 생성 시각.

챗봇 세션 (chat_sessions)

  • 세션 ID (id) — BIGSERIAL — 내부 PK.
  • 사용자 FK (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 대화 소유 사용자.
  • 펫 FK (pet_id) — BIGINT — 외래 키 → 반려견 프로필.펫 ID — NOT NULL — 문맥 펫.
  • 시작 시점 (started_at) — TIMESTAMPTZ — NOT NULL — 세션 시작.
  • 마지막 활동 (last_activity_at) — TIMESTAMPTZ — NOT NULL — 마지막 메시지 시각. 목록 정렬에 사용.
  • 삭제 시점 (deleted_at) — TIMESTAMPTZ — soft delete.

페어링 QR 토큰 (pairing_tokens)

  • 토큰 ID (id) — BIGSERIAL — 내부 PK.
  • 토큰 해시 (token_hash) — VARCHAR(64) — NOT NULL — QR에 인코딩된 평문 토큰의 SHA-256. 평문은 DB 저장 X.
  • 발급 사용자 FK (issued_by_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 토큰 발급 요청자 (A폰 소유자).
  • 발급 시점 (issued_at) — TIMESTAMPTZ — NOT NULL — 토큰 생성 시각.
  • 만료 시점 (expires_at) — TIMESTAMPTZ — NOT NULL — 미사용 시 만료. cleanup 인덱스 키.
  • 소비 시점 (consumed_at) — TIMESTAMPTZ — B폰 스캔 성공 시점. 1회만 세팅.
  • 소비 디바이스 FK (consumed_by_device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — 소비한 B폰.

페어링 그룹 (pairing_groups)

  • 그룹 ID (id) — BIGSERIAL — 내부 PK.
  • 소유 사용자 FK (owner_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 그룹 소유자.
  • B폰 viewer FK (viewer_device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — B폰. 토큰 발급 시점엔 NULL → B폰 스캔 후 채워짐.
  • A폰 Host FK (host_device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 페어링 토큰 발급자 (A폰). NOT NULL.
  • 페어링 완료 (paired_at) — TIMESTAMPTZ — NOT NULL — host_device_id가 채워진 시점.
  • 해제 시점 (unpaired_at) — TIMESTAMPTZ — 페어링 해제 시점.

프레임 메타데이터 (frame_metadata)

  • 프레임 ID (id) — BIGSERIAL — 내부 PK.
  • 세션 FK (session_id) — BIGINT — 외래 키 → 모니터링 세션.세션 ID — NOT NULL — 소속 모니터링 세션.
  • A폰 FK (device_id) — UUID — 외래 키 → 디바이스.디바이스 ID — NOT NULL — 캡처 디바이스 (denormalize).
  • 캡처 시각 (captured_at) — TIMESTAMPTZ — NOT NULL — 프레임 캡처 시각 (파티션 키).
  • S3 키 (s3_object_key) — TEXT — NOT NULL — 소속 1분 번들 tar의 S3 키. 같은 번들 프레임들이 공유. tar 엔트리 {capturedAtMs}.jpg = captured_at으로 개별 매칭. 30일 후 Lifecycle 삭제.
  • TFLite 강아지 여부 (dog_present_tflite) — BOOLEAN — A폰 TFLite 1차 판별 (B.4). 관대한 임계값.
  • AI 상태 (ai_status) — VARCHAR(10) — NOT NULL — QUEUED → PROCESSING → DONE / FAILED. Spot 중단 시 FAILED → 재큐잉.
  • 자세 분류 (pose_class) — VARCHAR(15) — 룰베이스 정적 자세 4종 (C1.3). STANDING / SITTING / LYING / UNCERTAIN. 운동은 별도 motion_intensity 축.
  • 평활화 자세 (pose_smoothed_class) — VARCHAR(15) — 시간적 평활화 후 (C1.4). 연속 N프레임 다수결.
  • Keypoints (pose_keypoints) — JSONB — RAW keypoints JSONB (17점 × x, y, conf). 2026-06-03 S3 archive에서 JSONB로 변경. motion_intensity 계산 시 같은 row JSONB 직접 사용 (배치…
  • 자세 처리 완료 (pose_processed_at) — TIMESTAMPTZ — 자세 Worker UPDATE 시점. NULL=미처리.
  • 운동 강도 (motion_intensity) — NUMERIC(3,2) — 프레임 t와 최근 N프레임 키포인트 변위(몸길이로 정규화) 누적 점수. 0.00~1.00. NULL=(a)미처리 (b)배치 첫 2프레임 (c)윈도우 Δt>3초 (d)다견 instance_count≥2 (e)conf…
  • 운동 처리 완료 (motion_processed_at) — TIMESTAMPTZ — 운동 Worker UPDATE 시점. NULL=미처리.