serval 取扱説明書

トーナメント・リーグ戦管理システム — Google Apps Script ウェブアプリ

🔰 はじめての方へ

大会用のページ（doc）は開発者（sin1.studio）が事前に用意しています。GASのコピーや設定は不要で、受け取ったURLを開くだけで使い始められます。

事前に受け取るもの

当日までの準備

1. 管理用URLを開いてパスワードを入力
   正しく入力すると、同じ端末・ブラウザでは次回から入力を省略できます。
2. 大会名を入力
   画面上部中央の欄に入力します。観客の画面にも表示されます。
3. 選手を登録
   「🏆 トーナメント設定」の「⬆ CSV読込」で名簿を一括登録します（サンプルCSVをExcelで編集すると簡単です）。選手数に合わせてトーナメント表とシード（不戦勝枠）が自動で作られます。項目の詳細は選手・機体登録へ。
4. 組み合わせを調整
   選手の枠をドラッグ＆ドロップで入れ替えられます。シードは枠をクリックして「シード設定」で変更します。

大会当日

1. 結果を入力
   トーナメント表の試合をクリックすると右側に入力欄が出ます。勝者と勝ち方を選んで「送信」すると、勝ち上がりと演出が自動で行われます。
2. 観客に公開
   閲覧用URL（QRコード化すると便利です）を共有します。会場のスクリーンには「📺 画面設定」から別画面を開いて映します（別画面表示）。

ご自身のGoogleアカウントでデータを完全に分けて運用したい場合は、新規ブックの作り方を参照してください。

🤖 Serval Bot（操作をAIに質問する）

Serval Bot は、この取扱説明書を学習（RAG）したAIボットです。「結果はどこで入力する？」「2本先取の送り方は？」など、操作で迷ったときに日本語で質問できます。

• 回答の根拠を確認する：AIはもっともらしく間違うことがあります。回答の最後にある番号（ソース）を押すと、取扱説明書の該当箇所を直接確認できます。
• 上手な質問のしかた：具体的に聞くほど正確に答えられます。
  ❌「送れません」
  ⭕「2本先取の試合で、1本目が終わったあと別画面の本数を1-0にするにはどう操作しますか？」
• サービスについて：Google の Gemini Notebook（旧 NotebookLM）を使っています。無料で使えますが、質問する人（あなた）の Google アカウントのAI利用枠が消費されます（無料アカウントでは1日数十回程度）。ログインや会話の内容が開発者に提供されることはありません。
• 免責事項：本ボットの回答を参考にしたことによる大会運営上のトラブル・データの損失などについて、開発者は責任を負いません。大事な操作（リセット・復元・組み合わせの変更など）は、本書で確認してから行ってください。

以上をご理解のうえ、自己責任でご利用いただける方は以下からどうぞ（Google アカウントでのログインが必要です）。

🤖 Serval Bot を利用する（Gemini Notebook）

servalとは

serval はロボット競技大会を対象としたトーナメント・リーグ戦管理ウェブアプリです。 Google スプレッドシートをデータベースとして利用し、Google Apps Script（GAS）のウェブアプリとしてブラウザ上で動作します。インストール不要、サーバー不要。

• トーナメント・リーグ戦の管理と、観客向けのリアルタイムウェブ配信
• 試合演出・応援機能・別画面表示による会場の盛り上げ
• LINE呼出しやSNSシェアなど周辺サービスとの連携

詳しい機能は次の「できること」にまとめています。

できること

serval で実際にできることを、運用実績のステータス別にまとめます。分かりやすさを優先し、上記の概要と重なる項目もあえて含めています。詳しい操作は各項目のリンク先を参照してください。

実運用で検証済み

ブラケット作成

