사스푸시

테이블 (17)

tb_billing

  • billing_id — BIGINT — 기본 키 — NOT NULL — NOT_ISSUED → ISSUED(매월 10일 발행) → PAID(후불 입금 확인)
  • group_id — BIGINT — NOT NULL — 세금계산서 번호
  • billing_period_from — DATE — NOT NULL — 세부내역서 Excel S3 키. 비동기 생성 — 생성 전 NULL
  • billing_period_to — DATE — NOT NULL — Excel 생성 완료 시점
  • status — VARCHAR(20) — NOT NULL — FINALIZED 시점. OPEN 상태에선 NULL
  • plan_code_snap — VARCHAR(20) — 생성일시 (KST)
  • subtotal — INT — NOT NULL — billing_line 식별자
  • vat_amount — INT — NOT NULL — billing.billing_id FK
  • total_amount — INT — NOT NULL — 그룹 식별자 (group 단위 쿼리 최적화)
  • payment_method_snap — VARCHAR(20) — NOT NULL — BASE_FEE(plan 결제) / CREDIT_CHARGE(크레딧 충전 결제)
  • paid_at — DATETIME — UPGRADE / RENEWAL / CREDIT
  • invoice_status — VARCHAR(20) — NOT NULL — BASE_FEE 라인의 plan 식별. CREDIT_CHARGE는 NULL
  • invoice_number — VARCHAR(50) — CREDIT_CHARGE 라인의 패키지 FK. BASE_FEE는 NULL
  • invoice_issued_at — DATETIME — CREDIT_CHARGE 라인 ↔ message_credit 충전 row 1:1 매핑. BASE_FEE는 NULL
  • excel_s3_key — VARCHAR(255) — 청구서 출력용 설명
  • excel_generated_at — DATETIME — 결제 금액(원). 정액 결제 1건 — 단가×수량 아님
  • finalized_at — DATETIME — PG 거래 ID — 라인 1건 = 결제 1건. 결제 이력 추적
  • created_at — DATETIME — NOT NULL — 발생(결제) 시점. usage_from = DATE(occurred_at), usage_to는 조회 시 계산

tb_billing_config

  • config_key — VARCHAR(50) — 기본 키 — NOT NULL — 설정 키 (예: DEFAULT_APP_COUNT, DEFAULT_USER_COUNT, TRIAL_DAYS)
  • config_value — VARCHAR(100) — NOT NULL — 설정 값
  • description — VARCHAR(200) — 설명
  • updated_at — DATETIME — NOT NULL — 갱신일시 (KST)

tb_billing_line

  • line_id — BIGINT — 기본 키 — NOT NULL
  • billing_id — BIGINT — 외래 키 → tb_billing.billing_id — NOT NULL — NOT_ISSUED → ISSUED(매월 10일 발행) → PAID(후불 입금 확인)
  • group_id — BIGINT
  • lint_type (line_type) — VARCHAR(30)
  • charge_type — VARCHAR(20)
  • plan_version_id — BIGINT
  • credit_package_id — BIGINT
  • description — VARCHAR(200)
  • amount — INT
  • payment_ref — VARCHAR(100)
  • occured_at — DATETIME
  • created_at — DATETIME

tb_credit_package

  • package_id — BIGINT — 기본 키 — NOT NULL — 충전한 패키지 FK
  • name — VARCHAR(50) — NOT NULL — 충전 건수(제공량). package.credit_amount 박제. 그룹 총 제공량 = SUM(amount)
  • credit_amount — BIGINT — NOT NULL — 이 충전분 사용 건수. charged_at ASC(FIFO) 소진 분배. ⚠️ 일별 배치/조회 시 성공량 기반 계산 스냅샷 — 진실은 tb_message
  • price — INT — NOT NULL — 충전 결제액(원). package.price 박제
  • effective_from — DATETIME — NOT NULL — 충전 결제 시점 (KST). 소진 순서 = ASC FIFO
  • effective_to — DATETIME — 생성일시 (KST)
  • created_at — DATETIME — NOT NULL — carryover 식별자

