saas-push 요금제

테이블 (15)

billing

  • billing_id — BIGINT — 기본 키 — NOT NULL — billing 식별자
  • group_id — BIGINT — NOT NULL — 그룹 식별자
  • billing_year_month — CHAR(7) — NOT NULL — 청구 식별 키 (예: "2025-06"). 청구 사이클 = 매월 1일~말일 고정 (2026-06 확정, 요금제 사이클과 분리)
  • billing_period_from — DATE — NOT NULL — 청구 기간 시작일 (KST) = 해당 월 1일
  • billing_period_to — DATE — NOT NULL — 청구 기간 종료일 (KST) = 해당 월 말일
  • status — VARCHAR(20) — NOT NULL — 청구 상태: OPEN(그 달 누적 중 — 결제 발생마다 라인 추가·합계 UPDATE 허용) / FINALIZED(정산 배치로 확정·immutable). 결제 발생 시 해당 월 row 없으면 INSERT(OPEN),…
  • plan_code_snap — VARCHAR(20) — NOT NULL — 청구 시점 대표(최종 적용) plan_code 박제 (청구 목록 표기/필터용). 월 내 복수 plan 시 마지막 적용 plan. plan 이름은 plan_master 조인, 정확한 진실·버전·금액은 billing_…
  • subtotal — INT — NOT NULL — 소계 = SUM(billing_line.amount), 부가세 전 (원)
  • vat_amount — INT — NOT NULL — 부가세 10% (= subtotal × 0.1)
  • total_amount — INT — NOT NULL — 총 청구액 (= subtotal + vat_amount)
  • payment_method_snap — VARCHAR(20) — NOT NULL — 청구 시점 결제 방식 박제: PRECHARGE_CARD / POSTPAY_INVOICE
  • paid_at — DATETIME — 결제 완료 시점 (KST). 선결제=PG 결제 시점, 후불=입금 확인 시점
  • invoice_status — VARCHAR(20) — NOT NULL — 세금계산서 흐름: NOT_ISSUED(미발행) → ISSUED(10일 세금계산서 발행) → PAID(후불 입금 확인 완료) — ADR-19, §2.4
  • invoice_number — VARCHAR(50) — 세금계산서 번호 (발행 후)
  • invoice_issued_at — DATETIME — 세금계산서 발행일시 (KST). 매월 10일 발행 (§2.4)
  • excel_s3_key — VARCHAR(255) — 청구 세부내역서 Excel S3 키 (예: billing/2025/06/billing-12345.xlsx). 비동기 생성 — 생성 전 NULL
  • excel_generated_at — DATETIME — Excel 생성 완료 시점 (KST). 다운로드는 이 시점 이후 가능
  • finalized_at — DATETIME — NOT NULL — 청구 row 확정(FINALIZED) 시점 (KST) — 이후 immutable. OPEN 상태에선 NULL (2026-06 변경 C: NOT NULL → NULL 허용, 마감 시 세팅)
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)

