プレミアムビリヤード倶楽部 - 本格3Dライク物理演算ビリヤードゲーム

【目的・ターゲット】隙間時間に本格的な駆け引きと爽快なポケット演出を楽しみたい全年齢層向けの、リッチなビジュアルと物理演算が売りのブラウザビリヤードゲーム。既存ラインナップにない伝統スポーツ×高級クラブ演出でストア上位を狙う。

【主要機能】
1. 8ボール/9ボールの2種目、CPU対戦(Easy/Normal/Hard/Master)
2. ドラッグでキューの角度・パワーゲージを調整し、サイドスピン(捻り)も設定できる直感操作。摩擦・反発・多重衝突を再現したCanvas 2D物理エンジン
3. トリックショットチャレンジ(日替わり固定配置ステージ、全30面)と自由練習モード
4. ショット後の自動スローモーションリプレイ演出、連続ポケットでコンボ表示
5. 4種テーブルテーマ(クラシック英国調/モダンネオン/和風/宇宙)を選択可能、テーマごとに背景・卓・照明が変化
6. モード別グローバルランキング(勝率・連勝・トリックショットクリア数)をMySQLで管理し、ニックネーム登録で参加

【画面構成】
・タイトル画面: 豪華なビリヤードルーム背景、モード/テーマ選択、ランキングボタン
・ゲーム画面: 俯瞰テーブル、下部にパワーゲージ・スピン操作パネル、残り球リスト、スコア表示
・結果画面: 勝敗演出、スコア、ランキング登録フォーム
・ランキング画面: モード別TOP20リスト
・設定画面: BGM/SE音量スライダー、ミュート、操作説明

【データ構造】
scoresテーブル(id, nickname, mode, theme, score, win_streak, trick_clear_count, created_at)。トリックステージ配置は固定JSONで内製、DB不要。

【デザイン方向性】
深いマホガニーとダークグリーンのラシャ、金縁の卓、スポットライトの陰影を基調とした高級クラブの雰囲気。ボール自体は色と光沢のみで表現し、番号はJSで描画。ネオンテーマは紫〜シアンのグロー装飾で差別化。

【BGM/SE仕様】
ラウンジジャズ調、BPM92・4/4拍子。ウォーキングベース+ブラシドラム(ハイハットのゴーストノート含む)+ジャズピアノのii-V-Iコード進行。Aメロ8小節(静かなピアノ主体)→Bメロ8小節(ベース強調・フィルあり)のループ構成。4小節ごとに軽いフィルやコードボイシング変化を入れる。Web Audio APIでAudioContext.currentTime基準の先読みスケジューリングを行い、BGM/SE音量を別管理、ミュート・停止時は全ノードをdisconnectして解放する。SEはボール衝突音・ポケット音・キュー音を短いノイズ+減衰エンベロープで合成。

## BGM品質要件
- アプリの雰囲気に合うジャンル・BPM・拍子を定め、ドラム、ベース、和声、メロディの4層で構成する
- 最低8小節またはA/Bの2展開を作り、休符、アクセント、フィル、フレーズ変化を入れる
- Web Audio APIはAudioContext.currentTime基準で先読みし、BGM/SE別音量・ミュート・停止処理を実装する
- 単一オシレーターの持続音や1〜3音だけの反復はBGMとして不可

## ビジュアル品質要件
- 生成済み素材を仕様内の用途・表示場所で実際に使用し、未使用素材を残さない
- 画風・配色・キャラクター比率を全画面で統一し、文字はHTML/CSSで重ねる
- PC・スマホで画像の欠け、引き伸ばし、文字との重なりがないことを開発完了前に確認する