1.6 KiB
1.6 KiB
2026-03-27: 권한 진단 (Permission Audit) 기능 구현 Implementation
봇의 주요 기능들이 정상 작동하기 위해 필요한 권한들을 자동으로 점검하고 관리자에게 보고하는 진단 시스템을 구현했습니다.
주요 변경 사항
1. PermissionAuditService 구현
- 기능별 권한 매핑: 음성 채널 자동화, 초대 추적, Mimic Webhook 등 봇의 주요 기능별 최소 필요 권한을 정의했습니다.
- 정밀 진단: 서버 수준의 전역 권한뿐만 아니라, 음성 생성기 채널 및 카테고리에 설정된 채널별 권한(Override)까지 상세히 스캔합니다.
- 계층 구조 검사: 봇 역할(Role)의 순위가 관리 대상 인원이나 역할보다 높은지 확인하는 계층 구조 검사 로직을 포함했습니다.
2. 관리자 명령어 (/audit-permissions)
- 관리자가 실시간으로 봇의 권한 상태를 확인할 수 있는 인터페이스를 제공합니다.
- 상태 표기: ✅(정상), ⚠️(채널 권한 주의), ❌(필수 권한 누락) 아이콘을 통해 직관적인 보고서를 출력합니다.
- Actionable Info: 누락된 권한이 있을 경우 "Missing: ..." 항목을 통해 정확히 어떤 권한을 추가해야 하는지 안내합니다.
3. 다국어 지원 (i18n)
- 봇의 언어 설정(EN, KO)에 따라 진단 결과 보고서의 모든 레이블과 설명이 올바르게 번역되어 출력됩니다.
검정 결과
npx tsc --noEmit: 컴파일 성공 및 타입 안정성 확인.- Guild 및 Channel 수준의 권한 점검 로직의 정확성 테스트 완료.