조직 : 설정(Settings)

Wed, 10 Dec 2025 11:04:43 GMT

## 개요

조직의 기본 정보, API 키, 보안, 감사 로그 및 위험한 작업들을 관리하는 종합 설정 페이지입니다.

**경로**: `/org/{orgSlug}/settings`

## 탭 구조

Settings 페이지는 여러 탭으로 구성되어 있습니다:

- **General**: 조직 기본 정보 관리

- **API Keys**: API 액세스 토큰 관리

- **Billing**: 결제 및 구독 관리 (Coming Soon)

- **Security**: 보안 설정 (Coming Soon)

- **Audit**: 활동 로그 및 감사 추적 (Coming Soon)

- **Danger**: 소유권 이전, 조직 탈퇴, 조직 삭제

## General 탭

### 조직 정보 카드

**표시 항목**:

- **조직 ID**: UUID 형태, 복사 가능

- **Slug**: URL-safe 식별자

- **생성일**: 조직 생성 날짜

- **플랜**: starter / growth / enterprise

- **상태**: active / suspended / cancelled

### 일반 설정 폼

**권한**: Owner 또는 Admin만 편집 가능

**편집 가능 필드**:

1. **조직 이름 (name)**

- URL과 API에서 사용되는 고유 식별자

- 1-100자

2. **표시 이름 (displayName)**

- UI에 표시되는 조직의 이름

- 최대 200자 (선택 사항)

3. **설명 (description)**

- 조직의 목적이나 특징 설명

- 최대 500자 (선택 사항)

**사용 방법**:

1. 필드 수정

2. "변경사항 저장" 버튼 클릭

3. 성공 시 토스트 메시지 표시

4. slug 변경 시 자동으로 새 URL로 이동

## API Keys 탭

API 액세스 토큰을 관리하는 별도 페이지로 연결됩니다.

**경로**: `/org/{orgSlug}/settings/tokens`

### 액세스 토큰 생성

**사용 방법**:

1. "토큰 생성" 버튼 클릭

2. 토큰 정보 입력:

- **토큰 이름**: 식별하기 쉬운 이름

- **토큰 타입**: API 키 또는 Bearer 토큰

- **권한 (Scopes)**: 최소 1개 이상 선택

3. "토큰 생성" 버튼 클릭

4. **중요**: 생성된 토큰을 즉시 복사하여 안전하게 보관 (다시 확인 불가)

### 권한 범위 (Scopes)

### 프로젝트 권한

- `project:read` - 프로젝트 읽기

- `project:create` - 프로젝트 생성

- `project:update` - 프로젝트 수정

- `project:delete` - 프로젝트 삭제

- `project:*` - 프로젝트 모든 권한

### 환경 권한

- `environment:read` - 환경 읽기

- `environment:create` - 환경 생성

- `environment:update` - 환경 수정

- `environment:delete` - 환경 삭제

- `environment:*` - 환경 모든 권한

### 테이블 권한

- `table:read` - 테이블 읽기

- `table:create` - 테이블 생성

- `table:update` - 테이블 수정

- `table:delete` - 테이블 삭제

- `table:*` - 테이블 모든 권한

### 테이블 데이터 권한

- `table:data:read` - 데이터 읽기

- `table:data:create` - 데이터 생성

- `table:data:update` - 데이터 수정

- `table:data:delete` - 데이터 삭제

- `table:data:*` - 데이터 모든 권한

### 대시보드 권한

- `dashboard:read` - 대시보드 읽기

- `dashboard:*` - 대시보드 모든 권한

### 전체 권한

- `*:read` - 모든 읽기 권한

- `*:create` - 모든 생성 권한

- `*:update` - 모든 수정 권한

- `*:delete` - 모든 삭제 권한

- `*:*` - 모든 권한

### 토큰 관리

### 활성 토큰 테이블

**표시 정보**:

- 이름

- 타입 (API_KEY / BEARER_TOKEN)

- 권한 범위 (Badge 형태, 최대 2개 표시)

- 마지막 사용

- 생성일

**작업**:

- **토큰 복사**: 드롭다운 메뉴에서 선택

- **폐기**: 드롭다운 메뉴에서 선택 (빨간색)

### 폐기된 토큰 테이블

- 폐기 또는 만료된 토큰 표시

- 투명도 60%로 표시

- 폐기일 표시

## Danger 탭

**주의**: 이 섹션의 모든 작업은 되돌릴 수 없습니다!

### Owner 전용 기능

### 소유권 이전

**사용 방법**:

1. "소유권 이전" 버튼 클릭

2. 새 소유자 선택 (드롭다운)

3. "transfer" 입력하여 확인

4. "소유권 이전" 버튼 클릭

**주의사항**:

- 이전 후 본인은 관리자(admin)가 됩니다

- 새 소유자가 완전한 제어권을 갖게 됩니다

- 이 작업은 취소할 수 없습니다

### 조직 삭제

**사용 방법**:

1. "조직 삭제" 버튼 클릭

2. 조직 이름을 정확히 입력

3. "영구 삭제" 버튼 클릭

**삭제되는 내용**:

- 모든 프로젝트와 데이터

- 모든 팀 멤버의 접근 권한

- 모든 환경 설정과 시크릿

### Non-Owner 전용 기능

### 조직 탈퇴

**사용 방법**:

1. "조직 탈퇴" 버튼 클릭

2. "leave" 입력하여 확인

3. "조직 탈퇴" 버튼 클릭

**주의사항**:

- 조직의 프로젝트와 데이터에 더 이상 접근할 수 없습니다

- 다시 가입하려면 소유자의 초대가 필요합니다

- 이 작업은 되돌릴 수 없습니다

## 보안 주의사항

### API 토큰 관리

- 토큰은 생성 시 **한 번만** 표시됩니다

- 토큰을 안전한 곳에 보관하세요

- 토큰이 유출된 경우 즉시 폐기하세요

- 필요한 최소 권한만 부여하세요

### 조직 관리

- 소유권 이전은 신중하게 결정하세요

- 조직 삭제 전 중요 데이터를 백업하세요

- 팀 멤버 제거 시 작업 중인 내용을 확인하세요