aura

Tables (19)

analysis_candidates

  • candidate_id — BIGINT — Primary key — NOT NULL — 후보 고유 ID
  • scan_job_id — BIGINT — Foreign key → scan_jobs.scan_job_id — NOT NULL — 분류 대상 스캔 작업 ID
  • item_id — BIGINT — Foreign key → scanned_items.item_id — NOT NULL — 분류 대상 항목 ID
  • category — ENUM('PROMOTION_MAIL', 'OLD_MAIL', 'DUPLICATE_FILE', 'OLD_DRIVE_FILE', 'LARGE_FILE', 'LOW_VALUE_ATTACHMENT', 'TEMP_OR_BACKUP', 'PROTECTED') — NOT NULL — 후보 또는 보호 대상 분류
  • risk_level — ENUM('LOW', 'MEDIUM', 'HIGH') — NOT NULL — 삭제 위험도
  • priority_score — DECIMAL(5, 2) — NOT NULL — 정리 우선순위 점수
  • ghost_score — DECIMAL(5, 2) — NOT NULL — 유령 데이터 가능성 점수
  • is_protected — TINYINT(1) — NOT NULL — 보호 대상 여부
  • selection_status — ENUM('NONE', 'SELECTED', 'DESELECTED') — NOT NULL — 화면 임시 선택 상태
  • selection_version — INT — NOT NULL — 선택 상태 변경 버전
  • estimated_reclaim_bytes — BIGINT — NOT NULL — 예상 확보 용량
  • ai_provider — VARCHAR(50) — AI 분석 제공자
  • ai_model_name — VARCHAR(100) — 분석에 사용한 Gemini 모델명
  • ai_confidence_score — DECIMAL(5, 2) — Gemini 의미 분석 신뢰도
  • semantic_tags_json — JSON — AI가 부여한 의미 태그 배열
  • matched_conditions_json — JSON — 사용자 조건과 메타데이터 매칭 근거
  • analyzed_at — DATETIME — NOT NULL — AI 분석 일시
  • updated_at — DATETIME — NOT NULL — 마지막 상태 변경 일시

announcement_reads

  • read_id — BIGINT — Primary key — NOT NULL — 읽음 기록 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • announcement_id — BIGINT — Foreign key → announcements.announcement_id — NOT NULL — 공지사항 ID
  • read_at — DATETIME — NOT NULL — 읽음 처리 일시

announcements

  • announcement_id — BIGINT — Primary key — NOT NULL — 공지사항 고유 ID
  • title — VARCHAR(200) — NOT NULL — 공지 제목
  • category — ENUM('POLICY', 'SERVICE', 'FEATURE') — NOT NULL — 공지 카테고리
  • content — TEXT — NOT NULL — 공지 본문
  • is_pinned — TINYINT(1) — NOT NULL — 상단 고정 여부
  • published_at — DATETIME — NOT NULL — 게시 일시
  • created_at — DATETIME — NOT NULL — 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 수정 일시

carbon_saving_histories

  • carbon_history_id — BIGINT — Primary key — NOT NULL — 탄소 절감 이력 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 사용자 ID. 익명화 시 NULL 가능
  • history_id — BIGINT — Foreign key → cleanup_histories.history_id — NOT NULL — 기준 정리 이력 ID
  • reclaimed_bytes — BIGINT — NOT NULL — 탄소 계산에 사용한 확보 용량
  • estimated_carbon_grams — DECIMAL(12, 4) — NOT NULL — 예상 탄소 절감량
  • formula_version — VARCHAR(30) — NOT NULL — 탄소 계산 공식 버전
  • calculated_at — DATETIME — NOT NULL — 계산 일시

cleanup_histories

  • history_id — BIGINT — Primary key — NOT NULL — 정리 이력 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 사용자 ID. 익명화 시 NULL 가능
  • cleanup_job_id — BIGINT — Foreign key → cleanup_jobs.cleanup_job_id — NOT NULL — 기준 정리 작업 ID
  • scan_job_id — BIGINT — Foreign key → scan_jobs.scan_job_id — 기준 스캔 작업 ID
  • action_type — ENUM('MOVE_TO_TRASH', 'RESTORE_FROM_TRASH', 'PERMANENT_DELETE', 'EMPTY_TRASH') — NOT NULL — 정리 작업 유형
  • cleaned_item_count — INT — NOT NULL — 정리 완료 항목 수
  • reclaimed_bytes — BIGINT — NOT NULL — 확보 용량
  • remaining_drive_bytes — BIGINT — 정리 후 남은 Drive 용량
  • completed_at — DATETIME — NOT NULL — 정리 완료 일시

