조직 : 팀(Team)

Wed, 10 Dec 2025 11:03:19 GMT

## 개요

Team 페이지는 조직의 팀 멤버를 관리하는 페이지입니다. Owner 또는 Admin 권한을 가진 사용자가 멤버 초대, 역할 변경, 멤버 제거 등의 작업을 수행할 수 있습니다.

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

## 주요 기능

### 1. 멤버 목록

조직에 가입한 활성 멤버와 보류 중인 초대를 구분하여 표시합니다.

### Active Members (활성 멤버)

**표시 정보**:

- 멤버 아바타 이미지

- 이름 (또는 닉네임, 이메일)

- 이메일 주소

- 역할 (Owner, Admin, Member, Billing)

- 상태 (Active)

- 가입일

- 현재 사용자 표시 (you 라벨)

### Pending Invitations (보류 중인 초대)

**표시 정보**:

- 초대받은 사람 이름/이메일

- 역할

- 초대 상태 (pending, expired, cancelled)

- 만료일

### 2. 멤버 초대

**권한 요구사항**: Owner 또는 Admin

**사용 방법**:

1. "멤버 초대" 버튼 클릭

2. 초대 폼 작성:

- 이름 입력 (필수)

- 이메일 주소 입력 (필수)

- 역할 선택 (member, admin, billing)

3. "초대장 전송" 버튼 클릭

4. 초대 이메일 자동 발송

### 3. 역할 변경

**권한 요구사항**: Owner 또는 Admin

**제한 사항**:

- Owner 역할은 변경 불가

- 본인의 역할은 변경 불가

**사용 방법**:

1. 멤버 행의 액션 메뉴 클릭

2. "역할 변경" 선택

3. 새로운 역할 선택

4. "변경" 버튼 클릭

### 4. 멤버 제거

**권한 요구사항**: Owner만 가능

**제한 사항**:

- Owner는 제거 불가

- 본인은 제거 불가

**사용 방법**:

1. 멤버 행의 액션 메뉴 클릭

2. "멤버 제거" 선택

3. 확인 다이얼로그에서 이메일 확인 입력

4. "제거" 버튼 클릭

### 5. 초대 관리

### 초대 재전송

**권한 요구사항**: Owner 또는 Admin

**사용 방법**:

1. Pending Invitations 테이블에서 해당 초대 확인

2. "초대 재전송" 버튼 클릭

3. 기존 초대 취소 후 새 초대 자동 생성

### 초대 취소

**권한 요구사항**: Owner만 가능

**사용 방법**:

1. Pending Invitations 테이블에서 해당 초대 확인

2. "초대 취소" 버튼 클릭

3. 초대 상태가 'cancelled'로 변경

### 6. 검색 및 필터링

### 검색

- 이름 또는 이메일로 실시간 검색

- 대소문자 구분 없음

### 역할 필터

- All (전체)

- Owner (소유자)

- Admin (관리자)

- Member (멤버)

- Billing (결제 담당자)

### 상태 필터

- All (전체)

- Active (활성)

- Pending (보류 중)

## 역할 및 권한

### 역할 구성

※ 현재 Beta에서는 Owner와 Member 역할만 사용할 수 있습니다.

| 역할 | 아이콘 | 설명 |
| --- | --- | --- |
| Owner | 👑 Crown | 조직의 소유자, 모든 권한 |
| Admin | 🛡️ Shield | 관리자, 대부분의 관리 권한 (준비 중) |
| Member | 👤 User | 일반 멤버, 제한된 권한 |
| Billing | 💳 CreditCard | 결제 담당자, 결제 관련 권한 (준비 중) |

### 권한 체계

### Owner 권한

- 멤버 초대

- 역할 변경 (Owner 제외)

- 멤버 제거 (Owner 및 본인 제외)

- 초대 재전송

- 초대 취소

### Member 권한

- 멤버 목록 조회만 가능

- 관리 작업 불가

## 팀원 초대 상태

| 상태 | 설명 | 색상 |
| --- | --- | --- |
| Pending | 대기 중 | 노란색 (warning) |
| Expired | 만료됨 | 빨간색 (error) |
| Cancelled | 취소됨 | 회색 (muted) |