billing_line

  • line_id — BIGINT — NOT NULL — billing.billing_id FK
  • billing_id — BIGINT — 외래 키 → billing.billing_id — NOT NULL — 그룹 식별자 (중복 저장으로 group 단위 쿼리 최적화)
  • group_id — BIGINT — NOT NULL — 라인 종류: BASE_FEE(plan 결제) / CREDIT_CHARGE(크레딧 선불 충전 결제). (2026-06 변경 C: 기존 CREDIT(후불 차감 청구) 폐기 — 크레딧은 선불 충전 결제로 전환. 2026…
  • line_type — VARCHAR(30) — NOT NULL — 결제 종류 (2026-06 변경 C): UPGRADE(plan 업그레이드) / RENEWAL(plan 주기 갱신) / CREDIT(크레딧 충전). BASE_FEE 라인은 UPGRADE/RENEWAL, CREDIT_…
  • charge_type — VARCHAR(20) — BASE_FEE 라인의 plan 식별 (2026-06 갭해소) — 한 청구월에 plan별 복수 BASE_FEE 라인 구분. 업그레이드 시 plan별로 1라인씩 생성. CREDIT_CHARGE 라인은 NULL
  • plan_version_id_snap — BIGINT — CREDIT_CHARGE 라인의 크레딧 패키지 FK (2026-06 변경 C) — credit_package.package_id. BASE_FEE 라인은 NULL. (credit_id로 message_credit→…
  • credit_package_id — BIGINT — CREDIT_CHARGE 라인 ↔ message_credit 충전 row 1:1 매핑 (2026-06 변경 F) — message_credit.credit_id FK. 충전 결제 1건 = billing_line 1…
  • credit_id — BIGINT — 청구서 출력용 설명 (예: "Pro 요금제 이용료", "크레딧 10,000건 충전"). 충전 건수 등 상세는 credit_package 조인으로 표기
  • description — VARCHAR(200) — 결제 금액 (원). BASE_FEE=plan 월요금, CREDIT_CHARGE=크레딧 패키지 가격. ⚠️ 단가×수량 계산 아님 — 정액 결제 1건의 금액. 건수·단가 분해는 plan_version.monthly_f…
  • amount — INT — NOT NULL — PG 거래 ID (2026-06 변경 C) — 라인 1건 = 결제 1건. 결제 이력 추적용
  • payment_ref — VARCHAR(100) — 발생(결제) 시점 (KST). BASE_FEE=해당 plan 결제일, CREDIT_CHARGE=크레딧 충전 결제일. 청구서 정렬 기준
  • occurred_at — DATETIME — 생성일시 (KST)
  • created_at — DATETIME — NOT NULL

credit_package (크레딧 선불 상품 마스터)

  • package_id (식별자) — BIGINT — 기본 키 — NOT NULL — credit_package 식별자
  • name (상품 표시명) — VARCHAR(50) — NOT NULL — 상품 표시명 (예: "크레딧 10,000건 패키지")
  • credit_amount (제공 크레딧 건수) — BIGINT — NOT NULL — 제공 크레딧 건수 (충전 시 message_credit.balance += credit_amount)
  • price (판매가) — INT — NOT NULL — 판매가 (원). 충전 결제 시 billing_line.amount
  • effective_from (상품 유효 시작일시) — DATETIME — NOT NULL — 이 상품(가격) 유효 시작일시 (KST)
  • effective_to (싱픔 우효종료일시) — DATETIME — 이 상품(가격) 유효 종료일시 (KST). NULL=현재 유효
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)

message_carryover (메시지 이월 묶음)

  • carryover_id (식별자) — BIGINT — 기본 키 — NOT NULL — message_carryover 식별자
  • group_id (그룹식별자) — BIGINT — NOT NULL — 그룹 식별자. 1 group = N 이월 묶음 (만료일 상이로 동시 공존)
  • source_plan_version_id (직전 플랜 버전 아이디) — BIGINT — NOT NULL — 이월 출처 plan_version_id FK — 직전(업그레이드 전) plan
  • amount (이월 발생 시점의 이월 건수) — BIGINT — NOT NULL — 이월 발생 시점의 이월 건수 (직전 plan 잔여 메시지)
  • granted_at (이월 발생 일시) — DATETIME — NOT NULL — 이월 발생 일시 (KST) = 업그레이드(새 플랜 결제) 시점
  • expires_at (이월 만료일시) — DATETIME — NOT NULL — 이월 만료 일시 (KST) = 새 plan 주기 종료(= 결제일 + 1달). 이후 remaining 소멸
  • status (상태(차감가능, 소진, 만료)) — VARCHAR(20) — NOT NULL — 이월 상태: ACTIVE(차감 가능) / EXHAUSTED(소진) / EXPIRED(만료 소멸)
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)

message_credit

  • credit_id — BIGINT — 기본 키 — NOT NULL — message_credit 식별자 = 충전 건 (2026-06 변경 F: 충전 원장 row, 그룹당 1건 → 충전마다 1건)
  • group_id — BIGINT — NOT NULL — 그룹 식별자. 1 group = N 충전 row (충전 건마다 적재 — 그룹 크레딧 총 제공량 = SUM(amount) GROUP BY group_id)
  • credit_package_id — BIGINT — NOT NULL — 충전한 크레딧 패키지 FK — credit_package.package_id (어느 상품으로 충전했는지)
  • amount — BIGINT — NOT NULL — 충전 건수(제공량). credit_package.credit_amount 박제. 그룹 크레딧 총 제공량 = SUM(amount) GROUP BY group_id
  • used — BIGINT — NOT NULL — 이 충전분에서 사용된 건수. 충전 시계열 빠른 순(charged_at ASC, FIFO)으로 소진 — 그룹 크레딧 사용량(성공량 기반, 플랜·이월 제공량 초과분)을 오래된 충전부터 분배 기입. 충전분별 잔여 = a…
  • price — INT — NOT NULL — 충전 결제액 (원). credit_package.price 박제. billing_line.amount와 동일
  • charged_at — DATETIME — NOT NULL — 충전 결제 시점 (KST). 사용량 소진 순서 기준 — 빠른 순(ASC) FIFO
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)