cleanup_job_items

  • cleanup_item_id — BIGINT — Primary key — NOT NULL — 정리 대상 고유 ID
  • cleanup_job_id — BIGINT — Foreign key → cleanup_jobs.cleanup_job_id — NOT NULL — 정리 작업 ID
  • candidate_id — BIGINT — Foreign key → analysis_candidates.candidate_id — 정리 후보 ID
  • item_id — BIGINT — Foreign key → scanned_items.item_id — 대상 항목 ID
  • item_source — ENUM('GMAIL', 'DRIVE') — NOT NULL — 대상 출처
  • external_item_id — VARCHAR(255) — 승인 당시 Gmail Message ID 또는 Drive File ID
  • snapshot_item_key — VARCHAR(320) — NOT NULL — 승인 당시 중복 방지 키
  • snapshot_title — VARCHAR(500) — 승인 당시 제목 또는 파일명
  • snapshot_size_bytes — BIGINT — NOT NULL — 승인 당시 용량
  • process_status — ENUM('PENDING', 'SUCCESS', 'FAILED', 'SKIPPED') — NOT NULL — 개별 처리 상태
  • failure_reason — VARCHAR(500) — 실패 또는 건너뜀 사유
  • processed_at — DATETIME — 처리 완료 일시
  • created_at — DATETIME — NOT NULL — 대상 생성 일시

cleanup_jobs

  • cleanup_job_id — BIGINT — Primary key — NOT NULL — 정리 작업 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 작업 요청 사용자 ID. 익명화 시 NULL 가능
  • scan_job_id — BIGINT — Foreign key → scan_jobs.scan_job_id — 기준 스캔 작업 ID
  • action_type — ENUM('MOVE_TO_TRASH', 'RESTORE_FROM_TRASH', 'PERMANENT_DELETE', 'EMPTY_TRASH') — NOT NULL — 정리 작업 유형
  • job_status — ENUM('PENDING', 'PROCESSING', 'COMPLETED', 'FAILED', 'PARTIAL_FAILED', 'CANCELED') — NOT NULL — 정리 작업 상태
  • selected_mail_count — INT — NOT NULL — 선택된 메일 수
  • selected_drive_count — INT — NOT NULL — 선택된 Drive 파일 수
  • total_selected_bytes — BIGINT — NOT NULL — 선택 항목 총 용량
  • success_item_count — INT — NOT NULL — 처리 성공 항목 수
  • failed_item_count — INT — NOT NULL — 처리 실패 항목 수
  • progress_percent — DECIMAL(5, 2) — NOT NULL — 작업 진행률
  • approved_at — DATETIME — NOT NULL — 사용자 최종 승인 일시
  • completed_at — DATETIME — 작업 완료 일시
  • error_message — VARCHAR(500) — 실패 사유
  • created_at — DATETIME — NOT NULL — 작업 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 상태 변경 일시

fcm_tokens

  • fcm_token_id — BIGINT — Primary key — NOT NULL — FCM 토큰 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • device_identifier — VARCHAR(150) — 앱 기기 식별자
  • fcm_token — VARCHAR(500) — NOT NULL — FCM 토큰
  • is_active — TINYINT(1) — NOT NULL — 활성 토큰 여부
  • last_used_at — DATETIME — 마지막 발송 사용 일시
  • created_at — DATETIME — NOT NULL — 토큰 등록 일시
  • updated_at — DATETIME — NOT NULL — 마지막 갱신 일시

