test: 年次フィルタリング機能のテストスクリプトを追加

/statsと/dojosの数値の違いを検証するテストを実装:
- /stats: sum(:counter) - 支部数の合計
- /dojos: 道場の個数 - 各道場は1回のみカウント

テスト結果:
- 全年度でテスト成功
- 差分は複数支部を持つ道場（大田・邑南など）によるもの
- 無効な年のリダイレクトも正常動作

docs: 仕様の違いを明確に文書化

Author: yasulab

docs/plan_download_yearly_stats.md

@@ -3,6 +3,14 @@
 ## 概要
 CoderDojoの統計データを年次でダウンロードできる機能を実装する。`/dojos` ページにクエリパラメータ（`?year=2024`）を追加することで、特定年のデータや全年次統計をCSV/JSON形式でダウンロード可能にする。既存の `/stats` ページとの混乱を避けるため、`/dojos` エンドポイントを拡張する形で実装する。
 
+### ⚠️ 重要な仕様の違い
+- **/stats の累積合計**: `sum(:counter)` - 複数支部を持つ道場は支部数分カウント（例: counter=3なら3としてカウント）
+- **/dojos のリスト**: 道場の個数 - 1道場は1つとしてカウント（counterに関わらず）
+
+これは意図的な仕様の違いです：
+- `/stats` は支部数の統計を表示
+- `/dojos` は道場のリストを表示（各道場は1回のみ）
+
 ### データの取得範囲
 - **yearパラメータなし（デフォルト）**:
   - 全形式（HTML/JSON/CSV）: 全道場（アクティブ + 非アクティブ）※既存の動作そのまま

script/test_yearly_dojos_count.rb

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+require 'net/http'
+require 'json'
+require 'uri'
+
+# 統計ページの累積合計データ（/statsから取得）
+# これはsum(:counter)の値（支部数の合計）
+STATS_COUNTER_TOTALS = {
+  2012 => 5,
+  2013 => 7,
+  2014 => 17,
+  2015 => 22,
+  2016 => 63,
+  2017 => 118,
+  2018 => 172,
+  2019 => 200,
+  2020 => 222,
+  2021 => 236,
+  2022 => 225,
+  2023 => 199,
+  2024 => 206
+}
+
+BASE_URL = 'http://localhost:3000'
+
+def fetch_dojos_count(year)
+  uri = URI("#{BASE_URL}/dojos.json?year=#{year}")
+  response = Net::HTTP.get_response(uri)
+  
+  if response.code == '200'
+    JSON.parse(response.body).length
+  else
+    nil
+  end
+end
+
+def test_invalid_years
+  puts "\n📍 無効な年のテスト:"
+  
+  # 範囲外の年
+  [2011, 2026].each do |year|
+    uri = URI("#{BASE_URL}/dojos.json?year=#{year}")
+    response = Net::HTTP.get_response(uri)
+    
+    # HTMLページへのリダイレクトを期待（302 Found）
+    if response.code == '302' || response.code == '303'
+      puts "  ✅ #{year}年: リダイレクト (#{response.code})"
+    else
+      puts "  ❌ #{year}年: 予期しないレスポンス (#{response.code})"
+    end
+  end
+  
+  # 文字列の年
+  uri = URI("#{BASE_URL}/dojos.json?year=invalid")
+  response = Net::HTTP.get_response(uri)
+  if response.code == '302' || response.code == '303'
+    puts "  ✅ 'invalid': リダイレクト (#{response.code})"
+  else
+    puts "  ❌ 'invalid': 予期しないレスポンス (#{response.code})"
+  end
+end
+
+def main
+  puts "🧪 道場数年次フィルタリングのテスト"
+  puts "=" * 50
+  
+  all_passed = true
+  
+  puts "\n📊 各年のアクティブ道場数の検証:"
+  puts "※ /dojos は道場リスト（道場数）、/stats は支部数合計（counter合計）を返します"
+  puts "\n年    | /stats | /dojos | 差分  | 説明"
+  puts "-" * 50
+  
+  STATS_COUNTER_TOTALS.each do |year, stats_total|
+    dojos_count = fetch_dojos_count(year)
+    
+    if dojos_count.nil?
+      puts "#{year} | #{stats_total.to_s.rjust(6)} | ERROR  |       | ❌ 取得失敗"
+      all_passed = false
+    else
+      diff = stats_total - dojos_count
+      status = diff >= 0 ? "✅" : "❌"
+      puts "#{year} | #{stats_total.to_s.rjust(6)} | #{dojos_count.to_s.rjust(6)} | #{diff.to_s.rjust(5)} | #{status} #{diff > 0 ? "複数支部あり" : ""}"
+    end
+  end
+  
+  # 無効な年のテスト
+  test_invalid_years
+  
+  # yearパラメータなしの場合
+  puts "\n📍 yearパラメータなしのテスト:"
+  uri = URI("#{BASE_URL}/dojos.json")
+  response = Net::HTTP.get_response(uri)
+  if response.code == '200'
+    total_count = JSON.parse(response.body).length
+    puts "  全道場数: #{total_count}個"
+    
+    # 全道場数は2024年の道場数よりも多いはず（非アクティブ含むため）
+    dojos_2024 = fetch_dojos_count(2024)
+    if total_count >= dojos_2024
+      puts "  ✅ 全道場数(#{total_count}) >= 2024年アクティブ道場数(#{dojos_2024})"
+    else
+      puts "  ❌ データ不整合: 全道場数が2024年アクティブ数より少ない"
+      all_passed = false
+    end
+  else
+    puts "  ❌ 取得失敗"
+    all_passed = false
+  end
+  
+  puts "\n" + "=" * 50
+  if all_passed
+    puts "✅ すべてのテストが成功しました！"
+  else
+    puts "❌ 一部のテストが失敗しました"
+    exit 1
+  end
+end
+
+main if __FILE__ == $0