コンテンツにスキップ

同意テンプレート設定ガイド

概要

本ガイドは、Vendure Dashboard で同意テンプレートを設定・改訂する運用担当者向けの手順書です。同意テンプレートは、対象商品の購入前に表示される同意モーダルの本文とチェック項目を定義します。

対象と前提

  • 対象画面: コンプライアンス > 同意テンプレート
  • 想定権限: UpdateCatalog
  • 事前確認:
  • 対象商品の同意タイプ（例: IMESO, GLYCOLIC_ACID）が決まっている
  • 同意本文の法務確認が完了している
  • 公開予定日と反映タイミングを運用チーム内で合意している

変更前に残す記録

改訂前に、少なくとも次を運用ログへ残します。

  • 対象テンプレート名
  • 対象の同意タイプ
  • 改訂対象の版（例: v2）
  • 公開予定日時
  • Storefront で確認する対象商品

設定項目の入力ルール

テンプレート名

  • 運用で判別しやすい命名を使用する
  • 推奨形式: <同意タイプ>_<用途>_v<版>
  • 例: IMESO_初回購入同意_v2

同意タイプ

  • 商品側の設定と一致させる
  • 不一致の場合、購入時に想定したテンプレートが表示されない

同意本文

  • 目的、禁止事項、免責、問い合わせ先を明記する
  • 改訂時は意味変更の有無を記録し、版を上げる

チェックリスト項目

  • 1項目1意図で簡潔に記載する
  • 「読みました」「理解しました」などの重複表現は避ける
  • 実運用で最低2項目を推奨:
  • 内容を確認した
  • 使用条件を理解した

新規作成手順

  1. Vendure Dashboard にログイン
  2. コンプライアンス > 同意テンプレート を開く
  3. 新規追加 をクリック
  4. 以下を入力
  5. テンプレート名
  6. 同意タイプ
  7. 同意本文
  8. チェックリスト項目を追加 で必要項目を登録
  9. 保存 をクリック
  10. 一覧で新規テンプレートが表示されることを確認

編集・改訂手順

  1. 一覧から対象テンプレートを検索
  2. 行アクションから 編集 を開く
  3. 本文またはチェックリストを更新
  4. 保存後、再度編集画面を開き、更新内容が保持されていることを確認
  5. 改訂内容を運用ログに記録

[!TIP] 既存文言を大きく変更する場合は、テンプレート名の版も更新し、どの版を公開したかを追跡できる状態にしてください。

公開前チェックリスト

  • 同意タイプが対象商品の設定と一致している
  • 本文の誤字脱字がない
  • チェックリストの文言が重複していない
  • 保存後に再編集して内容保持を確認した
  • Storefront で同意モーダル表示と同意完了を確認した

Storefront 動作確認手順（必須）

  1. 対象商品の詳細ページを開く
  2. カートに追加 を実行し同意モーダルを表示
  3. 以下を確認
  4. テンプレート本文が想定どおり表示される
  5. チェックリスト項目が表示される
  6. 全チェック後に送信し、モーダルが閉じることを確認
  7. 必要に応じて同意履歴表示を確認

よくある不具合と対処

同意モーダルに本文が出ない

  • 商品の consentTypes 設定とテンプレートの同意タイプが一致しているか確認する
  • 有効なテンプレートが存在するか確認する

編集内容が反映されない

  • 保存完了トーストを確認する
  • 一覧を再読み込みして再確認する

Storefront 確認で問題が見つかった

  1. 対象テンプレートを再度開き、直前の確認済み内容との差分を確認する
  2. 誤った本文やチェックリストを更新した場合は、確認済みの内容へ戻して保存する
  3. Storefront 動作確認手順 を再実施する
  4. どの版を戻したかを運用ログへ記録する
  5. 自力で切り分けできない場合は、システム管理者または保守窓口へ連絡する

ローカルで挙動が不安定

  • Seed を投入した Vendure と Storefront の参照先 URL を一致させる
  • VITE_PUBLIC_VENDURE_BASE_URL の設定先を確認する

参考