​
公開フロー

1

ドラフト確認

AIが生成した内容をプレビューし、必要に応じてチャットまたはビジュアルエディタで修正。
2

レビュー共有

自動採番されたプレビューURLをチームに共有。必要であればパスワード保護。
3

公開

「公開」ボタンを押すとGrav CMSへ書き出され、CDNキャッシュが更新されます。

​
プレビューと承認

  • 右上のデバイス切り替えでデスクトップ / タブレット / モバイルを即確認
  • /api/capture-screenshot を呼び出すと、最新のサムネイルをダッシュボードと共有資料に表示可能
  • コメントはチャット履歴としてPostgreSQLに保存され、後から確認できます
重要なレビューには「レポート」ボタンでPDF出力を活用すると、社内承認フローに添付しやすくなります。

​
公開オプション

  • 即時公開
  • 限定公開
  • カスタムドメイン
デフォルト設定。公開ボタンで即時に https://app.hirameki-web.com/u/{user-id}/{site-name} が更新されます。

​
公開後の管理

  • 版管理: Gravでは各サイトが /var/www/grav/user/pages/u-xxxx.site-name に保存。ディレクトリごとバックアップすればロールバックできます。
  • メタデータ: /api/update-site-title / /api/update-site-description でダッシュボード表示名を更新。
  • アクセス制御: /api/update-site-visibility で公開/非公開を自動化。CIから叩くことで承認フローと連携可能。
  • スクリーンショット: pm2 上で動くバックエンドがPuppeteerで撮影。必要に応じて再キャプチャしておくと共有がスムーズ。

​
CDNとキャッシュ

公開直後はCache-ControlヘッダーによりCDNへ即時プッシュされます。手動でキャッシュを無効化したい場合は、Nginx上で pm2 reload ai-web-builder-frontend → curl -X PURGE https://app.hirameki-web.com/{path} を実行するか、Cloudflareダッシュボードからパージしてください。
キャッシュパージ後は5〜10秒程度で再取得されます。短時間に連続で公開とパージを繰り返すとレートリミットにかかるので注意してください。

​
よくあるトラブル

サイト生成直後はバックエンドでファイル書き込み中の場合があります。数秒待っても改善しない場合は、APIログで権限エラーが出ていないか確認。
ブラウザキャッシュやCDNキャッシュが残っている可能性あり。スーパーリロードまたはキャッシュパージを実施。
DNSが正しく伝搬しているか、 cname.hirameki-web.com に向いているかを確認。Propagationには最大48時間必要です。