TangTang_v2

테이블 (39)

tbl_card_bill

  • id — BIGINT — 기본 키 — NOT NULL
  • card_id — BIGINT — 외래 키 → 카드.id — NOT NULL
  • billing_month — CHAR(7) — NOT NULL — YYYY-MM
  • due_date — DATE
  • bill_status_code — VARCHAR(10)
  • bill_status_name — VARCHAR(50)
  • total_amount — DECIMAL(15, 2) — NOT NULL
  • paid_amount — DECIMAL(15, 2) — NOT NULL
  • raw_json — JSON
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_category

  • id — BIGINT — 기본 키 — NOT NULL
  • category_name — VARCHAR(50) — NOT NULL
  • parent_id — BIGINT — 외래 키 → tbl_category.id — 상위 카테고리. NULL이면 대분류. 0809 반영 2026-08-05 migration 으로 개발 레포에만 들어가 있던 컬럼을 ERD 에 동기화. seed_category.sql 이 대분류 12·소분류 46 을…
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_llm_categorization_job

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • status — VARCHAR(20) — NOT NULL — PENDING/PROCESSING/COMPLETED/FAILED
  • transaction_count — INT — NOT NULL
  • started_at — DATETIME
  • finished_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_llm_categorization_job_item

  • id — BIGINT — 기본 키 — NOT NULL
  • job_id — BIGINT — 외래 키 → tbl_llm_categorization_job.id — NOT NULL
  • transaction_id — BIGINT — 외래 키 → 거래내역.id — NOT NULL
  • created_at — DATETIME — NOT NULL

tbl_merchant_category_map

  • id — BIGINT — 기본 키 — NOT NULL
  • merchant_name_normalized — VARCHAR(200) — NOT NULL
  • category_id — BIGINT — 외래 키 → tbl_category.id — NOT NULL
  • source — VARCHAR(20) — NOT NULL — MCC/KEYWORD/LLM
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_merchant_keyword_rule

  • id — BIGINT — 기본 키 — NOT NULL
  • keyword — VARCHAR(100) — NOT NULL — 원본 키워드 (화면 표시·관리용)
  • keyword_normalized — VARCHAR(100) — NOT NULL — 정규화된 키워드 (매칭 키). 공백/특수문자 제거 + 소문자
  • category_id — BIGINT — 외래 키 → tbl_category.id — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_user_category_map

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • merchant_name_normalized — VARCHAR(200) — NOT NULL
  • category_id — BIGINT — 외래 키 → tbl_category.id — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

tbl_user_category_pref

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • category_id — BIGINT — 외래 키 → tbl_category.id — NOT NULL
  • is_hidden — TINYINT(1) — NOT NULL — 이 사용자가 해당 표준 카테고리를 목록에서 숨겼는지 (커스텀 추가/삭제는 tbl_category에서, 표준 숨김만 여기서)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

개인 미션 월간 리포트 (tbl_challenge_monthly_report)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • year_month — CHAR(7) — NOT NULL — YYYY-MM. tbl_monthly_ranking과 동일 키
  • total_days — SMALLINT — NOT NULL — 판정 완료된 미션 배정 일수(PENDING·base_amount NULL 제외). 실패일 = total_days - success_days
  • success_days — SMALLINT — NOT NULL — 해당 월 미션 성공 일수
  • monthly_longest_streak — SMALLINT — NOT NULL — 대상 월 내부에서만 계산한 최장 연속 SUCCESS 일수
  • best_weekday — VARCHAR(3) — 성공률·도전일수·월요일~일요일 순으로 결정한 최고 성공 요일
  • earned_score — INT — NOT NULL — 성공 미션 난이도 점수와 전일 SUCCESS 보너스를 합산한 확정 점수
  • saved_amount — DECIMAL(15, 2) — NOT NULL — 성공일 Σ(B−S) · 화면 "덜 쓴 돈"
  • over_amount — DECIMAL(15, 2) — NOT NULL — 실패일 Σmax(S−B,0) · 화면 "더 쓴 돈". 실패일 절약분 불인정
  • net_amount — DECIMAL(15, 2) — 순 효과 · 히어로 숫자 겸 보관함 정렬키. 생성컬럼 = saved_amount - over_amount (STORED)' COMMENT '순 효과 · 히어로 숫자 겸 보관함 정렬키
  • category_results_json — JSON — CR_01_03 카테고리 × 성공/실패 breakdown
  • weekly_results_json — JSON — 주차별 도전·성공 일수(비율 아님). 달력 주(월요일 시작), 월 경계 제외
  • difficulty_results_json — JSON — CR_01_05 난이도별 도전·성공
  • group_record_json — JSON — 종료월에 CLOSED 및 final_* 완결 조건을 만족한 그룹 챌린지 전적 요약. 전적이 없으면 NULL
  • best_saving_date — DATE — 그 달 최고 절약일 트로피 카드
  • best_saving_amount — DECIMAL(15, 2)
  • calculation_version — VARCHAR(20) — NOT NULL — 산정 로직 버전. 예: v2026-07-30
  • created_at — DATETIME — NOT NULL — 월 확정 배치 실행 시각 = 확정 시각
  • updated_at — DATETIME — NOT NULL — 로직 개정으로 과거 월 재산출 시에만 변경

