Appearance
運営ダッシュボード導線ガイド
目的
サイト運営ダッシュボード（site-ops-dashboard）は、WordPress 管理メニューに散らばるカスタム管理画面を、運営者の作業目的から探せるようにするリンクハブである。
既存の page slug や管理メニュー配置は維持し、ダッシュボードは「入口を増やす」役割に限定する。
カテゴリ一覧
| カテゴリ | 用途 | 日常作業 | 注意が必要な操作 |
|---|---|---|---|
| 日別記事運用 | 日別記事の作成、リンク、公開前後の設定 | 対象 | 一部あり |
| P-WORLD / 画像運用 | P-WORLD メール、画像キャプチャ、外部取得 | 対象 | 外部通信・取得 |
| マスタ管理 | イベント、機種、表示名、誕生日関連マスタ | 対象 | 変更影響に注意 |
| 集客・外部連携 | X まとめ、広告タグなどの外部連携 | 対象 | API / HTML 管理 |
| 保守・確認 | ビルド、ログ、集計確認、データ削除、紐付け | 非日常 | 対象 |
日常作業で使う画面
日常的な運営導線として優先して表示する画面は、danger = none を基本とする。
| 作業 | 画面 ID | page slug | カテゴリ |
|---|---|---|---|
| 日別記事へのリンク設定 | ADM-005 | link-day-admin | 日別記事運用 |
| 日別記事の自動作成設定 | ADM-010 | daily-article-auto-create-settings | 日別記事運用 |
| 画像キャプチャ | ADM-002 | pworld-image-capture | P-WORLD / 画像運用 |
| イベントマスタ管理 | ADM-007 | event-master-admin | マスタ管理 |
| 〇〇の日マスタ管理 | ADM-004 | what-day-master-admin | マスタ管理 |
| 誕生日シード取り込み | ADM-013 | birthday-seed-admin | マスタ管理 |
| 誕生日機種紐付け | ADM-021 | birthday-kishu-admin | マスタ管理 |
| 機種マスタ管理 | ADM-017 | kishu-master-admin | マスタ管理 |
| 機種表示マッピング管理 | ADM-006 | kishu-display-mapping-admin | マスタ管理 |
| ヒートマップ島図管理 | ADM-012 | heatmap-layout-admin | マスタ管理 |
| X ツイートまとめ運用 | ADM-008 | twitter-summary | 集客・外部連携 |
| X ツイートまとめ設定 | ADM-009 | twitter-summary-settings | 集客・外部連携 |
| A8 広告管理 | ADM-022 | a8-ad-admin | 集客・外部連携 |
保守・危険操作で使う画面
削除、リセット、外部通信、大量取得、本番反映、ログ削除、集計確認に関わる画面は 注意 または 危険 として扱う。
| 危険度 | 画面 ID | page slug | 理由 |
|---|---|---|---|
| 注意 | ADM-001 | pworld-archive-admin | メール取得、関連処理、リセット操作 |
| 注意 | ADM-003 | build-manager-admin | ビルド成果物の確認・切り替え |
| 注意 | ADM-011 | min-repo-data-admin | 外部通信と Cookie 管理 |
| 注意 | ADM-014 | debug-log-manager | ログ閲覧・削除 |
| 注意 | ADM-016 | kishu-count-delta-admin | 集計結果の確認 |
| 注意 | ADM-020 | ana-slo-data-admin | 外部データ取り込み |
| 注意 | ADM-023 | new-machine-fetch-admin | 外部通信・大量取得 |
| 注意 | ADM-024 | new-machine-kishu-link-admin | 新台情報と機種マスタの紐付け変更 |
| 危険 | ADM-018 | daily-data-delete-admin | 日別データ削除 |
ダッシュボードカードのメタ情報方針
ダッシュボードに表示するカード情報は、運営者が「どの画面へ進むべきか」と「実行前に注意が必要か」を判断できる最小限にする。
| 項目 | 方針 |
|---|---|
| タイトル | 管理画面のメニュー名と揃える |
| 説明 | 主作業を 1 文で示す。実行ボタン名や細かな操作手順は書かない |
| 危険度 | none / caution / danger の 3 値に限定する |
| 状態サマリー | option、Cron、ファイル有無など軽い取得に限る |
| 並び順 | カテゴリ順とカード順は SiteOpsDashboardCatalog::get_sections() を正とする |
状態サマリーはダッシュボード表示のための補助情報であり、重い外部通信や大量 DB スキャンを伴う値は載せない。
管理画面追加時のチェックリスト
管理画面を追加、移動、または導線変更する PR では、次を確認する。
docs/design/一覧/ADM-一覧.mdに画面 ID、論理名、pageslug、典型 URL、導線種別、カテゴリ、危険度を追加または更新するdocs/design/管理画面/画面設計書/に対応する画面設計書を追加または更新する- サイト運営ダッシュボードに載せる場合は
SiteOpsDashboardCatalog::get_sections()に slug、タイトル、説明、危険度を追加する - ダッシュボードに載せない場合は、
ADM-一覧.mdのカテゴリを—とし、理由を備考または関連 Issue に残す pageslug、典型 URL、実装定数（PAGE_SLUG/PARENT_SLUG）が矛盾していないことを確認するpageslug を変更する必要がある場合は、移行手順、旧 URL の扱い、ブックマーク・外部スクリプトへの影響を明記して合意を取る
page slug 変更時の注意
page slug は WordPress 管理画面 URL の一部であり、ブックマーク、運用手順、外部スクリプト、オプション連携から参照される可能性がある。
既存画面の slug は安易に変更しない。変更が必要な場合でも、同じ PR 内で少なくとも次を扱う。
- 旧 slug から新 slug への移行方針
- 関連ドキュメントと画面設計書の更新
- ダッシュボード導線とカテゴリの更新
- 運営者への告知や手順変更の要否