요금제/권한 정책 업데이트 SQL

유료회원 인쇄 무제한, 퍼즐조각 보상 포인트, AI 사용량 제한, 최종 보류 요금제를 DB 기준으로 정리합니다.

베타 체크리스트 로그인/권한 점검 기본 권한 DB Supabase SQL

정책 반영 범위

정책	DB 반영 방식	주의
유료회원 프린트 무제한	`puzzlelo.print` 권한을 유료 플랜의 핵심 기능으로 유지	기존 구조 사용
퍼즐조각 보상 포인트	`puzzlelo.piece_credit` 설명/메타데이터를 보상 포인트 중심으로 업데이트	학생 지갑/거래내역 테이블은 다음 단계
AI 비용 폭탄 방지	AI 기능 키를 quota 타입으로 추가	실제 활성화는 월 사용량 로그/차단 로직 이후
최종 보류 요금제	`v2026_policy_hold_kr` 버전을 scheduled 상태로 추가	바로 과금 시작 아님

이 SQL은 기존 데이터를 삭제하지 않습니다. 다만 Supabase SQL Editor에서 실행해야 하며, 실행 전 아래 내용을 한 번 훑어본 뒤 적용하세요.

1. 정책 업데이트 SQL

-- ============================================================
-- PuzzleloHub entitlement policy update
-- Purpose:
-- 1) 유료회원 프린트 무제한 정책을 메타데이터로 명확화
-- 2) 퍼즐조각을 결제 재화가 아닌 학생 보상 포인트로 전환
-- 3) AI 기능은 월 quota가 필요한 별도 기능으로 분리
-- 4) 최종/마지막 전단계 보류 요금제를 scheduled plan_version으로 기록
-- ============================================================

begin;

-- 1. 퍼즐조각 의미 업데이트: 프린트 차감 재화가 아니라 학생 보상/달란트 포인트
update public.features
set title = '퍼즐조각 보상 포인트',
    description = '학생의 출석, 숙제, 퍼즐 완료, 생일, 도전 성공 등에 지급하는 교육용 보상 포인트입니다. 유료회원 프린트 권한과 분리합니다.',
    value_type = 'quota',
    default_limit = null,
    default_limit_unit = null,
    is_public = true,
    metadata = coalesce(metadata, '{}'::jsonb) || '{
      "policy":"student_reward_point",
      "not_for_paid_print_metering":true,
      "reward_examples":["birthday","homework_done","online_puzzle_complete","paper_puzzle_confirmed","teacher_manual_grant"],
      "beta_note":"무료회원 체험용 지급과 학생 보상 지급을 함께 지원하되, 유료 프린트 차감에는 사용하지 않음"
    }'::jsonb,
    updated_at = now()
where feature_key = 'puzzlelo.piece_credit';

-- 2. AI 사용량 제한이 필요한 기능 키 추가
insert into public.features
  (feature_key, app_key, title, description, value_type, default_limit, default_limit_unit, is_public, status, metadata)
values
  ('lms.personal_learning_report', 'lms', '내 학습 리포트', '개인 회원이 자신의 풀이 기록, 학습일, 정답률, 최근 활동을 확인하는 개인용 학습 리포트 권한입니다.', 'boolean', null, null, false, 'active', '{"launch":"beta_policy"}'),
  ('mathlo.ai_ocr_analysis', 'mathlo', 'AI OCR/문항 분석', '업로드 자료나 답안 이미지를 AI/OCR로 분석하는 기능입니다. 요금제별 월 사용량 제한이 필요합니다.', 'quota', 0, 'month', false, 'draft', '{"cost_guard":true,"launch":"future"}'),
  ('mathlo.ai_twin_problem_generate', 'mathlo', 'AI 쌍둥이 문항 생성', '오답 원인과 문항 유전자 코드를 기반으로 쌍둥이 문항을 생성하는 AI 기능입니다. 요금제별 월 사용량 제한이 필요합니다.', 'quota', 0, 'month', false, 'draft', '{"cost_guard":true,"launch":"future"}'),
  ('mathlo.ai_essay_feedback', 'mathlo', 'AI 서술형 첨삭', '서술형 풀이를 분석하고 첨삭 피드백을 생성하는 AI 기능입니다. 요금제별 월 사용량 제한이 필요합니다.', 'quota', 0, 'month', false, 'draft', '{"cost_guard":true,"launch":"future"}'),
  ('billing.receivable_management', 'billing', '수납/미납 관리', '학원·공부방 청구서 생성, 납부 처리, 미납자 확인, 영수증 출력 권한입니다.', 'boolean', null, null, false, 'active', '{"launch":"beta_ops"}')
