PERMISSIONS
3단계 권한 체계
봇관리자 → 서버장 → 관리자. 봇관리자만 봇 운영자 본인이고, 서버장·관리자는 각 서버에서 명령어로 임명합니다.
🤖 봇관리자
BOT ADMIN봇 운영자 본인. 모든 서버에서 최상위 권한을 가집니다.
- 모든 서버에서 모든 명령어 사용
- 각 서버의 서버장 임명/해임
- 비공개 봇관리자 전용 명령어 사용
- 봇 전역 설정 변경
👑 서버장
OWNER각 서버별로 분리. 해당 서버의 클린봇 설정 전권을 가집니다.
- 해당 서버 내 모든 명령어
- 관리자 임명/해임
- 클린 강도 변경
- 화이트·블랙리스트 관리
- 서버별 감시 대상 설정
- 다른 서버장 제재 불가 (안전장치)
🛡️ 관리자
ADMIN서버장이 임명. 일반 운영 보조 역할입니다.
- 클린 테스트 / 통계 조회
- 일반 멤버 타임아웃/해제
- 화이트·블랙리스트 조회
- 강도 변경·시작/중지 불가
- 다른 관리자/서버장 제재 불가
권한 임명 흐름
새 서버에 봇이 들어오면 다음 순서로 권한이 설정됩니다.
1
봇 초대
서버에 클린봇 추가 + 관리자 권한 부여
→
2
서버장 임명
봇관리자가 방문해!서버장임명 @서버주인
→
3
초기 설정
서버장이!감시대상 등 설정
→
4
관리자 임명
서버장이!관리자임명 @관리자
설정 저장 방식
🌐 전역 설정 (모든 서버 공통)
봇 호스팅 환경변수
- 봇관리자 ID 목록
- 위험 명령어 비밀번호
- Discord 봇 토큰 · OpenAI API 키
🏠 서버별 설정 (서버마다 분리)
봇 내부 데이터베이스
- 서버장 / 관리자 명단
- 감시 대상 · 로그 채널
- 클린 강도 / 카테고리 ON-OFF
- 화이트리스트 · 블랙리스트
- 클린 통계 · 자동 타임아웃 설정
📌 각 서버는 권한·설정이 완전히 독립적이에요. 한 서버에서 임명된 관리자가 다른 서버로 권한이 이어지지 않습니다.
안전장치
🔒
상호 제재 방지
봇관리자 ↔ 봇관리자, 서버장 ↔ 서버장, 관리자 ↔ 관리자는 서로 제재 불가. 하위 권한이 상위 권한을 제재하는 것도 불가.
⚖️
자동 클린 예외 없음
봇관리자·서버장·관리자도 욕설하면 클린 대상. 화이트리스트에 별도 등록해야 예외 처리됨 (의도된 설계).
🔐
내부 명령어 비공개
봇관리자 전용 명령어 중 공개된 것은 서버장 임명/해임뿐. 그 외 내부 운영용 명령어는 비공개로 보호되어, 외부 노출 시 악용 위험을 차단합니다.