Next.js SaaS スターターのドキュメント
Sushi SaaS スターターの導入、設定、拡張、運用に必要な手順です。設計判断や実装パターンは「ガイド」を参照してください。
管理コンソールのセットアップとアクセス
独立した管理アプリの実行とデプロイ、運用担当者の昇格、MFA の必須化、専用オリジンの設定を説明します。
管理コンソールのページと運用
提供済みの各管理ページと、請求、モデレーション、書き込み操作に対する安全策を説明します。
クイックスタート
対応する Node、pnpm、PostgreSQL、Redis で Sushi SaaS の Web と管理アプリをローカル実行します。
アーキテクチャとエラー契約
Sushi SaaS が強制するレイヤー、ブラウザのデータフロー、認可境界、情報を漏らさない多言語エラー方式を説明します。
データベースと migration
PostgreSQL、Drizzle schema、テスト DB、本番 migration runner を安全に扱います。
認証と管理アプリ
Better Auth、アカウント ID、個人組織、MFA 必須の独立管理アプリを設定します。
組織、チーム、テナント分離
個人ワークスペース、ロール、招待、席数上限、テナント分離、共有クレジット、組織課金を設定します。
プラン、上限、エンタイトルメント
Free・Plus・Max の機能、組織上限、Stripe 対応、猶予期間、複数契約、サポート例外を設定します。
Stripe 課金
subscription 価格、冪等 checkout、webhook、credit、portal 安全性、照合を設定します。
組織 credit ledger
組織共有 credit、append-only 会計、期限、冪等な消費、refund を理解します。
非公開 storage upload
policy、entitlement、quota、checksum、永続削除を備えた S3 互換の非公開 upload を設定します。
永続ジョブと Readiness
PostgreSQL ジョブキュー、Cron、再試行、重複排除、liveness と依存関係の readiness を運用します。
Transactional email
Resend、React Email template、安全な local auth link、永続 job 配信を設定します。
Slack 運用通知
機密情報を漏らさず、永続 job queue から運用 event を Slack へ送ります。
Structured logging
Node と edge で相関・redaction された structured log を使って運用します。
アカウントのデータ出力と消去
プライバシー台帳、認証付き出力、遅延消去、外部 provider の削除、仮名化、取消保護を設定します。
Text-to-video task pattern
組織 entitlement、quota、credit、idempotency、refund を備えた任意 demo を拡張します。
予約機能
同時実行に安全な hold、Stripe checkout、email、calendar を持つ opt-in 予約を有効化します。
デプロイとセキュリティ checklist
明示 migration、cron、readiness、信頼ネットワーク、本番 control で Web と admin をデプロイします。