Uniconvert

Tables (18)

EmailVerificationToken

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — Foreign key → User.id — NOT NULL — (FK<--User) 인증 대상 User. => LOCAL 가입 시에만 발급
  • token — VARCHAR(255) — NOT NULL — 랜덤 문자열. 인증 메일 링크에 포함되어 이메일 소유 확인 수단으로 사용됨
  • expires_at — DATETIME — NOT NULL — 토큰 만료 시각. 발급 후 N시간. 초과 시 링크 만료 처리
  • used — BOOLEAN — NOT NULL — 인증 완료 여부. 기본값 false. 인증 완료 시 true로 변경
  • created_at — DATETIME — NOT NULL — 발급 시각. 기본값 CURRENT_TIMESTAMP

PasswordResetToken

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — Foreign key → User.id — NOT NULL — (FK<-User)재설정을 요청한 User. LOCAL 유저만 발급 대상
  • token — VARCHAR(255) — NOT NULL — 랜덤 문자열. 재설정 링크에 포함되어 본인 확인 수단으로 사용됨
  • expires_at — DATETIME — NOT NULL — 토큰 만료 시각. 발급 후 1시간
  • used — BOOLEAN — NOT NULL — 토큰 사용 여부. 기본값 false. 재설정 완료 시 true로 변경되어 재사용 차단
  • created_at — DATETIME — NOT NULL — 발급 시각. 기본값 CURRENT_TIMESTAMP

User

  • id — BIGINT — Primary key — NOT NULL — 내부 식별용 고유 번호. 다른 모든 도메인이 이 값으로 사용자를 참조함
  • email — VARCHAR(255) — 가입 이메일. GUEST는 null. (email, provider) 조합으로 UNIQUE 제약
  • provider — VARCHAR(20) — NOT NULL — 가입 경로: LOCAL / GOOGLE / APPLE / GUEST. provider별로 완전히 별개의 계정(row)이 생성됨
  • provider_user_id — VARCHAR(255) — GOOGLE/APPLE이 발급한 고유 식별값(sub). 이메일이 바뀌어도 고정됨. LOCAL·GUEST는 null
  • password_hash — VARCHAR(255) — bcrypt 암호화된 비밀번호.(한글+숫자 8자리 이상) LOCAL만 값 존재, 나머지는 null
  • email_verified — BOOLEAN — NOT NULL — 이메일 인증 완료 여부. 기본값 false. LOCAL 가입 시 인증 전엔 로그인 불가
  • login_fail_count — INT — NOT NULL — 로그인 연속 실패 횟수. 기본값 0. 5회 도달 시 비밀번호 재설정 유도, 성공 시 0으로 초기화
  • home_currency — VARCHAR(10) — NOT NULL — 온보딩에서 설정한 홈 통화. 모든 환율 환산의 기준값
  • local_currencies — VARCHAR(255) — NOT NULL — 온보딩에서 설정한 현지 통화(복수 선택). 구조 미확정 — 추후 별도 테이블 정규화 검토 필요
  • last_active_at — DATETIME — NOT NULL — 마지막 활동 시각. 게스트 만료 판단 기준
  • guest_expires_at — DATETIME — GUEST만 값 존재. last_active_at + N시간으로 활동마다 갱신, 스케줄러가 이 값 기준으로 만료 게스트 삭제
  • created_at — DATETIME — NOT NULL — row 생성 시각. 기본값 CURRENT_TIMESTAMP. 가입 경로별로 생성 시점 의미가 다름(소셜=온보딩 완료 시점, 자체가입=인증 전 단계)
  • deleted_at — DATETIME — soft delete 시각. 탈퇴 후 30일간 동일 (email, provider) 재가입 차단 기준값

budget

  • id — BIGINT — Primary key — NOT NULL
  • user_id — BIGINT — NOT NULL
  • month — VARCHAR(7) — NOT NULL
  • amount — DECIMAL(12,2) — NOT NULL

budget_alert_setting

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — NOT NULL — 유저당 1개
  • is_enabled — BOOLEAN — NOT NULL — (default true)알림 ON/OFF
  • threshold_percent — INT — NOT NULL — (default 70)70 또는 90
  • last_sent_date — DATE — 마지막 발송 날짜. 아직 한 번도 안 보냈으면 null

category

  • id — BIGINT — Primary key — NOT NULL
  • name — VARCHAR(50) — NOT NULL
  • icon — VARCHAR(50)

