ローカル開発

対象読者：Alpha stack をローカルで実行する開発者。

Docker Compose は PostgreSQL、MinIO、両方の Go API、Developer Console、docs site を起動し、ローカル E2E に使います。

アカウントのメールはローカルMailpit（http://localhost:8025、SMTP 1025）で捕捉し、外部転送は設定しません。シードユーザーは明示的に確認済みの合成fixtureです。新規登録はメール確認を行います。旧Alphaのデータ入り環境には新構造を適用せず、空のローカル環境を使用します。既存 .env は上書きしません。

最小例

cd ../echo-nebula-infra
cp .env.example .env
./scripts/dev-apps-up.sh
./scripts/wait-for-services.sh
./scripts/e2e-all.sh
./scripts/dev-down.sh

dev-apps-up.sh は full stack の entry point です。PostgreSQL と MinIO の起動、private bucket の初期化、未適用 migration、container 内の Console/Docs dependencies install、両 API と web apps の起動を行います。dev-up.sh は依存サービスだけを使う場合に限ってください。wait-for-services.sh と e2e-all.sh は両 API の dependency component がすべて ready であることを要求します。/healthz だけでは acceptance evidence になりません。

よくある間違い

• services が healthy になる前に E2E を実行しないでください。
• PostgreSQL や object storage が利用可能であることを /healthz だけで判断せず、/readyz を確認してください。
• ローカル Alpha で production object storage や database credentials を再利用しないでください。
• shell smoke の成功を Console browser validation として扱わないでください。

次のステップ

完全な ローカル Docker Compose guide を読んでください。