• シングル・ダブルエリミネーション形式のトーナメント表を自動生成（基本サイズ4〜128、1〜4ブロックまで対応、選手数からサイズを自動算出）
• シード設定（不戦枠は繰り上げ表示）、逆シード（シードが多いブロックでは非シード同士の対戦を優先的に採番）
• 通常の3位決定戦（あり/なし切り替え、ドラッグで表示位置を移動可能）
• 通常スタイル／中央決勝（左右対向）スタイルの切り替え
• 上下の対戦相手ごとの色分け（6色編集可能パレット）、枠サイズ・テーマ（ダーク/ライト）・表示倍率の変更
• 選手・機体登録：名前リスト貼り付け、CSV取込（UTF-8/Shift_JIS）、ランダム配置、同所属の初戦回避（対戦がぶつかった場合の自動入替修復つき）、ドラッグ＆ドロップでの手動配置編集
• 参加者リストでの出欠・遅刻確認：大会当日の受付チェック、遅刻・早退・棄権・失格・出禁の状態管理
• スマホでのピンチイン・ピンチアウトによる表示倍率変更

試合運営

• 試合番号クリックで結果入力（勝者・勝ち方：1本先取／2本先取／不戦勝／勝者なし、試合時間の記録）
• 結果の取り消し（未送信の状態に戻す）。致命的な変更（試合後のドラッグ＆ドロップ・シード変更など）には確認ダイアログが出ます
• ウェブ配信（管理モードでの入力が閲覧モードに自動反映）。選手の「一言紹介」（自由記入のコメント）を対戦カード・別画面・選手詳細ポップアップに表示
• 対戦カード・勝ち上がり演出：次の試合が決まると対戦カードが大きく表示され、結果確定後は勝者側が拡大・敗者側が縮小しつつ勝者線が点滅するアニメーションが流れます。管理画面の操作は閲覧モード・別画面すべてにリアルタイム配信されます
• 画面下部の「次の試合バー」（次の試合／2番手／3番手＋スキップ、最大4件表示）。試合のスキップ、「この試合を次の試合にする」の入れ替えが可能
• 順位表の自動表示（単独/代表トーナメントは優勝・準優勝・3位、代表リーグは勝ち本数→負け本数→総試合時間の順で決定）
• 選手へのLINE呼出しボタン（line-call-system連携）。結果入力パネルの「対戦チームを呼出」で両チームを一括呼出
• バナー：ブラケット上に画像バナーを配置（ドラッグで移動・拡大縮小）。表示回数と各リンクのクリック数を集計

複数ブロック・代表戦

• 代表トーナメント（各ブロック優勝者同士で全体優勝を決定）、または代表リーグ戦（3ブロック時、2名トーナメント×3を縦並べ）
• 代表の3位決定戦（2ブロック時は各ブロック準優勝者同士、4ブロック時は代表戦準決勝の敗者同士）

別画面・配信連携

• 別画面1（?board）：縦型の大型表示。OBSなどでの配信に対応
• 別画面2（?lane）：横長バナー表示（画面下3分の1など）
• 別画面3（?sub）：追加の大型表示
• 別画面4（?meter）：WinMeter（勝敗メーター）。両者のBP（バトルポイント）から算出した事前勝率と、試合中のダウン・攻勢を加味したリアルタイム勝率バーを表示
• 各別画面で表示項目（ブロック・回戦、試合番号、選手名、フリガナ、所属、タイプ＝自由記入欄が2つでアーム種類等を記録可、一言紹介、勝ち数、試合時間、修理時間、二つ名・写真＝写真は表示サイズを小/中/大から選択可、推しコメント＝別画面1〜3、複数あれば6秒ごとに切り替え）・背景・フォント・ウィンドウサイズを個別に設定可能。フリガナは選手名の直上に表示されます。別画面1は試合切り替え時の入場演出（5方式＋ランダム）も選択できます
• 管理画面からの演出（勝ち上がり・対戦カード）が別画面にリアルタイム配信されます。演出設定では表示項目・写真サイズ・演出時間・効果音を勝ち上がり／対戦カードそれぞれ個別に設定でき、二つ名を先に見せる「焦らし演出」もON/OFF可能です（既定：対戦カードON／勝ち上がりOFF）
• 対戦カード演出には「通常／🔥派手／🌈ド派手」の3段階があり、「使用する（上位）」でベスト16・ベスト8・準決勝を派手、「使用する（決勝）」で3位決定戦・決勝をド派手に自動で切り替えられます（既定はどちらもOFF）。各段階は演出設定のボタンでテストプレイできます