currency

  • code — VARCHAR(3) — Primary key — NOT NULL — 통화 코드(ISO 4217). 예: KRW, GBP, EUR, USD. (지원되는)전 세계 통화를 미리 채워두는 기준 테이블
  • name_ko — VARCHAR(50) — NOT NULL — 한글 이름. 예: 영국 파운드, 유로, 미국 달러
  • name_en — VARCHAR(50) — NOT NULL — 영문 이름. 예: British Pound, Euro, US Dollar
  • symbol — VARCHAR(5) — NOT NULL — 화면 표시용 기호. 예: £, €, $, ₩
  • is_supported — BOOLEAN — NOT NULL — 현재 앱이 지원하는 통화인지 여부. 기본값 true. 정책서의 "v1.0 기준 N개 통화 지원"을 코드 배포 없이 토글로 관리하기 위한 플래그

email_report_setting

  • id — BIGINT — Primary key — NOT NULL
  • user_id — BIGINT — NOT NULL — 유저당 1개
  • is_enabled — BOOLEAN — NOT NULL — 수신여부, 기본값 OFF
  • email — VARCHAR(255) — NOT NULL — 수신 이메일 주소
  • send_time — TIME — NOT NULL — 발송 시간
  • updated_at — DATETIME — NOT NULL — 마지막 수정 시간