on conflict (feature_key) do update
set title = excluded.title,
    description = excluded.description,
    value_type = excluded.value_type,
    default_limit = excluded.default_limit,
    default_limit_unit = excluded.default_limit_unit,
    status = excluded.status,
    metadata = public.features.metadata || excluded.metadata,
    updated_at = now();

-- 3. 최종/마지막 전단계 보류 요금제 버전 추가
-- status = scheduled 이므로 현재 베타 권한을 즉시 대체하지 않습니다.
with price_rows(plan_key, price_amount, price_label, billing_interval, plan_note) as (
  values
    ('personal_plus', 9900::numeric, '월 9,900원 이내', 'month', '개인 유료 최종 보류가'),
    ('studyroom', 39000::numeric, '월 39,000원 이내', 'month', '공부방 최종 보류가'),
    ('academy', 149000::numeric, '월 149,000원 이내', 'month', '학원 최종 보류가'),
    ('school', 1800000::numeric, '연 1,800,000원 이내', 'year', '학교 단위 최종 보류가')
)
insert into public.plan_versions
  (plan_id, version_key, region_code, currency, price_amount, price_label, billing_interval, effective_from, is_legacy_lockable, status, metadata)
select p.id,
       'v2026_policy_hold_kr',
       'KR',
       'KRW',
       pr.price_amount,
       pr.price_label,
       pr.billing_interval,
       '2026-06-15 00:00:00+09'::timestamptz,
       true,
       'scheduled',
       jsonb_build_object(
         'pricing_status', 'policy_hold',
         'note', pr.plan_note,
         'print_policy', 'paid_unlimited',
         'puzzle_piece_policy', 'student_reward_point',
         'ai_policy', 'quota_limited'
       )
from price_rows pr
join public.plans p on p.plan_key = pr.plan_key
on conflict (plan_id, version_key, region_code) do update
set price_amount = excluded.price_amount,
    price_label = excluded.price_label,
    billing_interval = excluded.billing_interval,
    is_legacy_lockable = true,
    status = 'scheduled',
    metadata = public.plan_versions.metadata || excluded.metadata,
    updated_at = now();

-- 4. 정책 보류 버전에 핵심 기능 매핑
-- AI 기능은 비용 차단 구조가 완성될 때까지 enabled=false placeholder로 둡니다.
with hold_versions as (
  select pv.id as plan_version_id, p.plan_key
  from public.plan_versions pv
  join public.plans p on p.id = pv.plan_id
  where pv.version_key = 'v2026_policy_hold_kr'
    and pv.region_code = 'KR'
),
feature_rows(plan_key, feature_key, enabled, limit_value, limit_unit, metadata) as (
  values
    ('personal_plus', 'puzzlelo.play', true, null::int, null::text, '{}'::jsonb),
    ('personal_plus', 'puzzlelo.print', true, null::int, null::text, '{"policy":"unlimited_print"}'::jsonb),
    ('personal_plus', 'lms.personal_learning_report', true, null::int, null::text, '{}'::jsonb),
    ('personal_plus', 'puzzlelo.piece_credit', true, null::int, null::text, '{"policy":"reward_point"}'::jsonb),
    ('personal_plus', 'mathlo.ai_ocr_analysis', false, 30::int, 'month'::text, '{"future_quota":30}'::jsonb),
    ('personal_plus', 'mathlo.ai_twin_problem_generate', false, 30::int, 'month'::text, '{"future_quota":30}'::jsonb),
    ('personal_plus', 'mathlo.ai_essay_feedback', false, 30::int, 'month'::text, '{"future_quota":30}'::jsonb),

('studyroom', 'puzzlelo.play', true, null::int, null::text, '{}'::jsonb),
    ('studyroom', 'puzzlelo.print', true, null::int, null::text, '{"policy":"unlimited_print"}'::jsonb),
    ('studyroom', 'lms.personal_learning_report', true, null::int, null::text, '{}'::jsonb),
    ('studyroom', 'lms.student_management', true, null::int, null::text, '{}'::jsonb),
    ('studyroom', 'lms.attendance', true, null::int, null::text, '{}'::jsonb),
    ('studyroom', 'billing.receivable_management', true, null::int, null::text, '{}'::jsonb),
    ('studyroom', 'puzzlelo.piece_credit', true, null::int, null::text, '{"policy":"reward_point"}'::jsonb),
    ('studyroom', 'mathlo.ai_ocr_analysis', false, 300::int, 'month'::text, '{"future_quota":300}'::jsonb),
    ('studyroom', 'mathlo.ai_twin_problem_generate', false, 300::int, 'month'::text, '{"future_quota":300}'::jsonb),
    ('studyroom', 'mathlo.ai_essay_feedback', false, 300::int, 'month'::text, '{"future_quota":300}'::jsonb),

('academy', 'puzzlelo.play', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'puzzlelo.print', true, null::int, null::text, '{"policy":"unlimited_print"}'::jsonb),
    ('academy', 'lms.personal_learning_report', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'lms.student_management', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'lms.attendance', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'lms.multi_teacher', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'billing.receivable_management', true, null::int, null::text, '{}'::jsonb),
    ('academy', 'puzzlelo.piece_credit', true, null::int, null::text, '{"policy":"reward_point"}'::jsonb),
    ('academy', 'mathlo.ai_ocr_analysis', false, 1500::int, 'month'::text, '{"future_quota":1500}'::jsonb),
    ('academy', 'mathlo.ai_twin_problem_generate', false, 1500::int, 'month'::text, '{"future_quota":1500}'::jsonb),
    ('academy', 'mathlo.ai_essay_feedback', false, 1500::int, 'month'::text, '{"future_quota":1500}'::jsonb),

('school', 'puzzlelo.play', true, null::int, null::text, '{}'::jsonb),
    ('school', 'puzzlelo.print', true, null::int, null::text, '{"policy":"unlimited_print"}'::jsonb),
    ('school', 'lms.personal_learning_report', true, null::int, null::text, '{}'::jsonb),
    ('school', 'lms.student_management', true, null::int, null::text, '{}'::jsonb),
    ('school', 'lms.attendance', true, null::int, null::text, '{}'::jsonb),
    ('school', 'lms.multi_teacher', true, null::int, null::text, '{}'::jsonb),
    ('school', 'puzzlelo.piece_credit', true, null::int, null::text, '{"policy":"reward_point"}'::jsonb),
    ('school', 'mathlo.ai_ocr_analysis', false, null::int, 'contract'::text, '{"future_quota":"contract"}'::jsonb),
    ('school', 'mathlo.ai_twin_problem_generate', false, null::int, 'contract'::text, '{"future_quota":"contract"}'::jsonb),
    ('school', 'mathlo.ai_essay_feedback', false, null::int, 'contract'::text, '{"future_quota":"contract"}'::jsonb)
)
insert into public.plan_feature_limits
  (plan_version_id, feature_key, enabled, limit_value, limit_unit, metadata)
