週間・月間ランキングを追加

[kojira]

Closes #211

トータルに加えて**暦週・暦月(JST、週は月曜0:00始まり)**のランキングを追加します。

指標ごとの作り方

ぽいんと — users/{id}/sanpai_logs をコレクショングループで横断し、add_point を期間合計。週初と月初の早い方を下限にした1クエリで週間・月間の両方を賄う(週が月をまたぐケースに対応)。ログは2021年から残っているので遡って正確な値が出る。

せんとうりょく — status.total は現在値しか保存が無く過去を復元できないため、期間開始時点のスナップショット cache_data/battle_baseline との差分=伸び幅でランキング。

• 期間キーが変わったら基準値を作り直す(全員0から再スタート)
• 基準値の無いユーザー(新規・初回観測)は現在値で初期化して差分0にする ← 現在値まるごとで1位になる事故を防ぐ
• 伸び幅0以下は載せない。したがって導入直後は空になり、フロントがトータルにフォールバックする

実行とコスト

rankingUpdateGo(毎時)に相乗り。usersの追加スキャンは発生しない(既存スキャンから表示情報を引く)。

	頻度	追加コスト
せんとうりょく期間	毎時	基準値 1 read + 1 write
ぽいんと期間	3時間ごと	期間中の参拝ログ件数に比例

JST 0時は集計回に当たるので、週明け・月初の切り替わりは待たずに反映されます。期間集計が失敗しても(インデックス未作成・一時エラー等)ログを残してトータルの更新は続行します。

キャッシュの持ち方(1MiB対策)

ranking_cache は全ユーザーを表示情報つきで持っており上限が N≒2,000〜3,500。期間別で同じ持ち方をすると余裕が一気に縮むため:

• *_top: 上位100件(display_name / image_path つき)
• *_ranks: 全ユーザー分の {screen_name, value, rank} のみ

「あなたの順位」カードは順位と値しか使わないので、圏外でも自分の順位が出せます。

フロント

• Ranking.vue に指標×期間の2段セグメント。初期表示は週間×せんとうりょく
• 選択中の期間が空ならトータルにフォールバック+「まだ週間の記録が溜まっていないため、トータルを表示しています」の注記。溜まれば自動で期間表示に戻る
• 期間ランキングのヘッダには「週間で伸びたせんとうりょく」等の注記を出し、絶対値との誤解を防ぐ
• 全期間を1レスポンスで受け取るのでタブ切替で再フェッチしない(CDNキャッシュキーも増えない)
• トップページは幅が狭いので :show-tabs="false" でタブを出さず、週間(空ならトータル)のみ

インデックス

sanpai_logs.timestamp に COLLECTION_GROUP スコープのインデックスを追加。fieldOverrides は自動の単一フィールドインデックスを置き換えるため、既存の sanpaiHistoryGo が使う COLLECTION スコープの昇順・降順も併記しています。デプロイは既存の firebase deploy --force が拾います。

検証

• Firestoreエミュレータで go test ./... 全パス。新規テスト: 期間境界(月曜/日曜/月初が週の途中/UTC入力)、3時間間引きの判定、同点同順位・上位100件キャップと全件順位リスト、基準値の初期化・ロールオーバー・伸び幅・不在ユーザーの剪定、コレクショングループ集計、レスポンスの periods と圏外 my_rank
• yarn generate 成功
• ヘッドレスでUI3状態(フォールバック / 週間ぽいんと / 月間せんとうりょく)を目視確認

🤖 Generated with Claude Code

https://claude.ai/code/session_01DwkB6Hj2JggoKcy7FoxNcU

---

Generated by Claude Code

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.