exchange_rate

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • local_currency_code — VARCHAR(3) — Foreign key → currency.code — NOT NULL — 현지 통화 코드 (FK → currency.code). 예: GBP
  • home_currency_code — VARCHAR(3) — Foreign key → currency.code — NOT NULL — 홈 통화 코드 (FK → currency.code). 예: KRW
  • rate_date — DATE — NOT NULL — 이 환율이 적용되는 날짜
  • rate_value — DECIMAL(10,4) — NOT NULL — 환율 숫자. source가 AVERAGE면 하루 3회 수집값의 평균, MANUAL이면 직접 입력값
  • source — VARCHAR(10) — NOT NULL — 환율 출처. AVERAGE / MANUAL. ⚠️ 동일 (local_currency_code, home_currency_code, rate_date, source) 조합은 UNIQUE 제약 필요 (서비스 로직/엔티…
  • created_at — DATETIME — NOT NULL — row 생성 시각. 기본값 CURRENT_TIMESTAMP

expense

  • id — BIGINT — Primary key — NOT NULL
  • user_id — BIGINT — NOT NULL
  • category_id — BIGINT — Foreign key → category.id — NOT NULL
  • wallet_id — BIGINT — NOT NULL
  • local_currency_code — VARCHAR(3) — NOT NULL
  • local_amount — DECIMAL(12,2) — NOT NULL
  • applied_rate — DECIMAL(10,4) — NOT NULL
  • home_amount — DECIMAL(12,2) — NOT NULL
  • exchange_rate_id — BIGINT
  • expense_date — DATE — NOT NULL
  • sync_status — VARCHAR(10) — NOT NULL
  • created_at — DATETIME — NOT NULL

fixed_expense

  • id — BIGINT — Primary key — NOT NULL
  • user_id — BIGINT — NOT NULL
  • category_id — BIGINT — Foreign key → category.id — NOT NULL
  • wallet_id — BIGINT
  • name — VARCHAR(100) — NOT NULL
  • local_currency_code — VARCHAR(3) — NOT NULL
  • amount — DECIMAL(12,2) — NOT NULL
  • recurrence_type — VARCHAR(10) — NOT NULL
  • next_due_date — DATE — NOT NULL
  • is_date_fixed — BOOLEAN — NOT NULL
  • created_at — DATETIME — NOT NULL

main_wallet

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — NOT NULL — 유저당 정확히 1개만 존재
  • balance — DECIMAL(14,2) — NOT NULL — (default 0)현재 잔액(캐시된 최종값). 통화는 User.home_currency를 따름. MainWalletTransaction들의 누적 합과 항상 일치해야 함
  • created_at — DATETIME — NOT NULL — row 생성 시각

main_wallet_transaction

  • id — BIGINT — Primary key — NOT NULL
  • main_wallet_id — BIGINT — Foreign key → main_wallet.id — NOT NULL
  • type — VARCHAR(20) — NOT NULL — DEPOSIT(입금 기록) / MANUAL_SET(직접 잔액 설정) / TRANSFER_OUT(서브 지갑 송금으로 차감)
  • amount — DECIMAL(14,2) — NOT NULL — 변동 금액. DEPOSIT·TRANSFER_OUT은 증감분, MANUAL_SET은 설정 후 최종값과의 차액으로 통일(부호로 증감 표현)
  • memo — VARCHAR(100) — 사용자가 남기는 메모
  • created_at — DATETIME — NOT NULL

ocr_batch

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — NOT NULL — 업로드한 유저
  • image_url — VARCHAR(255) — NOT NULL — 업로드된 원본 이미지의 저장 경로(스토리지 URL)
  • status — VARCHAR(20) — NOT NULL — PROCESSING / COMPLETED / FAILED
  • created_at — DATETIME — NOT NULL — 업로드 시각

ocr_result_item

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • ocr_batch_id — BIGINT — Foreign key → ocr_batch.id — NOT NULL — 어느 배치에서 인식된 항목인지
  • transaction_date — DATE — NOT NULL — 인식된 거래 날짜. 날짜별 그룹핑 표시(E103)에 사용
  • merchant_name — VARCHAR(100) — 인식된 가게명. 인식 실패 시 null
  • local_amount — DECIMAL(12,2) — 인식된 금액. 인식 실패 시 null
  • local_currency_code — VARCHAR(3) — 인식된 통화. 텍스트에서 통화 기호/코드를 같이 파싱
  • suggested_category_id — BIGINT — 가게명 기반 자동 추천 카테고리
  • is_recognized — BOOLEAN — NOT NULL — (default true)OCR이 이 항목을 제대로 읽었는지(default false)취소거래 키워드 감지 여부
  • is_cancelled_transaction — BOOLEAN — NOT NULL — (default false)취소거래 키워드 감지 여부
  • is_checked — BOOLEAN — NOT NULL — (default true)저장 대상으로 선택됐는지(취소거래건에는 기본 False)
  • is_saved — BOOLEAN — NOT NULL — (default false)실제 Expense로 변환 저장 완료됐는지
  • expense_id — BIGINT — 저장 완료 시 연결된 Expense row
  • created_at — DATETIME — NOT NULL — 생성시각

rate_alert

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • user_id — BIGINT — NOT NULL — 한사람당 여러개 설정 가능
  • local_currency_code — VARCHAR(3) — NOT NULL
  • home_currency_code — VARCHAR(3) — NOT NULL
  • target_rate — DECIMAL(10,4) — NOT NULL — 목표 환율
  • is_active — BOOLEAN — NOT NULL — (default true)발송 후 자동 false
  • created_at — DATETIME — NOT NULL — 등록 시각

sub_wallet

  • id — BIGINT — Primary key — NOT NULL — 고유 식별
  • user_id — BIGINT — NOT NULL
  • name — VARCHAR(50) — NOT NULL — 예: 영국 계좌, 생활비 Pot
  • wallet_type — VARCHAR(20) — NOT NULL — LOCAL_ACCOUNT(현지계좌) / CASH(현금) / POT(목적별)
  • local_currency_code — VARCHAR(3) — NOT NULL
  • balance — DECIMAL(14,2) — NOT NULL — (default 0)현지 통화 기준 잔액
  • category_id — BIGINT — 연결 카테고리(선택)
  • is_locked — BOOLEAN — NOT NULL — (default false)잠금 여부. "지금 써도 되는 돈" 계산에서 제외
  • is_rate_fixed — BOOLEAN — NOT NULL — 환전 환율 고정 모드 여부
  • fixed_rate — DECIMAL(10,4) — is_rate_fixed=true일 때만 값 존재
  • created_at — DATETIME — NOT NULL

wallet_transfer

  • id — BIGINT — Primary key — NOT NULL — 고유 식별자
  • main_wallet_id — BIGINT — Foreign key → main_wallet.id — NOT NULL
  • sub_wallet_id — BIGINT — Foreign key → sub_wallet.id — NOT NULL
  • home_amount — DECIMAL(14,2) — NOT NULL — 메인 지갑 통화(홈통화) 기준 출금액
  • applied_rate — DECIMAL(10,4) — NOT NULL — 이 송금에 적용된 환율
  • local_amount — DECIMAL(14,2) — NOT NULL — 서브 지갑 통화 기준 입금액
  • created_at — DATETIME — NOT NULL