개인 미션 풀 (tbl_mission_pool)

  • id — BIGINT — 기본 키 — NOT NULL
  • mission_title — VARCHAR(100) — NOT NULL
  • mission_content — VARCHAR(255) — NOT NULL
  • mission_type — VARCHAR(10) — NOT NULL — ABSOLUTE(절대형=무지출·상한형, 콜드스타트 전용)/RELATIVE(상대형). 0809 재도입 최근 28일 데이터가 부족해 상대형 목표를 산정할 수 없는 사용자에게 절대형을 배정한다
  • category_id — BIGINT — 외래 키 → tbl_category.id — 상대형 미션 = 소분류(거래에 붙는 레벨과 동일) / 절대형 미션 = 대분류(콜드스타트). AI 과소비 카테고리 순위(MC_02_01)와 매칭해 배정
  • limit_price — INT — 절대형 미션의 하루 지출 상한. 0=무지출 미션, >0=상한형 미션(예: 카페 5,000원 이하). 상대형은 NULL - 목표는 배정 시점에 tbl_user_mission_info.target_value 가 계산해…
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

개인미션 사용자별 정보 (tbl_user_mission_info)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • mission_id — BIGINT — 외래 키 → 개인 미션 풀.id — NOT NULL
  • difficulty_id — BIGINT — 외래 키 → 검사 (미션)난이도 설정.id
  • assign_date — DATE — NOT NULL
  • target_rate — DECIMAL(5, 2) — 적용 절감률(%)
  • target_value — DECIMAL(15, 2) — 실제 목표 상한. 상대형 = B x (1 - 난이도별 절감률) / 무지출 절대형 = 0. 0812·#139 구 표기 "후 하한 클램프" 삭제 - 계산 목표가 하한 미만이면 목표를 끌어올리지 않고 같은 카테고리 무지…
  • base_amount — DECIMAL(15, 2) — 배정 시점 기준액 B = 최근 28일 중 해당 카테고리를 이용한 날의 일별 순소비 평균. 절감액 산정·검산 근거. NULL 허용은 의도적 - B=0(미사용)과 계산 안 됨을 구분한다. 0812 무지출 전환 행은 B…
  • assignment_reason — VARCHAR(30) — 배정 사유. NULL=일반 상대형 배정 / LOW_SPENDING_NO_SPEND=낮은 상대형 목표를 같은 카테고리 무지출로 전환 / MONTHLY_ABSOLUTE=월 1회 절대형(예정)
  • result — VARCHAR(10) — NOT NULL — SUCCESS/FAIL/PENDING
  • evaluated_at — DATETIME — 배치가 SUCCESS/FAIL로 확정 판정한 시각
  • result_checked_at — DATETIME — 전날 미션 결과 팝업을 사용자가 확인한 시각. NULL이면 아직 안 봤다(팝업 노출 대상). evaluated_at 과 다른 값이다
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

