수정

테이블 (29)

BankAccount

  • account_id — BIGINT — 기본 키 — NOT NULL
  • user_key — VARCHAR(100) — NOT NULL
  • bank_code — VARCHAR(20) — NOT NULL
  • account_number — VARCHAR(30) — NOT NULL
  • account_name — VARCHAR(100) — NOT NULL
  • owner_name — VARCHAR(50) — NOT NULL
  • balance — DECIMAL(19, 2) — NOT NULL
  • status — VARCHAR(20) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

BankTransaction

  • transaction_id — BIGINT — 기본 키 — NOT NULL
  • transaction_key — VARCHAR(100) — NOT NULL
  • transaction_type — VARCHAR(20) — NOT NULL
  • amount — DECIMAL(19, 2) — NOT NULL
  • balance_after — DECIMAL(19, 2) — NOT NULL
  • counterparty_name — VARCHAR(50) — NOT NULL
  • counterparty_account_number — VARCHAR(30) — NOT NULL
  • memo — VARCHAR(100)
  • transaction_at — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • account_id — BIGINT — NOT NULL
  • transfer_id — BIGINT — NOT NULL

BankTransfer

  • transfer_id — BIGINT — 기본 키 — NOT NULL
  • request_key — VARCHAR(100) — NOT NULL
  • from_account_id — BIGINT — NOT NULL
  • to_account_id — BIGINT — NOT NULL
  • amount — DECIMAL(19, 2) — NOT NULL
  • sender_memo — VARCHAR(100)
  • receiver_memo — VARCHAR(100)
  • status — VARCHAR(20) — NOT NULL
  • failure_reason — VARCHAR(255)
  • completed_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • account_id2 — BIGINT — NOT NULL

LinkedBankAccount

  • linked_account_id — BIGINT — 기본 키 — NOT NULL — 연결 계좌 식별자
  • user_id — BIGINT — NOT NULL
  • account_alias — VARCHAR(50)
  • masked_account_number — VARCHAR(50) — NOT NULL — 마스킹 계좌번호
  • connection_status — ENUM('AVAILABLE', 'UNAVAILABLE')
  • account_holder_name — VARCHAR(50) — NOT NULL — 예금주 성명
  • created_at — DATETIME — 연동일시
  • updated_at — DATETIME — 수정일시

LoanTransaction

  • transaction_id — BIGINT — 기본 키 — NOT NULL — 거래 식별자
  • contract_id — BIGINT — NOT NULL
  • schedule_id — BIGINT — NOT NULL — 상환 스케줄 ID
  • transaction_type — VARCHAR(20) — 거래 유형
  • amount — DECIMAL(15, 2) — NOT NULL — 거래 금액
  • sender_name — VARCHAR(50) — NOT NULL — 송금인 성명
  • memo — VARCHAR(255) — 입금 메모
  • match_status — VARCHAR(20) — NOT NULL — 대사 상태
  • payment_status — VARCHAR(20) — 상환 처리 상태
  • transacted_at — DATETIME — NOT NULL — 실제 이체 일시
  • synced_at — DATETIME — 동기화 일시

Notification

  • notification_id — BIGINT — 기본 키 — NOT NULL — 알림 식별자
  • user_id — BIGINT — NOT NULL
  • contract_id — BIGINT — NOT NULL
  • target_user_id — BIGINT — NOT NULL — 수신 유저 ID
  • notification_type — VARCHAR(30) — NOT NULL — 알림 유형
  • channel — VARCHAR(20) — NOT NULL — 발송 채널
  • sent_status — VARCHAR(20) — NOT NULL — 발송 상태
  • sent_at — DATETIME — 발송일시

NotificationSetting

  • setting_id — BIGINT — 기본 키 — NOT NULL — 설정 식별자
  • user_id — BIGINT — NOT NULL
  • channel — VARCHAR(20) — NOT NULL — 발송 채널
  • enabled — BOOLEAN — 수신 동의 여부

PaymentEvidence

  • payment_evidence_id — BIGINT — 기본 키 — NOT NULL — 납부 증빙 식별자
  • user_id — BIGINT — NOT NULL
  • payment_record_id — BIGINT — NOT NULL — 납부 기록 식별자
  • file_url — VARCHAR(500) — 업로드된 증빙 파일 경로
  • file_name — VARCHAR(255) — 업로드된 원본 파일명
  • created_by — BIGINT — NOT NULL — 증빙을 등록한 회원 ID
  • created_at — DATETIME — NOT NULL — 증빙 등록 시각

