> 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/running-apps.md).

# 앱 실행하기

워크스페이스에서 앱을 실행하고 실제 업무에 활용하는 방법입니다.

***

### 앱 실행하기

#### Step 1: 앱 선택

워크스페이스 사이드바에서 실행할 앱을 클릭합니다.

#### Step 2: 앱 사용

선택한 앱이 메인 영역에서 실행됩니다.

* **전체 화면**으로 앱 사용
* 에디터가 아닌 **실제 운영 환경**
* 입력한 데이터가 **실제로 저장**됨

***

### 에디터 vs 워크스페이스

| 항목        | 에디터 (v3)              | 워크스페이스    |
| --------- | --------------------- | --------- |
| **목적**    | 앱 개발/수정               | 앱 사용/운영   |
| **화면 구성** | Chat + Code + Preview | 앱 전체 화면   |
| **데이터**   | 개발용 데이터               | 실제 운영 데이터 |
| **접근 권한** | 앱 소유자/편집자             | 워크스페이스 멤버 |

***

### 앱 URL 구조

#### 워크스페이스 내 앱 URL

```
https://waveon.io/workspaces/{workspaceId}/apps/{appId}
```

#### 독립 앱 URL (배포된 앱)

```
https://{app-name}.waveon.io
```

***

### 데이터 저장

워크스페이스에서 입력한 데이터는 **실제 데이터베이스**에 저장됩니다.

#### 에디터 Preview와의 차이

| 환경          | 데이터 저장 위치      |
| ----------- | -------------- |
| 에디터 Preview | 개발용 (배포 전 테스트) |
| 워크스페이스 앱    | 운영용 (실제 데이터)   |
| 배포된 앱       | 운영용 (실제 데이터)   |

{% hint style="warning" %}
워크스페이스에서 입력한 데이터는 실제 데이터입니다. 테스트용 데이터를 입력할 때 주의하세요.
{% endhint %}

***

### 앱 편집하기

워크스페이스에서 앱을 수정하려면:

#### 방법 1: 편집 버튼

앱 실행 화면에서 **\[편집]** 버튼 클릭 (Admin 이상)

#### 방법 2: 사이드바 메뉴

1. 앱 이름 옆 **⋯** 버튼 클릭
2. **\[편집]** 선택

편집 버튼을 클릭하면 v3 에디터가 열립니다.

***

### 앱 공유

#### 워크스페이스 멤버에게

워크스페이스에 초대된 멤버는 자동으로 모든 앱에 접근할 수 있습니다.

→ 멤버 초대하기

#### 외부 사용자에게

앱을 배포하고 URL을 공유합니다.

1. 앱 편집 → **\[배포]**
2. 생성된 URL 공유

***

### 여러 앱 사용하기

#### 앱 간 전환

사이드바에서 다른 앱을 클릭하면 바로 전환됩니다.

* 현재 앱의 데이터는 저장됨
* 새 앱이 로드됨

#### 새 탭에서 열기

앱을 새 탭에서 열어 여러 앱을 동시에 사용할 수 있습니다.

1. 앱 이름 우클릭
2. **"새 탭에서 열기"** 선택

***

### 모바일에서 사용

워크스페이스 앱은 모바일 브라우저에서도 사용할 수 있습니다.

#### 접속 방법

1. 모바일 브라우저에서 워크스페이스 URL 접속
2. 로그인
3. 앱 선택 후 사용

#### 모바일 최적화

앱이 모바일에서 잘 보이려면 반응형으로 개발해야 합니다.

```
모바일에서도 잘 보이게 반응형으로 수정해줘.
작은 화면에서 테이블은 가로 스크롤이 되게 하고,
폼 필드는 세로로 쌓이게 해줘.
```

***

### 문제 해결

#### 앱이 로딩되지 않아요

1. 페이지 새로고침
2. 브라우저 캐시 삭제
3. 다른 브라우저에서 시도

#### 데이터가 저장되지 않아요

1. 네트워크 연결 확인
2. 필수 필드 입력 확인
3. 에디터에서 데이터 저장 기능 확인

#### 접근 권한이 없다고 나와요

1. 워크스페이스 멤버인지 확인
2. Admin에게 권한 요청

***

### 다음 단계

<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></tbody></table>