TEAM_FLEXRATE_ERD 요구사항 명세서_ver0422

테이블 (11)

AuditLog

  • 로그 고유 식별자 (log_id) — UUID — 기본 키 — NOT NULL
  • 회원 고유 식별자 (user_id) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 이벤트 종류 (event_type) — ENUM('LOGIN', 'PASSWORD_CHANGE', 'PASSKEY_REGISTER', 'LOAN_APPLY', 'ERROR') — NOT NULL
  • 인증/로그인 방식(이벤트 로그인 시) (auth_method) — ENUM('PASSWORD', 'PASSKEY', 'MFA')
  • 이벤트 상세 내용 (detail) — TEXT
  • 이벤트 발생 일시 (occurred_at) — DATETIME — NOT NULL
  • 이벤트 발생 IP (ip_address) — VARCHAR(45)
  • 이벤트 발생 디바이스 정보(브라우저, OS 등) (device_info) — VARCHAR(255)

FidoCredential

  • FIDO2 Credential 고유 식별자 (credential_id) — UUID — 기본 키 — NOT NULL
  • 회원 고유 식별자 (user_id) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • FIDO2 공개키(암호화 저장 권장) (public_key) — TEXT
  • Credential 사용 횟수(Replay Attack 방지) (sign_count) — INT
  • Credential 등록 일시 (registered_at) — DATETIME
  • 마지막 인증 성공 일시 (last_used_at) — DATETIME
  • Credential 등록 디바이스 정보(브라우저, OS 등) (device_info) — VARCHAR(255)
  • 활성/비활성 상태(삭제/분실 시 false) (is_active) — BOOLEAN

JwtToken

  • 토큰 고유 식별자 (jwt_id) — UUID — 기본 키 — NOT NULL
  • 회원 고유 식별자 (user_id) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • token — VARCHAR(255)
  • issued_at — DATETIME
  • expires_at — DATETIME
  • ip_address — VARCHAR(255)
  • device_info — VARCHAR(255)

LoanApplication

  • 대출 신청 고유 식별자 (application_id) — UUID — 기본 키 — NOT NULL
  • 신청한 대출 상품 ID (product_id) — UUID — 외래 키 → LoanProduct.대출 상품 고유 식별자 — NOT NULL
  • 회원 고유 식별자 (user_id) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 신청 일시 (applied_at) — DATETIME
  • 신청 상태 (status) — ENUM('PENDING', 'APPROVED', 'REJECTED', 'EXECUTED')
  • 대출 실행 일시(실행 완료 시) (executed_at) — DATETIME
  • 신청/실행 대출 금액 (amount) — DECIMAL(15,2)
  • 적용 금리 (rate) — DECIMAL(5,2)
  • 심사 결과(간단 요약) (review_result) — TEXT

LoanProduct

  • 대출 상품 고유 식별자 (product_id) — UUID — 기본 키 — NOT NULL
  • name — VARCHAR(255)
  • description — TEXT
  • max_amount — DECIMAL(15,2)
  • min_rate — DECIMAL(5,2)
  • max_rate — DECIMAL(5,2)
  • terms — VARCHAR(255)

LoanTransaction

  • 거래 고유 식별자 (transaction_id) — UUID — 기본 키 — NOT NULL
  • 연관 대출 신청 (application_id) — UUID — 외래 키 → LoanApplication.대출 신청 고유 식별자 — NOT NULL
  • 거래 유형 (type) — ENUM('EXECUTION', 'REPAYMENT', 'DELAY')
  • 거래 금액 (amount) — DECIMAL(15,2)
  • 거래 발생 일시 (occurred_at) — DATETIME
  • 거래 상태 (status) — ENUM('NORMAL', 'FAILED', 'CANCELLED')