PaymentObligation

  • obligation_id — BIGINT — 기본 키 — NOT NULL — 납부 의무 식별자
  • settlement_id — BIGINT — NOT NULL — 연결된 정산
  • participant_id — BIGINT — 확정된 참여자. 초대 수락 후 필수, 그 전엔 NULL 가능
  • invitation_id — BIGINT — 초대 식별자
  • shared_settlement_detail_id — BIGINT — NOT NULL — 공동정산 상세 식별자
  • expected_amount — DECIMAL(15, 2) — NOT NULL — 납부해야 할 금액
  • paid_amount — DECIMAL(15, 2) — NOT NULL — 실제 반영된 납부 금액 합계
  • remaining_amount — DECIMAL(15, 2) — NOT NULL — 예정 금액 - 납부 완료 금액
  • payment_status — ENUM('UNPAID', 'PARTIALLY_PAID', 'PAID') — NOT NULL — 납부 상태
  • due_status — ENUM('UPCOMING', 'DUE', 'OVERDUE') — NOT NULL — 기한 상태
  • review_status — ENUM('NORMAL', 'NEEDS_CHECK') — NOT NULL — 확인 상태
  • obligation_status — ENUM('ACTIVE', 'EXCLUDED', 'CANCELLED') — NOT NULL — 의무 상태

PaymentRecord

  • payment_record_id — BIGINT — 기본 키 — NOT NULL — 납부 기록 식별자
  • settlement_id — BIGINT — NOT NULL — 연결된 정산
  • obligation_id — BIGINT — NOT NULL — 납부 반영 대상
  • settlement_bank_transaction_id — BIGINT — 정산 은행 거래 ID
  • settlement_cycle_id — BIGINT — 정기정산 회차 (SettlementCycle FK, 외부 테이블, P2). 공동정산 P0에서는 미사용
  • amount — DECIMAL(15, 2) — NOT NULL — 납부로 인정된 금액
  • source_type — ENUM('AUTO_MATCH', 'MANUAL') — NOT NULL — 반영 출처
  • recorded_at — DATETIME — NOT NULL — 납부 기록 생성 시각
  • settlement_cycle_id2 — BIGINT — NOT NULL — 정산 회차 식별자

RecurringDetail

  • recurring_detail_id — BIGINT — 기본 키 — NOT NULL — 정기정산 상세 식별자
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • payer_id — BIGINT — NOT NULL
  • cycle_amount — DECIMAL(15, 2) — NOT NULL — 매 회차 납부해야 할 금액
  • cycle_rule — VARCHAR(50) — NOT NULL — 월간/주간 등 반복 기준
  • start_date — DATE — NOT NULL — 정기정산 시작일
  • end_date — DATE — 정기정산 종료일

RepaymentSchedule

  • schedule_id — BIGINT — 기본 키 — NOT NULL — 상환 스케줄 ID
  • contract_id — BIGINT — NOT NULL
  • sequence — INT — NOT NULL — 상환 회차
  • due_date — DATE — NOT NULL — 예정 지급일
  • principal_due — DECIMAL(15, 2) — NOT NULL — 예정 원금
  • interest_due — DECIMAL(15, 2) — NOT NULL — 예정 일할 이자
  • total_payment_due — DECIMAL(15, 2) — NOT NULL — 총 예정 상환액
  • remaining_principal — DECIMAL(15, 2) — NOT NULL — 상환 후 잔여 원금
  • status — VARCHAR(20) — NOT NULL — 상환 상태
  • paid_at — DATETIME — 완납 처리 일시
  • created_at — DATETIME — 생성일시

Settlement

  • settlement_id — BIGINT — 기본 키 — NOT NULL — 정산 식별자
  • owner_id — BIGINT — NOT NULL
  • settlement_type — ENUM('SHARED', 'RECURRING') — NOT NULL — 정산 유형
  • settlement_status — ENUM('DRAFT', 'IN_PROGRESS', 'CLOSED', 'CANCELLED') — NOT NULL — 정산 상태
  • settlement_category — VARCHAR(50) — 정산 성격(여행/회식/생활비 등). 조건부 선택: 분류/검색 필요 시 사용
  • title — VARCHAR(200) — NOT NULL — 정산명
  • created_at — DATETIME — NOT NULL — 정산 생성 시각
  • closed_at — DATETIME — 완료 시각. settlement_status=CLOSED 시점에만 기록

SettlementAccount

  • settlement_account_id — BIGINT — 기본 키 — NOT NULL — 정산 계좌 설정 ID
  • linked_account_id — BIGINT — NOT NULL — 연결 계좌 식별자
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • account_status — ENUM('ACTIVE', 'REPLACED', 'DISABLED') — NOT NULL — ACTIVE / CHANGED / DISABLED
  • selected_at — DATETIME — NOT NULL — 정산 계좌 선택일시
  • ended_at — DATETIME — 계좌 변경일시

