> For the complete documentation index, see [llms.txt](https://docs.waveon.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.waveon.io/workspace/basics.md).

# 워크스페이스 기본

워크스페이스는 팀이 함께 앱을 관리하고 운영하는 공간입니다.

***

### 워크스페이스란?

#### 개념

**워크스페이스**는 앱과 데이터를 팀 단위로 관리하는 공간입니다.

```
Workspace (워크스페이스)
├── Apps (앱들)
│   ├── 직원 관리 앱
│   ├── 재고 관리 앱
│   └── 고객 관리 앱
├── Data (데이터)
└── Members (멤버)
    ├── Owner
    ├── Admin
    └── Members
```

#### 사용 예시

| 워크스페이스 이름 | 포함 앱              | 멤버       |
| --------- | ----------------- | -------- |
| ABC 회사    | 인사관리, 재고관리, CRM   | 전 직원     |
| 마케팅팀      | 캠페인 관리, 리드 수집     | 마케팅팀원    |
| 프로젝트 A    | 프로젝트 대시보드, 이슈 트래커 | 프로젝트 참여자 |

***

### 워크스페이스 생성

#### Step 1: 생성 페이지 이동

1. 대시보드 상단의 워크스페이스 드롭다운 클릭
2. **\[+ 새 워크스페이스]** 선택

#### Step 2: 정보 입력

| 필드          | 설명                    |
| ----------- | --------------------- |
| **이름**      | 워크스페이스 이름 (예: ABC 회사) |
| **설명** (선택) | 워크스페이스 용도 설명          |

#### Step 3: 생성 완료

**\[생성]** 버튼을 클릭하면 워크스페이스가 생성됩니다.

***

### 워크스페이스 구조

#### 사이드바

| 메뉴       | 설명           |
| -------- | ------------ |
| **앱**    | 워크스페이스의 앱 목록 |
| **데이터**  | 데이터 관리       |
| **프로젝트** | 프로젝트 목록      |
| **설정**   | 워크스페이스 설정    |

#### 메인 영역

선택한 앱이 실행되는 공간입니다.

***

### 앱 추가하기

#### 기존 앱 추가

1. 워크스페이스 앱 목록에서 **\[+ 앱 추가]** 클릭
2. 기존에 만든 앱 선택
3. **\[추가]** 클릭

#### 새 앱 만들기

1. **\[+ 새 앱 만들기]** 클릭
2. v3 에디터에서 앱 생성
3. 자동으로 워크스페이스에 추가됨

***

### 멤버 역할

#### 역할 종류

| 역할         | 권한                 |
| ---------- | ------------------ |
| **Owner**  | 모든 권한 + 워크스페이스 삭제  |
| **Admin**  | 앱 관리, 멤버 초대, 설정 변경 |
| **Member** | 앱 사용, 데이터 조회/입력    |

#### 역할별 상세 권한

| 권한        | Owner | Admin | Member |
| --------- | ----- | ----- | ------ |
| 앱 사용      | ✅     | ✅     | ✅      |
| 데이터 입력    | ✅     | ✅     | ✅      |
| 앱 편집      | ✅     | ✅     | ❌      |
| 앱 추가/삭제   | ✅     | ✅     | ❌      |
| 멤버 초대     | ✅     | ✅     | ❌      |
| 멤버 역할 변경  | ✅     | ✅     | ❌      |
| 설정 변경     | ✅     | ✅     | ❌      |
| 워크스페이스 삭제 | ✅     | ❌     | ❌      |

***

### 멤버 초대

#### Step 1: 초대 페이지

1. 워크스페이스 설정 → **멤버** 탭
2. **\[멤버 초대]** 클릭

#### Step 2: 초대 정보 입력

| 필드      | 설명              |
| ------- | --------------- |
| **이메일** | 초대할 사람의 이메일     |
| **역할**  | Admin 또는 Member |

#### Step 3: 초대 발송

**\[초대]** 버튼을 클릭하면 초대 이메일이 발송됩니다.

#### 초대 수락

초대받은 사람이 이메일의 링크를 클릭하면 워크스페이스에 참여합니다.

***

### 워크스페이스 전환

여러 워크스페이스에 참여하고 있다면 쉽게 전환할 수 있습니다.

1. 상단의 워크스페이스 드롭다운 클릭
2. 이동할 워크스페이스 선택

***

### 워크스페이스 vs 개인 대시보드

| 항목         | 개인 대시보드  | 워크스페이스 |
| ---------- | -------- | ------ |
| **용도**     | 개인 앱 관리  | 팀 협업   |
| **앱 공유**   | 링크 공유    | 자동 공유  |
| **데이터 공유** | 별도 설정 필요 | 자동 공유  |
| **멤버 관리**  | 없음       | 있음     |
| **권한 관리**  | 없음       | 역할 기반  |

***

### 다음 단계

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>앱 실행하기</strong></td><td>워크스페이스에서 앱 사용</td><td></td></tr><tr><td><strong>팀 협업</strong></td><td>멤버 관리와 권한 설정</td><td></td></tr><tr><td><strong>설정</strong></td><td>워크스페이스 설정 관리</td><td></td></tr></tbody></table>