tb_credit_rate

  • rate_id — BIGINT — 기본 키 — NOT NULL — 제공 크레딧 건수
  • message_type (message_type2) — VARCHAR(10) — 외래 키 → tb_message_type.message_type — NOT NULL — 메시지 유형 코드: PUSH, SMS, LMS, UMS, ... (운영자 추가 가능)
  • version_no — INT
  • credits_per_msg — DECIMAL(10, 1) — NOT NULL — 유효 시작일시 (KST)
  • effective_from — DATETIME — NOT NULL — 유효 종료일시 (KST). NULL=현재 유효
  • effective_to — DATETIME — 생성일시 (KST)
  • created_at — DATETIME — NOT NULL — message_credit 식별자 = 충전 건

tb_custom_contract

  • contract_id — BIGINT — 기본 키 — NOT NULL — 월 PUSH quota (NULL=무제한)
  • group_id — BIGINT — NOT NULL — 제공 앱 수
  • monthly_fee — INT — NOT NULL — 제공 사용자 수
  • monthly_quota — INT — 계약 시작일시 (KST)
  • base_app_count — INT — NOT NULL — 계약 종료일시 (KST). NULL=현재 유효
  • base_user_count — INT — NOT NULL — 생성일시 (KST)
  • effective_from — DATETIME — NOT NULL — 갱신일시 (KST)
  • effective_to — DATETIME — CUSTOM 협의 요청 식별자
  • created_at — DATETIME — NOT NULL — 요청 그룹
  • updated_at — DATETIME — NOT NULL — REQUESTED → NEGOTIATING → CONFIRMED / REJECTED

tb_custom_plan_request

  • request_id — BIGINT — 기본 키 — NOT NULL — ADMIN 메일 발송 시점 (KST)
  • group_id — BIGINT — NOT NULL — 확정 시 생성된 custom_contract FK
  • status — VARCHAR(20) — NOT NULL — 담당 운영자
  • request_note — TEXT — 요청일시 (KST)
  • admin_email_sent_at — DATETIME — 확정일시 (KST)
  • confirmed_contract_id — BIGINT — 생성일시 (KST)
  • admin_id — VARCHAR(50) — 그룹 식별자. 1 group = 1 subscription. (가입만 한 그룹은 row 없음)
  • requested_at — DATETIME — NOT NULL — 현재 plan_code FK. ⚠️ TRIAL/TERMINATE 상태는 NULL 허용 (상품 아님)
  • confirmed_at — DATETIME — 현재 plan_version_id FK (grandfather). TRIAL/TERMINATED는 NULL
  • created_at — DATETIME — NOT NULL — 구독 상태: TRIAL / ACTIVE / PAST_DUE(갱신결제 실패 — 크레딧만 발송 가능) / CHANGE_PENDING(다운그레이드 대기) / TERMINATE_PENDING(해지 대기) / TERMINA…

tb_message_carryover

  • carryover_id — BIGINT — 기본 키 — NOT NULL — 청구 기간 시작 = 해당 월 1일
  • group_id — BIGINT — NOT NULL — 청구 기간 종료 = 해당 월 말일
  • source_plan_version_id — BIGINT — 외래 키 → tb_plan_version.plan_version_id — NOT NULL — OPEN(누적 중) / FINALIZED(확정·immutable). 결제 발생 시 UPSERT(OPEN), 정산 배치(매월 1일 02시)가 전월 OPEN→FINALIZED
  • amount — BIGINT — NOT NULL — 청구 시점 대표(최종 적용) plan_code 박제. TRIAL/TERMINATED 월은 NULL 가능. 진실·버전·금액은 billing_line
  • granted_at — DATETIME — NOT NULL — 소계 = SUM(billing_line.amount), 부가세 전(원)
  • expires_at — DATETIME — NOT NULL — 부가세 10%
  • status — VARCHAR(20) — NOT NULL — 총 청구액 = subtotal + vat
  • created_at — DATETIME — NOT NULL — 청구 시점 결제방식 박제: CARD / TAX_INVOICE

