> ## Documentation Index
> Fetch the complete documentation index at: https://docs.studynest.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 장애 대응 체크리스트

> 로그인, 메뉴, API, OCI, 메일 문제를 순서대로 점검합니다.

## 개요

로그인, 메뉴, API, OCI, 메일 문제를 순서대로 점검합니다. 이 문서는 StudyNest의 현재 메뉴 구조를 기준으로 작성되었습니다.

## 대상 사용자

* Platform 관리자
* Tenant 관리자
* Service 사용자
* API 개발자

## 필요한 권한

* 작업에 맞는 역할과 권한

## 접근 경로

* 화면 권한과 배포 설정에 따라 접근 경로가 달라질 수 있습니다.

## 작업 전 확인사항

* Active Tenant가 올바른지 확인합니다.
* 작업 대상 사용자의 권한과 역할을 확인합니다.
* 변경 영향 범위를 확인합니다.

## 작업 절차

1. 증상을 분류합니다.
2. 계정, 권한, Active Tenant를 먼저 확인합니다.
3. API 또는 애플리케이션 로그를 확인합니다.
4. 필요한 경우 관리자에게 조치를 요청합니다.

## 작업 결과 확인

* 변경 후 대상 목록이나 상세 화면을 새로 고칩니다.
* 감사 로그 또는 최근 활동에 작업 이력이 남았는지 확인합니다.
* 관련 사용자가 의도한 메뉴와 데이터에 접근할 수 있는지 확인합니다.

## 문제 해결

| 증상            | 1차 확인           | 2차 확인          |
| ------------- | --------------- | -------------- |
| 로그인 실패        | 계정 상태, 테넌트 slug | 세션 또는 인증 로그    |
| 메뉴 미노출        | 권한, 활성 테넌트      | 역할 바인딩         |
| API 401/403   | JWT, 권한         | 테넌트 context    |
| API Key 호출 실패 | Key 상태, 만료일     | 프로젝트 또는 서비스 연결 |
| OCI 작업 실패     | 작업 상태           | OCI 콘솔 리소스     |
| 메일 미발송        | SMTP 설정         | 애플리케이션 로그      |

## 관련 문서

* `ko/concepts/permissions` - 권한 모델 요약