QuesToDo — タスク管理を、冒険にする。

完全サーバーレス（運用コスト0円）

個人開発の持続可能性を最優先し、バックエンドを持たない構成に。データの真実は端末内SQLite、課金状態のみRevenueCatを真実とし、オフライン時は7日猶予付きローカルキャッシュで判定します。

効果: サーバー費用・運用監視・個人情報管理リスクがゼロ。タスク管理・RPGコアの全機能がオフラインで動作。

EXPはイベントソーシング的に管理

獲得EXPはexp_eventsテーブルへの追記のみで表現し、レベルや累計値は「再計算可能なキャッシュ」として扱います。レベル曲線を後から変更しても（実際に一度変更しました）、再計算関数を通すだけで既存ユーザーのデータが正しく移行されます。

効果: ストリーク・実績・統計21項目がすべて同じイベント列から純関数で導出でき、データ不整合が構造的に起きない。

追記型DBマイグレーション（v1→v9）

スキーマ変更はALTER ADD / CREATEのみ許可し、破壊的変更を禁止。各バージョンのフィクスチャから最新版へ昇格するテストを常備し、どの旧バージョンのユーザーが更新しても安全にアップグレードされることを保証します。

効果: 開発期間を通じ、実データ入りの実機DBへのスキーマ変更9世代をデータ事故ゼロで完走（旧版フィクスチャからの昇格テストで保証）。

テスト容易性を前提にした関数設計

ゲームロジック（レベル計算・ストリーク・EXPブースト）は純関数にし、現在時刻・今日の日付はnow / todayStrとして引数注入。ロジック内部でDate.now()を呼ばないルールを徹底しました。

効果: 日付跨ぎ・タイムゾーン・うるう日のようなモバイル特有のエッジケースを366件のテストで固定化。

外部SDKはservices/層に隔離

広告・課金・分析・共有・バックアップ・通知はすべてservices/に閉じ込め、画面コンポーネントからSDKを直接呼びません。APIキー未設定時は「安全な無効モード」で動作します。

効果: SDK差し替えやモック化が容易。ネイティブモジュール未搭載の旧ビルドでも起動不能にならない（動的import活用）。

マスタデータはDBではなくコードで管理

レベル曲線・スキル52種・アバターパーツ84項目のカタログはTypeScript定数。型チェックがそのままデータ検証になり、パーツIDは削除禁止（deprecatedフラグで廃止）として後方互換を守ります。

効果: マスタ更新はアプリ更新と原子的に配布され、DBとの不整合が起きない。

デザインシステムの自作

色・タイポグラフィ・角丸・余白をトークン化し、hex値のコード直書きを禁止。アクセントは1色のみ、フォントウェイトは3段階のみという制約で、非デザイナーでも一貫したUIを維持できるようにしました。ドット絵はコンテンツ領域限定というルールで「Apple的なUI × RPGの世界観」を両立しています。