> ## 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 접근을 함께 제어합니다. 역할은 권한의 묶음이고, 사용자는 테넌트 멤버십을 통해 역할을 부여받습니다.

## 권한 코드

| 권한                               | 의미              |
| -------------------------------- | --------------- |
| `platform.admin`                 | 플랫폼 관리 권한       |
| `tenant.read` / `tenant.write`   | 테넌트 조회와 수정      |
| `user.read` / `user.write`       | 사용자 조회와 관리      |
| `role.read` / `role.write`       | 역할 조회와 관리       |
| `project.read` / `project.write` | 프로젝트 조회와 관리     |
| `apikey.read` / `apikey.write`   | API Key 조회와 관리  |
| `service.read` / `service.write` | 서비스 카탈로그 조회와 관리 |
| `usage.read`                     | 사용량 조회          |
| `cost.read`                      | 비용과 예산 조회       |
| `audit.read`                     | 감사 로그 조회        |

<Warning>
  권한 변경은 사용자의 메뉴 노출과 API 접근에 바로 영향을 줄 수 있습니다. 운영 중 변경 전에는 대상 사용자와 테넌트 범위를 확인하십시오.
</Warning>