TeamAIXI

TeamAIXI v1.0 — 非公式の eFootball™ スカッド分析ツール（無料・ログイン不要） / An unofficial squad analysis tool for eFootball™ (free, no sign-in).

KONAMI および eFootball™ の公式サービスではなく、KONAMI による公認・提携・運営を受けていません。商標・製品名は各権利者に帰属します。

• 公開範囲・素材・既知の問題: docs/release/teamaixi-v1.md
• 変更履歴: CHANGELOG.md・リリースノート: RELEASE_NOTES.md
• 参照データの自動更新: docs/production-readiness/automated-update-pipeline.md
• 機能の状態: docs/product/feature-ledger.md・実装順: docs/product/integrated-roadmap.md

リポジトリ名・保存データのキー・共有 URL などの内部識別子は、互換性のため旧名（eFootball Team AI / efootball-team-ai）のままです。

---

現在の実装範囲（概要。詳細は機能台帳）

• 選手（World カード 13,297 枚）・監督の検索と詳細、選手比較（2〜4 人）、育成シミュレーション（能力値を直接タップする育成 UI）
• My Team・お気に入り・My Builds・ビルド分析・ビルドの JSON export / import
• スカッド編成・テンプレート・スカッド比較・スカッド診断（通常 / 辛口コメント・共有 URL・画像保存）・診断履歴・改善前後の比較・成長プロフィール
• AI ベスト 11（ルールベース）、基礎能力値のパーセンタイル・称号・バッジ・「あなたの一番」
• 認証（ログイン・パスワード再設定。新規登録は「限定テスト中」）、アカウント別のローカルデータ分離
• 日本語 / 英語、スマホ / PC
• 参照データ: Supabase（本番）。1 時間おきの更新検出、安全条件つきの自動の更新パイプライン

未実装（機能台帳を参照）: コミュニティ・写真付き投稿・友達・ランキング・Tier・ガチャ診断・生成 AI 機能・課金。

利用範囲: 参照データの自動更新が完成・検証されるまで、本人だけで検証する（他人への試用・新規登録・コミュニティ公開はしない）。

---

必要なもの

• Node.js 18 以上（開発環境では v24 で確認）
• npm

---

セットアップと起動（初心者向け手順）

すべて、このフォルダ（eFootball-Team-AI）の中で実行します。

# 1. 依存パッケージをインストール（キャッシュはこのフォルダ内の .npm-cache/ に限定）
npm install --cache ./.npm-cache --no-audit --no-fund

# 2. （任意）選手データを取得する。eFHUB へ GET 1回だけアクセスし、最大100件を保存する。
#    ネットワークが使えない場合はスキップしてよい（一覧は「データなし」表示になる）。
node scripts/fetch-player-index.mjs

# 3. 開発サーバーを起動
npm run dev

起動後、ブラウザで http://localhost:3000 を開きます。

---

よく使うコマンド

コマンド	説明
npm run dev	開発サーバーを起動（コード変更が即反映される）
npm run build	本番用にビルドできるか確認する
npm run start	ビルド結果を起動する（npm run build の後）
npm run typecheck	TypeScript の型エラーを検査する（tsc --noEmit）
npm run lint	ESLint でコードの問題を検査する
npm run test	Vitest で自動テストを実行する
node scripts/fetch-player-index.mjs	eFHUB から選手データを取得する（GET 1回・最大100件）

---

フォルダ構成

eFootball-Team-AI/
├── CLAUDE.md                  安全ルール（変更しない）
├── research.txt               調査資料（変更しない）
├── claude-master-prompt.txt   指示書（変更しない）
├── screenshots/               eFHUB のスクリーンショット（変更しない）
├── docs/
│   ├── efootball-team-ai-design.md  完全設計書
│   ├── efhub-ui-analysis.md         スクリーンショット分析
│   ├── data-verification.md         外部データ調査結果
│   └── progress.md                  進捗記録
├── scripts/
│   └── fetch-player-index.mjs   eFHUB 取得スクリプト（外部 GET 1回）
├── src/
│   ├── app/                  画面と内部API（Next.js App Router）
│   │   ├── layout.tsx        全画面共通の枠
│   │   ├── page.tsx          ホーム
│   │   ├── players/          プレイヤー一覧・詳細
│   │   └── api/              内部API（/api/players など）
│   ├── components/           画面部品（サイドメニュー・カードなど）
│   ├── lib/                  データ取得・検索・並べ替え・型・検証
│   └── data/                 取得した選手データ（JSON）
└── package.json

---

データの扱い

• 画面と内部 API は 外部サイトを直接呼びません。src/data/*.json を参照します。
• 外部データの取得は scripts/ のスクリプトでのみ行います。
• 取得スクリプトは失敗した場合、ファイルを書かずに終了します（既存データが壊れません）。
• 将来 PostgreSQL へ移行できるよう、データの読み書きは src/lib/players.ts の関数に集約しています。

---

ライセンス / 注意

• 本プロジェクトは個人開発の学習用です。
• eFHUB / eFootball World のデータ利用は各サイトの規約に従ってください（取得頻度を抑え、規約・robots.txt を確認すること）。
• eFootball および関連する名称は各権利者に帰属します。