応援・推し投票

• 推し投票：閲覧者が選手枠をタップして投票（端末1人1票、取り消し・投票し直し可）。32文字までの一言応援コメントを添えられます
• 「❤ 応援！」ボタン・スマホのシェイクで送る応援ハート（何度でも送信可）。別画面に炎上アニメーションで表示
• 管理画面の「📣 応援パネル」で推しランキング・応援ランキング・推しコメント一覧を確認可能

Xシェア・フォント

• Xシェア：ブラケットを画像としてキャプチャし、OGP付きシェアURLを生成してX（旧Twitter）に投稿
• フォント選択機能（選手名・数字・ベースの3系統を個別に設定）。Google Fontsから11種の和文フォントを動的ロード

データ入出力

• JSON形式での保存・読込・書き出し・取込（書式バージョン付き）
• 選手名簿のCSV取込（選手名・フリガナ・所属・所属フリガナ・番号・代表者名・連絡先・一言紹介・二つ名・写真URL）
• 大会成績CSV出力（?result&doc=<docKey>）：優勝〜ベストNの成績・勝敗数・本数を一覧化

作成済みだが実戦での検証がまだのもの 未検証

• 選手へのLINE呼出し：次の試合の選手にLINEで自動通知する機能自体は動作しますが、大会当日に選手の「番号」欄へ呼び出し用番号を登録する運用手順込みでの実戦検証はまだです。選手が待機所に来ているかどうかは判定せず、一律に通知が送られます
• ブロック代表のリーグ戦：3ブロック構成時、代表決定をトーナメント方式ではなく総当たり（3試合）のリーグ戦で行う設定が可能です。実戦での使用実績はまだありません

まだ作れていない機能（今後の構想） 未実装

• 全体を通したリーグ戦：現状のリーグ戦機能はブロック内の総当たり戦にとどまり、本大会のような「全参加者を通した総当たり」形式には対応していません
• 選手待機所のセルフチェックイン：待機所にタブレットを置き、選手自身が「来た」ボタンをセルフで押す、来ない場合は自動でLINE呼出しする、という運用は未実装です
• ストップウォッチ型の審判用デバイス：審判が手元の専用デバイス（M5Stack Stopwatchを想定したハードウェア）で試合時間・修理時間の計測、勝敗入力、次の試合の確認までできるようにする構想です。ブラウザの管理画面を開かずに試合を進行できるようにするのが狙いですが、現状はまだ設計段階です

システム構成

大会シリーズ（ブック）ごとに独立した GAS プロジェクトを1つ用意します。 各ブックの中に第1回・第2回…の各トーナメントが入る、2階層の構造です。 すべてのブックは serval ポータル から一元管理します。

新規ブックの作り方（新しい大会シリーズを登録する）

1. GASプロジェクトをコピー作成
   script.google.com にアクセスします。 既存の serval プロジェクト（例: TournamentManager）を開き、左上メニュー「…」→「コピーを作成」を選択します。 新しいスプレッドシートとGASプロジェクトが自動で作成されます。
2. ウェブアプリとしてデプロイ
   コピーしたGASを開き、右上「デプロイ」→「新しいデプロイ」を選択。 種類「ウェブアプリ」を選び、次のように設定します：

   • 説明：任意（例: 中島杯）
   • 次のユーザーとして実行：自分（例: sin1@sin1.studio）
   • アクセスできるユーザー：全員（Googleアカウント不要）

   「デプロイ」をクリックし、承認ダイアログが出た場合は「アクセスを承認」→ Googleアカウントを選択 →「詳細」→「（プロジェクト名）に移動」→「許可」の順に操作します。 表示された /exec の URL をコピーします。