MfaLog

  • MFA 인증 이력 고유 식별자 (mfa_log_id) — UUID — 기본 키 — NOT NULL
  • 인증시도 회원 ID (user_id2) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 인증 방식 (mfa_type) — ENUM('PASS', 'EMAIL', 'SMS')
  • 인증 결과 (result) — ENUM('SUCCESS', 'FAILURE')
  • 인증 시도 일시 (authenticated_at) — DATETIME
  • 연관 거래(대출 실행 등) ID (transaction_id) — UUID
  • 인증 시도 IP (ip_address) — VARCHAR(255)
  • 인증 시도 디바이스 정보 (device_info) — VARCHAR(255)

Notification

  • 알림 고유 식별자 (notification_id) — UUID — 기본 키 — NOT NULL
  • 회원 고유 식별자 (user_id2) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 알림 종류 (type) — ENUM('LOAN_APPROVAL', 'MATURITY_NOTICE')
  • 알림 내용(문자/이메일 본문 등) (content) — TEXT
  • 알림 발송 일시 (sent_at) — DATETIME
  • 읽음 여부 (is_read) — BOOLEAN

PasswordResetToken

  • 토큰 고유 식별자 (token_id) — UUID — 기본 키 — NOT NULL
  • 대상 회원 ID (user_id) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 재설정 토큰(암호화 저장) (token) — VARCHAR(255)
  • 만료 일시 (expires_at) — DATETIME
  • 사용 여부 (used) — BOOLEAN
  • 생성 일시 (created_at) — DATETIME

UserFinancialData

  • 데이터 고유 식별자 (data_id) — UUID — 기본 키 — NOT NULL
  • 데이터 소유 회원 ID (user_id2) — UUID — 외래 키 → Users.회원 고유 식별자 — NOT NULL
  • 데이터 종류 (data_type) — ENUM('INCOME', 'EXPENSE', 'CREDIT_SCORE', 'LOAN_BALANCE')
  • 데이터 값(숫자/문자 등, 데이터 타입에 따라) (value) — VARCHAR(255)
  • 데이터 수집 일시 (collected_at) — DATETIME
  • 데이터 출처(외부 기관, 직접 입력 등) (source) — VARCHAR(255)

Users (users)

  • 회원 고유 식별자 (user_id) — UUID — 기본 키 — NOT NULL
  • 이메일 (email) — VARCHAR(255) — NOT NULL — 회원 이메일(로그인 ID)
  • 비밀번호_해시 (password_hash) — VARCHAR(255) — NOT NULL — 비밀번호 해시, 평문 저장 금지
  • 비밀번호 최종변경 일시 (password_last_changed_at) — DATETIME — 비밀번호 최종 변경 일시
  • 회원 실명 (name) — VARCHAR(100) — NOT NULL — 회원 실명
  • 휴대폰 번호 (phone) — VARCHAR(20) — NOT NULL — 휴대폰 번호, 본인 인증 및 PASS 연동용
  • 생년월일 (birth_date) — DATE — 생년월일, 법적 요건 및 신원 확인용
  • 계정 생성 (created_at) — DATETIME — 계정 생성 일시
  • 최근 정보 수정 일시 (updated_at) — DATETIME — 최근 정보 수정 일시
  • 계정 상태 (status) — ENUM('ACTIVE', 'WITHDRAWN', 'SUSPENDED') — 계정 상태
  • 최근 로그인 일시 (last_login_at) — DATETIME — 최근 로그인 일시
  • 최근 로그인 방법 (last_login_method) — ENUM('PASSWORD', 'PASSKEY', 'SOCIAL') — 최근 로그인 방식
  • Pass 인증 연동 여부 (pass_linked) — BOOLEAN — PASS 인증 연동 여부
  • MFA 사용 여부 (mfa_enabled) — BOOLEAN — MFA 사용 여부
  • 리프레시 토큰 (refresh_token) — VARCHAR(512) — JWT 리프레시 토큰(암호화 저장 권장)
  • 리프레시 토큰 만료일자 (refresh_token_expiry) — DATETIME — 리프레시 토큰 만료일