tb_message_credit

  • credit_id — BIGINT — 기본 키 — NOT NULL — 이월 출처 plan_version_id (직전 plan)
  • group_id — BIGINT — NOT NULL — 이월 건수(제공량). 직전 plan 잔여 박제. 유효 이월 = SUM(amount) WHERE status=ACTIVE
  • credit_package_id — BIGINT — 외래 키 → tb_credit_package.package_id — NOT NULL — 이월 발생일시 = 업그레이드 시점
  • amount — BIGINT — NOT NULL — 만료일시 = 새 plan 주기 종료(current_period_end). 경과 시 EXPIRED → 소멸
  • price — INT — NOT NULL — 생성일시 (KST)
  • charged_at — DATETIME — NOT NULL — billing 식별자
  • created_at — DATETIME — NOT NULL — 그룹 식별자

tb_message_type

  • message_type — VARCHAR(10) — 기본 키 — NOT NULL — 메시지 유형 코드: PUSH, SMS, LMS, UMS, ... (운영자 추가 가능)
  • name — VARCHAR(50) — NOT NULL — 표시명
  • status — VARCHAR(20) — NOT NULL — ACTIVE / INACTIVE. ⚠️ 전환전송 선택지 노출 on/off — PUSH 실패 시 사용자에게 보여줄 전환 타입을 운영자가 제어
  • display_order — INT — UI 정렬 순서
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at — DATETIME — NOT NULL — 갱신일시 (KST)
  • created_by — VARCHAR(50) — 생성자(운영자) user_id

tb_payment

  • payment_id — BIGINT — 기본 키 — NOT NULL — payment 식별자 = 결제 1건
  • group_id — BIGINT — NOT NULL — 그룹 식별자
  • pay_category — VARCHAR(20) — NOT NULL — 결제 분류: PLAN(요금제) / CREDIT(크레딧 충전)
  • charge_type — VARCHAR(20) — NOT NULL — PLAN: UPGRADE / RENEWAL. CREDIT: CREDIT_CHARGE
  • settle_type — VARCHAR(20) — NOT NULL — 결제 시점 정산 방식 박제: CARD / TAX_INVOICE
  • pay_method — VARCHAR(20) — 결제 행위 수단: CARD_RECURRING(정기·빌링키) / CARD_ONETIME(단건 카드) / TRANSFER(단건 계좌이체). TAX_INVOICE면 NULL(월말 정산)
  • plan_version_id — BIGINT — PLAN 결제 시 plan_version FK 박제. CREDIT이면 NULL
  • credit_package_id — BIGINT — CREDIT 충전 시 패키지 FK. PLAN이면 NULL
  • credit_id — BIGINT — CREDIT 충전 시 message_credit 충전 row 1:1 매핑. PLAN이면 NULL
  • amount — INT — NOT NULL — 결제 금액(원). 정액 1건 — PLAN=월요금 전액, CREDIT=패키지 가격. ⚠️ 월 중 복수 업그레이드는 각 건 전액
  • description — VARCHAR(200) — 청구서 출력용 설명 (예: "Pro 요금제 이용료", "크레딧 10,000건 충전")
  • status — VARCHAR(20) — NOT NULL — 결제 상태: PAID(카드 즉시 완결) / UNBILLED(세금계산서 미청구 — 월말 tax_invoice로 묶임) / INVOICED(세금계산서 발행됨) / FAILED(카드 결제 실패). ⚠️ 실패/미입금 흐름…
  • pg_order_id — VARCHAR(100) — 토스 멱등키(orderId). 재시도 안전
  • pg_payment_key — VARCHAR(200) — 토스 거래 ID (결제 승인 후)
  • failure_code — VARCHAR(50) — 카드 결제 실패 코드
  • tax_invoice_id — BIGINT — 세금계산서 정산서 FK. 카드 고객은 NULL. 월말 배치가 묶을 때 세팅
  • occurred_at — DATETIME — NOT NULL — 결제(발생) 시점 (KST). usage_from = DATE(occurred_at), usage_to는 조회 시 계산(다음 PLAN payment from−1일, 마지막은 current_period_end−1일)
  • paid_at — DATETIME — 결제 완료 시점. 카드=PG 승인 시점, 세금계산서=입금 확인 시점
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)

