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건