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=미처리.