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