01 Arrangement Support
スティールダーツ 01 ゲーム（Double Out）のアレンジ判断を学ぶための Web アプリ / PWA です。
単なるチェックアウト早見表ではありません。
- なぜそのナンバーを狙うのか
- 狙いを外した場合にどうリカバリーするのか
- 171 点以上から、次ラウンドの良いテンパイをどう作るのか
- それらをどう反復学習するのか
までを扱います。答えを覚えるアプリではなく、01 アレンジの「判断規則」を身につけるアプリです。
公開先: https://chihirohashimotoac-coder.github.io/01ArrangementSupport/
4 つのモード
| モード | 対象 | やること |
|---|
| CHECKOUT | 残り 2〜170 | 基準ルート・MY ROUTE・理由・その他の合法ルートを表示。1 投ごとに追従。 |
| SETUP | 残り 171〜350 | 次ラウンドに良いテンパイを残す組み立てを提案。ノーテン（Bogey）を避ける。 |
| TRAINING | — | CHECKOUT / SETUP / RECOVERY / MIXED の反復練習と、成績の記録。 |
| SIMULATION | 301 / 501 / 701 / 任意 | 1 投ずつ自分で狙って上がりきる。着弾は設定した能力から盤面の座標として決まる。ゲーム中は答えを出さず、終了後に GAME REVIEW で振り返る。 |
特徴
- 理由が出る。 「T18 を狙って S18 に落ちても 104 が残るため、残り 2 本で T18 → BULL の
チェックアウトチャンスが残ります」のように、engine の計算結果から説明を組み立てます。
- 1 投ごとに追従する。 実際に刺さった場所をタップすると、残り点と残り本数から候補を再計算します。
Bust 判定と Undo があります。
- 成立するルートを不正解にしない。 TRAINING では推奨度 S / A / B / C を付け、
C（成立するが戦術的に非推奨）には必ず非推奨理由を表示します。
- 完全オフライン。 ログイン・バックエンド・外部 DB・生成 AI API を一切使いません。
判断はすべて決定論的な rule based engine です。
開発
npm ci
npm run dev # 開発サーバー
npm run verify # lint + typecheck + test + build
npm run test:e2e # Playwright（先に npm run build が必要）
npm run import:checkout # 添付 Excel から基準ルートデータを再生成
npm run audit:training # TRAINING の大量出題監査
npm run audit:simulation # SIMULATION の散布モデル統計監査
技術構成
React 19 / TypeScript (strict) / Vite / vite-plugin-pwa / Vitest / Testing Library /
Playwright / ESLint / GitHub Actions / GitHub Pages。サーバーは使いません。
ディレクトリ
src/
domain/ 盤面配置・得点・ダート・Double Out ルール（UI 非依存の事実）
data/ 戦術データ（基準ルート・Bogey・隣接・重み・説明文）
engine/ 探索と評価（checkout / setup / recovery / ranking / training）
geometry/ SVG ダーツボードの座標計算
components/ 表示部品
pages/ 画面
hooks/ React との接続
storage/ localStorage（設定・学習履歴）
scripts/ Excel 取り込み・検算、アイコン生成、SPA フォールバック
data/source/ 一次資料（添付 Excel）
docs/ 仕様書
UI / domain / data / engine / storage の責務を分離しています。
戦術データを React コンポーネントへ直書きしません。
データの出典について
- 残り 41〜170 の基準ルートは、添付 Excel
checkout_table_added_routes_final.xlsx の
「第1候補」を取り込んだもの（123 件）です。取り込み時と CI で毎回、
合計・最終ダート・Double Out・途中 Bust・指定ダブル終わりを再計算して検証します。
- 残り 2〜40 は Excel に収録がないため、明示ルールで導出しています
（
src/data/lowStandardRoutes.ts、39 件）。2026-08-31 に v1 の基準ルートとして人間が承認済みです。
- Excel のヘッダーには「PDC頻出ルート」とありますが、出典の一次資料を確認できていないため、
アプリ内では 「基準ルート（Standard Route）」 とだけ呼びます（人間承認済み）。
詳細は
docs/CHECKOUT_DATA_POLICY.md。
アプリ内では、トップページ下部の 「参考資料・出典」 から同じ内容を確認できます
（src/data/references.ts / src/pages/ReferencesPage.tsx）。
掲載するのはこのリポジトリ・添付資料・PR 履歴から実際に参照したことを確認できるものだけで、
Source of Truth / Reference / Project Documentation を区別して表示します。
戦術方針の位置づけ
ルートの推奨度や残し方の評価に使う重みは、人間が承認した v1 の戦術方針です。
「数学的・統計的に絶対正しい値」ではなく、運用しながら見直す前提の暫定値として扱います。
承認の内容と経緯は docs/APPROVALS.md に記録しています。
算術・ルール上の正しさ（合計が LEFT と一致する、最終ダートがダブルである、Bogey かどうか）は
engine が計算し、テストで検証している検証可能な事実で、上の戦術判断とは区別しています。
AI 開発者向け
このリポジトリは Claude Code と Codex の両方で開発します。
作業前に AGENTS.md と CLAUDE.md を必ず読んでください。
main への直接 push は禁止（PR 必須、自動 merge しない）- 戦術データの変更には Human Approval が必要
- 既存の
Darts-Calculator リポジトリは READ ONLY
ドキュメント
| ファイル | 内容 |
|---|
docs/SPEC.md | アプリ全体の仕様 |
docs/ARRANGE_RULES.md | 評価ルールと重み、理由コード |
docs/CHECKOUT_DATA_POLICY.md | 基準ルートデータの扱いと検算 |
docs/SETUP_THEORY.md | 171〜350 の考え方（0・1・4・7、TON の罠、S-BULL） |
docs/UI_SPEC.md | 画面仕様 |
docs/SIMULATION_DESIGN.md | SIMULATION の着弾モデル・進行・レビュー |
docs/TEST_STRATEGY.md | テスト方針 |
docs/DATA_CONFLICTS.md | 資料と計算結果の食い違い・確認事項 |
docs/APPROVALS.md | 戦術方針の人間承認記録（v1） |
