26 lines
1.8 KiB
Markdown
26 lines
1.8 KiB
Markdown
# 구독 티어 시스템 (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` 모델을 참조하여 현재 서버 내 카운트와 상한선을 대조한 뒤 통과 여부를 결정합니다.
|