SettlementBankTransaction

  • settlement_bank_transaction_id — BIGINT — 기본 키 — NOT NULL — 정산 은행 거래 ID
  • settlement_account_id — BIGINT — NOT NULL — 정산 계좌 설정 ID
  • external_transaction_id — VARCHAR(100) — NOT NULL — Mock은행 거래 식별자
  • counterparty_name — VARCHAR(50)
  • amount — DECIMAL(15, 2) — NOT NULL — 거래 금액
  • transaction_type — VARCHAR(20) — NOT NULL — DEPOSIT / WITHDRAWAL
  • transaction_processing_status — VARCHAR(30) — NOT NULL — UNPROCESSED / UNMATCHED / MATCHED / IGNORED / PROCESSING_FAILED
  • transaction_at — DATETIME — NOT NULL — 은행 거래 발생일시

SettlementConsent

  • consent_id — BIGINT — 기본 키 — NOT NULL — 동의/응답 기록 식별자
  • settlement_id — BIGINT — NOT NULL — 연결된 정산
  • invitation_id — BIGINT — NOT NULL — 응답 대상 초대
  • participant_id — BIGINT — 수락 시 확정된 참여자. decision_type=ACCEPTED일 때 필수
  • verified_user_id — BIGINT — NOT NULL
  • decision_type — ENUM('ACCEPTED', 'REJECTED', 'MOD_REQUESTED') — NOT NULL — 응답 유형
  • agreement_version — VARCHAR(50) — 동의 시점 약관/문구 버전. ACCEPTED 시 필수
  • consented_at — DATETIME — NOT NULL — 응답 처리 시각(서버 수신 시각 기준)
  • ip_address — VARCHAR(45) — 요청 발신 IP. ACCEPTED 시 필수
  • device_info — VARCHAR(255) — User-Agent 등 클라이언트 식별 정보
  • modification_note — VARCHAR(500) — 수정요청 사유. MOD_REQUESTED 시 필수

SettlementCycle

  • settlement_cycle_id — BIGINT — 기본 키 — NOT NULL — 정산 회차 식별자
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • recurring_detail_id — BIGINT — NOT NULL — 정기정산 상세 식별자
  • cycle_no — INT — NOT NULL — 회차 번호
  • expected_amount — DECIMAL(15, 2) — NOT NULL — 해당 회차의 납부 예정 금액
  • paid_amount — DECIMAL(15, 2) — NOT NULL — 해당 회차에 반영된 납부 금액
  • remaining_amount — DECIMAL(15, 2) — NOT NULL — 예정 금액에서 납부 금액을 뺀 금액
  • payment_status — ENUM('UNPAID', 'PARTIALLY_PAID', 'PAID') — NOT NULL — 회차 납부 상태
  • due_status — ENUM('UPCOMING', 'DUE', 'OVERDUE') — NOT NULL — 회차 기한 상태
  • due_date — DATE — NOT NULL — 해당 회차의 납부 마감일

SettlementHistory

  • settlement_history_id — BIGINT — 기본 키 — NOT NULL — 정산 이력 ID
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • actor_type — VARCHAR(20) — NOT NULL — USER / ADMIN / SYSTEM
  • actor_id — BIGINT — 실행자 ID. SYSTEM이면 NULL 가능
  • action_type — VARCHAR(30) — NOT NULL — CREATED / UPDATED / PAYMENT_APPLIED / CLOSED / CANCELLED
  • created_at — DATETIME — NOT NULL — 이력 생성일시

SettlementInvitation

  • invitation_id — BIGINT — 기본 키 — NOT NULL — 초대 식별자
  • inviter_id — BIGINT — NOT NULL
  • settlement_id — BIGINT — NOT NULL — 초대 대상 정산
  • invited_email — VARCHAR(255) — 초대받은 이메일. 조건부 선택: 이메일 초대에서만 사용
  • invitation_status — ENUM('INVITED', 'ACCEPTED', 'REJECTED', 'EXPIRED')
  • invitation_token — VARCHAR(255) — NOT NULL — 카카오톡/링크 초대 진입용 토큰
  • invited_at — DATETIME — NOT NULL — 초대 발송 시각
  • accepted_at — DATETIME — 수락 시각. invitation_status=ACCEPTED 시점에만 기록

SettlementLedger

  • settlement_ledger_id — BIGINT — 기본 키 — NOT NULL — 정산 원장 ID
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • total_expected_amount — DECIMAL(15, 2) — NOT NULL — 완료 시점 전체 예정 금액
  • total_paid_amount — DECIMAL(15, 2) — NOT NULL — 완료 시점 전체 납부 금액
  • closed_at — DATETIME — NOT NULL — 원장 생성일시