3. スクリプトプロパティを設定
   GASエディタの左側「⚙ プロジェクトの設定」→「スクリプトプロパティ」を開きます。 「プロパティを追加」で以下を設定してください：

   プロパティ名	値	用途
   ADMIN_TOKEN	任意のパスワード	ポータルからの書き込み認証
   LINE_TOKEN	LINE Notifyトークン	LINE通知（任意）
   LINE_CALL_URL	呼び出しサーバーのURL	LINE呼び出し（任意）

4. ポータルでブックを作成・URLを登録
   serval ポータル を開き、「＋ 新規ブック」をクリックします。 ブック名（例: 中島杯）を入力し、コピーした /exec URLを「GAS WebアプリURL」欄に貼り付けて保存します。 準備中カードが作成され、黄色バーに変わります。
5. ブックカードにトーナメントを追加
   ポータルのブックカード下部の「第 __ 回　トーナメント名」欄に入力して「＋ 追加」をクリックします。 例：第 7 回、トーナメント名 JimaCup7 → 「第7回 / JimaCup7 / 開く / 管理」の行が表示されます。 「開く」は ?doc=JimaCup7 付きのURL、「管理」は ?doc=JimaCup7&admin 付きのURLを開きます。

トーナメントの追加（同じブックの次の回を登録する）

中島杯の第6回・第8回など、同じ大会シリーズの新しい回を追加するには、同じGASに新しいトーナメントを登録するだけです。 新たにGASをコピーする必要はありません。同じスプレッドシートに回ごとのデータが別キーで保存されます。

1. ポータルで対象のブックカード（例: 中島杯）を開く
2. カード下部の追加行に「第 8 回　JimaCup8」のように入力して「＋ 追加」をクリック
3. 「開く」ボタンから ?doc=JimaCup8 付きのURLを開いて、新しいトーナメントの選手登録・設定を行う

GASのコード更新手順（servalのバージョンアップ時）

serval 本体のコード（Code.gs / app.html など）が更新された場合、各ブックのGASにも反映が必要です。

1. 更新済みの serval プロジェクト（TournamentManager）から更新内容を確認
2. 各ブックのGASプロジェクトを開き、該当するファイルを差し替えてコードを貼り替える
3. 「デプロイ → デプロイを管理 → 編集（鉛筆）→ バージョン：新バージョン → デプロイ」で反映
4. スクリプトプロパティ（ADMIN_TOKEN 等）は引き継がれるため、通常は再設定不要

画面の見かた（どこに何があるか）

管理画面（管理者としてログインした画面）は、大きく5つの場所に分かれています。

① 上部バーのボタン（左から順に）

② 左のメニュー

③ 中央のトーナメント表

• 選手の枠：クリックすると④に選手情報が出て編集できます。枠どうしをドラッグ＆ドロップすると入れ替えられます（試合が始まった後は確認が出ます）
• 試合番号（丸い数字）：クリックすると④が結果入力になります。色で状態が分かります（未試合・次の試合・終了など）
• 順位欄・3位決定戦：「（ドラッグで移動）」と書かれた見出しをドラッグすると、表示位置を動かせます
• 枠の後ろの「（棄権）」「（遅刻）」などは、参加者リストの状態です（出禁は表示されません）

④ 右のパネル

選手の枠を選んだとき：機体名・フリガナ・所属・所属フリガナ・番号・代表者名・連絡先・タイプ1/2・一言紹介文・二つ名・写真URLを編集できます。ほかに「シード設定（通常／シード）」「この枠を空にする」「呼出（番号に登録済みのLINEへ連絡）」があります。

試合番号を選んだとき（上から順に）：

• 見出し（例「Aブロック ／ 第1回戦（試合1）」）と、赤・青の選手名の横の本数チェック。勝った本数だけチェックして「送信」します（1本で送れば1本先取、2本なら2本先取）。キーボードは Shift+R／Shift+B で加算、Shift+S で送信
• 特殊ケース：不戦勝／勝者なし
• 試合時間（本数別）：1本目〜3本目の「開始」と「↺（リセット）」
• 修理時間：赤・青それぞれの修理タイマー
• ボタン：送信／この試合を次の試合にする／対戦カード演出／対戦チームを呼出（LINE）／この試合をスキップする
• その下に「対戦データベース」（過去の対戦・BP）と「WinMeter」（別画面4の勝敗メーター操作：ダウン・復帰・1本・攻勢・取り直し・リセット）

