사스푸시
테이블 (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)