trip
Tables (11)
ai_summaries
- ai_summary_id — BIGINT — Primary key — NOT NULL — PK · 정산 실행 식별자
- change_request_id — BIGINT — Foreign key → change_requests.change_request_id — NOT NULL — 대상 여행 FK
- summary_text — TEXT — 여행 내 정산 실행 순번 (단조 증가)
- impacted_members — JSON — 현재 정산본 여부: TRUE=현재 / NULL=과거 (여행당 TRUE 1건)
- estimated_correction_amount — DECIMAL(18, 2) — 재계산을 유발한 변경 기록 FK (nullable)
- recommended_action — VARCHAR(255) — 계산 일시
- created_at — DATETIME — NOT NULL — PK · 멤버 순액 식별자
- ) — COMMENT — 정산 실행 FK
- =AI — 변경영향
change_requests
- change_request_id — BIGINT — Primary key — NOT NULL — 변경 후 값 (amount_adjust=새 금액 / date_change=새 날짜)
- transaction_id — BIGINT — Foreign key → transactions.transaction_id — NOT NULL — 변경 사유
- requester_member_id — BIGINT — Foreign key → trip_members.trip_member_id — NOT NULL — 상태: applied(즉시 적용) / voided(되돌림) · 승인 절차 없음
- type — VARCHAR(20) — NOT NULL — 변경 시각 (audit: 언제)
- target_member_id — BIGINT — Foreign key → trip_members.trip_member_id — PK · 거래정정 식별자
- new_value — VARCHAR(255) — 대상 거래 FK (= 대상 부담의 거래)
- reason — VARCHAR(500) — 연계 변경 기록 FK (즉시 적용, 승인 불필요)
- status — VARCHAR(20) — NOT NULL — 감액 대상 부담(share) FK
- requested_at — DATETIME — NOT NULL — 정정액 (기준통화)
- =변경 — 기록(즉시 적용·승인 없음 · 변경자/시각 audit
member_nets
- member_net_id — BIGINT — Primary key — NOT NULL — 받는 멤버(채권자) FK
- run_id — BIGINT — Foreign key → settlement_runs.run_id — NOT NULL — 송금액 (기준통화)
- trip_member_id — BIGINT — Foreign key → trip_members.trip_member_id — NOT NULL — 송금 상태: pending / done(완료)
- paid_amount — DECIMAL(18, 2) — NOT NULL
settlement_runs
- run_id — BIGINT — Primary key — NOT NULL — 멤버 FK (비게스트만 생성)
- trip_id — BIGINT — Foreign key → trips.trip_id — NOT NULL — 총 결제액 (환불 반영, 기준통화)
- seq_no — INT — NOT NULL — 총 부담액 (환불 반영, 기준통화)
- is_current — BOOLEAN — 순액 = paid − owed (양수=받을, 음수=보낼)
- triggered_by_change_request_id — BIGINT — Foreign key → change_requests.change_request_id — PK · 송금 정산 식별자
- calculated_at — DATETIME — NOT NULL — 정산 실행 FK
- =정산 — 실행
settlements
- settlement_id — BIGINT — Primary key — NOT NULL
transaction_corrections
- correction_id — BIGINT — Primary key — NOT NULL — 상태: registered(등록) / voided(무효)
- transaction_id — BIGINT — Foreign key → transactions.transaction_id — NOT NULL — 처리 일시
- change_request_id — BIGINT — Foreign key → change_requests.change_request_id — NOT NULL — PK · AI 요약 식별자
- target_share_id — BIGINT — Foreign key → transaction_shares.share_id — NOT NULL — 대상 변경 기록 FK (변경당 0..1)
- correction_amount — DECIMAL(18, 2) — NOT NULL — AI 변경영향 요약문
- correction_rate — DECIMAL(18, 6) — NOT NULL — 영향받는 멤버 목록 (JSON)
- status — VARCHAR(20) — NOT NULL — 예상 정정액 (추정치)
- processed_at — DATETIME — NOT NULL — 권장 조치
transaction_shares
- share_id — BIGINT — Primary key — NOT NULL — 잔차(반올림 차액) 귀속자 여부
- transaction_id — BIGINT — Foreign key → transactions.transaction_id — NOT NULL — PK · 변경 기록 식별자
- trip_member_id — BIGINT — Foreign key → trip_members.trip_member_id — NOT NULL — 변경 대상 거래 FK
- share_amount — DECIMAL(18, 2) — NOT NULL — 변경한 멤버 FK (audit: 누가)
- residual_holder — BOOLEAN — NOT NULL — 변경 유형: member_cancel(인원취소)/date_change(날짜변경)/full_cancel(전체취소)/amount_adjust(금액정정)
- =거래별 — 멤버
transactions
- transaction_id — BIGINT — Primary key — NOT NULL — 분류: stay/flight/tour/transport/food/ticket/etc
- trip_id — BIGINT — Foreign key → trips.trip_id — NOT NULL — 거래 제목
- type — VARCHAR(20) — NOT NULL — 실결제자(돈 낸 사람) 멤버 FK
- category — VARCHAR(30) — 결제 통화 (ISO 4217)
- title — VARCHAR(200) — NOT NULL — 결제 통화 기준 결제 금액
- payer_member_id — BIGINT — Foreign key → trip_members.trip_member_id — NOT NULL — 동결 환율: 결제통화 1단위당 기준통화 (자국통화=1.0)
- payment_currency — CHAR(3) — NOT NULL — 기준통화 환산 동결액 = round_half_up(payment_amount × payment_rate)
- payment_amount — DECIMAL(18, 2) — NOT NULL — 환율 출처: manual(수동) / auto
- payment_rate — DECIMAL(18, 6) — NOT NULL — 부담 범위: shared(공용 균등) / personal(개인 단독)
- base_amount — DECIMAL(18, 2) — NOT NULL — 환불 정책 (예약만 해당, nullable)
- rate_source — VARCHAR(10) — NOT NULL — 거래 상태: active / amended(변경됨) / refunded(전액환불) / voided(무효·소프트삭제)
- scope — VARCHAR(10) — NOT NULL — 생성 일시
- refund_policy — VARCHAR(255) — 수정 일시
- status — VARCHAR(20) — NOT NULL — PK · 부담 식별자
- created_at — DATETIME — NOT NULL — 대상 거래 FK
- updated_at — DATETIME — NOT NULL — 부담 멤버 FK (이 거래를 부담하는 사람)
- =거래(예약/비용 — 통합
trip_members
- trip_member_id — BIGINT — Primary key — NOT NULL — 연결 계정 FK · 게스트/무인증이면 NULL
- trip_id — BIGINT — Foreign key → trips.trip_id — NOT NULL — 표시 이름
- user_id — BIGINT — Foreign key → users.user_id — 역할: owner(총무) / member(참여자) / guest(게스트)
- display_name — VARCHAR(100) — NOT NULL — 게스트 여부 (role=guest 와 일치)
- role — VARCHAR(20) — NOT NULL — 멤버 상태: active / left(탈퇴 — 이력 보존)
- is_guest — BOOLEAN — NOT NULL — 참여 일시
- status — VARCHAR(20) — NOT NULL — PK · 거래 식별자
- joined_at — DATETIME — NOT NULL — 소속 여행 FK
- =여행 — 멤버(총무/참여자/게스트
trips
- trip_id — BIGINT — Primary key — NOT NULL — 총무(생성자) 계정 FK · 무인증 단독운영이라 nullable
- owner_user_id — BIGINT — Foreign key → users.user_id — 여행명
- title — VARCHAR(200) — NOT NULL — 여행 국가
- country — VARCHAR(100) — 정산 기준 통화 (ISO 4217, 예: KRW)
- base_currency — CHAR(3) — NOT NULL — 여행 시작일 (표시용)
- start_date — DATE — 여행 종료일 (표시용)
- end_date — DATE — 여행 상태: active(진행) / closed(마감=정산 마감·읽기전용)
- status — VARCHAR(20) — NOT NULL — 편집 권한: owner_only(총무만) / all(전원)
- edit_permission — VARCHAR(16) — NOT NULL — 여행 생성 일시
- created_at — DATETIME — NOT NULL — PK · 여행 멤버 식별자
- =여행 — 단위(기준통화·상태·편집권한
users
- user_id — BIGINT — Primary key — NOT NULL — PK · 사용자(계정) 식별자
- email — VARCHAR(255) — NOT NULL — 로그인 이메일(고유) — 인증 후속
- name — VARCHAR(100) — NOT NULL — 사용자 이름
- created_at — DATETIME — NOT NULL — 계정 생성 일시' ) COMMENT 'PK · 여행 식별자
- =사용자 — 계정(현 배포는 무인증 — 로그인 후속