グループ管理マニュアル

このマニュアルでは、Game Awesome v5のグループ管理機能について、詳しく説明します。

グループとは

グループの役割

グループは、Game Awesome v5における大会やスクリムを運営するための基本単位です。

複数の大会をまとめる単位: 1つのグループに複数の大会を紐づけることができます
メンバー管理: グループメンバー（運営メンバー）が大会を運営できます
権限管理: オーナー、運営、運営補佐、メンバーなどの役割があります

グループの特徴

公開/非公開の設定: グループを公開または非公開に設定できます
招待コード: 招待コードを使ってメンバーを追加できます
グループページ: 各グループには専用の公開ページがあります

グループと大会・スクリムの関係

グループ
  ├─ 大会（複数可）
  │   └─ スクリム（複数可、大会に紐づく）
  └─ スクリム（複数可、大会に紐づかない）

重要なポイント:

すべての大会とスクリムは、必ず1つのグループに属します
グループを作成すると、そのグループ内で大会やスクリムを運営できます
グループのメンバーは運営メンバーであり、大会やスクリムの運営権限を持ちます
大会やスクリムへの参加は、グループメンバーであるかどうかとは関係なく、誰でも参加できます

グループ管理画面の基本操作

画面の構成

グループ管理画面は、以下の要素で構成されています：

招待コード入力欄: 招待コードでグループに参加
検索欄: グループ名で検索
グループを作成ボタン: 新しいグループを作成（権限がある場合のみ表示）
マニュアルボタン: このマニュアルを開く
グループ一覧テーブル: 所属グループの一覧表示

アクセス方法

グループ管理画面は、以下の手順でアクセスできます：

ログイン
- Game Awesome v5にログインします
- ログインしていない場合は、画面右上の「ログイン」ボタンからログインしてください
ユーザー情報モーダルを開く
- 画面右上のユーザーアイコン（アバター画像またはデフォルトアイコン）をクリック
- ユーザー情報モーダルが開きます
「グループ管理」メニューを選択
- モーダル内のメニューから「グループ管理」を選択
- 自分の所属グループ一覧が表示されます

グループの作成

作成権限

以下の権限を持つユーザーがグループを作成できます：

サイト管理者: 常に作成可能
サブ管理者: 常に作成可能
大会管理権限保有者: グループ作成の申請を行い、サイト管理者に許可されたユーザー

作成手順

「グループを作成」ボタンをクリック
- 権限がある場合のみ表示されます
- 検索欄の右側に表示されます
グループ作成モーダルが開く
- グループ名、説明、アイコンなどを設定できます
グループ情報を入力
- グループ名: 必須項目（最大200文字）
- 説明: 任意項目（最大1000文字）
- アイコン: 任意項目（画像をアップロード）
- 色: 任意項目（グループのテーマカラー）
作成を確定
- 「作成」ボタンをクリック
- グループが作成され、一覧に表示されます
作成後の操作
- 作成後は自動的に編集モードに切り替わります
- 詳細な設定を変更できます

作成後の初期状態

公開設定: デフォルトで「公開」に設定されます
権限: 作成者が自動的に「オーナー」になります
メンバー: 作成者のみがメンバーとして登録されます

グループへの参加（招待コード）

招待コードとは

招待コードは、グループの運営メンバーを追加するための一意のコードです。

注意: グループへの参加は、大会やスクリムへの参加とは異なります。グループメンバーは運営メンバーであり、大会やスクリムの運営権限を持ちます。大会やスクリムへの参加は、グループメンバーであるかどうかとは関係なく、誰でも参加できます。

生成方法: グループオーナーまたは運営が生成できます
有効期限: 設定により有効期限を設定できます
使用回数: 1回限りまたは複数回使用可能に設定できます

参加手順

招待コードを取得
- グループオーナーまたは運営から招待コードを受け取ります
- 招待コードは通常、英数字の文字列です
招待コード入力欄に入力
- グループ管理画面の上部にある「招待コードでグループに参加」欄に入力します
- プレースホルダーに従って入力してください
「参加」ボタンをクリック
- 入力した招待コードが有効かチェックされます
- 有効な場合は、自動的にグループに参加できます
参加完了
- 参加成功の通知が表示されます
- グループ一覧に新しいグループが表示されます

参加時のエラー

以下の場合、参加に失敗します：

無効な招待コード: 存在しない、または期限切れの招待コード
既に参加済み: 既にそのグループのメンバーである場合
グループが停止中: グループが停止（suspended）されている場合

