05. 納品・運用ポータル¶
本番稼働後の利用・運用・保守・引き継ぎに関する資料をまとめたポータルです。納品パッケージの中で、どの資料が「検収用」「操作用」「保守運用用」「契約条件用」なのかを分けて辿れるように整理しています。
このポータルの見方¶
- この
docs/05-delivery/index.mdは、検収・運用・引き継ぎで共有する主導線です。 - Cloudflare Pages 上のドキュメントサイトは、顧客共有用の絞った閲覧導線として扱います。検収・管理運用に必要な資料を中心に公開し、引き継ぎ資料はこのポータルまたは公式納品物 PDF から確認します。
- 公式納品物として参照する仕様書一式は、
.mkdocs/spec.ymlの構成をもとに出力する PDF を基準に確認してください。 - 検収判定そのものは PDF だけで完結せず、受入基準チェックリスト と 要件トレーサビリティマトリクス も合わせて確認します。
👥 立場別クイックアクセス¶
- 検収担当
- 最初に読む: 納品・検収報告書
- 補助資料: 要求仕様書 / 受入基準チェックリスト / 要件トレーサビリティマトリクス / 保守・サポート計画書(未確定項目あり)
- 目的: 納品範囲、受入条件、証跡、保守開始条件を確認する
- システム管理者・運用担当
- 最初に読む: 運用マニュアル索引
- 補助資料: 管理者マニュアル / Vendure Dashboard操作ガイド / 保守・障害対応索引 / バックアップとリストア / 保守・サポート計画書(窓口情報は未確定項目あり)
- 目的: 日常運用、役割、画面操作、障害一次対応、保守条件を確認する
- 引き継ぎ開発者・保守担当
- 最初に読む: 引き継ぎ索引
- 補助資料: 技術引き継ぎ書 / 保守・障害対応索引 / バックアップとリストア / 保守・サポート計画書(未確定項目あり)
- 目的: 全体構造、外部依存、保守運用、移管準備を確認する
- 一般ユーザー(補助導線)
- 最初に読む: 運用マニュアル索引
- 補助資料: 納品・運用ポータル
- 目的: ログイン、発注、マイページ、FAQ を確認する
- CMS編集担当
- 最初に読む: 運用マニュアル索引
- 補助資料: Vendure運用マニュアル / Vendure Dashboard操作ガイド / システム保守ガイド / WordPress CMS操作マニュアル(内部詳細)
- 目的: お知らせ・バナーの編集、キャンペーン本文の補助更新、メニュー管理、公開確認
✅ 検収担当の読み順¶
- 納品・検収報告書 で、今回の納品範囲・確認順序・対象外の扱いを確認する。
- 要求仕様書 の該当章で、満たすべき要求と成功基準を確認する。
- 受入基準チェックリスト で、ACC 単位の実施結果・判定・証跡を確認する。
- 要件トレーサビリティマトリクス で、要件ごとの in scope / out of scope / pending decision を確認する。
- 進捗管理ドキュメント で、ACC 以外の補助証跡(進捗台帳、dogfooding 記録)を必要に応じて参照する。
- 保守・サポート計画書(未確定項目あり) で、検収完了後の保守開始条件と窓口を確認する。
🧭 タスク別ショートカット¶
- Storefront を緊急停止したい:
maintenance/storefront-maintenance-kv-runbook.md
Cloudflare KV での非常停止・復旧手順を最短で確認する - 納品範囲と受入条件を確認したい:
delivery-and-acceptance-report.md
納品物一覧、要件対応状況、検収条件を確認する - 検収証跡の所在を確認したい:
delivery-and-acceptance-report.md
ACC、RTM、進捗資料の使い分けを確認する - 日常の発注操作を確認したい: manual/user-manual.md
ログイン、商品検索、品番注文、チェックアウト、マイページを確認する - どのマニュアルを読めばよいか迷っている:
manual/index.md
役割別・目的別の入口から、自分に合ったマニュアルを選ぶ - どの保守資料を読めばよいか迷っている:
maintenance/index.md
監視・緊急停止・バックアップ/復旧の入口から必要な runbook を選ぶ - Vendureの日常運用タスクを確認したい:
manual/vendure-operations-manual.md
顧客・商品・注文確認、価格・販促更新、配送設定の軽量手順を確認する - 管理者の役割と基本タスクを確認したい:
manual/admin-manual.md
役割、権限、よくある業務、関連資料への導線を確認する - Dashboard の詳細操作を確認したい:
manual/vendure-dashboard-manual.md
画面別・操作別の詳細手順を確認する - 同意テンプレートを更新したい:
manual/consent-template-setup.md
同意文言の作成、改訂、公開前確認を行う - 監視や定期保守を確認したい:
maintenance/index.md
監視項目、定期点検、障害対応の基準を確認する - バックアップ / 復旧手順を確認したい:
maintenance/index.md
バックアップ方針、復旧シナリオ、検証観点を確認する - 保守条件を確認したい:
保守・サポート計画書(未確定項目あり)
SLA、窓口、対応範囲、料金体系を確認する - 引き継ぎ準備を進めたい:
handover/index.md
全体像、技術引き継ぎ書、保守 runbook への入口を順に確認する - コードベースの全体像から確認したい:
handover/codebase-architecture-overview.md
構成の見取り図、主要な外部依存、引き継ぎ時の読み始めを確認する - CMSでお知らせを更新したい:
WordPress CMS公開運用マニュアル
お知らせの作成・編集・公開手順、フィーチャー設定、更新後の確認を確認する - CMSでキャンペーンバナーを更新したい:
WordPress CMS公開運用マニュアル /
Vendure Dashboard操作ガイド
campaign の公開正本は Vendure、本文や補助ビジュアルは WordPress として確認する - CMSの変更がStorefrontに反映されない:
WordPress CMS公開運用マニュアル
公開状態の確認、再保存、一次対応手順を確認する(深い切り分けは内部詳細へ)
📁 資料の役割分担¶
- 納品・検収
- 役割: 何を納品し、どう受け入れるかを整理する
- 代表資料: 納品・検収報告書
- 検収証跡
- 役割: 受入判定・要件対応・補助記録を確認する
- 代表資料: 受入基準チェックリスト / 要件トレーサビリティマトリクス / 進捗管理ドキュメント
manual/- 役割: 利用者・管理者向けの操作手順
- 代表資料: 運用マニュアル索引 / ユーザーマニュアル / Vendure運用マニュアル / 管理者マニュアル / Vendure Dashboard操作ガイド / WordPress CMS公開運用マニュアル
maintenance/- 役割: 監視、定期保守、障害一次対応、バックアップ/復旧
- 代表資料: 保守・障害対応索引 / システム保守ガイド / バックアップとリストア
handover/- 役割: 構成、コードベース理解、外部依存、引き継ぎの土台
- 代表資料: 引き継ぎ索引 / コードベース アーキテクチャ概要 / 技術引き継ぎ書
- 保守条件
- 役割: 契約条件、窓口、応答条件、対象範囲
- 代表資料: 保守・サポート計画書(未確定項目あり)
🧭 運用ガイドライン¶
- 納品・運用資料は、利用者が観察できる結果や操作手順を優先して書く。
- 「運用手順」と「保守契約条件」を同じ文書に混在させない。
- 保守運用の変更があった場合は
maintenance/の関連資料とポータルの導線を同時に更新する。 - 障害対応フローや監視ルールを見直したら、必要に応じて
04-project-management/側の共有資料とも同期する。 - バージョンやライセンスなど数値を伴う情報は、根拠があるものだけを記載する。
✅ チェックリスト¶
- 新しい納品/検収系資料を追加したら、立場別・タスク別の両方の導線へ追記した。
- 保守運用の変更点を
maintenance/内の関連資料に反映した。 - 引き継ぎに影響する変更を
handover/配下の関連資料に反映した。 - 保守条件の変更がある場合は
maintenance-support-plan.mdと整合を取った。