<%= link_to dojos_path(format: :json), dojos_path(format: :json) %> で JSON に変換できます+ 対象期間を選択すると、その時点のアクティブな道場の一覧を表示・ダウンロードできます。 +
+| @@ -73,26 +110,49 @@ | ||||||||
|---|---|---|---|---|---|---|---|---|
|
-
- <%= link_to dojo_path(dojo[:id]) do %>
- <%= dojo[:name] %> - (ID: <%= dojo[:id] %>) - <% end %> - - |
- - <%= dojo[:created_at].strftime("%F") %> - | -- - - - <%= CGI.unescape dojo[:url].gsub('https://', '').gsub('http://', '').gsub('www.', '').chomp('/') %> - - - - | + <% if dojo[:is_active] %> +
+
+ <%= link_to dojo_path(dojo[:id]) do %>
+ <%= dojo[:name] %> + (ID: <%= dojo[:id] %>) + <% end %> + + |
+ + <%= dojo[:created_at].strftime("%F") %> + | ++ + + + <%= truncate(CGI.unescape(dojo[:url].gsub('https://', '').gsub('http://', '').gsub('www.', '').chomp('/')), length: 30) %> + + + + | + <% else %> +
+
+ <%= link_to dojo_path(dojo[:id]) do %>
+ <%= dojo[:name] %> + (ID: <%= dojo[:id] %>) + <% end %> + + |
+ + <%= dojo[:created_at].strftime("%F") %> + | ++ + + + <%= truncate(CGI.unescape(dojo[:url].gsub('https://', '').gsub('http://', '').gsub('www.', '').chomp('/')), length: 30) %> + + + + | + <% end %>
| <%= @lang == 'en' ? 'Prefecture' : '都道府県名' %> @@ -373,10 +373,10 @@ <% @data_by_prefecture.each_with_index do |(prefecture, count), index| %> | |||
|---|---|---|---|
| + | <%= prefecture %> | -+ | <%= count %> | <% else %> diff --git a/db/dojos.yaml b/db/dojos.yaml index 715c38e67..4cce8c578 100644 --- a/db/dojos.yaml +++ b/db/dojos.yaml @@ -3084,7 +3084,6 @@ order: '272124' created_at: '2022-11-18' name: 八尾 - counter: 2 prefecture_id: 27 logo: "/img/dojos/yao-yotteco.webp" url: https://www.facebook.com/profile.php?id=100087493006122 diff --git a/docs/plan_download_yearly_stats.md b/docs/plan_download_yearly_stats.md new file mode 100644 index 000000000..fdb7f6e3e --- /dev/null +++ b/docs/plan_download_yearly_stats.md @@ -0,0 +1,519 @@ +# 📊 道場統計年次ダウンロード機能 - 実装計画 + +## 概要 +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）: 全道場（アクティブ + 非アクティブ）※既存の動作そのまま +- **yearパラメータあり（例: year=2024）**: + - HTML/JSON/CSV すべての形式: その年末時点でアクティブだった道場のみ + +## 🎯 要件定義 + +### Phase 1: 基本実装（MVP） +1. `/dojos` ページに年次フィルタリング機能を追加 +2. 特定年のアクティブ道場リストをCSV/JSON形式でダウンロード可能に +3. データ内容： + - yearパラメータなし: 全道場リスト（アクティブ + 非アクティブ） + - yearパラメータあり: その年末時点のアクティブ道場リスト +4. 対応形式： + - HTML（表示用） + - CSV（ダウンロード用） + - JSON（API用） + +### Phase 2: 拡張機能（将来） +- 都道府県別・地域別でのフィルタリング（例: ?year=2024&prefecture=東京都） +- イベント数・参加者数の統計も含める +- 年次推移の統計データ（全年の集計データ） +- より詳細なCSVエクスポートオプション + +## 🏗️ 技術設計 + +### 1. ルーティング設計 + +```ruby +# config/routes.rb + +# 既存のルーティングをそのまま活用 +get '/dojos', to: 'dojos#index' # HTML, JSON, CSV（拡張） +get '/dojos/:id', to: 'dojos#show' # HTML, JSON, CSV + +# URLパターン例： +# GET /dojos → 現在のアクティブ道場一覧（HTML） +# GET /dojos?year=2024 → 2024年末時点のアクティブ道場一覧（HTML） +# GET /dojos.csv → 全道場リスト（アクティブ + 非アクティブ） +# GET /dojos.csv?year=2024 → 2024年末時点のアクティブ道場リスト（CSV） +# GET /dojos.json → 全道場リスト（アクティブ + 非アクティブ） +# GET /dojos.json?year=2024 → 2024年末時点のアクティブ道場リスト（JSON） +``` + +### 2. コントローラー設計 + +```ruby +# app/controllers/dojos_controller.rb + +class DojosController < ApplicationController + # 既存のindexアクションを拡張 + def index + # yearパラメータがある場合の処理 + if params[:year].present? + year = params[:year].to_i + # 有効な年の範囲をチェック + unless year.between?(2012, Date.current.year) + flash[:alert] = "指定された年（#{year}）は無効です。2012年から#{Date.current.year}年の間で指定してください。" + return redirect_to dojos_path + end + + @selected_year = year + end_of_year = Time.zone.local(@selected_year).end_of_year + + # その年末時点でアクティブだった道場を取得 + @dojos = [] + Dojo.active_at(end_of_year).includes(:prefecture).order(order: :asc).each do |dojo| + @dojos << { + id: dojo.id, + url: dojo.url, + name: dojo.name, + logo: root_url + dojo.logo[1..], + order: dojo.order, + counter: dojo.counter, + is_active: dojo.active_at?(end_of_year), + prefecture: dojo.prefecture.name, + created_at: dojo.created_at, + description: dojo.description, + } + end + + @page_title = "#{@selected_year}年末時点のCoderDojo一覧" + else + # yearパラメータなしの場合（既存の実装そのまま） + @dojos = [] + Dojo.includes(:prefecture).order(order: :asc).all.each do |dojo| + @dojos << { + id: dojo.id, + url: dojo.url, + name: dojo.name, + logo: root_url + dojo.logo[1..], + order: dojo.order, + counter: dojo.counter, + is_active: dojo.is_active, + prefecture: dojo.prefecture.name, + created_at: dojo.created_at, + description: dojo.description, + } + end + end + + # respond_toで形式ごとに処理を分岐 + respond_to do |format| + format.html { render :index } # => app/views/dojos/index.html.erb + format.json { render json: @dojos } + format.csv { send_data render_to_string, type: :csv } # 新規追加 + end + end + + def show + # 既存の実装のまま + end +end +``` + +### 3. ビュー設計 + +#### 3.1 `/dojos/index.html.erb` の更新 + +```erb + +