payment_method (그룹별 결제 수단)

  • group_id (그룹 식별자) — BIGINT — 기본 키 — NOT NULL — 그룹 식별자. 1 group = 1 payment_method
  • method_type (카드/세금계산서) — VARCHAR(20) — NOT NULL — PRECHARGE_CARD(선결제 카드) / POSTPAY_INVOICE(후불 세금계산서)
  • card_ref (pg 카드 토큰ref) — VARCHAR(100) — NOT NULL — PG 카드 토큰 ref. PRECHARGE_CARD 시 NOT NULL. 토큰화된 카드 식별자만 보관 (PCI-DSS 준수)
  • invoice_email (세금게산서 수신 이메일) — VARCHAR(255) — NOT NULL — 세금계산서 수신 이메일. POSTPAY_INVOICE 시 NOT NULL
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at (갱신일시) — DATETIME — NOT NULL — 갱신일시 (KST)

plan_master (Untitled2)

  • plan_code — VARCHAR(20) — 기본 키 — NOT NULL
  • name — VARCHAR(50)
  • display_order — INT
  • created_at — DATETIME
  • updated_at — DATETIME

plan_version (Untitled)

  • plan_version_id — BIGINT — 기본 키 — NOT NULL
  • plan_code — VARCHAR(20) — 외래 키 — NOT NULL
  • version_no — INT
  • description — VARCHAR(200)
  • monthly_fee — INT
  • monthly_quota — INT
  • base_app_count — INT
  • base_user_count — INT
  • test_daily_quota — INT
  • effective_from — DATETIME
  • effective_to — DATETIME
  • created_at — DATETIME
  • created_by — VARCHAR(50)

sales_inquiry_category (영업 문의 카테고리)

  • category_code (카테고리 식별자) — VARCHAR(30) — 기본 키 — NOT NULL — 카테고리 식별자 (운영팀 합의 후 정의 — open-q §14.1)
  • display_text (드롭다운 표시 문구) — VARCHAR(200) — NOT NULL — PA_0108 드롭다운 표시 문구
  • display_order (UI 정렬 순서) — INT — NOT NULL — UI 정렬 순서
  • is_active (활성 여부) — BOOLEAN — NOT NULL — 활성 여부
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at (갱신일시) — DATETIME — NOT NULL — 갱신일시 (KST)