google_permissions

  • permission_id — BIGINT — Primary key — NOT NULL — 권한 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • service_type — ENUM('GMAIL', 'DRIVE') — NOT NULL — Google 서비스 유형
  • permission_status — ENUM('CONNECTED', 'DENIED', 'EXPIRED', 'RECONNECT_REQUIRED', 'DISCONNECTED') — NOT NULL — 권한 연결 상태
  • scope_text — TEXT — 서비스별 허용 Scope
  • connected_at — DATETIME — 권한 연결 일시
  • disconnected_at — DATETIME — 권한 해제 일시
  • last_checked_at — DATETIME — 마지막 권한 검증 일시
  • updated_at — DATETIME — NOT NULL — 마지막 상태 변경 일시

monthly_user_statistics

  • monthly_stat_id — BIGINT — Primary key — NOT NULL — 월별 통계 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 사용자 ID. 익명화 시 NULL 가능
  • stat_owner_key — VARCHAR(80) — NOT NULL — 월별 통계 소유자 키
  • stat_year_month — CHAR(7) — NOT NULL — 월 단위 값
  • scan_count — INT — NOT NULL — 월별 스캔 횟수
  • cleanup_count — INT — NOT NULL — 월별 정리 횟수
  • trashed_item_count — INT — NOT NULL — 휴지통 이동 항목 수
  • permanently_deleted_item_count — INT — NOT NULL — 영구 삭제 항목 수
  • reclaimed_bytes — BIGINT — NOT NULL — 월별 확보 용량
  • estimated_carbon_grams — DECIMAL(12, 4) — NOT NULL — 월별 탄소 절감량
  • created_at — DATETIME — NOT NULL — 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 갱신 일시

notification_settings

  • notification_setting_id — BIGINT — Primary key — NOT NULL — 알림 설정 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • is_scan_complete_enabled — TINYINT(1) — NOT NULL — 스캔 완료 알림 수신 여부
  • is_scan_recommend_enabled — TINYINT(1) — NOT NULL — 스캔 권장 알림 수신 여부
  • updated_at — DATETIME — NOT NULL — 마지막 설정 변경 일시

notifications

  • notification_id — BIGINT — Primary key — NOT NULL — 알림 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 수신 사용자 ID. 익명화 시 NULL 가능
  • scan_job_id — BIGINT — Foreign key → scan_jobs.scan_job_id — 연결된 스캔 작업 ID
  • cleanup_job_id — BIGINT — Foreign key → cleanup_jobs.cleanup_job_id — 연결된 정리 작업 ID
  • notification_type — ENUM('SCAN_COMPLETED', 'SCAN_RECOMMENDED', 'DRIVE_STORAGE_LOW', 'CLEANUP_COMPLETED') — NOT NULL — 알림 유형
  • title — VARCHAR(150) — NOT NULL — 알림 제목
  • message — VARCHAR(500) — NOT NULL — 알림 내용
  • target_screen — ENUM('HOME', 'ANALYSIS_SUMMARY', 'STATISTICS', 'CLEANUP_RESULT') — NOT NULL — 알림 클릭 이동 화면
  • is_read — TINYINT(1) — NOT NULL — 읽음 여부
  • sent_at — DATETIME — NOT NULL — 발송 일시
  • read_at — DATETIME — 읽음 일시

oauth_tokens

  • token_id — BIGINT — Primary key — NOT NULL — 토큰 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • encrypted_refresh_token — VARCHAR(1000) — 암호화된 Google Refresh Token
  • access_token_expires_at — DATETIME — Access Token 만료 일시
  • scope_text — TEXT — 발급받은 Google OAuth Scope 문자열
  • token_status — ENUM('VALID', 'EXPIRED', 'REVOKED', 'REFRESH_FAILED') — NOT NULL — 토큰 상태
  • last_refreshed_at — DATETIME — 마지막 토큰 갱신 성공 일시
  • refresh_failed_at — DATETIME — 마지막 토큰 갱신 실패 일시
  • failure_reason — VARCHAR(500) — 토큰 갱신 실패 사유
  • revoked_at — DATETIME — 토큰 폐기 일시
  • created_at — DATETIME — NOT NULL — 토큰 저장 일시
  • updated_at — DATETIME — NOT NULL — 마지막 갱신 일시

