ADM-016 機種台数変化（前日比）管理

概要

• 自動検出された機種台数の前日比変化（db_daily_article_kishu_count_delta）を一覧で確認する。
• 誤検知を想定し、差分値の編集および行の削除ができる。
• 次回のサマリ自動再計算で当該 hall×日の行は差し替えられる（手動修正は消えうる）。

外部インターフェース

管理画面 URL

• URL: /wp-admin/options-general.php?page=kishu-count-delta-admin
• 権限: manage_options

一覧 URL のクエリ

ページネーション・編集リンク・リダイレクト先はいずれも build_list_page_url() が組み立てる。

クエリ	内容
paged	ページ番号（1 のときは省略）
kcd_hall / kcd_period_from / kcd_period_to / kcd_kishu	フィルタ値（URL エンコード。空なら省略）
kcd_edit	編集対象の ID
kcd_success	1 成功系、0 失敗系
kcd_msg	表示文言（URL エンコード）

一覧 URL のエンコード

add_query_arg() は値をエンコードしないため、build_list_page_url() は AdminQueryUrl 経由で渡された生値を 1 回だけエンコードする。生値のままだと & や # を含む機種名で検索したときに条件や文言が途中で切れる。

既知の制約: 受け取り側の sanitize_text_field() は % + 16 進 2 桁を削除するため、A%2Bb のような検索語は往復で値が変わる。

画面構成

領域	内容
フィルタ	ホール（複数可）、対象日 From/To、機種名（部分一致）
一覧	ID / ホール / 対象日 / 機種 / 前日比差分 / 更新日時 / 操作（編集・削除）
編集	選択行の count_delta_vs_previous_day（0 不可）

エラー

条件	ユーザー向け挙動	メッセージ
権限なし	wp_die	権限がありません
nonce 不正	リダイレクト＋エラー通知	認証に失敗しました
差分が 0	更新拒否	差分 0 は登録対象外です。誤検知の場合は削除してください
存在しない ID	更新・削除拒否	指定された ID が不正です

更新不可とみなすもの

• 画面 slug kishu-count-delta-admin — ブックマーク・運用ドキュメント参照のため

変更履歴（設計書）

日付（JST）	変更内容	コード側の対応
2026-08-09	一覧 URL のクエリと、フィルタ値を URL エンコードすることを明記	#3181
2026-08-09	エンコードを AdminQueryUrl に集約	#3187