tb_payment_method

  • group_id — BIGINT — 기본 키 — NOT NULL — 생성일시 (KST)
  • settle_type — VARCHAR(20) — NOT NULL — 갱신일시 (KST)
  • billing_key — VARCHAR(200) — 1건당 차감 크레딧. ⚠️ 실제 값 미정(10번) — 예시: PUSH=1, SMS=?, LMS=?
  • card_ref — VARCHAR(100) — 유효 시작일시 (KST)
  • invoice_email — VARCHAR(255) — 유효 종료일시 (KST). NULL=현재 유효
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at — DATETIME — NOT NULL — credit_package 식별자

tb_plan_master

  • plan_code — VARCHAR(20) — 기본 키 — NOT NULL — 표시명 (예: Basic, Pro, Premium, Enterprise, Custom)
  • name — VARCHAR(50) — NOT NULL — UI 정렬 순서
  • display_order — INT — 생성일시 (KST)
  • created_at — DATETIME — NOT NULL — 갱신일시 (KST)
  • updated_at — DATETIME — NOT NULL — plan_version 식별자

tb_plan_version

  • plan_version_id — BIGINT — 기본 키 — NOT NULL — 동일 plan_code 내 순번
  • plan_code — VARCHAR(20) — 외래 키 → tb_plan_master.plan_code — NOT NULL — 카피 문구
  • version_no — INT — NOT NULL — 월 이용료(원). CUSTOM 카탈로그는 NULL(협의). 그 외 non-null(앱단 보장). 예: BASIC=50000, PRO=150000, PREMIUM=400000, ENTERPRISE=650000
  • description — VARCHAR(200) — 월 PUSH 발송 quota. NULL=무제한(CUSTOM 협의). 예: BASIC=300000, PRO=1000000, PREMIUM=3000000, ENTERPRISE=5000000. ⚠️ plan quota는…
  • monthly_fee — INT — 기본 제공 앱 수. CUSTOM=NULL(협의). 예: BASIC=3, PRO/PREMIUM=5, ENTERPRISE=10
  • monthly_quota — INT — 기본 제공 사용자 수. CUSTOM=NULL(협의). 예: BASIC=3, PRO/PREMIUM=5, ENTERPRISE=10
  • base_app_count — INT — 일별 테스트 발송 제공량. NULL=무제한. billable 미포함
  • base_user_count — INT — 유효 시작일시 (KST)
  • test_daily_quota — INT — 유효 종료일시 (KST). NULL=현재 유효
  • effective_from — DATETIME — NOT NULL — 생성일시 (KST)
  • effective_to — DATETIME — 생성자 user_id
  • created_at — DATETIME — NOT NULL — CUSTOM 계약 식별자
  • created_by — VARCHAR(50) — 그룹(고객사). 1 group = 시계열 N 계약

tb_subscription

  • group_id — BIGINT — 기본 키 — NOT NULL — TRIAL 시작일시 = 체험 신청일
  • plan_code — VARCHAR(20) — 외래 키 → tb_plan_master.plan_code — TRIAL 종료 예정일시 = trial_started_at + TRIAL_DAYS(config)
  • plan_version_id — BIGINT — 외래 키 → tb_plan_version.plan_version_id — 체험 제공 PUSH 건수. ⚠️ 고객별 상이 — admin 개설 시 지정값 박제(plan_version 무시). PUSH 전용, 전환전송 불가
  • status — VARCHAR(20) — NOT NULL — 최초 결제일시 (KST). 불변 기준점
  • pending_change_id — BIGINT — 외래 키 → tb_subscription_change_request.request_id — 현재 plan 주기 시작 = 최근 결제일. 업그레이드마다 갱신
  • trial_started_at — DATETIME — 현재 plan 주기 종료 = 다음 결제 예정일(exclusive). 월말 클램프(anchor day 보존, Go AddDate 정규화 금지 — 전용 헬퍼). 다운/해지 적용 시점도 이 시점(익월 동일자)
  • trial_ends_at — DATETIME — 생성일시 (KST)
  • trial_message_quota — INT — 갱신일시 (KST)
  • first_paid_at — DATETIME — change request 식별자
  • current_period_start — DATETIME — 그룹 식별자
  • current_period_end — DATETIME — PLAN_UPGRADE(즉시 APPLIED + 직전 plan 잔여 이월) / PLAN_DOWNGRADE(익월 동일자 적용) / TERMINATE(익월 동일자 적용, TERMINATED 전환 — PAYG 아님)
  • created_at — DATETIME — NOT NULL — 변경 전 plan_code 박제. TRIAL이면 NULL
  • updated_at — DATETIME — NOT NULL — 변경 전 plan_version_id 박제

