ランキング有料化 実装タスク分解

本資料は、以下2資料を実装に落とし込むためのタスク分解です。

• docs/ranking-premium-feature-plan.md
• docs/design/playeragg-mvp-scoring-spec.md

1. 実装スコープ（MVP）

• 無料で表示
  • ランキング画面の「チーム成績」
  • 「今月のMVP（1〜3位）」の順位表示
• 有料で表示
  • 部門別ランキング（打撃/投手/守備/走塁）
  • 個人成績の詳細
  • 通算成績閲覧
• 課金
  • 月額300円（iOS/Android）

2. 画面仕様タスク（Flutter）

2.1 ランキング画面の表示制御

• 対象: teambase/lib/features/rankings/fiscal_year_rankings_screen.dart
• タスク
  • 課金状態フラグを参照し、無料/有料セクションを出し分ける
  • 無料ユーザーでは「チーム成績 + 今月のMVP」のみ表示
  • 有料セクション位置にアップセル導線（CTA）を表示

2.2 今月のMVP表示UI

• 対象: ランキング画面のチーム成績カード
• タスク
  • MVP 1〜3位の選手名と総合スコアを表示
  • 同点時順位ルールに従って表示
  • MVP算出不能時のフォールバック文言を表示

2.3 有料導線UI

• タスク
  • 月額300円訴求カード（価値説明、課金ボタン）
  • 復元ボタン（Restore Purchases）
  • エラー時のユーザー向けメッセージ

3. 課金機能タスク（IAP）

3.1 プロダクト定義

• App Store Connect / Google Play Console
  • iOS: TeamBase_monthly_premium
  • Android: monthly_premium_300
  • 説明文・審査用情報を準備

3.2 Flutter実装

• 推奨: in_app_purchase（既存方針に合わせる）
• タスク
  • 商品取得
  • 購入処理
  • 購入復元
  • 購入結果の永続化（ローカル + サーバー検証結果）

3.3 サーバー検証（推奨）

• Firebase Functions
• タスク
  • レシート/トークン検証API
  • premiumEntitlements 的な購読状態保存
  • 有効期限・失効・返金反映

4. データ/集計タスク（MVPスコア）

4.1 計算関数実装

• 仕様元: docs/design/playeragg-mvp-scoring-spec.md
• タスク
  • computeMonthlyMvpRankings() 実装
  • 正規化関数（通常/逆指標）実装
  • 下限条件（AB/Outs）実装
  • 同点解決ルール実装

4.2 集計範囲

• タスク
  • 当月データのみ抽出する集計パスを追加
  • 採用済み試合結果のみ対象にする

4.3 パフォーマンス

• タスク
  • 可能ならサーバー集計 + キャッシュ
  • クライアントでの再計算回数を最小化

5. 権限/課金状態管理タスク

5.1 課金状態プロバイダ

• タスク
  • isPremium を返す Provider 作成
  • ログイン中ユーザーの購読状態を監視

5.2 機能ガード

• タスク
  • 部門別ランキングタブ表示ガード
  • 個人成績詳細遷移ガード
  • API/Firestore読み取り側にもガードを追加（必要に応じて）

6. 計測タスク（必須）

6.1 主要イベント

• ranking_screen_open
• premium_cta_view
• premium_cta_tap
• purchase_start
• purchase_success
• purchase_restore
• premium_feature_view

6.2 KPI集計

• 転換率（CTA -> 課金成功）
• 課金継続率（1か月 / 3か月）
• 無料ユーザーの試合入力率変化

7. テストタスク

7.1 単体テスト

• MVP計算関数
  • 正規化
  • 逆指標
  • 下限条件
  • 同点順位

7.2 UIテスト

• 無料ユーザー表示
• 有料ユーザー表示
• 課金導線（ボタン活性・エラー表示）

7.3 回帰テスト

• 既存ランキング表示の崩れ確認
• 試合結果入力からランキング反映までの導線確認

8. リリース手順（推奨）

Step 1

• MVPスコア計算 + 今月のMVP無料表示（先行リリース）

Step 2

• 課金導線を表示（機能ロックは緩め）

Step 3

• 有料ガードを有効化（部門別/個人成績）

Step 4

• KPI観測1か月 -> 文言/価格/導線改善

9. 実装チェックリスト

• MVP算出関数を実装
• 今月のMVPをチーム成績に表示
• 課金状態Providerを実装
• ランキング画面の無料/有料出し分け
• IAP商品取得/購入/復元
• サーバー検証（推奨）
• 計測イベント埋め込み
• 単体/UI回帰テスト
• ストア審査用説明の準備

10. 将来拡張（次フェーズ）

• 推移グラフ
• 月次ハイライト
• 比較機能
• MVP内訳表示（カテゴリ別点数）