草トーくん団体戦の作り方（男子/女子/混合団体戦）
チーム単位でエントリーする団体戦大会の作成手順。種目選択・チーム人数・タイ形式・参加費・決済モデルの設定方法を説明します。
最終更新: 2026年6月13日
草トーくんは個人戦・ペア戦に加えて 団体戦 に対応しています。テニスベアでも全大会の約 12% が団体戦というニーズの高い形式です。
用語
| 用語 | 意味 |
|---|---|
| チーム | N 人の参加者で構成される 1 エントリー単位（一般的に 4〜6 人） |
| チーム代表者 | チームの申込責任者。連絡・決済・キャンセル等の主体 |
| タイ | チーム A vs チーム B の対戦。1 タイ = 複数のラバーで構成 |
| ラバー | タイの中で実際にコート上で行われる個別の試合 |
| タイ形式 | ラバーの構成ルール（例: D3 = ダブルス 3 本勝負） |
設定の流れ（大会作成フォーム）
1. 種目を選ぶ
「形式」セクションの 種目 で次のいずれかを選択:
- 男子団体戦
- 女子団体戦
- 混合団体戦
団体戦を選ぶと「団体戦の設定」セクションが展開されます。
2. チーム人数（下限・上限）
例:
- 「4〜6 名」: 最低 4 名、最大 6 名のチーム編成を許可
- 「6〜6 名」: 6 名固定
タイ形式が要求する最低人数以上にしてください。
3. タイ形式
| タイ形式 | 内容 | 必要メンバー数 |
|---|---|---|
| ダブルス 3 本勝負（D × 3） | ダブルス 3 試合、2 勝先取 | 6 名 |
| ダブルス 3 本（同点時タイブレーク） | 通常は 2 ダブルスで決着、1-1 ならタイブレーク | 4 名 |
| シングルス 2 本 + ダブルス 3 本（S2D3） | シングルス 2 + ダブルス 3 の合計 5 本勝負 | 8 名 |
| ダブルス 2 本 + タイブレーク（D2_TIEBREAK） | 4 名団体戦向け。2 ダブルス + 同点時タイブレーク | 4 名 |
| シングルス 3 本勝負（S × 3） | シングルス 3 試合、2 勝先取（オールシングルス） | 3 名 |
| シングルス 5 本勝負（S × 5） | シングルス 5 試合、3 勝先取（オールシングルス） | 5 名 |
上記の 6 つは クイック選択用のプリセット です。シングルス本数・ダブルス本数・同点時タイブレーク有無を 自由に組み合わせて 独自のタイ形式を作ることもできます（プリセットに一致しない場合は「カスタム」として保存されます）。
チーム上限人数がタイ形式の最低人数を下回っている場合は、フォームに警告（「⚠ チーム上限人数（N 名）がこのタイ形式の最低人数（M 名）を下回っています」）が表示されます。上限人数を増やすか、後述の 重複出場を許可 すると解消できます。
重複出場（少人数チーム向け）
「同じ選手が複数の試合に出場できる（重複出場を許可）」 トグルを有効にすると、1 人のメンバーが同じタイ内の複数ラバーに出場できるようになり、少人数チームでも参加できます。
- 重複出場 なし（既定）: 全ラバーを別人で組むため、必要人数が多くなります（例: D × 3 は 6 名）
- 重複出場 あり: メンバーを循環して割り当てるため、最低人数が下がります（例: ダブルスを含む形式なら最低 2 名、シングルスのみなら最低 1 名）
フォームには選択中のタイ形式に応じた「重複出場あり／なしの最低人数」がそれぞれ表示されます。
4. 参加費単位
団体戦では次の 2 種類が選べます:
- 1 チームあたり: 例 「¥18,000 / チーム」
- 1 名あたり: 例 「¥3,000 / 名」（チーム合計は自動計算）
入力後に「💰 ¥18,000 / チーム（4 名なら 1 名あたり ¥4,500〜6 名なら ¥3,000）」のような プレビュー が表示されます。
区分別料金（一般 / 学生 等）も両方の単位で利用可能です。
5. 決済モデル
| モデル | 動作 | 向く運用 |
|---|---|---|
| 代表者一括（together） | 代表者がチーム分まとめて Stripe 決済 | 代表者が事前に会費を集めている / 後で割り勘集金する運用 |
| メンバー個別（separate） | 各メンバーに個別の Stripe 決済リンクが発行される | メンバー間の集金を草トーくんに任せたい |
「メンバー個別」を選ぶと、代表者ダッシュボードで各メンバーの入金状況（未入金 / オンライン入金済 / 現金受領済 / 免除）を一覧管理できます。
どちらを選んでも、最終的には主催者の Stripe Connect 口座にチーム全員分の合計が振り込まれます。違いは「誰が決済画面を操作するか」だけです。
6. 出場オーダーの決め方（任意）
「各チームの代表者がオーダーを提出する」 トグルで、ラバーの出場者をどう決めるかを選べます。
- オフ（既定）: 出場メンバーはチームの並び順（登録順）から自動で割り当てられます
- オン: 対戦ごとに「どのペア／選手を第1・第2…ラバーに出すか」を各チームの代表者が提出します。両チームが提出すると同時に公開され、戦略性のある運用になります
大会形式（match_format）との関係
団体戦の タイ形式 と 大会形式（予選リーグ / トーナメント / DE / スイス / コンソレ）は 直交する独立した設定 です。任意の組み合わせが可能です。
例: 「混合団体戦 × 予選リーグ（総当たり）× S2D3」
予選リーグ（A B C D の 4 チーム総当たり）
├ A vs B（タイ）
│ ├ 第1シングルス: A.山田 vs B.田中 → 6-3
│ ├ 第2シングルス: A.鈴木 vs B.佐藤 → 4-6
│ ├ 第1ダブルス: A.加藤/渡辺 vs B.高橋/伊藤 → 6-4
│ ├ 第2ダブルス: A.木村/中村 vs B.吉田/山本 → 6-2
│ └ 第3ダブルス: A.松本/小林 vs B.林/斎藤 → 3-6
│ タイ結果: A 3-2 で勝ち
├ A vs C ...
└ ...
チーム管理（主催者）
団体戦の大会ページに 「チーム一覧」 と既存の「決済管理」メニューが両方とも有効になります。
/organizer/tournaments/[id]/teams — チーム構成の確認
- エントリーしたチームの名称・紹介文・メンバー一覧を確認
- 各チームの 人数充足チェック（タイ形式の最低人数を下回るチームに警告）
- 代表者・登録ユーザー・未登録メンバーをバッジで区別
- 入金状況は読み取り専用バッジで表示。更新は決済管理ページから行います
/organizer/tournaments/[id]/payments — 入金状況の更新
団体戦のメンバー個別決済（separate）の入金追跡は決済管理ページで行います。
- メンバー単位で「未入金 / オンライン入金済 / 現金受領済 / 免除」を更新
- チーム別にグループ化して表示
- 集計バッジでチーム全体の入金状況を一覧確認可能
チーム管理（代表者）
団体戦の代表者は、ヘッダーメニューの 「自分のチーム（団体戦）」 から自身が登録したチームを管理できます。
/my/teams — 自分が代表者のチーム一覧
- 複数の団体戦エントリーがある場合はここに並ぶ
- 各チームのメンバー数、未入金メンバー数、締切経過状況が分かる
/my/teams/[teamId] — チーム詳細
- メンバー一覧（代表者・登録/未登録・区分・入金状況）
- チーム名・紹介文・人数充足状況の表示
- 締切前なら「メンバーを編集」ボタンからエントリー画面（編集モード）へ
- 締切後は編集不可（ボタンは非活性化）
過去のチームからメンバーをコピー
団体戦のチームメンバーは大会ごとに似た構成になることが多いため、過去に自分が代表者として 登録したチームから ワンクリックでメンバーをコピー できる機能を用意しています。
- 利用条件: 代表者として 1 件以上のチーム履歴があること（現状は全代表者に開放）
- 利用箇所: 新規エントリー画面の「メンバー」欄上部にある「📋 過去のチームからメンバーをコピー」
- 動作: 直近 50 件の自分のチームを選択 → 既存のメンバー（代表者除く）が一括でコピー される。コピー後にメンバーの追加・削除も可能
将来「参加者プレミアムプラン」が実装された際に、このコピー機能をプレミアム特典として 位置づける可能性があります（P1-128 で別途検討）。
未登録メンバーと決済について
団体戦に 未登録メンバー（氏名のみで追加した人）を含める場合、決済モデルによって扱いが 変わります。フォーム上にも警告が表示されますが、ここで再整理します。
- 代表者一括（together）: 代表者がチーム合計を一括で決済。未登録メンバーがいても 影響なし
- メンバー個別（separate）: 登録メンバーには Stripe 個別リンクが発行されるが、 未登録メンバーには発行できないため、代表者の立替か当日現金での支払いになる。 代表者がこのメンバー分も合算で支払うことを念頭に置いて編成してください
マイページ・参加予定の大会との連携
/my のダッシュボードや /my/upcoming で団体戦エントリーを見ると、ペア戦の「パートナー指定」ボタンは表示されず、代わりにチーム編集用のボタンが表示されます（画面によりラベルが異なり、/my/upcoming では「チームメンバーを編集」、/my ダッシュボードでは「チームを編集」と表示されます）。いずれをクリックしても /my/teams/[teamId] のチーム詳細画面へ遷移します。
団体戦エントリーには「チーム: ○○ （N 名）」も併記されるため、ペア戦の「パートナー: 〇〇」と区別できます。
ドロー生成（団体戦）
通常通り「対戦組み合わせ」メニューからドロー生成すると、団体戦では自動的に タイ → ラバー展開 が走ります。
予選リーグの場合:
1. 既存のリーグ生成（各チーム同士のタイを matches に作成、match_layer='tie'）
2. 各タイに対してタイ形式に従ってラバー（実コート試合）を子レコードとして作成
- match_layer='rubber'
- parent_match_id = タイの id
- メンバー順で自動的にラバー出場者を割当（display_order 昇順）
メンバーが少なくてタイ形式の最低人数を満たさないチームがあると、そのタイの展開はスキップされます（主催者に通知 → メンバー追加して再生成）。
進行ボード（団体戦）
進行ボードには ラバー（実コート試合）のみ が表示されます。タイは「親レコード」として裏で集計され、画面には出ません。
- 各ラバーは通常試合と同じく、コート割当・スコア入力が可能
- ラバーのスコアを確定すると、親タイの集計が自動更新される
- 例: D3 のタイで最初の 2 ラバーが「1-1」になると、タイは "in_progress"
- 3 ラバー目で決着すると、タイは "finished" + 勝者確定
- D3_TIEBREAK / D2_TIEBREAK では、最初の 2 ラバーが 1-1 でない場合は 3 ラバー目を実施しない運用（システム上はスキップ可能）
β 期の現状（v1 スコープ）
| 項目 | v1 対応 | 備考 |
|---|---|---|
| 男子・女子・混合の 3 種目 | ✅ | テニスのみ。ピックル / ソフトテニスは将来 |
| チーム人数 可変 | ✅ | フォームで 2〜20 名の範囲で下限・上限を指定 |
| タイ形式 6 プリセット ＋ 自由設定 | ✅ | プリセット: D3 / D3_TIEBREAK / S2D3 / D2_TIEBREAK / S3 / S5。シングルス・ダブルス本数を自由に組み合わせたカスタム形式も可 |
| 重複出場（少人数チーム向け） | ✅ | トグルで許可。1 人が同タイの複数ラバーに出場でき、最低人数が下がる |
| 既存大会形式との組み合わせ | ✅ | リーグ・トーナメント・DE・スイス・コンソレ |
| 代表者一括決済 | ✅ | |
| メンバー個別決済 | ✅ | 各メンバーに決済リンク |
| メンバー個別キャンセル | ❌ | 代表者が一括キャンセル（v2） |
| 男子団体戦の性別チェック | ❌ | プロフィール性別との連動は v2 |
よくある質問
Q. メンバーは草トーくんアカウント登録が必須？
A. 必須ではありません。代表者がチーム編成時に「未登録メンバーは氏名のみで追加」できます。ただし、未登録メンバーへは Stripe 決済リンクや push 通知を送れません（メンバー個別決済は登録ユーザーのみ）。
Q. チーム編成後にメンバーを変更できる？
A. エントリー締切前は代表者が自由に入れ替え可能。同じエントリーページ
（/tournaments/[id]/entry/team）にアクセスすると、既に作成したチームの編集モード
が開きます。
- 追加メンバー: 既存と同じく草トーくんユーザー検索 / 未登録氏名入力。追加メンバー には「招待されました」通知が届きます
- 削除メンバー: メンバー行の「削除」を押す。削除されたメンバーには「チームから 外れました」通知が届きます
- チーム名・チーム紹介の変更も同じ画面で可能
決済の影響:
- 代表者一括決済（together）: メンバー数の増減で料金が変わる場合は、代表者が 追加で支払う or 主催者が返金対応します
- メンバー個別決済（separate）: 追加メンバーは個別の決済リンクが新たに発行 されます。削除メンバーが既に決済済みの場合は主催者の Stripe 操作で個別返金
締切後は主催者の承認が必要です。
Q. 代表者が体調不良で来られない場合は？
A. v1 では代表者だけがチームの管理操作を持ちます。代表者の代替を立てる場合は主催者に連絡してください（代表者変更の運用フローは v2 で予定）。
関連: