v1.1 ドーパミン強化アップデート 仕様書

リリース概要

KPI 設計

A. Daily Challenge（日替わりチャレンジ）

概要

全プレイヤーが同じ日に同じ色順をプレイするモード。 日付（yyyyMMdd）をシードとする SplitMix64 ベースの決定論的 RNG でシーケンスを生成することで、 サーバーレスで全員が同一体験を共有できる。 公開起算日: 2026-05-12 = Day 1。

シーケンス生成ルール

• 最大 50 ラウンドを事前生成（起動時の遅延なし）
• 同色 3 連続を回避する制約を持つ再シャッフルロジック
• 24:00（端末ローカル時間）で自動リセット
• タイムゾーン跨ぎでも同一日扱い（ローカル日付基準）

処理フロー（Daily Challenge プレイ）

結果シェア

ゲームオーバー時に DailyChallengeResultView を表示し、絵文字グリッド（🟥🟩🟦🟨）形式でシェア可能。

UserDefaults キー（Daily Challenge）

関連ファイル

B. ストリーク強化（毎日続けたくなる装置）

大型ストリーク表示（LargeStreakDisplayView）

idle 画面に大型炎アイコン + 日数を常時表示。 既存の StreakBadgeView より視覚的インパクトを大幅に強化。

ストリークシールド

• 週 1 回まで自動消費
• 1 日休んでもストリークを継続維持
• 次回利用可能日を chromatic_streak_shield_available_date で管理

マイルストーン演出

演出トリガー: idle 画面への復帰時にチェック。chromatic_last_streak_milestone で重複防止。

プッシュ通知リマインダー

• 毎日 21:00 に「今日の CHROMATIC はまだ？」を配信
• 当日プレイ済みの場合は翌日への自動リスケジュール（二重発火防止）
• chromatic_notifications_enabled で ON/OFF 管理

処理フロー（ストリークシールド判定）

UserDefaults キー（ストリーク強化）

関連ファイル

C. Juice 演出強化（ドーパミン分泌の瞬間最大化）

HapticsManager（ハプティクス一元管理）

ParticleBurstView（Canvas パーティクル爆発）

SwiftUI Canvas + TimelineView による軽量パーティクル実装。 重力・回転・透明度フェードを対応。

NewBestFlashView（全画面ゴールドフラッシュ）

プレイ中ベスト更新の瞬間に全画面ゴールドフラッシュを発火。0.3s でフェードアウト。

ScreenShakeModifier（画面シェイク）

GeometryEffect ベースの減衰 sin 波シェイク。マイルストーン到達時・ベスト更新時に発火。

MilestoneFlashView 強化

• スケールスプリングアニメーション
• 外側へのリップルエフェクト
• カラーグラデーション（マイルストーン日数に応じた色変化）
• 文字のトラッキング展開アニメーション

関連ファイル

v1.1 追加実装（評価フィードバック反映）

「短時間で脳を高負荷運転させる」設計としてはかなり強い。
ただし現状は 競技性は強いが、依存性はまだ弱い。
必要なのは Near Miss / Flow演出 / Variable Reward / リズム没入 / Surprise。

D. Near Miss演出（「あと一歩」訴求）

目的: 「ベストまであと1」「Round 5まであと2」など、惜しい時のフレーズで再挑戦動機を最大化。

仕様（通常モード）— GameOverOverlayView

表示優先4段階で出し分け（nearMissText: String? computed property で返す）:

仕様（Daily Challenge）— DailyChallengeResultView

2系統のフレーズを独立して表示可能:

「明日来てね」誘導は Near Miss と独立して表示可（idle帰着動機）。

UI仕様

• カラー: オレンジ系 #FF9500
• 背景: Capsule + 0.4 opacity 影
• アニメーション: バウンスインアニメ

変更ファイル: GameOverOverlayView.swift（nearMissText computed property 追加、NEW BEST ! と排他で表示）、DailyChallengeResultView.swift（nearMissText + comebackText 追加）

E. 速度カーブ 6段階化

目的: 評価AIから「320→250msの急変で記憶ゲー→反射ゲーに変質する」指摘を受け、滑らかなランプに修正。

Difficulty.insane の roundOffset を 19 → 24 に変更。INSANE難易度モードは Round 25+ の INSANE 280ms 速度から開始。

注意: 既存ベストスコアは継続有効。新スコアは旧より上振れ可能性あり（互換性のある変更）。

変更ファイル: GameViewModel.swift（computeSpeed() 6段階化、Difficulty.insane.roundOffset 19→24）

F. Variable Surprise 4種（合計 5.5% 発火）

目的: 評価AIから「報酬密度が単調、予測可能、Variable Reward不足」を指摘され、希少サプライズを追加。

実装クラス

• SurpriseEffectManager（@Observable @MainActor singleton）— 4種発火・確率判定・1プレイ1回制約
• SurpriseBannerView（共用バナーView）— 4種共有のCapsuleバナー

発火条件

• ラウンドクリア時に確率判定（handlePanelTap 内ラウンドクリア時に maybeTrigger(round:) 呼び出し）
• Round 5 未満では発火しない（達成感確立後に効くため）
• 同一プレイで2回発火しない（希少性維持）
• startGame() 時に resetForNewGame() でフラグリセット

4種の演出

注: v1.1 では GOLDEN / ECHO / FLOW は「バナー表示のみ」。各演出の追加ロジック（金パネル化・シーケンスリプレイ・心拍パルス）は v1.2 で本格実装予定。

バナー仕様（SurpriseBannerView）

• Capsule背景に LinearGradient（左→右）
• shadow × 2層
• scale spring bounce-in（0.5 → 1.0）
• 1.4秒後にfade out
• .allowsHitTesting(false)

変更ファイル: GameViewModel.swift（startGame() で resetForNewGame() 呼び出し）、GameView.swift（SurpriseEffectManager.shared 監視、RainbowParticleBurstView 追加、SurpriseBannerView × 4 配置）

アーキテクチャ・追加ファイル一覧

Effects/
├── HapticsManager.swift          # ハプティクス一元管理
├── ParticleBurstView.swift       # SwiftUI Canvas パーティクル
├── ScreenShakeModifier.swift     # GeometryEffect ベース画面シェイク
├── SurpriseEffectManager.swift   # 4種サプライズ発火・確率・1回制約（新規）
└── SurpriseBannerView.swift      # 共用サプライズバナーView（新規）

Daily/
├── SeededRandomNumberGenerator.swift  # SplitMix64 決定論的RNG
├── DailyChallengeManager.swift        # 日付シード・本日ベスト管理
├── DailyChallengeEntryButton.swift    # ホームのエントリボタン
└── DailyChallengeResultView.swift     # 絵文字グリッド結果オーバーレイ

Streak/
├── LargeStreakDisplayView.swift     # idle画面の大型炎+日数表示
└── StreakMilestoneOverlay.swift     # 7/30/100日のお祝い演出

Notifications/
└── NotificationManager.swift        # 毎日21時リマインダー

Game/
└── NewBestFlashView.swift           # 全画面ゴールドフラッシュ

修正ファイル（評価フィードバック反映）:
├── GameViewModel.swift              # startGame()→resetForNewGame(), maybeTrigger(), computeSpeed()6段階化, roundOffset 19→24
├── GameView.swift                   # SurpriseEffectManager.shared監視, RainbowParticleBurstView, SurpriseBannerView×4
├── GameOverOverlayView.swift        # nearMissText computed property 追加（NEW BEST ! 排他）
└── DailyChallengeResultView.swift   # nearMissText + comebackText 追加

UserDefaults 新規キー一覧（v1.1 追加分）

UI 画面遷移（v1.1 変更点）

通知許諾フロー

1. 初回起動時: ATT 許諾後、二回目の idle 復帰タイミングで UNUserNotificationCenter 許諾リクエスト
2. 許可後: 毎日 21:00 の UNCalendarNotificationTrigger(repeats: true) を 1 本登録
3. プレイ済み日: refreshAfterPlay() で同名 ID を削除 → 翌日シングルトリガー + 明後日以降リピートに切り替え
4. 既に拒否済み: SettingsView で「設定アプリから許可してください」へ誘導

ビジネスルール

• Daily Challenge は 1 日 1 回のみ（当日プレイ済み = ボタンを「結果を見る」に変更）
• ストリークシールドは 週 1 回のみ使用可能（連続使用不可）
• マイルストーン演出は各日数につき 1 回のみ（chromatic_last_streak_milestone で管理）
• Daily Challenge のシーケンスはサーバー不要・クライアント完結（オフライン対応）
• Public起算日 2026-05-12 = Day 1 は DailyChallengeManager にハードコード

エラー処理

既知のリスク・制約

• Daily Challenge はローカル時刻基準のためタイムゾーン跨ぎで同一日扱いとなり得る（許容）
• 通知二重発火防止のため refreshAfterPlay() で同名 ID 削除 + 再登録パターンを採用
• パーティクルは Canvas レンダリングのため低スペック端末で FPS 低下の可能性
• iOS 18.0+ 必須（既存と同じ）

関連仕様書

• ストリーク機能（StreakManager） — v1.0 ベース仕様
• ゲームロジック — 速度加速・マイルストーン
• ゲーム画面（CR-GAME-01） — idle / プレイ中 UI
• 設定画面（CR-SET-01） — 通知 ON/OFF 設定

v1.2 で取り組む課題

評価AIの提案のうち、規模が大きいか v1.1 で実装しきれなかった項目。次期スプリントの計画時に参照すること。

変更履歴