select hv.plan_version_id, fr.feature_key, fr.enabled, fr.limit_value, fr.limit_unit, fr.metadata
from hold_versions hv
join feature_rows fr on fr.plan_key = hv.plan_key
on conflict (plan_version_id, feature_key) do update
set enabled = excluded.enabled,
    limit_value = excluded.limit_value,
    limit_unit = excluded.limit_unit,
    metadata = public.plan_feature_limits.metadata || excluded.metadata,
    updated_at = now();

commit;

2. 적용 후 검증 SQL

-- ============================================================
-- PuzzleloHub entitlement policy verify
-- ============================================================

-- 1. 퍼즐조각 의미 확인
select
  feature_key,
  title,
  value_type,
  default_limit,
  default_limit_unit,
  metadata
from public.features
where feature_key = 'puzzlelo.piece_credit';

-- 2. AI quota 기능 키 확인
select
  feature_key,
  app_key,
  title,
  value_type,
  default_limit,
  default_limit_unit,
  status,
  metadata
from public.features
where feature_key in (
  'mathlo.ai_ocr_analysis',
  'mathlo.ai_twin_problem_generate',
  'mathlo.ai_essay_feedback'
)
order by feature_key;

-- 3. 최종 보류 요금제 버전 확인
select
  p.plan_key,
  p.title,
  pv.version_key,
  pv.price_label,
  pv.billing_interval,
  pv.status,
  pv.metadata
from public.plan_versions pv
join public.plans p on p.id = pv.plan_id
where pv.version_key = 'v2026_policy_hold_kr'
order by p.display_order;

-- 4. 보류 요금제별 핵심 권한 확인
select
  p.plan_key,
  pv.version_key,
  pfl.feature_key,
  pfl.enabled,
  pfl.limit_value,
  pfl.limit_unit,
  pfl.metadata
from public.plan_feature_limits pfl
join public.plan_versions pv on pv.id = pfl.plan_version_id
join public.plans p on p.id = pv.plan_id
where pv.version_key = 'v2026_policy_hold_kr'
order by p.display_order, pfl.feature_key;

3. 체험권 부여 테스트 SQL

실제 결제 없이 특정 로그인 이메일에 기간제 권한을 부여해 `entitlement_grants` 흐름을 확인합니다.

체험권 받을 이메일 체험 플랜 기간