1
Tables (26)
BankAccount
- account_id — BIGINT — Primary key — 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 — Primary key — 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 — Primary key — 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 — Primary key — NOT NULL — 연결 계좌 식별자
- user_id — BIGINT — NOT NULL — 회원 식별자
- bank_user_id — VARCHAR(100) — 은행 사용자 ID
- masked_account_number — VARCHAR(50) — NOT NULL — 마스킹 계좌번호
- account_holder_name — VARCHAR(50) — NOT NULL — 예금주 성명
- external_account_id — VARCHAR(100) — NOT NULL — 외부/Mock 계좌 ID
- connection_status — VARCHAR(20) — NOT NULL — 연결 상태
- created_at — DATETIME — 연동일시
- updated_at — DATETIME — 수정일시
Payment_obligation
- obligation_id — BIGINT — Primary key — NOT NULL — 납부 의무 식별자
- settlement_id — BIGINT — NOT NULL — 연결된 정산
- participant_id — BIGINT — 확정된 참여자. 초대 수락 후 필수, 그 전엔 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 — 의무 상태
- invitation_id — BIGINT — NOT NULL — 초대 식별자
Payment_record
- payment_record_id — BIGINT — Primary key — NOT NULL — 납부 기록 식별자
- settlement_id — BIGINT — NOT NULL — 연결된 정산
- obligation_id — BIGINT — NOT NULL — 납부 반영 대상
- settlement_bank_transaction_id — BIGINT — 연결된 은행 거래 (BankTransaction FK, 외부 테이블). 자동매칭 시 필수, 수동완납 시 NULL 가능
- 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 — 납부 기록 생성 시각
RepaymentSchedule
- schedule_id — BIGINT — Primary key — NOT NULL — 상환 스케줄 ID
- contract_id2 — BIGINT — Foreign key → loan_contract.contract_id — NOT NULL
- 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 — Primary key — NOT NULL — 정산 식별자
- owner_id — BIGINT — NOT NULL — 정산을 생성한 회원 (User FK, 외부 테이블)
- 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 시점에만 기록
Settlement_consent
- consent_id — BIGINT — Primary key — NOT NULL — 동의/응답 기록 식별자
- settlement_id — BIGINT — NOT NULL — 연결된 정산
- invitation_id — BIGINT — NOT NULL — 응답 대상 초대
- participant_id — BIGINT — 수락 시 확정된 참여자. decision_type=ACCEPTED일 때 필수
- decision_type — ENUM('ACCEPTED', 'REJECTED', 'MOD_REQUESTED') — NOT NULL — 응답 유형
- verified_user_id — BIGINT — NOT NULL — 응답을 실제 수행한 회원 (User FK, 외부 테이블)
- 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 시 필수
Settlement_invitation
- invitation_id — BIGINT — Primary key — NOT NULL — 초대 식별자
- settlement_id — BIGINT — NOT NULL — 초대 대상 정산
- invited_email — VARCHAR(255) — 초대받은 이메일. 조건부 선택: 이메일 초대에서만 사용
- invitation_token — VARCHAR(255) — NOT NULL — 카카오톡/링크 초대 진입용 토큰
- invitation_status — ENUM('INVITED', 'ACCEPTED', 'REJECTED', 'EXPIRED') — NOT NULL — 초대 상태
- invited_at — DATETIME — NOT NULL — 초대 발송 시각
- accepted_at — DATETIME — 수락 시각. invitation_status=ACCEPTED 시점에만 기록
Settlement_participant
- participant_id — BIGINT — Primary key — NOT NULL — 정산 참여자 식별자
- settlement_id — BIGINT — NOT NULL — 참여 중인 정산
- user_id — BIGINT — NOT NULL — 참여 회원 (User FK, 외부 테이블)
- participant_role — ENUM('OWNER', 'MEMBER') — NOT NULL — 참여자 역할
- participant_status — ENUM('ACTIVE', 'LEFT', 'REMOVED') — NOT NULL — 참여 상태
- joined_at — DATETIME — NOT NULL — 정산 참여 시각
Shared_settlement_detail
- shared_settlement_detail_id — BIGINT — Primary key — 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 — 납부 기한. 조건부 선택: 기한 기반 미납/연체 판단 필요 시 사용
User
- user_id — BIGINT — Primary key — NOT NULL
- email — VARCHAR(50)
- nickname — VARCHAR(50)
- password — VARCHAR(50)
- created_at — DATETIME
- updated_at — DATETIME
bank_connection
- bank_connection_id — BIGINT — Primary key — NOT NULL — 은행 연결 상태 ID
- linked_bank_account_id — BIGINT — NOT NULL — 연결 계좌 ID
- connection_status — VARCHAR(30) — NOT NULL — AVAILABLE / REAUTH_REQUIRED / ACCOUNT_UNAVAILABLE
- last_checked_at — DATETIME — NOT NULL — 마지막 계좌 상태 확인일시
bank_sync_cursor
- bank_sync_cursor_id — BIGINT — Primary key — NOT NULL — 동기화 커서 ID
- settlement_account_id — BIGINT — NOT NULL — 정산 계좌 설정 ID
- last_synced_transaction_key — VARCHAR(100) — NOT NULL — 마지막 동기화 거래키
- last_synced_at — DATETIME — NOT NULL — 마지막 동기화 시각
linked_bank_account
- linked_bank_account_id — BIGINT — Primary key — NOT NULL — 연결 계좌 ID
- user_id — BIGINT — NOT NULL — 계좌를 연결한 회원 ID
- bank_account_id — BIGINT — NOT NULL — Mock은행 BankAccount 식별자
- account_alias — VARCHAR(50) — 계좌 별칭
- linked_at — DATETIME — NOT NULL — 계좌 연결일시
loan_contract
- contract_id — BIGINT — Primary key — 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 — 계약 상태
- address — VARCHAR(255) — 계약서 표기 주소
- phone — VARCHAR(20) — 계약서 표기 연락처
- created_at — DATETIME — NOT NULL
- updated_at — DATETIME — NOT NULL
loan_contract_change_request
- change_request_id — BIGINT — Primary key — NOT NULL
- contract_id — BIGINT — Foreign key → loan_contract.contract_id — NOT NULL
- requester_id — BIGINT — NOT NULL — 요청자 회원ID
- 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 — Primary key — NOT NULL — 파일ID
- contract_id — BIGINT — Foreign key → loan_contract.contract_id — 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_signature
- signature_id — BIGINT — Primary key — NOT NULL — 서명ID
- loanparticipant_id — BIGINT — Foreign key → loan_participant.loanparticipant_id — NOT NULL — 참여자ID
- user_id — BIGINT — Foreign key → loan_participant.user_id — NOT NULL
- contract_id — BIGINT — Foreign key → loan_participant.contract_id — NOT NULL
- signature_file — VARCHAR(255) — NOT NULL — 서명파일
- signed_at — DATETIME — NOT NULL — 서명일시
loan_participant
- loanparticipant_id — BIGINT — Primary key — NOT NULL — 참여자ID
- user_id — BIGINT — Foreign key → User.user_id — NOT NULL
- contract_id — BIGINT — Foreign key → loan_contract.contract_id — NOT NULL
- loanparticipant_role — VARCHAR(20) — NOT NULL — 참여역할
- created_at — DATETIME — NOT NULL — 참여일
settlement_account
- settlement_account_id — BIGINT — Primary key — NOT NULL — 정산 계좌 설정 ID
- settlement_id — BIGINT — NOT NULL — 정산 ID
- linked_bank_account_id — BIGINT — NOT NULL — 연결 계좌 ID
- account_status — VARCHAR(20) — NOT NULL — ACTIVE / CHANGED / DISABLED
- selected_at — DATETIME — NOT NULL — 정산 계좌 선택일시
- changed_at — DATETIME — 계좌 변경일시
settlement_bank_transaction
- settlement_bank_transaction_id — BIGINT — Primary key — NOT NULL — 정산 은행 거래 ID
- settlement_account_id — BIGINT — NOT NULL — 정산 계좌 설정 ID
- external_transaction_id — VARCHAR(100) — NOT NULL — Mock은행 거래 식별자
- 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 — 은행 거래 발생일시
settlement_history
- settlement_history_id — BIGINT — Primary key — NOT NULL — 정산 이력 ID
- settlement_id — BIGINT — NOT NULL — 정산 ID
- 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 — 이력 생성일시
settlement_ledger
- settlement_ledger_id — BIGINT — Primary key — NOT NULL — 정산 원장 ID
- settlement_id — BIGINT — NOT NULL — 정산 ID
- total_expected_amount — DECIMAL(15, 2) — NOT NULL — 완료 시점 전체 예정 금액
- total_paid_amount — DECIMAL(15, 2) — NOT NULL — 완료 시점 전체 납부 금액
- closed_at — DATETIME — NOT NULL — 원장 생성일시
transaction_match
- transaction_match_id — BIGINT — Primary key — NOT NULL — 거래 매칭 ID
- settlement_bank_transaction_id — BIGINT — NOT NULL — 정산 은행 거래 ID
- obligation_id — BIGINT — NOT NULL — 납부 의무 ID
- match_status — VARCHAR(20) — NOT NULL — CONFIRMED / REJECTED
- matched_amount — DECIMAL(15, 2) — NOT NULL — 매칭 금액
- matched_at — DATETIME — NOT NULL — 매칭 처리일시