# アカウントとプロジェクト {#accounts-and-projects}

Tuist の一部の機能では、データの永続化を提供し他のサービスと連携できるサーバーが必要です。サーバーと連携するには、アカウントと、ローカルプロジェクトに接続するプロジェクトが必要です。

## アカウント {#accounts}

サーバーを利用するにはアカウントが必要です。アカウントには次の 2 種類があります。

- **個人アカウント:** これらのアカウントはサインアップ時に自動的に作成され、ID プロバイダー（例: GitHub）から取得するか、メールアドレスの先頭部分から得られるハンドルで識別されます。
- **組織アカウント:** これらのアカウントは手動で作成され、開発者が定義したハンドルで識別されます。組織では、他のメンバーを招待してプロジェクトで共同作業できます。

[GitHub](https://github.com) に慣れている場合、概念は似ており、個人アカウントと組織アカウントを持ち、URL を構築する際に使用される*ハンドル*で識別されます。

> [!NOTE]
> **Cli-first**
>
> アカウントとプロジェクトを管理する操作のほとんどは CLI で行います。アカウントとプロジェクトの管理を容易にするウェブインターフェースの開発を進めています。


<.localized_link href="/cli/organization">`tuist organization`</.localized_link> のサブコマンドを使用して組織を管理できます。新しい組織アカウントを作成するには、次を実行します。
```bash
tuist organization create {account-handle}
```

### 組織のメンバーシップ {#organization-membership}

ユーザーは、招待、自動的なシングルサインオン登録、または<.localized_link href="/guides/integrations/authentication/scim">System for Cross-domain Identity Management provisioning</.localized_link>を通じて組織のメンバーになれます。

組織の ID プロバイダーで認証しても、それだけでメンバーシップが付与されるわけではありません。組織の<.localized_link href="/guides/integrations/authentication/sso#choose-an-enrollment-policy">single sign-on enrollment policy</.localized_link>により、信頼済みドメインのユーザーが招待を必要とするか、自動的に参加できるかが決まります。

管理者は、ダッシュボードから、または<.localized_link href="/cli/organization/invite">`tuist organization invite`</.localized_link>を使用してメンバーを招待できます。承認時に`user`以外のロールを付与するには、`--role admin`または`--role viewer`を指定してください。

### ロール {#roles}

すべての組織メンバーは、次の 3 つのロールのいずれかを保持します。

| ロール | 付与される権限 |
| --- | --- |
| **Admin** | ユーザーができることすべてに加え、組織の管理（メンバーと招待、プロジェクト、請求、トークン、Webhook、設定）が可能です。 |
| **User** | 組織の作業を読み取り、実行します。ビルドとテストの実行、キャッシュへの書き込み、プレビューの作成と削除、テストケースの状態の変更などを行います。 |
| **Viewer** | 組織の作業を読み取りますが、変更は行いません。ダッシュボード、ビルド、テスト実行、不安定なテストおよび隔離されたテスト、プレビュー、バンドル、ランナーのアクティビティはすべて読み取り可能です。マシン上でコマンドを実行するため、ランナーへのインタラクティブシェルまたは VNC セッションのアタッチはできません。 |

誰かを招待する際にロールを選択し、後でダッシュボードの**Members**から変更できます。このように設定されたロールは、後のサインインによって上書きされることはありません。

## プロジェクト {#projects}

プロジェクトは、リモートプロジェクトを通じてアカウントと統合する必要があります。GitHub との比較を続けると、変更をプッシュするローカルリポジトリとリモートリポジトリを持つことに似ています。<.localized_link href="/cli/project">`tuist project`</.localized_link>を使用してプロジェクトを作成および管理できます。

プロジェクトはフルハンドルで識別され、これは組織ハンドルとプロジェクトハンドルを連結した結果です。たとえば、ハンドルが`tuist`の組織と、ハンドルが`tuist`のプロジェクトがある場合、フルハンドルは`tuist/tuist`になります。

ローカルプロジェクトとリモートプロジェクトの紐付けは設定ファイルで行います。設定ファイルがない場合は、`Tuist.swift`に作成し、以下の内容を追加してください。

```swift
let tuist = Tuist(fullHandle: "{account-handle}/{project-handle}") // e.g. tuist/tuist
```

> [!WARNING]
> **Tuist Project-only Features**
>
> <.localized_link href="/guides/features/cache/module-cache">module caching</.localized_link>などの一部の機能では、Tuist が管理するプロジェクトが必要です。プロジェクトの管理に Tuist を使用していない場合、これらの機能は利用できません。


プロジェクトの URL はフルハンドルを使用して構築されます。たとえば、公開されている Tuist のダッシュボードは[tuist.dev/tuist/tuist](https://tuist.dev/tuist/tuist)でアクセスでき、ここで`tuist/tuist`はプロジェクトのフルハンドルです。