1.8 KiB

Raw Permalink Blame History

구독 티어 시스템 (Subscription Tiers)

체인지로그 (Changelog)

2026-03-27: 구독 티어제 체제 설계, 서버 내 생성용 채널 허용 개수 지정 정책화

본문 (Body)

1. 개요 및 설계 의도

이 문서는 사용자의 "구독 티어(Subscription Tier)"에 따른 시스템 제한을 설명합니다. Kord의 인프라는 모든 서버 자원을 제한 없이 사용하는 것을 방어하기 위해 디스코드 봇을 초대한 관리자의 티어 수준(Free ~ Premium)에 맞춰 리소스를 할당합니다.

이는 음성 채널 분야뿐만 아니라 향후 개발될 로그 분석기, 커스텀 웹훅 등의 서비스에도 재사용할 수 있도록 UserSubscription 및 GuildOwnership 모델을 바탕으로 독립적으로 설계되었습니다.

2. 티어 구조 명세

티어를 보유하는 단위는 **사용자(User)**이며, 서버(Guild)는 소유자에게 귀속되어 티어를 상속받습니다.

티어 레벨 (Tier)	소유 가능한 적용 서버 수 한도	서버당 '생성용 채널' 개수 최대치
FREE (프리)	1인당 최대 1개 서버	서버당 최대 1개
STANDARD (스탠다드)	1인당 최대 3개 서버	서버당 최대 3개
PRO (프로)	1인당 최대 5개 서버	서버당 무제한 (`Unlimited`)
PREMIUM (프리미엄)	1인당 최대 10개 서버	서버당 무제한 (`Unlimited`)

3. 검증 로직 가이드

서버 소유권 연결 (GuildOwnership): 서버 관리자나 봇 초대자가 /claim을 통해 해당 서버의 티어 지갑을 본인과 연결합니다.
기능 제한 검사: 자원 획득(예: /voice-setup 등) 커맨드가 실행될 때 UserSubscription 모델을 참조하여 현재 서버 내 카운트와 상한선을 대조한 뒤 통과 여부를 결정합니다.

1.8 KiB Raw Permalink Blame History