Appearance
IF一覧
サーバーがビュー/クライアント初期化へ渡す データ構造(Presentation DTO 等) の設計書 IF-* のレジストリ。
WordPress REST で返す JSON 契約 は API-一覧(API-)を正とする。本一覧は PHP → Twig/HTML/wp_localize_script 境界を主に扱う。
設計書コード(ID)一覧
| 設計書コード | 機能名(概要) | 詳細ファイル |
|---|---|---|
| IF-001 | 日別記事結果 Presentation DTO | IF-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_samai | RankingUnitDataDto(台別・差枚ランキング) | 台別ランキング(差枚)および関連ランキング表のデータ供給 |
ranking_unit_rotation | RankingUnitDataDto(台別・回転ランキング) | 台別ランキング(回転)および関連ランキング表のデータ供給 |
ranking_kishu_sum_samai | RankingKishuDataDto(機種別・合計差枚) | 機種別ランキング(合計差枚) |
ranking_kishu_avg_samai | RankingKishuDataDto(機種別・平均差枚) | 機種別ランキング(平均差枚) |
ranking_kishu_avg_rotation | RankingKishuDataDto(機種別・平均回転) | 機種別ランキング(平均回転) |
end_number_data | EndNumberDataDto | 末尾統計の表示 |
heat_map_samai | HeatMapDataDto(差枚) | ヒートマップ(差枚) |
heat_map_rotation | HeatMapDataDto(回転) | ヒートマップ(回転) |
heat_map_all | HeatMapDataDto(全体) | ヒートマップ(全体) |
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 | 簡易レイアウト定義(同上) |