Sushi SaaS を構築・運用する

目的のタスクを選ぶと、正確な設定手順と確認方法が分かります。選択の理由を理解したり、変更点を判断したりする場合は「ガイド」を参照してください。

はじめに

クイックスタート

Core で顧客アプリと永続 worker をローカル起動し、必要になったら管理コンソールと Content Studio を追加します。

プロダクトをカスタマイズする

独自機能を作る前に、プロダクト名、対応言語、ビジュアル、テーマ、法務情報、オプション機能の方針を決めます。

Next.js SaaS と Payload の環境設定

開発・本番プロファイルと内部シークレットを用意し、共有する SaaS サービスと独立した Content Studio を正しく設定します。

アーキテクチャとエラー契約

データ、認可、ユーザー向けエラーの境界を破らずに Sushi SaaS を拡張します。

プロダクトを構築

データベースとマイグレーション

PostgreSQL の運用先を選び、実行中のアプリを壊さず Drizzle の変更をリリースします。

顧客認証

顧客のログイン方法を選び、MFA とプラットフォーム権限で独立した運用コンソールを守ります。

組織、チーム、テナント分離

顧客の共同作業モデルを決め、同梱の組織内の役割、招待、利用人数、テナント境界を調整します。

プラン、上限、エンタイトルメント

Free・Plus・Max の既定カタログを、プラン判定を散在させずに独自の料金体系へ変えます。

Next.js SaaS の Stripe サブスクリプション

Stripe の商品カタログを接続し、安全なサブスクリプション変更方針を選び、支払いが一度だけ反映されることを確認します。

SaaS の利用クレジット・消費・返金台帳

利用量の測り方を選び、組織で共有するクレジットを安全に付与、消費、失効、返却します。

Next.js で S3・R2 に非公開ファイルをアップロード

ポリシー、エンタイトルメント、容量上限、チェックサム、永続削除を備えた S3 互換の非公開アップロードを設定します。

Payload Content Studio とマーケティングメールの設定

独立した Payload CMS、最初の管理者、コンテンツジョブ、SaaS ゲートウェイを使う承認済みメール配信を設定します。

運用とリリース

永続ジョブと稼働準備

PostgreSQL ジョブキュー、cron、再試行、重複排除、プロセスの生存確認と依存関係の稼働準備確認を運用します。

テストと CI の契約

テスト階層、実インフラ、Playwright、カバレッジのラチェット、build gate を保証を弱めずに使います。

Next.js と Resend のトランザクションメール

Resend、React Email テンプレート、安全なローカル認証リンク、永続ジョブによる配信を設定します。

可観測性と構造化ログ

Redacted log、OpenTelemetry trace、queue readiness、alert を web と worker 間で相関します。

Slack 運用通知

機密情報を漏らさず、永続ジョブキューから運用イベントを Slack へ送ります。

アクセス解析と同意管理

Google Analytics と AdSense の要否を判断し、同意と法的開示を設定して、早期にスクリプトが読み込まれないことを検証します。

アカウントのデータ出力と消去

プライバシー台帳、認証付き出力、遅延消去、外部サービス上のデータ削除、仮名化、取り消し保護を設定します。

バックアップ、保持、復元訓練

検証可能な PostgreSQL dump を作り、保護された一時 DB だけに復元し、明示的な保持を適用します。

コンテナとローンチ準備

Web、admin、worker、Content Studio を build し、migration を分離して本番監査を実行します。

デプロイとセキュリティのチェックリスト

明示的なマイグレーション、cron、稼働準備確認、信頼できるネットワーク、本番制御を使って Web と管理アプリをデプロイします。

任意の製品例

5 クレジット画像生成ワークフロー

非同期の有料タスクを認証、権限、冪等クレジット、永続 worker、非公開 storage、失敗補償まで追います。

テキストから動画を生成するタスクの実装例

組織のエンタイトルメント、利用上限、クレジット、冪等性、返却処理を備えた任意のデモを拡張します。

予約機能

同時実行に安全な仮押さえ、Stripe Checkout、メール、カレンダーを備えた任意の予約機能を有効にします。

紹介プログラムとアフィリエイト報酬を設定する

紹介機能がプロダクトに合うか判断し、帰属と報酬を設定し、運用上の不足を補って全体をテストします。

管理コンソール

管理コンソールのセットアップとアクセス

独立した管理アプリの実行とデプロイ、運用担当者の昇格、MFA の必須化、専用オリジンの設定を説明します。

管理コンソールのページと運用

提供済みの各管理ページと、請求、モデレーション、書き込み操作に対する安全策を説明します。