22

Tables (11)

boarding_events

  • event_id — BIGINT — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • bus_id — BIGINT — Foreign key → buses.bus_id — NOT NULL
  • board_station_id — BIGINT — Foreign key → stations.station_id
  • alight_station_id — BIGINT — Foreign key → stations.station_id
  • board_idempotency_key — VARCHAR(36) — NOT NULL — 탑승 멱등성 키
  • alight_idempotency_key — VARCHAR(36) — 하차 멱등성 키
  • status — VARCHAR(20) — NOT NULL — HOLDING / CONFIRMED / CANCELLED / TIMEOUT
  • payment_method — VARCHAR(20) — PREPAY / POSTPAY
  • held_amount — DECIMAL(8, 2) — 홀드 금액 (차감 아님)
  • final_amount — DECIMAL(8, 2) — 최종 차감 요금
  • rssi_mean — DECIMAL(6, 2) — ML 특징점
  • rssi_std_dev — DECIMAL(6, 2) — ML 특징점
  • rssi_beacon_balance — DECIMAL(6, 2) — ML 특징점
  • imu_accel_max — DECIMAL(6, 3) — ML 특징점
  • imu_gyro_variance — DECIMAL(8, 5) — ML 특징점
  • ml_confidence — DECIMAL(4, 3) — ML 신뢰도
  • boarded_at — DATETIME — NOT NULL — 탑승 확정 시각
  • alighted_at — DATETIME — 하차 확정 시각
  • timeout_at — DATETIME — NOT NULL — HOLDING 만료 기한
  • device_time — DATETIME — NOT NULL — 앱 기기 시각
  • created_at — DATETIME

buses

  • bus_id — BIGINT — NOT NULL — 버스 고유 ID
  • operator_id — INT — NOT NULL — 운수회사 ID
  • route_number — VARCHAR(20) — NOT NULL — 노선 번호 (예: 147)
  • beacon_uuid — VARCHAR(36) — NOT NULL — 비콘 UUID
  • beacon_major — INT — NOT NULL — 비콘 Major
  • beacon_minor — INT — NOT NULL — 비콘 Minor
  • tx_power — INT — NOT NULL — 비콘 신호 강도 기준값
  • status — VARCHAR(20) — ACTIVE / INACTIVE
  • created_at — DATETIME

charge_history

  • charge_id — BIGINT — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • idempotency_key — VARCHAR(36) — NOT NULL — 충전 멱등성 키
  • amount — DECIMAL(8, 2) — NOT NULL
  • status — VARCHAR(20) — NOT NULL — COMPLETED / FAILED / SAGA_COMPENSATED
  • pg_transaction_id — VARCHAR(255) — PG 승인 번호
  • created_at — DATETIME

fare_table

  • route_number — VARCHAR(20) — Primary key — NOT NULL — 노선 번호
  • board_seq — INT — Primary key — NOT NULL — 승차 정류장 순번
  • alight_seq — INT — Primary key — NOT NULL — 하차 정류장 순번
  • fare — DECIMAL(8, 2) — NOT NULL — 실질 요금
  • max_fare — DECIMAL(8, 2) — NOT NULL — 노선 최대 요금

outbox

  • id — BIGINT — NOT NULL
  • topic — VARCHAR(100) — NOT NULL — Kafka 토픽
  • payload — JSON — NOT NULL — 메시지 바디
  • created_at — DATETIME
  • published_at — DATETIME — NULL = 미발행

payments

  • payment_id — BIGINT — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • event_id — BIGINT — Foreign key → boarding_events.event_id — 1:0..1 관계
  • idempotency_key — VARCHAR(36) — NOT NULL — 정산 멱등성 키
  • payment_type — VARCHAR(20) — NOT NULL — DEDUCT / CHARGE / AUTO_CHARGE / REFUND
  • amount — DECIMAL(8, 2) — NOT NULL
  • post_balance — DECIMAL(10, 2) — NOT NULL — 정산 후 잔액 (Audit Trail)
  • processed_at — DATETIME

processed_messages

  • message_id — VARCHAR(255) — NOT NULL — Kafka 중복 방지
  • processed_at — DATETIME

sensor_logs

  • log_id — BIGINT — Primary key — NOT NULL
  • logged_at — DATETIME — Primary key — NOT NULL
  • user_id — BIGINT
  • bus_id — BIGINT
  • rssi_series — JSON — Raw RSSI 배열 (ML 학습용)
  • imu_series — JSON — Raw IMU 배열 (ML 학습용)
  • behavior — VARCHAR(20)
  • ml_confidence — DECIMAL(4, 3)
  • PARTITION — p2026_06
  • PARTITION — pMAX

stations

  • station_id — BIGINT — NOT NULL — 정류장 고유 ID
  • station_name — VARCHAR(100) — NOT NULL — 정류장 이름
  • route_number — VARCHAR(20) — NOT NULL — 노선 번호
  • seq_no — INT — NOT NULL — 노선 내 정류장 순번
  • latitude — DECIMAL(10, 7) — NOT NULL — 위도
  • longitude — DECIMAL(10, 7) — NOT NULL — 경도
  • created_at — DATETIME

user_cards

  • card_id — BIGINT — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • billing_key — VARCHAR(255) — NOT NULL — PG사 빌링키
  • card_company — VARCHAR(50) — NOT NULL — 카드사
  • masked_card_number — VARCHAR(20) — NOT NULL — 마스킹 카드번호
  • auto_charge_enabled — BOOLEAN — 자동충전 활성화
  • auto_charge_threshold — DECIMAL(8, 2) — 자동충전 트리거 잔액
  • auto_charge_amount — DECIMAL(8, 2) — 자동충전 금액
  • created_at — DATETIME

users

  • user_id — BIGINT — NOT NULL — 사용자 고유 ID
  • phone_number — VARCHAR(20) — NOT NULL — 휴대폰 번호
  • device_token — VARCHAR(255) — 푸시 알림 토큰 (FCM/APNs)
  • balance — DECIMAL(10, 2) — 선불 지갑 잔액
  • postpay_amount — DECIMAL(8, 2) — 후불 미납 금액
  • status — VARCHAR(20) — ACTIVE / SUSPENDED
  • version — INT — NOT NULL — Optimistic Lock 버전
  • created_at — DATETIME