subscription (테넌트 별 구독 상태)

  • group_id (그룹 식별자) — BIGINT — 기본 키 — NOT NULL — 그룹 식별자. 1 group = 1 subscription
  • plan_version_id (요금제 디테일 식별자) — BIGINT — NOT NULL — 현재 plan_version_id FK (grandfather용 — 가격 변경 시 고정)
  • plan_code (요금제 식별자) — VARCHAR(20) — NOT NULL — 현재 plan_master.plan_code FK
  • status (구독 상태) — VARCHAR(20) — NOT NULL — 구독 상태: TRIAL / ACTIVE / CHANGE_PENDING(다운그레이드 대기) / TERMINATE_PENDING(해지 대기 — 해지 정책 미정 보류). 해지 후 PAYG는 status=ACTIVE +…
  • pending_change_id (pending 상태일 때의 요청 id) — BIGINT — CHANGE_PENDING / TERMINATE_PENDING 상태일 때 해당 subscription_change_request.request_id FK
  • trial_started_at (무료 체험 시작일시) — DATETIME — TRIAL 시작일시 = 가입일 (TRIAL/이전 TRIAL이었던 경우만)
  • trial_ends_at (무료체험 종료 예정일시) — DATETIME — TRIAL 종료 예정일시 = trial_started_at + 14일 (ADR-16)
  • first_paid_at (최초 결제 일시 (불변)) — DATETIME — 최초 결제일시 (KST). 구독 시작 기준점(불변) — 업그레이드해도 변하지 않음. 주기 경계 계산은 current_period_start/end 사용
  • current_period_start (현재 plan 주기 시작) — DATETIME — 현재 plan 주기 시작 (KST) = 최근 결제일. 업그레이드(=새 플랜 전액 결제)마다 갱신. 발송량 PLAN 주기 시작 경계 (§2.3). 월 경계 day가 필요하면 DATE(current_period_sta…
  • current_period_end (현재 plan 주기 종료) — DATETIME — 현재 plan 주기 종료 = 다음 결제 예정일 (KST) = current_period_start + 1달. 이 주기 종료 시 plan 갱신 결제 배치 동작. 이월 만료일도 동일 시점(새 plan 주기 종료)
  • plan_used (현재 플랜 주기 플랜 점유 사용량) — BIGINT — NOT NULL — 현재 PLAN 주기 플랜 점유 사용량(건). 점유 = 발송 성공 + 미발송 예약 승인. PLAN 주기 시작/갱신(current_period_start 갱신) 시 0 리셋. 잔여 = monthly_quota − pl…
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at (갱신일시) — DATETIME — NOT NULL — 갱신일시 (KST)

subscription_audit_log (audit log)

  • audit_id (식별자) — BIGINT — 기본 키 — NOT NULL — audit 식별자
  • group_id (그룹 식별자) — BIGINT — NOT NULL — 그룹 식별자
  • actor_user_id (액션 수행자) — VARCHAR(50) — NOT NULL — 액션 수행자 user_id
  • action_type (액션 타입) — VARCHAR(30) — NOT NULL — 액션 타입: ACTIVATE_USER / DEACTIVATE_USER / DELETE_USER / PLAN_UPGRADE_APPLIED / PLAN_DOWNGRADE_REQUEST / PLAN_DOWNGRADE_C…
  • target_type (대상 도메인 타입) — VARCHAR(20) — 대상 도메인 타입: USER / SUBSCRIPTION / CREDIT / PAYMENT_METHOD
  • target_id (대상 식별자) — VARCHAR(50) — 대상 식별자 (예: user_id, request_id)
  • before_value (변경 전 상태) — JSON — 변경 전 상태 (JSON, 스키마 변경 유연성)
  • after_value (변경 후 상태) — JSON — 변경 후 상태 (JSON)
  • metadata (추가 컨텍스트) — JSON — 추가 컨텍스트: IP, source, request_id 등
  • created_at (생성일시) — DATETIME — NOT NULL — 발생일시 (KST)

subscription_change_request (요금제 변경/해지 신청 이벤트)

  • request_id (요청 식별자) — BIGINT — NOT NULL — 그룹 식별자
  • group_id (그룹 식별자) — BIGINT — NOT NULL — PLAN_UPGRADE(새 플랜 1달 전액 결제 즉시 APPLIED + 직전 plan 잔여 이월 — "차액 흡수" 폐기, 2026-06 갭해소) / PLAN_DOWNGRADE(익월 적용, 2026-06 확정) /…
  • request_type (요청 타입(업/다운그레이드,해지)) — VARCHAR(20) — NOT NULL — 변경 전 plan_code (시점 박제)
  • from_plan_code (변경 전 플랜 code) — VARCHAR(20) — NOT NULL — 변경 전 plan_version_id FK (시점 박제)
  • from_plan_version_id (변경 전 플랜 버전) — BIGINT — NOT NULL — 변경 후 plan_code (시점 박제). TERMINATE 시 PAYG
  • to_plan_code (변경 후 플랜 code) — VARCHAR(20) — NOT NULL — 변경 후 plan_version_id FK (시점 박제)
  • to_plan_version_id (변경 후 플랜 버전) — BIGINT — NOT NULL — 다운그레이드 시 PA_0105에서 비활성 대상 사용자 ID 목록. JSON 배열 (예: 123, 456)
  • affected_user_ids (다운그레이드 시 비활성화 id 목록) — JSON — 신청일시 (KST)
  • requested_at (신청 일시) — DATETIME — NOT NULL — 적용 예정 일시. PLAN_UPGRADE=requested_at. PLAN_DOWNGRADE/TERMINATE=다음 청구 주기 시작 (시점 잠정 — open-q §13, 가안 익월 1일 00:00 KST)
  • effective_at (적용 예정일시) — DATETIME — NOT NULL — 실제 적용일시. PLAN_UPGRADE는 requested_at과 동일. PLAN_DOWNGRADE/TERMINATE는 청구 주기 도래 배치에서 세팅
  • applied_at (실제 적용일시) — DATETIME — 취소일시. 다운그레이드/해지 취소 시. PLAN_UPGRADE는 취소 불가 → NULL
  • cancelled_at (취소 일시) — DATETIME — PENDING(다운그레이드/해지 대기) / APPLIED(적용 완료) / CANCELLED(취소). PLAN_UPGRADE는 INSERT 시 즉시 APPLIED
  • status (상태 값) — VARCHAR(20) — NOT NULL — PLAN_UPGRADE 결제 참조 ID. 선결제 카드=PG 거래 ID (필수). 후불 invoice=NULL (별도 invoice 번호는 billing.invoice_number)
  • created_at (생성일시) — DATETIME — NOT NULL

tb_custom_contract

  • contract_id — BIGINT — 기본 키 — NOT NULL — CUSTOM 계약 식별자
  • group_id — BIGINT — NOT NULL — 그룹(고객사) — 1 group = 시계열 N 계약(재협상 이력)
  • monthly_fee — INT — NOT NULL — 협상 월 이용료 (원)
  • monthly_quota — INT — 월 발송량 quota (NULL=무제한)
  • base_app_count — INT — NOT NULL — 제공 앱 수
  • base_user_count — INT — NOT NULL — 제공 사용자 수
  • effective_from — DATETIME — NOT NULL — 계약 적용 시작일시 (KST)
  • effective_to — DATETIME — 계약 적용 종료일시 (KST). NULL=현재 유효
  • created_at — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at — DATETIME — NOT NULL — 갱신일시 (KST)

termination_reason_master (해지 사유 마스터)

  • reason_code (식별자) — VARCHAR(30) — 기본 키 — NOT NULL — 사유 코드 식별자 (예: NOT_USING, COMPETITOR, QUALITY, UX_ISSUE, OTHER)
  • display_text (표시 문구) — VARCHAR(200) — NOT NULL — PA_0107 라디오 옵션 표시 문구
  • requires_extra_input (추가 입력 필요 여부) — BOOLEAN — NOT NULL — 추가 입력 필요 여부 (예: COMPETITOR는 제품명 입력)
  • extra_input_label (추가 입력 필드 라벨) — VARCHAR(50) — 추가 입력 필드 라벨 (예: "제품명")
  • display_order (UI 정렬 순서) — INT — NOT NULL — UI 정렬 순서
  • is_active (활성 여부) — BOOLEAN — NOT NULL — 활성 여부. 비활성화 옵션은 신규 응답에서 노출 안 됨
  • created_at (생성일시) — DATETIME — NOT NULL — 생성일시 (KST)
  • updated_at (갱신일시) — DATETIME — NOT NULL — 갱신일시 (KST)

termination_survey (해지 사유 설문 응답)

  • survey_id (식별자) — BIGINT — 기본 키 — NOT NULL — 그룹 식별자
  • group_id (그룹 식별자) — BIGINT — NOT NULL — 연결된 subscription_change_request.request_id FK (TERMINATE 신청)
  • change_request_id (연결된 구독 변경 요청 테이블 아이디) — BIGINT — NOT NULL — 해지 시점 plan_code 박제
  • terminated_plan_code (해지 시점 플랜 code) — VARCHAR(20) — NOT NULL — 해지 시점 plan_version_id FK 박제
  • terminated_plan_version_id (해지 시점 플랜 버전) — BIGINT — NOT NULL — 구독 유지 기간(일) — 분석용
  • subscription_duration_days (구독 유지 기간) — INT — termination_reason_master.reason_code FK. NULL=미응답
  • reason_code (사유 식별자) — VARCHAR(30) — 외래 키 → termination_reason_master.reason_code — 경쟁사 제품명 (reason_code=COMPETITOR 시)
  • competitor_name (경쟁사 제품명) — VARCHAR(100) — 추가 의견 (자유 입력)
  • additional_comment (추가 의견) — VARCHAR(1000) — ARCHAR(1000) COMMENT '응답일시 (KST)
  • responded_at (응답 일시) — DATETIME — NOT NULL — 응답자 user_id (그룹관리자)
  • responded_by_user_id (응답자 user id) — VARCHAR(50) — 운영팀 사후 작성 메모
  • admin_note (운영팀 사후 메모) — VARCHAR(1000) — 사후 대응 상태: NONE / CONTACTED / RECOVERED / CONFIRMED_LOST
  • follow_up_status (사후 대응 상태) — VARCHAR(20) — 생성일시 (KST)
  • created_at (생성일시) — DATETIME — NOT NULL — 해지 1건당 설문 1건