프로모션 코드

프로모션 코드를 생성하여 사용자에게 Pro 플랜 무료 이용 기간을 제공합니다.

생성 방법

Firestore Console에서 루트 레벨 promoCodes 컬렉션에 문서를 추가합니다.

경로: promoCodes/{코드}

문서 ID를 코드와 동일하게 설정하세요.

{
  "code": "PRO-3M-PARTNER2026",
  "durationDays": 90,
  "label": "2026 파트너 프로모션 3개월",
  "maxUses": 1,
  "usedCount": 0,
  "usedBy": [],
  "active": true,
  "createdAt": "Timestamp (서버 타임스탬프)",
  "expiresAt": null
}

필드 설명

필드	타입	설명
code	string	프로모션 코드 (문서 ID와 동일)
durationDays	number	Pro 플랜 무료 기간 (일 수)
label	string	관리용 설명
maxUses	number	최대 사용 횟수
usedCount	number	현재 사용 횟수 (0으로 시작)
usedBy	array	사용자 기록
active	boolean	활성 여부
createdAt	Timestamp	생성 시간
expiresAt	Timestamp or null	만료 시간 (null이면 무제한)

사용자 적용 경로

설정 > 플랜 탭 > 프로모션 코드 입력 → 검증 → Pro 플랜 활성화

보안

• promoCodes 컬렉션은 Firestore Rules에서 클라이언트 읽기/쓰기 모두 차단
• 모든 조회/검증은 Server Action(Admin SDK)으로만 처리