Skip to content

IF一覧

サーバーがビュー/クライアント初期化へ渡す データ構造(Presentation DTO 等) の設計書 IF-* のレジストリ。

WordPress REST で返す JSON 契約API-一覧API-)を正とする。本一覧は PHP → Twig/HTML/wp_localize_script 境界を主に扱う。

設計書コード(ID)一覧

設計書コード機能名(概要)詳細ファイル
IF-001日別記事結果 Presentation DTOIF-001_日別記事結果_PresentationDTO.md

IF-001 日別記事結果 Presentation DTO

詳細の全文・変更履歴は IF-001_日別記事結果_PresentationDTO.md を正とする。以下は折りたたみサマリー。

データ構造(概要)

DTO受け取る内容の概要
DailyArticleResultPresentationDto(ルート)対象ホール・対象日文字列、台別/機種別/末尾/ヒートマップへの入れ子参照、ヒートマップ略称マップ、みんレポ引用元 URL(任意)。画面全体の文脈とブロック別データへの入口。
RankingUnitDataDto台別ランキング。日付ごとの順位表(差枚用・回転用の 2 系統)。ショートコード/テンプレート側が非同期で差し替えるランキング系 UI のデータ源。
RankingKishuDataDto機種別ランキング。ホール絞り込み済みの日別×台別および機種集計(合計差枚・平均差枚・平均回転の 3 種)。機種別ランキング表示のデータ源。
EndNumberDataDto末尾。末尾番号別の統計と台別明細。末尾統計ブロックのデータ源。
HeatMapDataDtoヒートマップ。当日の台別データ、詳細/簡易レイアウト(別処理で注入され得る)。差枚・回転・全体の 3 インスタンス。ヒートマップ表示のデータ源。

表示可否はルート単体ではなく、各入れ子の 当日分のデータ有無(およびヒートマップではレイアウト取得結果)からビュー側で判定する。

DailyArticleResultPresentationDto(ルート) — ホール・対象日、下位 DTO への参照、略称マップ、みんレポ URL を束ねる集約の入り口。
フィールド型・構造の要約主な用途(UI 中立)
hall対象ホール(列挙)画面全体のホール文脈
target_day対象日の表示用文字列(例: Y/n/j日付ラベル・クエリ文脈
ranking_unit_samaiRankingUnitDataDto(台別・差枚ランキング)台別ランキング(差枚)および関連ランキング表のデータ供給
ranking_unit_rotationRankingUnitDataDto(台別・回転ランキング)台別ランキング(回転)および関連ランキング表のデータ供給
ranking_kishu_sum_samaiRankingKishuDataDto(機種別・合計差枚)機種別ランキング(合計差枚)
ranking_kishu_avg_samaiRankingKishuDataDto(機種別・平均差枚)機種別ランキング(平均差枚)
ranking_kishu_avg_rotationRankingKishuDataDto(機種別・平均回転)機種別ランキング(平均回転)
end_number_dataEndNumberDataDto末尾統計の表示
heat_map_samaiHeatMapDataDto(差枚)ヒートマップ(差枚)
heat_map_rotationHeatMapDataDto(回転)ヒートマップ(回転)
heat_map_allHeatMapDataDto(全体)ヒートマップ(全体)
heatmap_abbreviation_map機種表示略称の連想配列(表示名 → 略称)ヒートマップセル等の機種略称表示
min_repo_source_url引用元 URL または未設定時 null(投稿 meta から補完され得る)みんレポ等の引用元リンク
RankingUnitDataDto — 台別ランキング。日付キーごとの順位表データと種別(差枚/回転)。ルートでは差枚・回転の 2 フィールドに分かれる。
フィールド型・構造の要約
ranking_data_by_date日付文字列(YYYY-MM-DD)をキーとし、その日のランキング行を値とするマップ(複数日分を保持し得る)
hall対象ホール
target_day基準日(文字列、YYYY-MM-DD
typeランキング種別(差枚/回転など)
RankingKishuDataDto — 機種別ランキング。ホール絞り込み済みの日別×台別リストと機種集計リスト、集計軸(合計差枚・平均差枚・平均回転)。ルートでは 3 フィールドに分割。
フィールド型・構造の要約
hall_filtered_daily_data_per_unit_dtosホール絞り込み済みの日別×台別データの配列
daily_data_kishusホール絞り込み済みの機種別集計データの配列
target_day基準日(文字列、YYYY-MM-DD
type機種ランキング種別(合計差枚/平均差枚/平均回転など)
hall対象ホール
EndNumberDataDto — 末尾データ。末尾別の統計と、末尾ごとの台別明細。
フィールド型・構造の要約
end_number_stats末尾別の集計(統計)
end_number_details末尾別の台別明細
hall対象ホール
target_day対象日(文字列、YYYY-MM-DD
HeatMapDataDto — ヒートマップ。当日の台別データ・種別文字列・詳細/簡易レイアウト。ルートでは差枚・回転・全体の 3 インスタンス。
フィールド型・構造の要約
daily_data_per_unit_dtos当日・対象ホールの台別データ(セル値の元)
hall対象ホール
target_day対象日(文字列、YYYY-MM-DD
typeヒートマップ種別(差枚/回転/全体)
heat_map_layout_data島/台の詳細レイアウト定義(同期 HTML 組み立て前に別処理で注入され得る。取得失敗時は空になり得る)
heat_map_simple_layout_data簡易レイアウト定義(同上)