⑤ 下の「次の試合バー」

次の試合・2番手・3番手が並びます。クリックするとその試合が④に開きます。試合の順番を入れ替えたいときは、④の「この試合を次の試合にする」「この試合をスキップする」を使います。

閲覧画面（観客のスマホ）

管理者でない人が開くと閲覧画面になります。トーナメント表が自動で更新され、選手名をタップすると選手の紹介、枠をタップすると推し投票ができます（設定による）。「❤ 応援！」ボタンやスマホを振ると応援ハートが送れます。

初期設定

大会を始める前に、左のメニューで次の順に確認すると迷いません。

1. 🏆 トーナメント設定：選手リスト（またはCSV読込）、先取本数、ブロック数、3位決定戦の有無を決めて「ランダム配置」
2. ⚙ 表示設定：試合時間・修理時間・時間のベル、枠に出す内容
3. 🏷 名称設定：「機体名」などの呼び名（必要なときだけ）
4. 🎬 演出設定・📺 画面設定：会場モニターや配信で使うときだけ

選手・機体登録

まとめて登録するときは左のメニューの「🏆 トーナメント設定」の選手リスト（またはCSV読込）、1人ずつ直すときはトーナメント表の枠をクリックして右のパネルで編集します。

• 選手名：表示名（漢字・英字可）
• フリガナ：カタカナ。漢字・英字名がある場合のみ表示されます
• 所属：チーム名・学校名など（任意）
• 番号：LINE通知で使う呼び出し番号（数字のみ）
• シード：トーナメントの山の組み分けに影響します

CSV取込

「⬆ CSV読込」ボタンからExcel等で作成した選手名簿を一括登録できます。文字コードはUTF-8・Shift_JISの両方に対応（Excelで保存したCSVもそのまま読み込めます）。

サンプルファイル：sample_players.csv（対応する全項目を網羅した例です。ダウンロードして書式の参考にしてください）

選手名,フリガナ,所属,所属（フリガナ）,番号,代表者名,連絡先,一言紹介,二つ名,写真URL
サンプルナイト,サンプルナイト,はるかぜ工業高校,ハルカゼコウギョウコウコウ,1,山田太郎,yamada@example.com,初出場です。よろしくお願いします,鋼鉄の意地,https://example.com/photos/sample-knight.jpg
テストランナー,,個人参加,,2,鈴木一郎,,,,
デモウォリアー,デモウォリアー,みなと大学ロボット研究会,ミナトダイガクロボットケンキュウカイ,3,,demo@example.com,ベスト8を目指します,,
シンプル号,,,,4,,,,,

1行目は見出し行です。以下の見出し名（いずれか1つでも完全一致すればOK）に対応しています。列の順序・列数は自由で、選手名以外は全て省略可能です（上のサンプルの4行目「シンプル号」のように選手名と番号だけでも読み込めます）。

見出し行を省略し「選手名,所属」の2列だけを並べる簡易形式にも対応しています。また所属列自体を省略し、選手名の列に 選手名（所属名） の形式でまとめて書いた場合も自動的に選手名と所属に分割されます。

参加者リスト（受付チェック）

管理画面左の「👥 参加者リスト」ボタンから、大会当日の出欠・遅刻確認ができます。

• 受付：選手ごとにチェックボックスで受付済みかどうかを記録します。上部に「受付済み ○ / ○ 名」と表示されます
• 状態：遅刻・早退・棄権・失格・出禁を選手ごとにプルダウンで設定できます（設定した選手は一覧で薄く表示されます）。出禁は管理者だけが見られる場所に保存され、閲覧者には届きません
• 番号順・名前順・所属順・試合順（最初の対戦番号順）・受付済み優先の5種類でソートできます

トーナメント進行

対戦組み合わせ生成

「トーナメント」タブを開き「組み合わせを生成」ボタンをクリックします。登録済みの選手から自動的にブラケットが生成されます。

試合の進行

