ドキュメントガイドGitHub
はじめに

クイックスタート

ガイド付きフローで web、admin、Content Studio、worker、PostgreSQL、Redis、ローカル storage を設定・起動します。

Sushi SaaS

コミット 2a1a04a で確認済みです。

完了すると、顧客 app、admin console、Content Studio、durable worker、SaaS dev/test DB、Payload DB、Redis、private S3-compatible bucket が一緒に動きます。

必要環境

  • Node.js >=20.19.0 <23
  • pnpm 10.22.0
  • Docker Compose

ガイド付き初回起動

git clone https://github.com/PansaLegrand/sushi-saas-template.git
cd sushi-saas-template
pnpm install
./scripts/setup.sh development
pnpm dev:doctor
pnpm dev:all

Setup は pnpm customize を開き、不足する ignored env を書き、PostgreSQL・Redis・Garage を起動し、sushi_dev、sushi_test、sushi_content、restore DB を作り、Drizzle/Payload migration と sushi-dev bucket を準備します。再実行可能で既存 env は上書きしません。中立設定のままなら pnpm setup を使えます。

dev:doctor は version、環境境界と権限、Docker、DB、Redis、migration、object storage、Studio、port を secret を表示せず読み取り確認します。

dev:all は次を起動します。

ProcessAddress
顧客 apphttp://localhost:3000
Adminhttp://localhost:3001
Content Studiohttp://localhost:3002/admin
Workerprefix log 付き background process

安全な fixture と reset

pnpm dev:seed
pnpm dev:reset -- --dry-run
pnpm dev:reset

Seed は verified .test account、personal organization、deterministic 1,000 credits、demo reservation を冪等に作成・修復します。Reset は外部 service を拒否し、対象を表示して確認を要求し、この Compose project の data だけを再作成します。

完全な検証

curl http://localhost:3000/api/health
curl http://localhost:3000/api/ready
pnpm test:fast
pnpm test:e2e
pnpm build

Playwright は Better Auth で login し、tenant credits、実 Garage upload、5-credit image task から worker と signed result までを確認します。次に製品のカスタマイズ、アーキテクチャ、テストと CIへ進んでください。

このページの内容

必要環境
ガイド付き初回起動
安全な fixture と reset
完全な検証
クイックスタート · Sushi SaaS