tb_subscription_change_request

  • request_id — BIGINT — 기본 키 — NOT NULL — 변경 후 plan_version_id 박제. TERMINATE면 NULL
  • group_id — BIGINT — NOT NULL — 다운그레이드/해지 시 비활성 대상 사용자 ID 목록 (예: 123, 456). ⚠️ 비활성화 방식 미정(20): 신청 전 강제 vs 적용 시점 자동
  • request_type — VARCHAR(20) — NOT NULL — 신청일시 (KST)
  • from_plan_code — VARCHAR(20) — 적용 예정일시. UPGRADE=requested_at. DOWNGRADE/TERMINATE=current_period_end (익월 동일자, 19번 확정)
  • from_plan_version_id — BIGINT — 외래 키 → tb_plan_version.plan_version_id — 실제 적용일시
  • to_plan_code — VARCHAR(20) — 취소일시. 다운/해지 신청 취소 시. UPGRADE는 취소 불가
  • to_plan_version_id — BIGINT — 외래 키 → tb_plan_version.plan_version_id — PENDING / APPLIED / CANCELLED. UPGRADE는 INSERT 시 즉시 APPLIED
  • affected_user_ids — JSON — PENDING일 때만 group_id — 그룹당 PENDING 1건 강제
  • requested_at — DATETIME — NOT NULL — 생성일시 (KST)
  • effective_at — DATETIME — NOT NULL — 그룹 식별자. 1 group = 1 payment_method
  • applied_at — DATETIME — CARD(PG 카드) / TAX_INVOICE(세금계산서 후불)
  • cancelled_at — DATETIME — CARD일 때: RECURRING(정기, 카드만) / ONETIME(단건). TAX_INVOICE면 NULL
  • status — VARCHAR(20) — NOT NULL — card_charge_type=ONETIME일 때: CARD / TRANSFER(계좌이체). RECURRING은 카드만이라 NULL
  • pending_group — BIGINT — 정기결제용 PG 빌링키 (card_charge_type=RECURRING 시). 토큰화 식별자만 보관 (PCI-DSS)
  • created_at — DATETIME — NOT NULL — 단건 카드 토큰 ref (onetime_method=CARD 시)

tb_tax_invoice

  • tax_invoice_id — BIGINT — 기본 키 — NOT NULL — tax_invoice 식별자
  • group_id — BIGINT — NOT NULL — 그룹 식별자
  • period_from — DATE — NOT NULL — 정산 기간 시작 = 해당 월 1일
  • period_to — DATE — NOT NULL — 정산 기간 종료 = 해당 월 말일
  • status — VARCHAR(20) — NOT NULL — OPEN(그 달 누적 중) → ISSUED(매월 10일 세금계산서 발행) → PAID(입금 확인). ⚠️ 미입금 독촉 흐름(17) 미정
  • subtotal — INT — NOT NULL — 소계 = SUM(payment.amount WHERE tax_invoice_id=this), 부가세 전(원)
  • vat_amount — INT — NOT NULL — 부가세 10%
  • total_amount — INT — NOT NULL — 총액 = subtotal + vat
  • invoice_number — VARCHAR(50) — 세금계산서 번호 (발행 후)
  • invoice_issued_at — DATETIME — 세금계산서 발행일시 (KST). 매월 10일
  • paid_at — DATETIME — 입금 확인 시점 (KST)
  • finalized_at — DATETIME — ISSUED 확정 시점 — 이후 immutable
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)