scan_jobs

  • scan_job_id — BIGINT — Primary key — NOT NULL — 스캔 작업 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — 작업 요청 사용자 ID. 익명화 시 NULL 가능
  • setting_id — BIGINT — Foreign key → scan_settings.setting_id — 적용된 기본 스캔 설정 ID
  • job_status — ENUM('PENDING', 'SCANNING', 'ANALYZING', 'COMPLETED', 'FAILED', 'CANCELED', 'PARTIAL_FAILED') — NOT NULL — 작업 상태
  • scan_source — ENUM('MAIL', 'DRIVE_ALL', 'DRIVE_FOLDER', 'MAIL_AND_DRIVE') — NOT NULL — 실제 적용된 스캔 범위
  • condition_snapshot_json — JSON — NOT NULL — 스캔 요청 당시 조건 스냅샷
  • progress_percent — DECIMAL(5, 2) — NOT NULL — 전체 진행률
  • mail_scanned_count — INT — NOT NULL — 조회한 메일 수
  • drive_scanned_count — INT — NOT NULL — 조회한 Drive 파일 수
  • candidate_count — INT — NOT NULL — 정리 후보 수
  • protected_count — INT — NOT NULL — 보호 분류 수
  • estimated_reclaim_bytes — BIGINT — NOT NULL — 예상 확보 용량
  • error_message — VARCHAR(500) — 실패 또는 부분 실패 사유
  • started_at — DATETIME — 작업 시작 일시
  • completed_at — DATETIME — 작업 완료 일시
  • canceled_at — DATETIME — 작업 취소 일시
  • deleted_at — DATETIME — 이력 숨김 또는 삭제 요청 일시
  • created_at — DATETIME — NOT NULL — 작업 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 상태 변경 일시

scan_settings

  • setting_id — BIGINT — Primary key — NOT NULL — 스캔 설정 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • scan_source — ENUM('MAIL', 'DRIVE_ALL', 'DRIVE_FOLDER', 'MAIL_AND_DRIVE') — NOT NULL — 기본 스캔 범위
  • drive_folder_id — VARCHAR(255) — 특정 Drive 폴더 ID
  • include_subfolders — TINYINT(1) — NOT NULL — 하위 폴더 포함 여부
  • last_opened_before_months — INT — 마지막 열람 기준 개월 수
  • last_modified_before_months — INT — 마지막 수정 기준 개월 수
  • created_before_months — INT — 파일 저장일 기준 개월 수
  • exclude_recent_days — INT — NOT NULL — 최근 사용 항목 제외 기준 일수
  • include_keywords — JSON — 삭제 후보 포함 키워드 배열
  • exclude_keywords — JSON — 보호 대상 제외 키워드 배열
  • file_extensions — JSON — 삭제 후보 파일 확장자 조건
  • include_mail_attachment_size — TINYINT(1) — NOT NULL — 메일 첨부파일 용량 포함 여부
  • apply_recent_conditions — TINYINT(1) — NOT NULL — 최근 조건 자동 적용 여부
  • created_at — DATETIME — NOT NULL — 설정 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 수정 일시

scanned_items

  • item_id — BIGINT — Primary key — NOT NULL — 스캔 항목 고유 ID
  • scan_job_id — BIGINT — Foreign key → scan_jobs.scan_job_id — NOT NULL — 소속 스캔 작업 ID
  • user_id — BIGINT — Foreign key → users.user_id — 사용자 ID. 익명화 시 NULL 가능
  • item_source — ENUM('GMAIL', 'DRIVE') — NOT NULL — 항목 출처
  • external_item_id — VARCHAR(255) — Gmail Message ID 또는 Drive File ID
  • parent_external_id — VARCHAR(255) — Drive 상위 폴더 ID
  • folder_path — VARCHAR(1000) — Drive 폴더 경로. AI 의미 분석 맥락용
  • title — VARCHAR(500) — 메일 제목 또는 파일명
  • sender_domain — VARCHAR(255) — Gmail 발신자 도메인
  • label_text — VARCHAR(500) — Gmail 라벨 문자열
  • snippet — VARCHAR(500) — Gmail 스니펫 일부
  • mime_type — VARCHAR(150) — Drive MIME 타입
  • file_extension — VARCHAR(20) — 파일 확장자
  • size_bytes — BIGINT — NOT NULL — 항목 용량
  • attachment_size_bytes — BIGINT — NOT NULL — Gmail 첨부파일 추정 용량
  • received_at — DATETIME — 메일 수신 일시
  • created_time — DATETIME — Drive 파일 생성 일시
  • modified_time — DATETIME — Drive 파일 수정 일시
  • last_opened_time — DATETIME — Drive 마지막 열람 일시
  • is_starred — TINYINT(1) — NOT NULL — Gmail 별표 여부
  • is_important — TINYINT(1) — NOT NULL — Gmail 중요 표시 여부
  • has_attachment — TINYINT(1) — NOT NULL — Gmail 첨부파일 여부
  • is_shared — TINYINT(1) — NOT NULL — Drive 공유 여부
  • md5_checksum — VARCHAR(100) — Drive 중복 판단용 체크섬
  • owner_email — VARCHAR(150) — Drive 소유자 이메일
  • is_trashed — TINYINT(1) — NOT NULL — 휴지통 이동 여부
  • trashed_at — DATETIME — 휴지통 이동 확인 일시
  • metadata_json — JSON — 기타 메타데이터
  • deleted_at — DATETIME — 이력 숨김 또는 삭제 요청 일시
  • created_at — DATETIME — NOT NULL — 저장 일시

