タイムドミノ - 連鎖崩壊パズルゲーム

## 1. アプリの目的・ターゲットユーザー

ドミノ牌を盤面に配置して連鎖倒壊ルートを設計し、最小枚数・最短時間でゴールを達成する「配置型物理パズルゲーム」。
CSSアニメーションで倒壊の連鎖をリアルに再現し、「設計→実行→結果確認」のサイクルが気持ちよく回るカジュアルゲームです。
ターゲットは小学校高学年〜大人全般（特に物理パズル・ルート設計系が好きなゲーマー）。スキマ時間（1〜5分）でも遊べるステージ構成にします。

---

## 2. 主要機能

- **配置モード**：グリッド（10×10マス）上にドミノ牌を縦・横・斜め45°で設置。ドラッグ or タップで配置、右クリック or 長押しで回転。
- **連鎖シミュレーション**：「スタート」ボタンで最初の1枚が倒れ、CSSトランジション+タイムラインキュー方式で順番に連鎖アニメーションが発動。チェーン数・倒壊タイムをカウント。
- **ギミックタイル**：カーブ台（90°方向転換）、ジャンプ台（1マス飛び越し）、ブースター（倒壊速度UP）、ブロック壁（通過不可）の4種を各ステージに配置。
- **ステージモード**：全30ステージ（チュートリアル5＋初級10＋中級10＋上級5）。各ステージに「最小使用枚数」「★3クリア条件（チェーン○回以上 など）」を設定。クリア状況をLocalStorageに保存。
- **エンドレス＆スコアモード**：ランダム生成ステージで制限時間60秒以内に配置→連鎖。スコアをPHPサーバーのMySQLに保存してグローバルランキングを表示。
- **デイリーチャレンジ**：毎日同じシードのステージ（日付ベース生成）を提供。当日のトップタイムランキングをDB管理。

---

## 3. 画面構成

### タイトル画面
- ゲームロゴ（ドミノが倒れるループCSSアニメーション）
- 「ステージモード」「エンドレス」「デイリーチャレンジ」「ランキング」の4ボタン

### ステージ選択画面
- 難易度タブ（チュートリアル / 初級 / 中級 / 上級）
- ステージカード一覧（番号・クリア済み★数・ベストスコアを表示）

### ゲームプレイ画面（メイン）
- 上部：ステージ番号 / 残り配置可能枚数 / チェーン数カウンター / タイマー
- 中央：10×10グリッド（各マスにドミノ・ギミックを配置）
- ギミックタイルは最初からグリッドに固定配置
- 配置済みドミノはアイコン（縦棒 or 横棒 or 斜め棒）で表示
- 右パネル（PCはサイドバー / スマホは下部ドロワー）：
- 使えるピース一覧（ドミノ・ギミック）と残り枚数
- 「リセット」「元に戻す」「スタート」ボタン
- シミュレーション中は配置不可、倒壊アニメーション再生
- 結果表示モーダル：チェーン数・タイム・★評価・ベスト更新フラグ・次のステージへボタン

### ランキング画面
- エンドレス全期間ランキング（TOP 20）
- デイリーチャレンジ今日のランキング（TOP 20）
- ニックネーム（最大8文字、送信時入力）とスコアを表示

---

## 4. データ構造

### テーブル: `scores`
| カラム | 型 | 説明 |
|---|---|---|
| id | INT AUTO_INCREMENT PK | |
| mode | ENUM('endless','daily') | ゲームモード |
| daily_date | DATE NULL | デイリーの場合の日付 |
| nickname | VARCHAR(16) | プレイヤー名 |
| score | INT | スコア（連鎖数×100 - 経過秒×5） |
| chain_count | INT | 連鎖数 |
| elapsed_sec | FLOAT | クリアタイム（秒） |
| created_at | DATETIME DEFAULT NOW() | |

### LocalStorage（クライアント側）
- `domino_stage_progress`: JSON（ステージID → {cleared: bool, stars: int, bestTime: float}）
- `domino_endless_best`: INT（ベストスコア）

### ステージデータ（PHPベタ書きor JSONファイル）
- stages.json：各ステージの{id, name, gridSize, fixedGimmicks[], maxPieces, targetChains, starConditions[]}を配列で管理

---

## 5. デザインの方向性

- **カラーパレット**：濃いウッドブラウン（#3E2009）を背景に、アイボリー（#F5EED8）のドミノ牌、ゴールドアクセント（#D4A017）で結果演出
- **テイスト**：温かみのあるボードゲーム風。手書き風ドット絵ではなく、シンプルなフラットアイコン+影つきカードUI
- **アニメーション**：倒壊はCSSのrotateZトランジション（0.2〜0.4秒）＋タイムアウトで順番に発火。軽くバウンス感を加える
- **フォント**：日本語はNoto Sans JP、数字はOrbitron（Google Fonts）でゲーム感を演出
- **レスポンシブ**：グリッドはvmin単位でスマホ・PCどちらでも画面内に収まるよう設計。スマホはピース選択を下スライドドロワーに格納