1. トーナメント表の試合（試合番号）をクリックすると、右側に結果入力欄が出ます
2. 「1本目」の「開始」で試合時間を計り、終わったら「停止」。「↺」でその本の時間を初期値に戻せます
3. 本を取った選手のチェックボックスに印を付けます。2本先取の試合で1本目のあとにチェックすると、別画面の時間は2本目の初期値に切り替わります
4. 「送信」で確定すると、勝者が次の試合へ進み、演出が流れます（キーボードは Shift+R / Shift+B で加算、Shift+S で送信）

時間のベル

カウントダウンのとき、残り30秒で「チーン」、10秒で「チンチーン」、0秒で「チンチンチーン」と鳴り、0秒でタイマーが止まります。「⚙ 表示設定」のタイマー設定でそれぞれON/OFFでき、「🔔 ベルを試聴」で音を確認できます。

棄権・失格の試合

参加者リストで棄権・失格（出禁を含む）にした選手がいる試合を開くと、相手の「不戦勝」（両者なら「勝者なし」）が入力済みになります。内容を確認して「送信」してください。トーナメント表の選手枠には（遅刻）（棄権）などが表示されます（出禁は表示されません）。

複数ブロック・代表戦 NEW

設定でトーナメント数を2以上にすると、A・B…の各ブロックとは別に「代表トーナメント」（または代表リーグ戦）が右側に表示され、各ブロックの優勝者（代表）同士で全体の優勝を争います。

代表の3位決定戦

設定の「代表にも3位決定戦を設ける」にチェックを入れると、全体3位を決める試合が追加されます。ブロック数によって対戦カードの意味が異なります。

• 2ブロック時：代表決定戦（決勝）とは別に、AブロックとBブロックそれぞれの自分自身の決勝で敗れた選手（ブロック準優勝）同士が3位を争います
• 3ブロック以上（代表4枠）時：代表トーナメント自身の準決勝で敗れた2名が3位を争います

リーグ戦進行

「リーグ」タブで総当たり戦を管理します。各対戦の勝敗ポイントを入力すると自動的に順位表が更新されます。

別画面表示（観客用）

管理画面上部の「📺 別画1」〜「📊 別画4」で、観客・配信向けの表示専用画面を別ウィンドウで開けます。開いている別画面のボタンにマウスを乗せると、1/4に縮小した画面が表示されます。

配信専用モード（別のPCで映す）

次のURLを開くだけで、管理画面なしでも別画面が表示され、サーバーから最新の状態を数秒ごとに取り込みます（結果の反映はおおむね4〜9秒）。

…/exec?board&doc=大会名   別画面1
…/exec?lane&doc=大会名    別画面2（横長）
…/exec?sub&doc=大会名     別画面3

同じPCで管理画面が配信している間はそちらを優先します（即時反映）。別画面4（WinMeter）は管理PCで開いてください。試合時間のタイマーや試合途中の本数も表示されます。

画面ごとの設定（「📺 画面設定」）

• 推しコメント：対戦中の2機に寄せられたコメントを表示（複数は6秒ごとに切り替え）。OFFにすると数秒で消えます
• 赤と青を左右入れ替え：機体と色の組み合わせはそのまま、表示の左右だけを入れ替えます
• VS（勝ち数OFF時）とその大きさ（大・中・小）
• 長い機体名は文字の高さを保ったまま横幅を圧縮して表示します（最大50%。それでも入らない場合のみ省略）

演出（勝ち上がり・対戦カード）はタップするといつでも省略できます。「🎬 演出設定」の表で、管理画面と閲覧者・別画面それぞれの表示・効果音をON/OFFできます（例：管理画面では演出を出さず、別画面にだけ出す）。

応援・推し投票 NEW

閲覧者が別画面（?board等）や閲覧モードで選手枠をタップすると、選手の詳細ポップアップに「☆ 推す」ボタンと一言応援欄が表示されます。

