프로젝트 : 설정(Settings)

Wed, 10 Dec 2025 11:54:32 GMT

## 개요

프로젝트의 기본 정보를 확인하고, 일반 설정을 수정하며, 프로젝트 삭제와 같은 위험한 작업을 수행하는 설정 페이지입니다.

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

## 주요 기능

### 1. 프로젝트 정보

프로젝트의 기본 정보를 읽기 전용으로 확인할 수 있습니다.

**표시 항목**:

### 식별 정보

- **프로젝트 ID**: UUID 형태, 복사 가능 (복사 버튼 클릭 시 클립보드에 자동 복사)

- **Slug**: URL-safe 식별자 (예: `my-project`)

### 메타데이터

- **생성일**: 프로젝트 생성 날짜

- **상태**: active / archived / deleted

- active: 활성 상태 (기본 배지)

- archived: 보관됨 (보조 배지)

- deleted: 삭제됨 (위험 배지)

- **클라우드**: AWS / Google Cloud / Azure

- **리전**: 프로젝트의 주 리전 (예: `ap-northeast-2`)

### 2. 일반 설정

프로젝트의 이름과 설명을 수정할 수 있습니다.

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

**편집 가능 필드**:

1. **프로젝트 이름 (name)**

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

- 1-100자

- 필수 입력

2. **설명 (description)**

- 프로젝트의 목적이나 특징 설명

- 최대 500자 (선택 사항)

**사용 방법**:

1. 필드 수정

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

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

**참고**: 권한이 없는 사용자(Member)에게는 입력 필드가 비활성화되며 "변경사항 저장" 버튼이 표시되지 않습니다.

### 3. 위험 구역 (Danger Zone)

**권한**: Owner 또는 Admin만 접근 가능

프로젝트를 삭제할 수 있는 위험한 작업 영역입니다. 빨간색 테두리로 강조 표시됩니다.

### 프로젝트 삭제

**사용 방법**:

1. "프로젝트 삭제" 버튼 클릭

2. 삭제 확인 다이얼로그가 표시됨

3. 경고 메시지 확인:

- 모든 환경과 테이블

- 모든 데이터와 스키마

- 모든 API 엔드포인트와 설정

4. 확인을 위해 프로젝트 이름을 정확히 입력

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

**주의사항**:

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

- 프로젝트와 관련된 모든 데이터가 영구적으로 삭제됩니다

- 프로젝트 이름을 정확히 입력해야 삭제 버튼이 활성화됩니다

- 삭제 완료 후 자동으로 프로젝트 목록 페이지로 이동합니다

## 사용 방법

### 프로젝트 정보 확인하기

1. Settings 페이지 접속

2. "프로젝트 정보" 섹션에서 기본 정보 확인

3. 프로젝트 ID 복사 버튼을 클릭하여 ID를 클립보드에 복사

### 프로젝트 이름과 설명 수정하기

1. "일반 설정" 섹션으로 이동

2. 프로젝트 이름 또는 설명 수정

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

4. 성공 메시지 확인

### 프로젝트 삭제하기

1. "위험 구역" 섹션으로 스크롤

2. "프로젝트 삭제" 버튼 클릭

3. 경고 메시지를 주의 깊게 읽기

4. 프로젝트 이름을 정확히 입력

5. "영구 삭제" 버튼 클릭하여 확정

## 권한 시스템

| 역할 | 정보 확인 | 일반 설정 편집 | 프로젝트 삭제 |
| --- | --- | --- | --- |
| Owner | ✓ | ✓ | ✓ |
| Admin | ✓ | ✓ | ✓ |
| Member | ✓ | ✗ | ✗ |

**참고**: 권한은 소속된 조직에서의 역할에 따라 결정됩니다.