Raid Repository
Read in: 日本語 | English | Deutsch | Français | 简体中文 | 한국어
FF14 レイド固定向けのポータル。日程 / 軽減表 / ロット / 攻略情報 / 動画 / 練習ログを 1 か所にまとめます。
「1 固定 = 1 デプロイ」を前提にした単一テナントのアプリで、自分の固定用に fork して使います。入口は Discord サーバーの会員かどうかで守られていて、ログインできるのはそのサーバーのメンバーだけです。
🔗 デモ (閲覧専用): https://demo-raid-repository.vercel.app
実際の画面を触って確かめられます。自分でデモを作る必要はありません — 使い始める手順は下の「使い始める」です。
できること
日程
- 方式を 3 つから選べます: 自前作成式 (候補日の追加・出欠入力・開催確定までポータル内で完結) / 同期式 (character-sheets から取り込み) / 使わない
- 確定した回を次回開催として強調 (当日は「開始まで N 時間 M 分」)
- 定期枠 (毎週この曜日) を決めると、候補日の自動追加がその曜日だけになります。ダイアログから期間 × 曜日の一括生成も可能。定期枠から外れた日には「臨時」「今回だけ」のバッジが付きます
- 出欠は ○ × △ に加えて、遅刻の到着予定 / 早退の予定時刻を本人が入力できます (
21:30〜 のように記号の隣に出ます)
- 未入力の人への自動催促、全員そろったときの自動確定 (任意)
- Discord 通知のテンプレートで
{discord_relative} / {discord_time} が使え、読む人のタイムゾーンで「3 時間後」のように表示されます
- 日ごとのメモ (重要度つき)。書いた本人と幹部が編集でき、投稿者が記録されていない古いメモは誰でも片付けられます
- 出席サマリー — 回答 (○×△) と練習ログの実績を突き合わせて、直近 90 日の出席とズレを一覧にします。自前作成式・同期式のどちらでも使えます
コンテンツ (カテゴリー)
- レイドコンテンツ単位のステータス (未着手 / 練習中 / クリア済 / 休止中)、ドラッグ並べ替え、Realtime で即時共有
- カードに直近 8 週の到達度スパークライン。タブを開かずに現在地が分かります
- 難易度ラベルと進行モデル (層 / フェーズ) をコンテンツごとに指定できるので、名称が未発表の新難易度でも運用できます
- 背景画像を設定でき、カード内の映す位置まで指定できます
コンテンツごとのタブ
| タブ | 中身 |
|---|
| 軽減表 | Google スプレッドシートをそのまま表示。スマホでは読み取り専用のカード表示に組み替え、「自分のロール」「自分の担当だけ」に絞れます |
| ロット管理 | 同じくシート表示 + 今週の消化チェック (火 17:00 JST リセット) と BiS (XivGear 埋め込み)。「欲しい人」の行列は畳めます |
| 攻略情報 | リンク集 (タイトル自動取得・タグ・既読)。Google スプレッドシート等は種類が分かるカードで表示します |
| 動画 | YouTube サムネイル + クリック再生、FFLogs / XIVAnalysis へのリンク |
| マクロ | ゲーム内マクロをワンタップでコピー。ウェイマークとストラテジーボードの共有コードも同じタブに |
| 練習ログ | 下記 |
練習ログ
FFLogs から pull 単位で取り込んで表示します。
- 総 pull 数 / 練習日数 / 最高到達 / クリア回数、日別の進行バー
- 各 pull から FFLogs / XIVAnalysis / 動画のその時点へワンクリック
- ワイプ原因 (最初に落ちたジョブ ← 致命技) と、どのギミックで崩れているかの集計。死亡の直前に何が起きていたかも見られます
- 絶はフェーズ滞在時間と各フェーズの初到達、零式は層ごとの初踏破
- 1 日ぶんをプル・ボックス列で表示 (1 箱 = 1 pull、クリアは
✓)
- pull ごとのミス注釈 — 「ここでこれをミスした」を後から書き足せます
- ⚠ 個人 DPS は保存も表示もしません。 死亡の記録も「ジョブ + 技」までで、プレイヤー名は持ちません
自分のページ (/me)
ヘッダーの人型アイコンから開きます。自分のぶんだけが出ます (幹部でも他人の行は出ません)。
- 自分のジョブ設定 (既定 + コンテンツごとの上書き)。ここで決めたジョブが軽減表の絞り込みに使われます
- 残り BiS と学習パスの進み具合をバーで表示
- 出席サマリーへの入口
そのほか
- コマンドパレット (Ctrl+K) — コンテンツ・タブ・操作を横断で検索
- Discord 自動取り込み — コンテンツごとに攻略 / 動画チャンネル ID を登録すると、毎日 01:00 JST に直近 100 件から URL を拾って該当タブに登録します (ボタンで即実行も可)
- 学習パス — 新しく入った人向けに「動画 → 散開図 → マクロ → 軽減表」の順序つきチェックリスト
- テーマ — 拡張パック 7 種のテーマと専用の背景演出
- 色の意味は 5 段階で統一 (
src/lib/perf-tone.ts) — 良い = emerald → lime → amber → orange → rose = 悪い。残り HP・死亡数・進行バー・出欠記号・週制限に同じ尺度を使います。⚠ 色だけで意味を伝えない (数字と記号を必ず併記)
使い始める
手で集める値は 6 つだけ (必須 5 つ + 管理者ロール ID)、所要 20〜40 分です。詳しい画面の位置は docs/setup.md にあります。
⚠ fork する前に
Fork ボタンの先で、リポジトリ名の既定値 raid-repository を必ず変えてください。そのままだと他の固定の fork と見分けが付かなくなります (例: pandora-raid, tuesday-night-raid)。Vercel のプロジェクト名の既定値にもなります。
1. 値を 6 つ集める (ブラウザ)
| # | 値 | どこで |
|---|
| 1〜3 | Supabase の Project URL / anon / service_role | Supabase でプロジェクトを作り、Settings → API |
| 4 | Discord の Bot トークン | Developer Portal → Bot → Reset Token (SERVER MEMBERS INTENT を ON) |
| 5 | Discord の サーバー ID | Discord (開発者モード) → サーバー右クリック |
| 6 | 管理者ロール ID (DISCORD_ADMIN_ROLE_IDS) | Discord → サーバー設定 → ロール → 右クリック → ロール ID をコピー。未設定だと誰も編集・設定できません |
あわせてブラウザ側で 3 つ:
- Bot を自分のサーバーに招待 (Developer Portal → OAuth2 → URL Generator → Scopes
bot)。Bot がサーバーに居ないと誰もログインできません
- Discord の OAuth2 → Redirects に
https://<project ref>.supabase.co/auth/v1/callback を登録
- Supabase の Authentication → Providers → Discord を ON にして、Discord の Client ID / Secret を貼る
2. 設定とデータベース (コマンド)
このリポジトリを Fork してから、自分の fork を手元に clone します。
git clone https://github.com/<自分>/<fork 名>.git
cd <fork 名>
npm install
npm run setup
npm run setup が、値を検証しながら .env.local を書き、ランダムで良い値 (CRON_SECRET など) を生成し、テーブルの作成まで案内して、最後に診断まで走ります。
3. デプロイして、戻り先を登録する
Vercel → Add New → Project で自分の fork を Import し、Environment Variables に .env.local の中身を全部貼って Deploy します (CRON_SECRET・SECRET_ENCRYPTION_KEY・DISCORD_ADMIN_ROLE_IDS も含めて。詳しくは docs/setup.md の手順 6)。⚠ DEV_AUTH_BYPASS / PUBLIC_DEMO_MODE の行は貼らないでください。
デプロイでドメインが決まったら、Supabase → Authentication → URL Configuration に Site URL と Redirect URLs (https://<ドメイン>/auth/callback と http://localhost:3000/auth/callback) を登録します。ここを忘れるとログイン後に戻れません。
npm run doctor -- --url https://<自分のドメイン>
うまくいかないときは
npm run doctor
環境変数・Supabase への到達・スキーマの適用・Discord ログインの有効化・Bot のトークンとサーバー在籍・SERVER MEMBERS INTENT を実際に叩いて確認し、❌ には直し方を出します。
技術
Next.js 16 + React 19 + Tailwind CSS v4 / Supabase (Postgres + Realtime + RLS) / shadcn/ui + Base UI / Vercel (main への push で自動デプロイ、Cron Jobs)。
守りは 4 層
- proxy — Discord OAuth の入口。サーバーのメンバーでなければ中に入れない
- ページ — ロールごとの表示制限
- Server Action — 書き込みは 1 本ずつ admin 判定
- RLS — DB 側でも同じ判定 (アプリを迂回しても書けない)
FFLogs のトークンは AES-256-GCM で暗号化して保管します。
ローカル開発
npm install
npm run setup # 初回。.env.local を作ります (手で書くなら .env.local.example をコピー)
npm run dev
http://localhost:3000 を開きます (ターミナルには 127.0.0.1 と出ますが、ログインの戻り先は localhost で登録しているので localhost で開いてください)。
| コマンド | 何をするか |
|---|
npm run setup | 対話式のセットアップ (.env.local 作成 → スキーマ → 診断) |
npm run doctor | 設定の診断。-- --url https://… で公開済みサイトも見ます |
npm run dev | 開発サーバー (このパソコンからだけ開ける 127.0.0.1。DEV_AUTH_BYPASS で admin になるので、同じ Wi-Fi の他の端末からは開けないようにしてある) |
npm run build | 本番ビルド |
npm run lint | ESLint |
scripts/check-*.mjs は純関数と契約の検査で、CI で全部走ります。
ドキュメント
ブランド
ロゴは public/brand/ にあります。logo-mark.svg の正方形マークは、クリスタル = 蓄積した知識の器、周囲の 8 点 = 8 人 PT で、上 2 点がタンク (青)、下 2 点がヒーラー (緑)、左右 4 点が DPS (赤)。logo-wordmark-dark.svg / logo-wordmark-light.svg は背景の明暗別で、この README の先頭では自動的に切り替わります。アプリ側でもファビコン・iOS ホーム画面アイコン・ログイン画面・起動中スプラッシュに同じマークを使っています。
social-preview.png (1280×640) は GitHub のリポジトリカードに出る画像です。リポジトリの Settings → Social preview から手動でアップロードします (GitHub の API では変更できません)。
License
MIT
ただし src/app/fonts/ のフォント (Geist・JetBrains Mono・Orbitron) は SIL Open Font License 1.1 です (各フォントの OFL-*.txt)。
