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

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

## アカウント {#accounts}

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

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

[GitHub](https://github.com) に馴染みがあれば、その概念と似ています。個人アカウントと組織アカウントを持ち、URL を構築する際に使用される*ハンドル*で識別されます。

組織は <.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">シングルサインオン登録ポリシー</.localized_link>により、信頼済みドメインのユーザーが招待を必要とするか、自動的に参加できるかが決まります。

管理者はダッシュボードから、または <.localized_link href="/cli/organization/invite">`tuist organization invite`</.localized_link> でメンバーを招待できます。`--role admin` または `--role viewer` を渡すと、承諾時に `user` 以外のロールを付与できます。

### ロール {#roles}

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

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