# 워크스페이스와 프로젝트 설정하기

**워크스페이스**는 팀입니다. 멤버, 역할, 알림 채널, 감사 로그가 여기에 속합니다. 그 안의 **프로젝트**는 모바일 앱처럼 출시하는 제품 하나이며, 앱과 저장소를 갖습니다. 대부분의 팀은 워크스페이스 하나에 제품마다 프로젝트 하나를 둡니다.

## 1. 계정 만들기

가입 페이지에서 이름, 이메일, 8자 이상의 비밀번호를 입력하고 **Create account**를 선택합니다. 이미 계정이 있다면 **Have an account? Sign in**을 선택하세요.

![가입 양식: 이름, 이메일, 비밀번호, Create account](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/138e3e07-2c34-40f9-ae55-8041f4c9eda5/sign-up.png)

## 2. 워크스페이스 만들기

새 계정에는 워크스페이스가 없으므로 Mocco가 첫 워크스페이스를 만들라고 안내합니다. 보통 회사나 팀 이름으로 이름을 정하고 **Create workspace**를 선택하세요. 워크스페이스를 만든 사람이 소유자가 되고, Mocco가 워크스페이스의 **Home**을 엽니다. Home에는 모든 제품에서 팀이 기다리는 승인(게이트에서 멈춘 배포, 보호된 환경의 플래그 변경, 올린 최소 앱 버전, 보호된 OTA 채널의 릴리스), 감사 로그의 최근 항목, 프로젝트가 표시됩니다. 대기 중인 승인마다 프로젝트 이름과 승인 대상이 표시됩니다. 플래그 변경이면 환경, OTA면 채널, 최소 버전이면 앱입니다("QA App · Production"). 승인할 화면으로 가는 링크도 있습니다.

![Home: 승인을 기다리는 채널 규칙 변경과 플래그 변경, 최근 감사 항목, 프로젝트들](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/fc4d0dc1-12b1-43d8-ba3c-d3e363166463/home.png)

![워크스페이스 만들기: 워크스페이스 이름과 Create workspace](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/39805d7c-5283-476c-8a7a-f3217def0c29/create-workspace.png)

여러 워크스페이스에 속할 수 있습니다. 워크스페이스를 하나 더 만들거나 전환하려면 상단 바에서 Mocco 로고 옆의 워크스페이스 메뉴를 열고 **New workspace** 또는 원하는 워크스페이스를 선택하세요. 워크스페이스의 **Settings** 페이지에서 이름을 바꿀 수 있고, 소유자는 여기서 워크스페이스를 삭제할 수도 있습니다.

## 3. 프로젝트 만들기

워크스페이스의 사이드 내비게이션에서 **Projects**를 엽니다. 프로젝트의 **Name**을 입력하고 **Create project**를 선택합니다. Mocco가 이름에서 **Handle**을 제안합니다(`Acme Mobile`은 `acme-mobile`이 됩니다). 프로젝트를 만들기 전에 바꿀 수 있습니다. 핸들은 소문자, 숫자, 중간 하이픈으로 이루어진 최대 40자이며, 워크스페이스 안에서 고유해야 합니다.

![Projects 페이지: 새 프로젝트 양식과 활성 프로젝트들](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/56371005-966d-4d9a-be11-98210beb0fb1/projects.png)

Mocco가 새 프로젝트를 엽니다. 상단 바의 프로젝트 메뉴로 프로젝트 사이를 전환하고, **All projects**는 목록으로 돌아갑니다.

더 이상 작업하지 않는 프로젝트는 **Overview** 페이지 아래쪽의 **Archive**로 보관할 수 있습니다. 보관한 프로젝트는 읽기 전용이 되고 목록에서 숨겨집니다. 삭제되는 것은 없습니다. Projects 페이지의 **Show archived**를 선택하면 다시 나열되고, Overview의 **Unarchive**로 되돌립니다.

## 4. 앱 등록하기

프로젝트의 **Overview** 페이지에서 **Apps** 아래의 **Add app**을 선택합니다. 빌드 대상마다 앱을 하나씩 추가하고, **Platform**을 고르고 **Name**을 붙입니다.

- **iOS**: **Bundle ID**를 입력합니다. 앱이 App Store에 있다면 숫자로 된 **App Store ID**도 입력합니다.
- **Android**: **Application ID**를 입력합니다. 애플리케이션 ID와 다르다면 **Play package**도 입력합니다.
- **Web**: **Web origins**를 입력합니다. 프로젝트의 publishable 키를 쓸 수 있는 사이트이며, `https://app.acme.com` 같은 형식입니다. 여러 개는 공백이나 쉼표로 구분합니다. 나중에 **Edit origins**로 바꿀 수 있습니다.
- **React Native**와 **Server**: 이름만 필요합니다.

그런 다음 **Add app**을 선택합니다.

![프로젝트 Overview 페이지에서 iOS 앱 추가하기](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/6dcec2f0-21f5-44f8-8d21-8073c3e9f863/add-app.png)

강제 업데이트는 스토어 앱(iOS와 Android)에서 동작합니다. 웹 앱의 오리진은 브라우저에서 publishable 키를 어디서 쓸 수 있는지 정합니다. [API 키](https://www.mocco.club/docs/ko/articles/avn27u-api-keys)를 참고하세요.

## 5. 저장소 연결하기

같은 페이지의 **Repositories** 아래에서 저장소를 고르고 **Link**를 선택해, 이 프로젝트가 어떤 저장소에서 출시하는지 지정합니다. 저장소는 GitHub가 연결되고 워크스페이스의 **Deploys** 페이지에 추가되면 여기에 나타납니다. [배포 거버넌스](https://www.mocco.club/docs/ko/articles/f48fys-overview#connect-github)를 참고하세요. 저장소 하나를 여러 프로젝트에 연결할 수 있고, **Unlink**로 연결을 해제합니다.

## 6. 제품 켜기

워크스페이스의 사이드 내비게이션에서 **Products**를 열고 쓰려는 제품 옆의 **Turn on**을 선택합니다. 그 제품의 페이지가 모든 프로젝트의 사이드 내비게이션에 바로 나타납니다. OTA와 강제 업데이트에는 **Force update**와 **OTA updates**가, **Release** 아래에는 **Feature flags**가, 메신저에는 **Inbox**가, **Support** 아래에는 **Help center**가 생깁니다. **Turn off**를 선택하면 다시 숨겨집니다.

![Products 페이지](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/d13baefb-e6a4-41ae-9b79-f336748e941d/products.png)

배포 거버넌스는 항상 켜져 있습니다. **Coming soon**으로 표시된 제품은 아직 사용할 수 없습니다.

## 다음 단계

- [멤버와 접근 권한](https://www.mocco.club/docs/ko/articles/pns8fb-members-and-access): 워크스페이스에 누가 있고 누가 승인할 수 있는지 알아봅니다.
- [API 키](https://www.mocco.club/docs/ko/articles/avn27u-api-keys): 앱과 서버를 연결합니다.
- 제품별 가이드: [OTA와 강제 업데이트](https://www.mocco.club/docs/ko/articles/x62axp-overview), [기능 플래그](https://www.mocco.club/docs/ko/articles/f3cruw-quickstart), [메신저](https://www.mocco.club/docs/ko/articles/ky2kfv-contact-us), [상태 페이지](https://www.mocco.club/docs/ko/articles/dn83zy-status-page), [알림](https://www.mocco.club/docs/ko/articles/f56ie6-overview).