verify-permissions

Purpose

1. 역할-탭 매핑 정합성 - types/system.ts의 DEFAULT_TAB_PERMISSIONS와 실제 UI 동작이 일치하는지 검증
2. usePermissions 훅 사용 - 권한이 필요한 컴포넌트에서 usePermissions를 올바르게 호출하는지 검증
3. useTabPermissions 필터링 - Sidebar에서 역할에 따라 탭이 올바르게 필터링되는지 검증
4. 권한 기반 UI 분기 - 버튼/메뉴의 조건부 렌더링이 역할에 따라 올바르게 동작하는지 검증

When to Run

• types/system.ts의 역할 또는 탭 권한을 수정한 후
• hooks/usePermissions.ts 또는 hooks/useTabPermissions.ts 수정 후
• 관리자 전용 기능을 추가하거나 수정한 후
• 새로운 역할(role)을 추가한 후
• components/Navigation/Sidebar.tsx 수정 후

Related Files

Workflow

Step 1: 8개 역할 정의 완전성 검증

검사: types/system.ts에 8개 역할이 모두 정의되어 있는지 확인합니다.

grep -n "master\|admin\|manager\|math_lead\|english_lead\|math_teacher\|english_teacher\|'user'" types/system.ts | head -20

PASS 기준: 8개 역할(master, admin, manager, math_lead, english_lead, math_teacher, english_teacher, user) 모두 참조 FAIL 기준: 역할 정의 누락

Step 2: DEFAULT_TAB_PERMISSIONS 구조 검증

검사: 모든 역할에 대해 허용 탭 배열이 정의되어 있는지 확인합니다.

grep -A 2 "DEFAULT_TAB_PERMISSIONS" types/system.ts | head -15

PASS 기준: DEFAULT_TAB_PERMISSIONS에 8개 역할의 키가 존재 FAIL 기준: 역할 키 누락

Step 3: useTabPermissions 훅 → Sidebar 연결 검증

검사: Sidebar에서 useTabPermissions를 사용하여 탭을 필터링하는지 확인합니다.

grep -n "useTabPermissions\|accessibleTabs\|filteredTabs" components/Navigation/Sidebar.tsx | head -5

PASS 기준: Sidebar에서 탭 필터링 로직 존재 FAIL 기준: Sidebar가 권한 없이 모든 탭을 표시

수정: const accessibleTabs = useTabPermissions() 추가 후 탭 목록 필터링

Step 4: 관리자 전용 탭 접근 제한 검증

검사: payment, role-management 탭이 일반 교사(math_teacher, english_teacher) 역할에서 제외되는지 확인합니다.

grep -A 5 "math_teacher\|english_teacher" types/system.ts | grep -v "payment\|role-management" | head -10

PASS 기준: 교사 역할의 탭 목록에 payment, role-management가 포함되지 않음 FAIL 기준: 교사가 관리자 전용 탭에 접근 가능

Step 5: usePermissions import 확인

검사: 권한 체크가 필요한 주요 관리 컴포넌트에서 usePermissions를 import하는지 확인합니다.

grep -rl "usePermissions" components/Staff/ components/Billing/ components/RoleManagement/ components/PaymentReport/ 2>/dev/null

PASS 기준: 관리 탭의 주요 컴포넌트에서 usePermissions 사용 FAIL 기준: 권한 체크 없이 관리 기능 접근 가능

Step 6: AppTab 타입과 TAB_META 동기화 검증

검사: AppTab 유니온 타입의 모든 값이 TAB_META에도 정의되어 있는지 확인합니다.

grep -c "AppTab" types/system.ts
grep "'dashboard'\|'calendar'\|'timetable'\|'payment'\|'gantt'\|'consultation'\|'attendance'\|'students'\|'grades'\|'classes'\|'classroom'\|'classroom-assignment'\|'student-consultations'\|'staff'\|'daily-attendance'\|'billing'\|'role-management'\|'resources'\|'withdrawal'\|'help'" types/system.ts | head -5

PASS 기준: AppTab의 모든 값(19개+)이 TAB_META에 메타데이터가 존재 FAIL 기준: 탭 타입은 있지만 메타데이터가 없는 탭 존재

Output Format

Exceptions

다음은 위반이 아닙니다:

1. 대시보드와 도움말의 전체 접근 - dashboard, help 탭은 모든 역할에서 접근 가능한 것이 정상
2. useRoleSimulation의 권한 우회 - 개발/테스트 환경에서 역할 시뮬레이션은 실제 권한 체크를 우회할 수 있음
3. 컴포넌트 내부 권한 체크와 탭 필터링의 중복 - 탭 레벨과 컴포넌트 레벨에서 이중으로 권한을 체크하는 것은 보안 심층 방어 패턴