의견 메인 탭 승격 + 코스 무료 슬롯 폐지 + 등급별 월 부스트 한도 — POP-SPOT v2.12

// v2.12 — src/lib/rank.ts. 프론트 장의 등급 임계
export const RANK_THRESHOLD = { BEGINNER: 3, HUNTER: 6, MASTER: 12 } as const;
//                              ^^^^^^^^^^^^  ^^^^^^^^^^^ ^^^^^^^^^^
//                              스탬프 3개    6개        12개
// as const 은 추론된 타입을 최소로 고정. RANK_THRESHOLD.MASTER 가 number 가 아닌 12 리터럴 타입으로 고정됨
export function rankOf(stamps: number) {
  // 위: 입력 stamps (수집한 스탬프 개수) 에 따른 등급 계산
  if (stamps >= RANK_THRESHOLD.MASTER)   return 'MASTER';
  if (stamps >= RANK_THRESHOLD.HUNTER)   return 'HUNTER';
  if (stamps >= RANK_THRESHOLD.BEGINNER) return 'BEGINNER';
  // 위: 높은 등급부터 차례대로 검사. 순서 중요 — 반대로 하면 12보다 큰 수도 BEGINNER 로 결론 내려지게 됨
  return 'NONE';
  // 위: 스탬프 0~2개 — 아직 아무 등급도 못 달은 가입자. 부스트 쿠타 0.
}

// v2.12 — src/lib/boost.ts. 등급별 월간 부스트 사용 한도
export const BOOST_QUOTA = {
  MASTER: 5, HUNTER: 3, BEGINNER: 1, NONE: 0,
  //      ^         ^             ^         ^   등급이 높을수로 동행 부스트 획득 기회 많이
  //                                              "돈 내면 키워" 가 아닌 "스탬프 모으면 더 송출" 원리
} as const;

// v2.12 — BoostPolicy.java (백엔드). 프론트와 동일한 수치 — 둘 같이 갱신
public enum Rank {
//     ^^^^   자바 enum. 타입 안전 — Rank.MASTER 형식으로 쓰며 switch 에서 누락 감지 가능
    MASTER(12, 5), HUNTER(6, 3), BEGINNER(3, 1), NONE(0, 0);
    //     ^^  ^         ^  ^             ^  ^        ^  ^
    //     |   |         |  |             |  |        |  +-- monthlyBoost (등급별 월 한도)
    //     |   |         |  |             |  |        +----- minStamps (이 이상이면 해당 등급)
    //     |   |         |  |             |  +-------------- BEGINNER: 3 스탬프 이상 + 월 1회 부스트
    //     |   |         |  +------------------------------- HUNTER:   6 스탬프 + 월 3회
    //     |   +----------------------------------------- MASTER:   12 스탬프 + 월 5회
    private final int minStamps;
    private final int monthlyBoost;
    //                ^^^^^^^^^^^^   이 값을 BoostUsage.used_count 와 비교해 이번 달 추가 사용 가능 여부 판단
}

-- v2.12 — V8__boost.sql. 동행 게시글의 부스트 상태·사용 관리
ALTER TABLE mate_post
  ADD COLUMN boosted_until TIMESTAMP NULL;
  --         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^   이 시각까지 상단 노출. NULL 이면 부스트 안 된 일반 게시글
  --                                        조회 시 NOW() < boosted_until 조건을 ORDER BY 원조건으로 상단 정렬

CREATE TABLE boost_usage (
  user_id    BIGINT NOT NULL,
  year_month CHAR(7) NOT NULL,           -- '2026-05' 표기. 월 단위 추적
  used_count INT NOT NULL DEFAULT 0,     -- 이번 달에 쓴 부스트 회수. BoostPolicy.monthlyBoost 와 비교
  PRIMARY KEY (user_id, year_month)
  --           ^^^^^^^^^^^^^^^^^^^^^^   복합 PK. user·월 조합 1 개 레코드 유일.
  --                                     INSERT ... ON CONFLICT (user_id, year_month) DO UPDATE SET used_count=used_count+1
  --                                     패턴으로 upsert — 있으면 증가, 없으면 삽입
);