花結び こいこい - 美しい和絵巻の花札対戦ゲーム

【目的・ターゲット】日本の伝統的カードゲーム「花札(こいこい)」を、誰でもすぐ遊べるブラウザ対戦ゲームとして再構築。ルールを知らない人も図鑑モードで学べ、暇つぶし〜本格対戦まで幅広い層(10代〜シニア)に対応する無料公開アプリ。

【主要機能】
1. こいこいルール完全実装:場札8枚・手札8枚・山札からの取り札、光/タネ/タン/カス役の自動判定、役成立時に「こいこい」続行か「勝負」で確定するか選べる。
2. CPU対戦(初級・中級・上級の3難易度、思考ロジックの強さを変化)、1本/3本/5本勝負を選択可能。
3. 12ヶ月の花札44枚を美麗な和風イラストで表現し、獲得時・役成立時に光るパーティクル演出。
4. 図鑑・ルール解説モード:月ごとの絵柄名称、役一覧(五光・猪鹿蝶・花見で一杯等)を得点例つきで解説。
5. 対局結果・通算成績・役達成履歴を記録し、グローバルランキングに登録可能。
6. 和風BGM/SEのミュート切替、フルスクリーン対応、スマホ縦持ち・PC両対応レイアウト。

【画面構成】
(1)タイトル画面:モード選択、難易度選択、図鑑・ルールボタン、ランキングボタン、BGM/SEミュートスイッチ。
(2)対局画面:中央に場札、上部にCPU手札(裏向き)、下部に自分手札、左右に獲得札エリア、役成立時はモーダルで「こいこい/勝負」選択。
(3)図鑑画面:12ヶ月カード一覧と役解説のタブ切替。
(4)結果画面:勝敗・得点内訳・累計成績、ランキング登録フォーム。
(5)ランキング画面:難易度別TOP20表示。

【データ構造】MySQLテーブル game_scores(id, player_name, difficulty, rounds_played, rounds_won, total_score, best_yaku, played_at)。カード・役定義はJS内マスタで管理し、対局進行はLocalStorageに一時保存。

【デザイン方向性】畳・行灯・月夜をイメージした落ち着いた和モダン配色(藍・朱・金)。カードは浮世絵調の繊細な線画で統一。BGMはWeb Audio APIで生成:BPM76・4/4拍子、琴風シンセの主旋律によるAメロ8小節→尺八風装飾音が加わるBメロ8小節→太鼓風パーカッションの4小節ごとフィルを挟みループ。AudioContext.currentTime基準で先読みスケジューリングし、BGM/SEを別ゲインノードで管理、ミュートボタンと停止時のノード解放(disconnect)を実装。

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

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