user_consents

  • consent_id — BIGINT — Primary key — NOT NULL — 동의 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • is_privacy_agreed — TINYINT(1) — NOT NULL — 개인정보 수집 및 이용 동의 여부
  • is_ai_analysis_agreed — TINYINT(1) — NOT NULL — Gemini API 기반 AI 의미 분석 동의 여부
  • is_metadata_only_agreed — TINYINT(1) — NOT NULL — 메일 본문/파일 원문 미저장 안내 확인 여부
  • is_user_approval_required_agreed — TINYINT(1) — NOT NULL — 사용자 승인 후 휴지통 이동 안내 확인 여부
  • consent_version — VARCHAR(30) — NOT NULL — 동의 문서 버전
  • consented_at — DATETIME — 최종 동의 일시
  • updated_at — DATETIME — NOT NULL — 마지막 수정 일시

user_withdrawals

  • withdrawal_id — BIGINT — Primary key — NOT NULL — 탈퇴 이력 고유 ID
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 사용자 ID
  • reason — VARCHAR(500) — 탈퇴 사유
  • google_disconnected — TINYINT(1) — NOT NULL — Google 연결 해제 여부
  • token_deleted — TINYINT(1) — NOT NULL — 토큰 삭제 또는 폐기 여부
  • scan_data_policy — ENUM('DELETE', 'ANONYMIZE', 'KEEP') — NOT NULL — 스캔 데이터 처리 정책
  • history_data_policy — ENUM('DELETE', 'ANONYMIZE', 'KEEP') — NOT NULL — 정리 및 통계 이력 처리 정책
  • processed_status — ENUM('PENDING', 'COMPLETED', 'FAILED') — NOT NULL — 탈퇴 처리 상태
  • failure_reason — VARCHAR(500) — 처리 실패 사유
  • withdrawn_at — DATETIME — NOT NULL — 탈퇴 요청 일시
  • processed_at — DATETIME — 탈퇴 처리 완료 일시

users

  • user_id — BIGINT — Primary key — NOT NULL — 사용자 내부 고유 ID
  • google_provider_id — VARCHAR(100) — Google 계정 고유 식별자
  • email — VARCHAR(150) — Google 계정 이메일
  • display_name — VARCHAR(100) — Google 프로필 표시 이름
  • profile_image_url — VARCHAR(500) — Google 프로필 이미지 URL
  • account_status — ENUM('ACTIVE', 'DISCONNECTED', 'WITHDRAWN') — NOT NULL — 계정 상태
  • last_login_at — DATETIME — 마지막 로그인 일시
  • withdrawn_at — DATETIME — 탈퇴 처리 일시
  • anonymized_at — DATETIME — 개인정보 익명화 일시
  • anonymous_user_key — VARCHAR(64) — 탈퇴 후 통계 보존용 익명 사용자 키
  • created_at — DATETIME — NOT NULL — 계정 생성 일시
  • updated_at — DATETIME — NOT NULL — 마지막 수정 일시