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 · 여행 식별자
  • =사용자 — 계정(현 배포는 무인증 — 로그인 후속