エラーメッセージが表示されるので、内容を確認してください。

グループの共有方法

グループページの共有

各グループには専用の公開ページがあります：

グループ一覧から「ページを開く」アイコンをクリック
- アクション列の外部リンクアイコン（🔗）をクリック
- 新しいタブでグループページが開きます
URLを共有
- グループページのURLをコピーして共有できます
- 例: https://gav5.app/groups/{hash_id}
公開設定を確認
- グループが「公開」に設定されている場合、誰でも閲覧可能です
- グループが「非公開」に設定されている場合、メンバーのみ閲覧可能です

招待コードの共有

グループ管理モーダルを開く
- グループ一覧から「編集」アイコン（⚙️）をクリック
- グループ管理モーダルが開きます
招待コードを生成
- 「招待」タブを選択
- 「招待コードを生成」ボタンをクリック
招待コードをコピー
- 生成された招待コードをコピー
- メンバーに共有します
共有方法
- Discord、Twitter、メールなどで共有できます
- 招待コードは文字列なので、どこでも共有可能です

グループページの特徴

グループ情報: グループ名、説明、アイコンなどが表示されます
大会一覧: グループに紐づく大会が表示されます
スクリム一覧: グループに紐づくスクリムが表示されます
メンバー一覧: グループメンバーが表示されます（公開設定による）

グループの編集と管理

一覧からの直接編集

グループ管理画面のテーブルから、以下の項目を直接編集できます：

グループ名の編集

編集アイコン（✏️）をクリック
- グループ名の横にある編集アイコンをクリック
- 編集権限がある場合のみ表示されます
テキスト入力に切り替わる
- グループ名が入力欄に表示されます
編集内容を入力
- 新しいグループ名を入力します
保存
- Enterキーを押すか、フォーカスを外すと保存されます
- Escキーでキャンセルできます

公開設定の編集

編集アイコン（✏️）をクリック
- 公開設定の横にある編集アイコンをクリック
- 編集権限がある場合のみ表示されます
セレクトボックスに切り替わる
- 「公開」または「非公開」を選択できます
選択を確定
- 選択すると自動的に保存されます
- Escキーでキャンセルできます

グループ管理モーダルでの編集

詳細な設定を変更する場合は、グループ管理モーダルを使用します：

「編集」アイコン（⚙️）をクリック
- アクション列の歯車アイコンをクリック
- グループ管理モーダルが開きます
各タブで設定を変更
- 情報: グループ名、説明、アイコンなど
- 大会管理: グループに紐づく大会の管理
- スクリム管理: グループに紐づくスクリムの管理
- 招待: 招待コードの生成と管理
- メンバー: メンバーの管理
保存
- 各タブで変更内容を保存します

グループの削除

グループの削除は、オーナーのみが実行できます：

グループ管理モーダルを開く
「削除」ボタンをクリック
確認ダイアログで「削除」を選択
削除が実行される
- 関連する大会やスクリムも削除されます（注意が必要）

グループの権限と役割

役割の種類

グループには以下の役割があります：

オーナー（Owner）

権限: すべての操作が可能
特徴:
- グループの作成者が自動的にオーナーになります
- グループの削除が可能
- すべての設定を変更可能
- メンバーの追加・削除・ロール変更が可能
- 招待リンクの生成・一覧取得が可能

運営（Admin）

権限: グループの管理が可能
特徴:
- グループの設定を変更可能
- 大会やスクリムの管理が可能
- 招待リンクの生成・一覧取得が可能
- メンバーの追加・削除・ロール変更が可能
- メンバーの追加・削除が可能
- 招待コードの生成が可能

運営補佐（Editor）

権限: 大会やスクリムの管理が可能
特徴:
- グループ管理モーダルにアクセス可能
- 大会やスクリムの作成・編集が可能
- グループの基本設定の閲覧が可能
- 招待リンクの生成・メンバー管理は不可（オーナーまたは運営のみ）

メンバー（Member）

権限: グループ管理モーダルへのアクセス可能（一部機能は制限あり）
特徴:
- グループの情報を閲覧可能
- グループ管理モーダルにアクセス可能
- 大会やスクリムの管理が可能
- 招待リンクの生成・メンバー管理は不可（オーナーまたは運営のみ）
- 注意: 大会やスクリムへの参加は、グループメンバーであるかどうかとは関係なく、誰でも参加できます