SC-018 最近の導入台一覧ショートコード

概要

• 考察日・ホールを属性で受け取り、P-16「最近の台入れ替え」と同じ 7 日間（DailyArticleKishuCountDeltaPeriod::LOOKBACK_DAYS_BEFORE_CONSIDERATION_DATE = 考察日 − 6 日 〜 考察日）の db_daily_article_kishu_count_delta から、前日比が正（+） の機種を一覧表示する（Issue #2501）。
• データ取得は SC-015 と同一の DailyArticleKishuCountDeltaRepository::list_for_hall_and_period_range() を利用する。
• 同一機種が複数日で + になっている場合、最新の period_key の行のみを表示する（Repository の period_key DESC 順で先頭採用）。
• 各機種から期間機種別差枚ランキング（PUB-005）へ遷移するリンクを付与する。期間は + 検出日（period_key）〜考察日を事前指定する。
• 増台日から考察日までの 累計差枚・平均差枚（台毎）を PeriodSamaiSummaryService と同じ集計で各行に表示する。
• 表示名は delta テーブルの kishu（機種マスタ JOIN 後の表示名）。PUB-005 のハイライトも同一名で整合する。
• 0 件時は空 HTML（セクション非表示）。

ワイヤーフレーム

ブロック一覧

ブロックID	ブロック名	表示内容	初期値	ユーザー操作	アクション
B-0	最近の導入台一覧	見出し＋日付・機種・累計差枚・平均差枚・期間分析リンクのテーブル	前日比 + の機種があるときのみ	期間分析リンク	-

表示条件・注記

• 属性: consideration_date / hall 必須。heading_id 任意。
• 対象: 考察日を含む直近 7 日間で前日比が正（+）の機種のみ（同一機種は最新 period_key）。
• 0 件: セクション非表示（空 HTML）。
• 実装参照: Twig core_src/View/templates/recent_new_machine_list/recent_new_machine_list.twig。mockup mockups/RecentNewMachineListWireframe/。SC-015 とは列が異なるため専用 WF。

外部インターフェース

ショートコードタグ

• タグ名: [recent_new_machine_list]
• 入力例: [recent_new_machine_list consideration_date="2024-06-01" hall="アイランド秋葉原" heading_id="recent-new-machine-list-heading-1"]

属性一覧

属性	役割	必須
consideration_date	考察日（YYYY-MM-DD / YYYY/MM/DD / YYYYMMDD 形式、2020年〜当年）	○
hall	対象ホール名（HallEnum 対応）	○
heading_id	見出し要素の HTML id（日別記事テンプレートでは loop.index 付き）	-

出力

列	内容
日付	period_key（+ 検出日。表示は n/j 形式・年なし）
機種名	kishu
累計差枚	増台日〜考察日の合計差枚（PeriodSamaiSummaryService と同集計。データなしは -）
平均差枚	同上期間の台毎平均差枚（小数第 1 位。データなしは -）
期間分析	PUB-005 へのリンク（period_key 〜 考察日の期間・機種ハイライト付き）

• 見出し: 「最近導入、増台した台の状況は？」
• ソート: period_key DESC

エラー

条件	ユーザー向け挙動	メッセージ / ログ
consideration_date 未指定または空	ErrorHandler の返す文言	ValidationException（日付バリデーション系）
hall 未指定または不正値	同上	ValidationException（HallEnum 照合失敗）
コントローラー・サービスの例外	ErrorHandler の返す文言	ErrorHandler::handle_error() 経由

利用元

画面	処理番号	呼び出しパターン	備考
PUB-001 日別記事（シングル）	P-17	[recent_new_machine_list consideration_date="Y-m-d" hall="…" heading_id="recent-new-machine-list-heading-{n}"]	関連日（P-12）の直後。0 件時はセクション非表示。heading_id はホールループ内でユニーク化（P-16 と同パターン）