Organization 管理
Organization は、aqua でチームアクセスを管理するための最上位の単位です。すべてのプロジェクトは Organization に所属し、Organization のメンバーシップによって、プロジェクトの閲覧や操作が制御されます。
Personal と Team Organization
Section titled “Personal と Team Organization”aqua には 2 種類の Organization があります。
| Personal | Team | |
|---|---|---|
| 作成方法 | ユーザー登録時に自動作成 | Web UI から手動作成 |
| 上限 | ユーザーあたり 1 つ | 複数作成可能 |
| メンバー | オーナーのみ | オーナー + 招待メンバー |
| 課金プラン | 常に Free | Free、Team、Enterprise |
| 削除 | 不可 | 可能（オーナーのみ） |
Personal Organization は登録時に自動作成され、削除できません。個人プロジェクト用のワークスペースとして機能します。
Team Organization は、プロジェクトを他のユーザーと共有し、QA プランの共同作業を行うためのものです。各メンバーにはロールが割り当てられ、操作権限が制御されます。
Team Organization の作成
Section titled “Team Organization の作成”Web UI の Organizations ページから Team Organization を作成できます。
- New Organization をクリックします。
- Organization の名前を入力します。
- Create をクリックします。
作成者は自動的にその Organization の owner になります。
メンバーとロール
Section titled “メンバーとロール”Organization のメンバーには、以下の 4 つのロールのいずれかが割り当てられます（権限の高い順）。
| ロール | 説明 |
|---|---|
owner | 全権限。課金管理、Organization の削除、オーナーシップの移譲が可能。 |
admin | メンバーの招待・削除、ロール変更、課金管理が可能。 |
member | QA プランの作成・実行、プロジェクト管理、プロジェクトメモリの更新が可能。 |
viewer | プロジェクト、QA プラン、実行結果の閲覧のみ。 |
権限マトリクス
Section titled “権限マトリクス”| 操作 | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| プロジェクトとプランの閲覧 | ✓ | ✓ | ✓ | ✓ |
| QA プランの作成・実行 | ✓ | ✓ | ✓ | |
| メンバーの招待 | ✓ | ✓ | ||
| メンバーのロール変更 | ✓ | ✓ | ||
| Owner への昇格 | ✓ | |||
| メンバーの削除 | ✓ | ✓ | ||
| Organization 名の変更 | ✓ | |||
| 課金の管理 | ✓ | ✓ | ||
| Organization の削除 | ✓ |
メンバーの招待
Section titled “メンバーの招待”メンバーを招待するには、Organization ページの Members タブを開きます。
- Add Member をクリックします。
- 招待するユーザーのメールアドレスを入力します。ユーザーはすでに aqua アカウントを持っている必要があります。
- ロール（Admin、Member、Viewer）を選択します。
- Add をクリックします。
ロールの変更
Section titled “ロールの変更”Admin と Owner は、Members タブでメンバー名の横にあるドロップダウンから新しいロールを選択してロールを変更できます。Owner への昇格や Owner のロール変更は、Owner のみが実行できます。
メンバーの削除
Section titled “メンバーの削除”Admin と Owner は、Members タブでメンバー名の横にある削除ボタンをクリックしてメンバーを削除できます。Owner を Organization から削除することはできません。
Organization 内のプロジェクト
Section titled “Organization 内のプロジェクト”プロジェクトは CLI（aqua-cli init）から作成します（Web UI からは作成できません）。CLI がリクエストを送信すると、サーバーは X-Project-Key ヘッダーを使用してプロジェクトが所属する Organization を自動的に解決します。
- 同じキーのプロジェクトを持つ Team Organization のメンバーである場合、そのプロジェクトが使用されます。
- それ以外の場合、Personal Organization にプロジェクトが自動作成されます。
プロジェクトの移動
Section titled “プロジェクトの移動”Project Settings からプロジェクトを別の Organization に移動できます。
- プロジェクトの設定ページを開きます。
- 移動セクションで、移動先の Organization を選択します。
- 移動を確認します。
移動先の Organization のメンバーである必要があります。QA プランと実行履歴はプロジェクトと一緒に移動します。
移動は即時反映されます
移動すると、プロジェクトとそのすべてのデータは新しい Organization に属します。アクセスは移動先 Organization のメンバーシップに基づいて制御されます。
Organization の削除
Section titled “Organization の削除”owner のみが Team Organization を削除できます。Personal Organization は削除できません。
削除は取り消せません
Organization を削除すると、すべてのプロジェクト、QA プラン、実行履歴、その他のデータが削除されます。この操作は元に戻せません。
Organization を削除するには:
- Organization ページの Settings タブを開きます。
- Danger Zone セクションまでスクロールします。
- Delete Organization をクリックして確認します。