優れたライブデモでは、初めて訪れた人がワンクリックでログインし、リアルなデータが詰まったアプリを見て、主要なワークフローを試し、次の訪問者のために何も壊すことなく去っていけます。そのために必要なものは4つです。他のすべてから切り離されたデモ環境、本物らしいデータを作成するシーダー、スケジュールに沿った自動リセット、そしてデモモードで無効化または疑似動作させる機能の短いリストです。
ソースコードの購入者にとって、デモは試乗に最も近いものです。デモは、ガイド記事Webアプリ・SaaSのソースコードを販売する方法で取り上げている主要な信頼のシグナルの1つであり、AppTrovoでは、API専用のバックエンドのように製品に本当に画面が存在しない場合を除き、製品提出チェックリストによってデモURLが必須とされています。この記事はその技術編です。初日だけでなく300日目にもきちんと動くデモの作り方を解説します。
マーケットプレイスの多くの製品がLaravelで作られているため、例にはLaravelを使用しますが、考え方はすべて他の技術スタックにも当てはまります。
どのデモ方式を選ぶべきか?
公開デモの運用方法には一般的に4つあります。ほとんどの販売者は1つ目から始め、訪問者同士の干渉が続く場合にのみ2つ目に移行すべきです。
| 方式 | 仕組み | 長所 | 短所 |
|---|---|---|---|
| 定期リセット付きの共有デモ | インストールは1つ。全員が同じアカウントを使い、1時間程度ごとにデータを復元する | 安価でシンプル。ほぼどんなアプリでも使える | 次のリセットまで、他の訪問者による変更が見えてしまう |
| 訪問者ごとのサンドボックス | 訪問者ごとに新しいテナントまたはデータベースを用意し、数時間後に削除する | クリーンな体験で、干渉がない | コード量とサーバーリソースが増える。クリーンアップ用のジョブが必要 |
| 読み取り専用デモ | 閲覧はできるが、書き込みはブロックされる | 何も壊されず、悪用もされない | 購入者がコアのワークフローを試せず、デモの説得力が弱まる |
| 動画によるウォークスルー | ライブ環境の代わりに録画したツアーを見せる | メンテナンスが一切不要 | 購入者が自由に探索できない。代替ではなく補足として使うのが最適 |
製品がすでにマルチテナント対応であれば、訪問者ごとのサンドボックスは多くの場合簡単です。初回訪問時にテンプレートから新しいテナントを作成し、数時間以上経過したテナントを削除すればよいのです。単一企業向けアプリの場合は、リセット付きの共有デモが現実的な選択です。
ステップ1:独立したデモ環境を作る
大切なものと同じサーバー、データベース、ストレージバケットでデモを運用してはいけません。管理者権限付きの公開デモは、探りを入れてくださいと言っているようなものです。
- 専用のサブドメインを使う。
demo.yourproduct.comのように、専用のTLS証明書を持つサブドメインにします。 - 専用のデータベースユーザーを用意する。デモ用データベースに対する権限のみを付与します。
- 専用の環境ファイルを使う。
APP_DEMO=trueのようなフラグを設定し、コードが1か所でconfig('app.demo')をチェックできるようにします。 - デバッグモードをオフにする。公開デモでは
APP_DEBUG=falseが必須です。スタックトレースからパスや設定が漏れる可能性があります。 - すべての外部サービスにダミーの認証情報を使う。テストモードの決済キー、ログ出力またはサンドボックスのメーラーを使い、本物のSMSゲートウェイは使いません。
- 購入者がダウンロードするものと同じビルドをデプロイする。ZIPより新しい、または古いバージョンが動いているデモは、混乱とサポートチケットを生みます。
ステップ2:リアルなデモデータを投入する
空っぽのダッシュボードでは何も売れません。デモは、数か月間アプリを使ってきた企業のように見えるべきです。購入者がインストール時に実行する最小限のシーダーとは別に、DemoSeeder のような専用のシーダーを書きましょう。仕組みについてはLaravelのシーディングに関するドキュメントで解説されています。
デモデータを本物らしく見せるもの
- 今日を基準にした相対的な日付。
now()->subDays(rand(1, 90))のようなオフセットでレコードを生成します。日付をハードコードすると数週間でデモが放置されたように見え、グラフには空の月が表示されてしまいます。 - もっともらしい名前と金額。Fakerなどのライブラリを固定シードで使い、リセット後も毎回同じデータになるようにしたうえで、スクリーンショットに登場するレコードは手作業で作成します。
- すべてのステータスを網羅する。支払済み・期限超過・下書きの請求書、未対応・保留中・完了のチケットを用意します。購入者は各状態がどう見えるかを確認したいのです。
- ページネーションや検索を試せる程度のデータ量にしつつ、レポートが遅くなるほど多くはしません。主要なテーブルごとに数百件程度が通常は適切です。
- アップロード済みのファイルや画像。リポジトリ内のフォルダからアバター、商品写真、文書などを投入し、ページに壊れた画像が表示されないようにします。
- 実在の人物を使わない。たとえ「匿名化済み」であっても、クライアント案件からエクスポートしたデータは絶対に使わないでください。生成しましょう。
データにストーリーを持たせる
架空の企業を1つ決め、それに合ったデータを投入します。たとえば「Greenleaf Landscaping、スタッフ12名、顧客140社、今週予定されている作業あり」といった具合です。一貫したストーリーがあればレポートやダッシュボードに意味が生まれ、ログインページに短いガイドツアー(「今日のスケジュールを開き、作業を別の技術者にドラッグしてみましょう」)を書くこともできます。
ステップ3:ログインを手間なくする
「ライブデモ」をクリックしてからアプリが表示されるまでの手順が1つ増えるごとに、訪問者は離れていきます。デモモードでは、ログインページにデモ用アカウントを直接表示しましょう。
- ロールごとに1つのボタン:「管理者としてログイン」「マネージャーとしてログイン」「スタッフとしてログイン」「クライアントとしてログイン」。各ボタンはフォームに入力するか、デモ専用のログインルートにPOSTします。
- 認証情報もテキストで表示する。自分で入力したい訪問者のため、また出品ページのデモセクションのためです。
- フロントエンドや顧客向け画面へのリンク。予約ページやクライアントポータルなど、アプリにそうした画面がある場合に用意します。
- 全ページにバナーを表示する:「デモモードです。データは1時間ごとにリセットされます。メールは送信されません。」これで、誤解に基づくバグ報告を防げます。
ワンクリックのルートは、config('app.demo') がtrueのときにのみ存在するよう保護してください。パスワード不要のログインルートを、たとえ無効化した状態でも購入者向けのダウンロードに含めるのは、負う必要のないリスクです。
ステップ4:デモを自動でリセットする
訪問者はレコードを削除し、設定を変更し、おかしなファイルをアップロードします。定期的なリセットですべてを元に戻しましょう。データ量に合った方法を選んでください。
| リセット方法 | 手順 | 適したケース |
|---|---|---|
| マイグレーションとシーダーで再構築 | php artisan migrate:fresh --seed --seeder=DemoSeeder --force を実行する | 小〜中規模のデータセット。常に現在のスキーマと一致する |
| データベースのスナップショットを復元 | 一度シードしてデータベースをダンプし、リセットのたびにそのダンプを復元する(例:pg_restore や mysql を使用) | シードに数分かかる大規模なデータセット |
| コンテナを再作成 | データを組み込んだイメージからデモを起動し、スケジュールに沿ってコンテナを置き換える | コンテナ化された製品。最もクリーンな分離 |
| 訪問者ごとのテナントを削除 | 一定時間を過ぎたサンドボックスをジョブで削除する | 訪問者ごとのサンドボックスを使うマルチテナント製品 |
セッションを壊さないリセットコマンド
リセット処理を demo:reset のような1つのコマンドにまとめ、フレームワークのスケジューラーで実行します(例:Schedule::command('demo:reset')->hourly())。Laravelのタスクスケジューリングのドキュメントをご覧ください。このコマンドは次の処理を行うべきです。
- 「デモをリセット中です。1分ほどで戻ります」という親切なページを表示して、アプリをメンテナンスモードにする。
- データベースを再構築または復元する。
- 公開ストレージからアップロードファイルを削除し、シード用のファイルをコピーし直す。
- キャッシュ、キューに入ったジョブ、セッションをクリアし、存在しなくなったユーザーとしてログインしたままの訪問者が残らないようにする。
- アプリを再開し、ホームページに一度アクセスしてキャッシュを温める。
ほとんどのアプリでは1時間ごとで問題ありません。リセットに1分以上かかる場合は、実行頻度を下げるかスナップショット方式に移行してください。可能であれば、次回のリセット時刻をデモのバナーに表示しましょう。
ステップ5:訪問者に変更させてはいけないものを制限する
購入者の環境では無害でも、公開デモでは有害になる操作があります。それらはデモモードでブロックしましょう。理想的には1つのミドルウェアまたはポリシーにまとめ、一覧を一目で確認できるようにします。
- メールとSMSの送信。ログメーラーを使い、何もサーバーの外に出ないようにします。そうしないと、「ユーザーを招待」フォームを通じて、デモが無料のスパム中継サーバーになってしまいます。
- デモアカウントのパスワードとメールアドレス。訪問者が管理者のパスワードを変更すると、次のリセットまで他のすべての訪問者が締め出されてしまいます。
- アップロード。本番環境よりも厳しくファイルの種類とサイズを制限し、アップロードされたファイルを実行されうるパスから配信しないでください。
- 外部へのリクエスト。Webhook、「接続テスト」ボタン、URLインポーターは、あなたのサーバーから他のサーバーを呼び出させる目的で悪用される可能性があります。無効化するか、疑似動作にしてください。
- インストーラー、バックアップ、アップデート、システム設定。パスや環境変数の値が見える画面や、コマンドを実行できる画面は非表示にします。
- 決済。決済プロバイダーのテストモードを使い、チェックアウトページにテスト用のカード番号を表示します。
操作をブロックした場合は、403ページではなく「デモでは無効です」といった明確なメッセージを表示し、その機能が存在することを訪問者に伝えましょう。ログインとフォーム送信にはレート制限も追加してください。OWASP Top Tenは、攻撃者が公開Webアプリに対してまず何を試すかを思い出すのに役立ちます。
ステップ6:デモを検索結果から除外し、監視する
- noindexルールを追加する。上位表示させたいのは出品ページであり、ダミーデータが入ったデモの管理画面ではありません。Googleはnoindexでインデックス登録をブロックするためのガイドで選択肢を説明しています。
- 稼働状況を監視する。デモが停止したときに通知してくれる無料の死活監視ツールは、設定しておく価値があります。出品ページのデモが壊れていると、気づかないうちに売上を失います。
- リセットのログを確認する。各リセットの開始・終了・結果をログに記録し、失敗時にはアラートを出します。リセットが失敗してデモがメンテナンスモードのまま残るのは、よくある、そして避けられる障害です。
- ディスク容量に注意する。アップロード、ログ、古いスナップショットは増えていきます。リセット時にログをローテーションし、ストレージを整理しましょう。
- リリースのたびに更新する。パッケージ化するのと同じタグからデモをデプロイし、リリースのチェックリストに「デモを更新済み」を追加します。サポート、アップデート、バージョン管理に関するガイドにそのチェックリストが掲載されています。
ライブデモのチェックリスト
- サブドメイン、データベースユーザー、ストレージを分離する。
- 環境設定で
APP_DEBUG=falseとデモ用フラグを設定する。 - すべての外部サービスにテストモードのキーを使い、メールにはログメーラーを使う。
- 相対日付、すべてのステータス、シード用ファイルを備えた専用のデモシーダーを用意する。
- ロールごとのワンクリックログイン、テキストでの認証情報表示、全ページへのデモバナーを用意する。
- データベース、ファイル、キャッシュ、キュー、セッションをクリアする定期リセットを設定する。
- パスワード変更、外部へのリクエスト、危険な設定画面をブロックする。
- ログインとフォームにレート制限をかける。
- デモにnoindexを設定し、稼働監視とリセットのアラートを用意する。
- デモのバージョンをダウンロード版と一致させる。
デモが安定したら、出品ページの最初の画面からリンクし(コードが売れる出品ページの書き方を参照)、AppTrovoに製品を出品する際に製品フォームへデモURLを登録しましょう。
よくある質問
公開デモはどのくらいの頻度でリセットすべきですか?
共有デモであれば、1時間ごとが妥当なデフォルトです。訪問者がデモを壊れた状態や見苦しい状態のまま去ることが多い場合は頻度を上げ、リセットに時間がかかる場合やデータがあまり変わらない場合は頻度を下げてください。次のリセットがいつ行われるかは、必ず訪問者に表示しましょう。
デモでは管理者の全権限を与えるべきですか?
多くの場合は、はい。購入者が最も時間を費やすのは管理画面と設定なので、そこを見たいと考えています。管理者の全権限を与えつつ、デモ用パスワードの変更やバックアップの実行など、他の人のデモを壊したりサーバーを露出させたりする少数の操作だけをブロックしましょう。
動画があればデモは不要ですか?
動画は役立ちますが、ライブデモの代わりにはなりません。購入者はデモを使って、速度や自分の端末での表示、動画では省略される細部を確認します。動画は手早い概要説明に、デモは証拠として使いましょう。
デモを通じたスパムを防ぐにはどうすればよいですか?
すべてのメールをログドライバーに送り、SMSと外部へのWebhookを無効にし、フォームとログインにレート制限をかけ、定期的にリセットして書き込まれたコンテンツが消えるようにします。訪問者が入力したアドレスに、デモから本物のメッセージを送らせることは決してしないでください。
安価な共有ホスティングでデモを運用できますか?
ホストがcronに対応していて、リセットがすぐに終わるなら可能です。ただし通常は小規模なVPSのほうが信頼性が高く、デモを適切に分離できます。どちらを選ぶにしても、実データを保持するサーバーからはデモを切り離しておきましょう。