• 推し投票：「☆ 推す」で1票投票（端末（ブラウザ）ごとに1人1票）。ボタンは「⭐ 推し中」に変わり、もう一度押すと投票を取り消して他の選手に投票し直せます
• 一言応援：投票中の選手にのみ、32文字までの応援コメントを入力できます。入力後しばらくすると自動送信され、投票を取り消すと同時にコメントも消えます
• ❤ 応援！（応援ハート）：投票とは別に、ボタンまたはスマホのシェイク操作で送信できる一過性のリアクションです（何度でも送信可）。board/sub画面に炎上アニメーションで表示されます

管理画面の「📣 応援パネル」では、推しランキング・応援ランキングに加え、「💬 推しコメント」タブで選手ごとのコメント一覧（新しい順・投稿日時付き）を確認できます。一覧は管理者のみ閲覧でき、投稿者を特定する情報は表示されません。

別画面1〜3の画面設定で「推しコメント」をONにすると、対戦中の2機に寄せられたコメントを別画面にも表示します（複数あれば6秒ごとに切り替え）。コメントは管理画面が約30秒ごとに取得するため、表示までに最大30秒ほどかかり、管理画面を開いている間だけ更新されます。

修理タイマー

試合終了後に修理時間を計測できます。試合の右カラムの「修理開始」ボタンで計測開始。設定で指定した上限時間に達すると別画面の表示から自動的に消えます。

LINE通知

次の試合に呼ばれる選手にLINEで自動通知します。

設定手順

1. LINE Notify でトークンを取得（「トークへの通知」で自分のトークに送るのが簡単）
2. 呼び出しサーバーを起動。line-call-system を PC でローカル起動し、cloudflared などで外部公開URLを取得。
3. GASのスクリプトプロパティに設定：

   • LINE_TOKEN：LINE Notifyのトークン
   • LINE_CALL_URL：呼び出しサーバーの外部URL（例：https://xxxx.trycloudflare.com）
4. 選手の「番号」欄に呼び出し用の番号（数字のみ）を登録

アナウンス

「設定 → アナウンス」に短いテキストを入力すると、別画面の「応援」ボタンと試合キューの間に表示されます。 休憩時間のお知らせや「14時まで 自由練習」などを一時的に表示するのに使います。空にすると非表示になります。

バナー広告

「設定 → バナー」から画像URLと表示時間を設定できます。別画面で試合と試合の間にバナーが自動的に表示されます。

X（Twitter）シェア

試合確定後に「Xシェア」ボタンが表示されます。試合結果の画像を生成してXに投稿できます。 Renderにデプロイされたシェアサーバーが画像生成を担当します。

ポータル管理

serval ポータル からブックの一覧表示・編集・削除と、各ブック内トーナメントの追加・削除ができます。

• ブックカード：「編集」でブック名・GAS URL・メモを更新、「削除」でポータルから非表示（ソフトデリート）
• トーナメント行：「開く」→選手閲覧モード、「管理」→管理者モード（パスワード認証あり）、「×」で行を削除
• 「削除済みも表示」チェックで削除済みブックを表示し「復元」できます。GASのデータ自体は削除されません。

ポータルの書き込み操作（作成・更新・削除・トーナメント追加）には管理者パスワードが必要です。 初回アクセス時にプロンプトが表示され、ブラウザのlocalStorageに保存されます。

大会成績CSV出力 NEW

GASウェブアプリのURLに ?result&doc=<docKey> を付けてアクセスすると、参加選手・機体の大会成績一覧をCSVファイルとしてダウンロードできます。

https://script.google.com/macros/s/…/exec?result&doc=JimaCup7

CSVには以下の列が出力されます（1試合ごとの細かい情報は含みません）。

「大会成績」列の付き方はブロック数によって変わります。

データ管理

全データはGASに紐付いたGoogleスプレッドシートの「Store」シートに保存されています。 ver211以降のデータは圧縮して保存されるため、シートを直接開いても中身は読めません。内容の確認やバックアップは管理画面の「⬇ バックアップ」（JSON保存）を使ってください。

トラブルシュート

更新履歴

主な更新のみを記載しています（軽微な修正は省略）。バージョン番号は管理画面左上の見出しに表示されます。