SettlementParticipant

  • participant_id — BIGINT — 기본 키 — NOT NULL — 정산 참여자 식별자
  • user_id — BIGINT — NOT NULL
  • participant_role — ENUM('OWNER', 'MEMBER') — NOT NULL — 참여자 역할
  • participant_status — ENUM('ACTIVE', 'LEFT', 'REMOVED') — NOT NULL — 참여 상태
  • joined_at — DATETIME — NOT NULL — 정산 참여 시각
  • settlement_id — BIGINT — NOT NULL — 정산 식별자

SharedSettlementDetail

  • shared_settlement_detail_id — BIGINT — 기본 키 — NOT NULL — 공동정산 상세 식별자
  • settlement_id — BIGINT — NOT NULL — 정산 식별자
  • total_expected_amount — DECIMAL(15, 2) — NOT NULL — 공동정산 전체 금액
  • split_type — ENUM('EQUAL', 'CUSTOM') — NOT NULL — 분배 방식
  • due_date — DATE — 납부 기한. 조건부 선택: 기한 기반 미납/연체 판단 필요 시 사용

TransactionMatch

  • transaction_match_id — BIGINT — 기본 키 — NOT NULL — 거래 매칭 ID
  • obligation_id — BIGINT — NOT NULL — 납부 의무 식별자
  • settlement_bank_transaction_id — BIGINT — NOT NULL — 정산 은행 거래 ID
  • match_status — ENUM('CONFIRMED', 'REJECTED') — NOT NULL — CONFIRMED / REJECTED
  • matched_amount — DECIMAL(15, 2) — NOT NULL — 매칭 금액
  • matched_at — DATETIME — NOT NULL — 매칭 처리일시

User

  • user_id — BIGINT — 기본 키 — NOT NULL
  • email — VARCHAR(50)
  • password — VARCHAR(50)
  • created_at — DATETIME
  • updated_at — DATETIME

loan_contract

  • contract_id — BIGINT — 기본 키 — NOT NULL
  • principal_amount — DECIMAL(15, 2) — NOT NULL — 대출 원금
  • interest_rate — DECIMAL(5, 2) — NOT NULL — 연 이자율 (%)
  • repayment_type — VARCHAR(20) — NOT NULL — 상환 방식
  • start_date — DATE — NOT NULL — 대출 시작일
  • maturity_date — DATE — NOT NULL — 만기일
  • repayment_day — INT — NOT NULL — 매월 상환일 (1~31)
  • status — VARCHAR(20) — NOT NULL — 계약 상태
  • birth_date — DATETIME
  • address — VARCHAR(255) — 계약서 표기 주소
  • phone — VARCHAR(20) — 계약서 표기 연락처
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

loan_contract_change_request

  • change_request_id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — NOT NULL
  • change_reason — TEXT — NOT NULL — 변경사유
  • new_maturity_date — DATE — 변경 만기일
  • new_interest_rate — DECIMAL(5, 2) — 변경 연이자율
  • new_repayment_type — VARCHAR(20) — 변경 상환방식
  • status — VARCHAR(20) — NOT NULL — 요청상태
  • reject_reason — VARCHAR(255)
  • created_at — DATETIME
  • processed_at — DATETIME

loan_contract_file

  • file_id — BIGINT — 기본 키 — NOT NULL — 파일ID
  • contract_id — BIGINT — NOT NULL
  • original_filename — VARCHAR(255) — NOT NULL — 원본 파일명
  • saved_filename — VARCHAR(255) — NOT NULL — 저장 파일명
  • file_size — BIGINT — NOT NULL — 파일 크기
  • file_type — VARCHAR(50) — NOT NULL — 파일 타입
  • uploaded_by — BIGINT — NOT NULL — 업로드 회원ID
  • created_at — DATETIME — NOT NULL — 업로드 일시

loan_contract_history

  • history_id — BIGINT — 기본 키 — NOT NULL
  • contract_id — BIGINT — NOT NULL
  • before_status — VARCHAR(20) — NOT NULL
  • after_status — VARCHAR(20) — NOT NULL
  • created_at — DATETIME — NOT NULL

loan_participant

  • loanparticipant_id — BIGINT — 기본 키 — NOT NULL — 참여자ID
  • user_id — BIGINT — NOT NULL
  • contract_id — BIGINT — NOT NULL
  • loanparticipant_role — VARCHAR(20) — NOT NULL — 참여역할
  • created_at — DATETIME — NOT NULL — 참여일