asset_schema

테이블 (4)

가용 생활비 스냅샷 테이블 (daily_cashflow_snapshot)

  • 유저 아이디 (user_id) — BIGINT — 기본 키 — NOT NULL — [논리적FK] 사용자 식별자로 1명의 유저는 1개의 스냅샷만 가짐
  • 가용한도금액 (calculated_limit) — DECIMAL(18,4) — NOT NULL — Work 도메인에서 계산된 오늘의 가용 한도 금액
  • 열공예산버퍼 금액 (study_buffer) — DECIMAL(18,4) — NOT NULL — Work 도메인에서 AI가 예측하여 알려준 "열공예산" 버퍼금액
  • 가용한도 금액 산출 일자 (snapshot_date) — DATE — NOT NULL — 해당 가용한도금액이 산출된 기준일자 (하루가 지나면 무효화)
  • 가용한도 금액 갱신 일자 (updated_at) — DATETIME — NOT NULL — 스냅샷 정보가 마지막으로 갱신된 일시

거래 내역 테이블 (transaction_history)

  • 거래 고유 식별자 (id) — BIGINT — 기본 키 — NOT NULL — snowflake 방식의 ID 채번
  • 계좌원장 아이디 (account_id) — BIGINT — NOT NULL — [논리적FK] account 테이블의 id값을 참조(누구의 계좌에서 일어난 거래인지 파악)
  • 거래유형 (type) — VARCHAR(202) — NOT NULL — DEPOSIT: 입금, WITHDRAW: 출금, TRANSFER: 이체
  • 거래금액 (amount) — DECIMAL(18,4) — NOT NULL — 거래금액. 0원 거래는 막아야 하므로 default 없이 필수로 입력받음
  • 상대방 계좌토큰 (target_token) — VARCHAR(255) — 송금 시 상대방의 account_token 값. (출금 혹은 입금일땐 NULL)
  • 최초 생성시 대기상태 (status) — VARCHAR(20) — NOT NULL — 최초 생성 시 대기 상태. KFTC 응답 후 SUCCESS 혹은 FAIL로 업데이트
  • 멱등성 키 (idempotency_key) — VARCHAR(255) — NOT NULL — 중복 결제 방지를 위해 FE에서 넘겨준 고유 키
  • 거래 최초 요청일시 (created_at) — DATETIME — NOT NULL — 거래 최초 요청 일시
  • 거래 변경 일시 (updated_at) — DATETIME — NOT NULL — 상태가 PENDING에서 다른 상태로 변경된 최종 일시

계좌 원장 테이블 (account)

  • 아이디 (id) — BIGINT — 기본 키 — NOT NULL — snowflake로 생성후 Insert
  • 유저 아이디 (user_id) — BIGINT — NOT NULL — [논리적FK]Auth 도메인의 사용자 PK 참조
  • 계좌토큰 (account_token) — VARCHAR(255) — NOT NULL — Auth 도메인에서 발급한 계좌번호 토큰값
  • 계좌 가용잔액 (balance) — DECIMAL(18,4) — NOT NULL — 현재 가용 잔액으로 부동소수점 오류 방지 위해 DECIMAL 사용
  • 계좌 상태 (status) — VARCHAR(20) — NOT NULL — 계좌 상태 (ACTIVE: 정상, SUSPENDED: 정지, CLOSED: 해지)
  • 계좌 최초개설일시 (created_at) — DATETIME — NOT NULL — 계좌 최초 개설 일시
  • 계좌 변동일시 (updated_at) — DATETIME — NOT NULL — 잔액 등 계좌 정보가 마지막으로 변경된 일시

이벤트 아웃박스 테이블 (transactional_outbox)

  • 아웃박스 레코드 고유 식별자 (id) — BIGINT — 기본 키 — NOT NULL — snowflake 방식으로 채번
  • 발행 이벤트 종류 (aggregate_type) — VARCHAR(50) — NOT NULL — 예: KFTC_TRANSFER_REQUEST
  • 발행 이벤트 아이디 (aggregate_id) — BIGINT — NOT NULL — [논리적FK] transaction_history 테이블의 id 값을 참조( 어떤 거래에 대한 이벤트인지 파악)
  • 메세지 본문 내용 (payload) — JSON — NOT NULL — Kafka로 쏠 실제 메세지 내용 (JSON 문자열)
  • 전송성공여부 (is_published) — TINYINT(1) — NOT NULL — [중요Field] Kafka 전송 성공여부. 배치 스케줄러가 0인것만 읽어서 발행 시도
  • 트랜잭션 (이벤트) 발생일시 (created_at) — DATETIME — NOT NULL — 트랜잭션(이벤트)이 발생한 최초 일시