거래내역 (tbl_transaction)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • account_id — BIGINT — 외래 키 → 연결 계좌.id — 대출·카드 출처 거래는 NULL (tbl_connected_account 에 안 걸림)
  • source_type — VARCHAR(20) — NOT NULL — BANK/DEPOSIT/SECURITIES/LOAN/PAYMONEY/CARD_CREDIT/CARD_CHECK
  • codef_tr_key — VARCHAR(100) — NOT NULL — CODEF 거래 고유키(중복 수집 방지). 페이머니 등 더미데이터는 시딩 스크립트가 DUMMY-{user_id}-{seq} 규칙으로 채워 넣음 - NULL 허용 시 코드 실수로 값이 비거나(UNIQUE+NULL은…
  • merchant_name — VARCHAR(200)
  • merchant_name_normalized — VARCHAR(200) — 정규화명 (고정지출 매칭용)
  • amount — DECIMAL(15, 2) — NOT NULL — 거래 금액(항상 양수). 환불 거래도 양수로 저장하고 is_refund=1로 구분(음수 저장 안 함, 2026-07-20 피드백 반영)
  • direction — VARCHAR(10) — IN/OUT
  • tr_date — DATE — NOT NULL
  • tr_time — TIME
  • description1 — VARCHAR(200) — CODEF resAccountDesc1
  • description2 — VARCHAR(200) — CODEF resAccountDesc2
  • description3 — VARCHAR(200) — CODEF resAccountDesc3
  • description4 — VARCHAR(200) — CODEF resAccountDesc4
  • cancel_yn — CHAR(1) — 카드 승인내역 API resCancelYN
  • is_refund — TINYINT(1) — NOT NULL — 환불 거래 여부 (GC_05_01)
  • original_transaction_id — BIGINT — 외래 키 → 거래내역.id — 환불 대상 원거래
  • refunded_amount — DECIMAL(15, 2) — 이 환불 거래 행 자체가 환불한 금액(원거래가 아니라 환불 거래 쪽 행에 저장). 부분환불이면 원거래 금액보다 작을 수 있음. 원거래 하나에 환불이 여러 번 걸쳐 있었던 경우 누적 환불액은 SUM(refunded_…
  • classification — VARCHAR(20) — NOT NULL — CONSUMPTION(소비)/TRANSFER(자산이동)/INCOME(수입) 3분류. 2026-08-03 불가피지출(OBLIGATION)은 v1 범위 제외 - ck_tx_class CHECK도 3값
  • category_id — BIGINT — 외래 키 → tbl_category.id
  • category_source — VARCHAR(20) — 카테고리 판정 출처. RULE_MCC/RULE_KEYWORD/LLM/USER. category_id 가 NULL 이면 반드시 NULL
  • is_excluded_from_summary — TINYINT(1) — NOT NULL — 가승인-즉시취소 등 집계 제외
  • loan_id — BIGINT — 외래 키 → 대출.id
  • card_id — BIGINT — 외래 키 → 카드.id — 카드 출처 거래의 카드
  • candidate_id — BIGINT — 외래 키 → 고정지출 후보군.id
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • correlation_id — VARCHAR(100) — 체크카드 승인과 은행출금을 잇는 연결키 (raw_json 유래)
  • linked_transaction_id — BIGINT — 외래 키 → 거래내역.id — 연결된 상대 거래 (자기참조)
  • original_approval_no — VARCHAR(100) — 카드 취소·환불 원거래 승인번호 (raw_json 유래)
  • merchant_category_code — VARCHAR(30) — 후속 카테고리화용 (이번 범위 아님, 보존만)
  • merchant_category_name — VARCHAR(100)
  • raw_json — JSON — 목서버 원본 응답 보존

검사 (미션)난이도 설정 (tbl_mission_difficulty)

  • id — BIGINT — 기본 키 — NOT NULL
  • difficulty_name — VARCHAR(10) — NOT NULL — EASY/NORMAL/HARD
  • min_reduction_rate — DECIMAL(5, 2) — NOT NULL — 절감률 하한(%)
  • max_reduction_rate — DECIMAL(5, 2) — NOT NULL — 절감률 상한(%)
  • score — INT — NOT NULL — 성공 시 부여 점수
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

고정지출 리마인더 (tbl_fixed_expense_payment_reminder)

  • id — BIGINT — 기본 키 — NOT NULL
  • fixed_expense_candidate_id — BIGINT — 외래 키 → 고정지출 후보군.id — NOT NULL
  • expected_payment_date — DATE — NOT NULL
  • notification_type — VARCHAR(30) — NOT NULL
  • created_at — DATETIME — NOT NULL

고정지출 탐지 룰 (tbl_fixed_expense_rule)

  • id — BIGINT — 기본 키 — NOT NULL
  • rule_name — VARCHAR(50)
  • min_repeat_count — INT — NOT NULL — 최소 반복 횟수(2026-07-13 확정값 3)
  • amount_tolerance_pct — DECIMAL(5, 2) — NOT NULL — 금액 오차 허용 %(5~10)
  • cycle_tolerance_days — INT — NOT NULL — 결제 주기 오차 허용일
  • is_active — TINYINT(1) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

고정지출 후보군 (tbl_fixed_expense_candidate)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • merchant_name_normalized — VARCHAR(200) — NOT NULL
  • avg_amount — DECIMAL(15, 2) — NOT NULL
  • cycle_days — INT — NOT NULL
  • detected_count — INT — NOT NULL
  • category_id — BIGINT — 외래 키 → tbl_category.id
  • is_excluded — TINYINT(1) — NOT NULL — 사용자가 "고정지출 아님"으로 직접 제외
  • confirmed_at — DATETIME — 사용자가 고정지출로 확정한 시각(이슈 #204). NULL이면 미확정 탐지 후보. is_excluded(제외)와 별개 축이다
  • status — VARCHAR(20) — NOT NULL — ACTIVE/BUFFER/VERIFIED_CANCELLED - 결제 소멸 관측으로 검증(2026-07-22 CANCEL_EXPECTED 셀프체크 제거)
  • next_expected_date — DATE — 검증 루프: 다음 결제 예정일(±7일)
  • verified_at — DATETIME — 결제 소멸 관측으로 해지 검증 완료된 시각 (FS_02_03). 실제 절감액은 avg_amount로 파생
  • relapse_detected_at — DATETIME — 요요 재발 감지 시각 (FS_02_04)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

그룹 재판 기소 (tbl_indictment)

  • id — BIGINT — 기본 키 — NOT NULL
  • result_id — BIGINT — 외래 키 → 그룹 재판 일일 결과.id — NOT NULL — uk_ind_result - 기소는 일별 결과 1행당 최대 1건임을 DB가 강제한다(중복 기소 방지)
  • group_id — BIGINT — 외래 키 → 재판 그룹.id — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL — 피기소자
  • status — VARCHAR(20) — NOT NULL — DEFENSE_WAIT(변론 대기)/VOTING(투표 진행중)/GUILTY/INNOCENT. 판결 확정(GUILTY/INNOCENT) 후에는 재심·재투표 없음 - 2026-07-20 REFUND_APPEAL 완전…
  • message — VARCHAR(300)
  • result — TINYINT(1) — 판결 요약 플래그. 1=GUILTY / 0=INNOCENT / NULL=미확정. status와 동일 정보이며 집계 쿼리 편의용(핵심로직 D-3·무투표마감·혐의인정 3곳이 이 규칙으로 기록)
  • verdict_method — VARCHAR(20) — 판결 근거. VOTE(다수결)/NO_VOTE(0표 무죄추정)/AI_JUDGMENT(동률 시 판사 탕이 AI 판결)/CONFESSION(혐의 인정, GC_06_06). 판결 확정 시 기록. 2026-08-03 신설.…
  • ai_verdict_reason — VARCHAR(300) — 판사 탕이의 AI 판결 사유 원문. verdict_method=AI_JUDGMENT 일 때만 기록, 그 외 NULL. 판결 상세(GC_07_04)에 그대로 노출
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

그룹 재판 일일 결과 (tbl_group_challenge_daily_result)

  • id — BIGINT — 기본 키 — NOT NULL
  • group_id — BIGINT — 외래 키 → 재판 그룹.id — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • challenge_date — DATE — NOT NULL
  • daily_amount — DECIMAL(15, 2) — NOT NULL — 집계 배치 전용(2026-08-14). 5분마다 UPSERT로 덮어쓴다. 판결 감액을 여기에 반영하지 말 것 - 배치가 지워버린다. 실효액은 effective_amount
  • verdict_deduction_amount — DECIMAL(15, 2) — NOT NULL — 판결 전용. 무죄로 인정된 감액 누계. 배치는 이 컬럼을 쓰지 않는다
  • effective_amount — DECIMAL(15, 2) — 실효 소비액. 생성 컬럼(STORED) = GREATEST(daily_amount - verdict_deduction_amount, 0). 일일 결산 랭킹의 정렬 키라 0에서 바닥을 친다 - 음수면 감액 큰 사람이…
  • target_count — INT — NOT NULL — 미션 해당 타겟의 소비 횟수
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

그룹 재판 참여자 (tbl_group_member)

  • group_id — BIGINT — 외래 키 → 재판 그룹.id — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • lives_count — INT — NOT NULL — 일일평가=챌린지 기간(일수), 기간평가=1 고정
  • final_outcome — VARCHAR(20) — SURVIVED/ELIMINATED. 종료 다음날 확정 배치가 final_rank와 동시 기록(write-once). NULL=미확정
  • final_rank — INT — 종료 후 배치에서 확정. 탈락자는 전원 공동 최하위
  • final_charge_amount — DECIMAL(15, 2) — 최종 실제 부담금 = 챌린지 기간 해당 카테고리 소비 - 판결로 인정된 감액(tbl_defense.deduction_amount). 종료 확정 배치가 원장에서 1회 계산해 기록(write-once, final_ra…
  • joined_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

그룹 재판 투표 (tbl_vote)

  • group_id — BIGINT — 외래 키 → 재판 그룹.id — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL — 투표자
  • indictment_id — BIGINT — 외래 키 → 그룹 재판 기소.id — NOT NULL
  • verdict — VARCHAR(10) — NOT NULL — GUILTY/INNOCENT
  • comment — VARCHAR(40) — 익명 한줄 코멘트. GC_06_05 최대 40자
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

기소건에 대한 변론 (tbl_defense)

  • id — BIGINT — 기본 키 — NOT NULL
  • indictment_id — BIGINT — 외래 키 → 그룹 재판 기소.id — NOT NULL
  • content — TEXT
  • actual_burden_amount — DECIMAL(15, 2) — 사용자가 변론에서 신고한 실제 부담 금액(2026-08-14 의미 변경, 구 requested_adjustment_amount). 0 이상 — 원 거래액 초과 여부는 애플리케이션이 검증(원 거래액이 이 테이블에 없…
  • deduction_amount — DECIMAL(15, 2) — 인정된 감액 = 원 거래액 - actual_burden_amount. 무죄와 함께 확정되고, 유죄면 반영하지 않는다
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

대출 (tbl_loan)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • loan_no_encrypted — VARCHAR(200) — NOT NULL — 대출계좌번호 등 CODEF 응답의 대출 식별값(암호화 저장). 재동기화 시 upsert 키 - 없으면 동일 대출이 동기화마다 중복 행으로 쌓임
  • bank_name — VARCHAR(50) — NOT NULL
  • bank_code — VARCHAR(10) — 대출 기관코드(캐피탈 CP_*·저축은행 SB_*). 목서버 institutionCode 를 그대로 저장
  • loan_type — VARCHAR(100) — NOT NULL
  • loan_amount — DECIMAL(15, 2) — NOT NULL
  • balance — DECIMAL(15, 2) — NOT NULL — 현재 잔액. 완제 시 0으로 갱신(행 삭제 안 함 - 상환 이력도 통계 대시보드 표시 대상)
  • interest_rate — DECIMAL(5, 2) — NOT NULL
  • start_date — DATE — NOT NULL
  • maturity_date — DATE — NOT NULL
  • monthly_payment — DECIMAL(15, 2) — NOT NULL — 월 상환액(CODEF 제공 시). 대출 상세 대시보드 표시용 - 2026-07-22 Figma
  • next_payment_date — DATE — 다음 상환 예정일(D-day 표시용)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • loan_no_masked — VARCHAR(100) — 목서버 제공 마스킹 대출번호

리프레시 토큰 (tbl_refresh_token)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • token_hash — CHAR(64) — NOT NULL — SHA-256 해시. 원문 토큰은 서버에 저장하지 않고 클라이언트만 보유 - DB 덤프 유출 시에도 토큰 재사용 불가
  • expires_at — DATETIME — NOT NULL
  • is_revoked — TINYINT(1) — NOT NULL — 탈취 의심/재사용 감지 시 조기 폐기 (AU_02_01)
  • revoked_at — DATETIME — 폐기 시각 (로그아웃 시 즉시 폐기 포함, AU_02_03)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

명예 인증서 AI 타이틀 (tbl_mission_certificate_title)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • year_month — CHAR(7) — NOT NULL — 인증서 대상 월(YYYY-MM)
  • title_1 — VARCHAR(50) — AI 명예 타이틀 후보 1
  • title_2 — VARCHAR(50) — AI 명예 타이틀 후보 2
  • title_3 — VARCHAR(50) — AI 명예 타이틀 후보 3
  • status — VARCHAR(20) — NOT NULL — NOT_REQUESTED/IN_PROGRESS/COMPLETED/FAILED
  • provider — VARCHAR(30) — OPENAI 또는 FALLBACK
  • model — VARCHAR(100) — 생성에 사용한 모델명
  • prompt_version — VARCHAR(40) — 타이틀 프롬프트 버전
  • input_hash — CHAR(64) — 비식별 성과 집계 입력 SHA-256
  • attempt_count — INT — NOT NULL — AI 생성 시도 횟수
  • requested_at — DATETIME — AI 생성 요청 시각
  • completed_at — DATETIME — AI 생성 완료 시각
  • failed_at — DATETIME — AI 생성 실패 시각
  • failure_code — VARCHAR(64) — 외부 API 실패 코드
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

미션 제공할 상위 카테고리 매핑 (tbl_user_mission_analysis)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • cycle_start_date — DATE — NOT NULL — 이 주기를 산정한 날
  • category_id — BIGINT — 외래 키 → tbl_category.id — NOT NULL — 미션 풀에 행이 있는 소분류만 들어온다
  • category_rank — TINYINT — NOT NULL — 1~3. 배정 순서
  • spending_amount — DECIMAL(15, 2) — NOT NULL — 산정 시점 최근 28일 합계
  • spending_ratio — DECIMAL(5, 2) — NOT NULL — 전체 소비 대비 비중(%). 화면 "배달앱 24%" 표기용
  • transaction_count — INT — NOT NULL — 산정 시점 거래 건수
  • assigned_date — DATE — 이 순위가 배정된 날. NULL 이면 아직 안 썼다
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

변론 시 첨부 이미지 (tbl_defense_images)

  • id — BIGINT — 기본 키 — NOT NULL
  • defense_id — BIGINT — 외래 키 → 기소건에 대한 변론.id — NOT NULL
  • image_url — VARCHAR(100) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME

사용자 동의 이력 (tbl_user_consent)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • consent_type — VARCHAR(30) — NOT NULL — TERMS(약관)/PRIVACY(개인정보)/THIRD_PARTY(제3자제공)/FINANCIAL_DATA(마이데이터 전송요구·금융정보)/MARKETING(마케팅수신)/AI_USAGE(AI활용)/CHALLENGE(챌린…
  • is_required — TINYINT(1) — NOT NULL — 필수/선택 동의 구분
  • terms_version — VARCHAR(20) — NOT NULL — 동의 시점의 약관 버전
  • withdrawn_at — DATETIME — 철회 시각. 철회는 이 행을 UPDATE(신규 INSERT 아님) - 철회 시 해당 데이터 수집·활용 즉시 중단, DS_01_02
  • status — TINYINT(1) — NOT NULL — 철회 상태 관리
  • expires_at — DATETIME — 동의 유효기간 만료 시각. 마이데이터 전송요구(FINANCIAL_DATA) 동의는 1년 - 만료 전 재동의 필요, 금융데이터 동의관리 화면 D-day 카운트다운. NULL=만료 개념 없는 동의(일반 약관 등). 2…
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

사용자 정보 (tbl_user)

  • id — BIGINT — 기본 키 — NOT NULL
  • social_provider — VARCHAR(20) — NOT NULL — 소셜 로그인 제공자 (GOOGLE 등)
  • provider_user_id — VARCHAR(100) — NOT NULL — 제공자 측 고유 ID
  • email — VARCHAR(100)
  • nickname — VARCHAR(50) — 사용자가 직접 정한 표시명. NULL 이면 온보딩 미완료 — 중복 허용(UNIQUE 없음)
  • social_name — VARCHAR(50) — OAuth 제공자가 준 이름(구글 name). 닉네임 미설정 시 표시명 fallback. 표시명 = nickname ?? social_name
  • profile_image_key — VARCHAR(255) — 프로필 이미지 저장 키. NULL 이면 미설정(이니셜 아바타). URL 이 아니라 키다 - 값 형식 'profile/{userId}/{uuid}.jpg'. 응답 필드 profileImageUrl 은 서버가 이 키로…
  • name — VARCHAR(50) — 실명(본인확인용). 계좌연동 간편인증 화면(AC_01_02)에서 사용자가 확인·수정한 값을 저장한다. 닉네임·소셜 이름과 별개 컬럼이다
  • phone — VARCHAR(20) — 휴대폰 번호(본인인증). 연락처 변경 시 재인증 - 프로필 관리 화면(MY)
  • birth_date — DATE — 연령대 코호트 비교(v2)용
  • gender — VARCHAR(10)
  • status — VARCHAR(20) — NOT NULL — ACTIVE/WITHDRAWN/BLOCKED — 물리 삭제 없음
  • withdrawn_at — DATETIME — 탈퇴 신청 시각
  • difficulty_id — BIGINT — 외래 키 → 검사 (미션)난이도 설정.id — NOT NULL — 현재 선택 난이도. 가입 시 EASY(id=1) 부여
  • mock_scenario_key — VARCHAR(50) — '목서버 시나리오 키 수동 오버라이드. NULL 이면 mock.server.scenario-keys 풀-나머지 로직을 따른다(#334). 값은 API 없이 수동 SQL 로 지정한다 - 시연용 유저에게 특정 시나리오…
  • relative_mission_qualified_at — DATETIME — 최초 28일·50건 조건을 충족한 상대형 미션 자격 획득 시각. NULL 이면 미획득. 챌린지 동의를 철회해도 유지 (2026-08-13, 이슈 #165)
  • tutorial_seen_at — DATETIME — 메인 챌린지 튜토리얼(MC_01_05) 완료 시각. NULL 이면 미완료. 그룹 챌린지는 group_tutorial_seen_at 로 분리(2026-08-11, 이슈 #128)
  • group_tutorial_seen_at — DATETIME — 그룹 챌린지 튜토리얼(GC_01_01) 완료 시각. NULL 이면 미완료
  • personal_mission_unlock_status — VARCHAR(20) — NOT NULL — 맞춤 미션 개시 안내 상태: UNTRACKED/INSUFFICIENT/PENDING/SEEN
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

알림 (tbl_notification)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • type — VARCHAR(30) — NOT NULL — DIET_REPORT/CHALLENGE_RESULT/GROUP_JUDGMENT 등
  • title — VARCHAR(100) — NOT NULL
  • content — VARCHAR(300) — NOT NULL
  • deep_link_url — VARCHAR(300) — 알림 클릭 시 이동할 딥링크 (NT_01_03)
  • is_read — TINYINT(1) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

알림 실패시 DLQ (tbl_notification_dlq)

  • dlq_id — BIGINT — 기본 키 — NOT NULL
  • original_event_type — VARCHAR(50)
  • payload_json — JSON
  • error_message — VARCHAR(500)
  • retry_count — INT — NOT NULL
  • reg_date — DATETIME — NOT NULL

알림 종류별 설정 (tbl_notification_setting)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • notification_type — VARCHAR(30) — 알림 종류별 개별 설정은 추후 확장. 현재는 NULL
  • is_enabled — TINYINT(1) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

연결 계좌 (tbl_connected_account)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • codef_connected_id — VARCHAR(100) — CODEF 커넥티드아이디
  • bank_code — VARCHAR(10) — 금융기관 코드 (은행 코드 또는 증권사 코드, account_type에 따라 의미 다름)
  • bank_name — VARCHAR(50) — 금융기관명 (은행명 또는 증권사명)
  • account_name — VARCHAR(100) — 계좌 상품명 (CODEF resAccountName)
  • account_no_encrypted — VARCHAR(200) — 계좌번호 HMAC-SHA256(결정적·단방향). 중복 검사 전용이며 복호화 경로 없음 (2026-08-05 정정, DS_02_01)
  • account_no_masked — VARCHAR(30) — 표시용 마스킹 계좌번호 (110-***-****23)
  • account_type — VARCHAR(20) — NOT NULL — 입출금/예적금/펀드/페이머니/SECURITIES
  • deposit_type_code — VARCHAR(5) — 은행 계좌 전용: CODEF resAccountDeposit 코드(10:미분류,11:수시입출,12:정기/적금,13:신탁,14:미분류). 증권/페이머니는 NULL
  • provider — VARCHAR(20) — 페이머니 전용: KAKAOPAY/NAVERPAY
  • balance — DECIMAL(15, 2) — 증권 계좌는 보유상품 총평가금액 요약치
  • sync_status — VARCHAR(20) — NOT NULL — NORMAL/SYNCING/NEED_SYNC/FAILED/NEED_RECONNECT
  • last_sync_at — DATETIME — 마지막 동기화 성공 시각 (AC_02_04)
  • sync_fail_reason — VARCHAR(200) — 동기화 실패 사유 (재시도 가능 여부 판단용, AC_02_05)
  • is_active — TINYINT(1) — NOT NULL — 연결 해제 여부 (AC_01_04)
  • expires_at — DATETIME — 재연동(재동의) 만료 예정일. 마이데이터 연결은 1년마다 재동의 필요, 만료 30일 전 알림·만료 시 sync_status=NEED_RECONNECT - 계좌 연동관리 화면. NULL=만료 없음/미설정. 2026-…
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

연속 성공일수 (tbl_streak_count)

  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • streak_count — BIGINT — 현재 연속 성공 일수
  • longest_streak_count — BIGINT — 미션 첫 시작부터 last_check_date까지 최장 연속 일수
  • last_check_date — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

월간 랭킹 (tbl_monthly_ranking)

  • year_month — CHAR(7) — 기본 키 — NOT NULL — YYYY-MM
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • total_score — INT — NOT NULL — 그 달 획득 점수
  • ranking — INT — NOT NULL — 월간 순위
  • ratio — DECIMAL(15, 2) — NOT NULL — 상위 퍼센트
  • monthly_longest_streak — INT — 그 달 최장 연속 성공일
  • success_ratio — DECIMAL(15, 2) — 월간 미션 성공률(%). 분모는 판정 완료된 미션 배정 일수 — tbl_challenge_monthly_report.total_days와 동일 정의(2026-07-30 확정)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL — 마지막 배치 갱신 시각. 당월엔 매일 갱신, 지난달은 마지막 갱신값이 곧 확정 랭킹

자산 스냅샷 (tbl_asset_snapshot)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • year_month — CHAR(7) — NOT NULL — YYYY-MM
  • net_worth — DECIMAL(15, 2) — 월말 순자산 = total_asset - total_debt (AS_02_03)
  • total_asset — DECIMAL(15, 2)
  • total_debt — DECIMAL(15, 2) — 월말 부채 총액 (tbl_loan SUM 대신 배치 확정 시 저장)
  • category_summary_json — JSON — 카테고리별 소비 합계. 예: {"FOOD_01": 350000, "CAFE_01": 80000} (카테고리코드→금액 매핑, 월간 리포트/연간 차트 재사용)
  • ai_comment — JSON — 월간 AI 소비 피드백 문자열 배열(JSON, 1~3개). 2026-08-13 TEXT NOT NULL → JSON NULL 로 변경, 기존 값은 JSON_ARRAY() 로 감싸 보존
  • compare_comment — TEXT — 월간 절약 비유 문장. 절감액이 없으면 NULL. 2026-08-13 NOT NULL → NULL 로 변경
  • ai_analysis_status — VARCHAR(20) — NOT NULL — NOT_REQUESTED, IN_PROGRESS, COMPLETED, FAILED
  • ai_analysis_provider — VARCHAR(30) — 분석 결과를 생성한 외부 제공자
  • ai_analysis_model — VARCHAR(100) — 분석 결과를 생성한 모델명
  • ai_analysis_prompt_version — VARCHAR(40) — 분석 프롬프트 버전
  • ai_analysis_input_hash — CHAR(64) — 비식별 월간 집계 입력의 SHA-256 해시
  • ai_analysis_attempt_count — INT — NOT NULL — 생성 시도 횟수
  • ai_analysis_requested_at — DATETIME — 생성 요청 시각
  • ai_analysis_completed_at — DATETIME — 생성 성공 시각
  • ai_analysis_failed_at — DATETIME — 생성 실패 시각
  • ai_analysis_failure_code — VARCHAR(64) — 사용자 정보나 원문을 포함하지 않는 실패 코드
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

자산 연동 히스토리 (tbl_financial_sync_history)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • status — VARCHAR(20) — NOT NULL — COMPLETED/FAILED
  • synced_sources — JSON — 성공한 소스 배열
  • failed_source — VARCHAR(20) — BANK/DEPOSIT/SECURITIES/LOAN/PAY_MONEY/CARD
  • fail_reason — VARCHAR(500)
  • started_at — DATETIME — NOT NULL
  • finished_at — DATETIME
  • created_at — DATETIME — NOT NULL

재판 그룹 (tbl_challenge_group)

  • id — BIGINT — 기본 키 — NOT NULL
  • admin_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL — 방장
  • group_name — VARCHAR(100) — NOT NULL
  • category_id — BIGINT — 외래 키 → tbl_category.id — NULL=총소비 챌린지 / NOT NULL=카테고리별 챌린지
  • limit_amount — INT — NOT NULL
  • eval_type — VARCHAR(10) — NOT NULL — DAILY(일일평가)/PERIOD(기간평가)
  • max_members — INT — NOT NULL — 정원 상한(2~6). 생성 화면에 입력란이 없어 6 으로 고정하며, 챌린지가 성립하는 최소 인원은 2명이다. 참여 시 tbl_group_member 수가 이 값을 넘지 못하게 앱이 제한하고 화면에 "N/max명"…
  • start_date — DATE — NOT NULL
  • end_date — DATE — NOT NULL — 시작일로부터 최대 7일 (CHECK: end_date ≤ start_date + 6일)
  • invite_code — VARCHAR(20) — NOT NULL
  • status — VARCHAR(20) — NOT NULL — RECRUITING(생성~시작 전, 멤버 모집)/ACTIVE(진행중)/JUDGING(판결유예)/CLOSED(종료) start_date 도달 시 배치가 RECRUITING→ACTIVE 자동 전환(2026-07-22)
  • memo — VARCHAR(300) — 그룹이 자율로 정하는 1등 리워드·꼴등 벌칙 등 자유 메모(표시 전용, 시스템 미지급·미집행). 화면에 규칙으로 노출. 미기입 가능·참여자 모이면 수정 가능. 2026-07-22 회의(winner_reward/lo…
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

주식 (tbl_investment_holding)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • account_id — BIGINT — 외래 키 → 연결 계좌.id — NOT NULL
  • symbol — VARCHAR(30) — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • market_country — CHAR(2) — NOT NULL
  • currency — CHAR(3) — NOT NULL
  • quantity — DECIMAL(20,8) — NOT NULL
  • average_purchase_price — DECIMAL(20,4) — NOT NULL
  • last_price — DECIMAL(20,4) — NOT NULL
  • purchase_amount — DECIMAL(20,4) — NOT NULL
  • market_value — DECIMAL(20,4) — NOT NULL
  • profit_loss_amount — DECIMAL(20,4) — NOT NULL
  • profit_loss_rate — DECIMAL(20,4) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

카드 (tbl_card)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자 정보.id — NOT NULL
  • institution_code — VARCHAR(10)
  • institution_name — VARCHAR(50)
  • card_no_masked — VARCHAR(30) — NOT NULL
  • product_name — VARCHAR(100)
  • card_product_code — VARCHAR(50)
  • card_type_code — VARCHAR(10) — NOT NULL — 01=신용카드, 02=체크카드 (목서버 시드 관례. 공식 enum 없음)
  • card_status_code — VARCHAR(10)
  • currency — CHAR(3) — NOT NULL
  • issued_at — DATE
  • last_sync_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL