本地开发

目标读者：在本机运行 Alpha 栈的开发者。

Docker Compose 会启动 PostgreSQL、MinIO、两个 Go API、Developer Console 和文档站，用于本地端到端验证。

账号邮件由本地 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 是完整栈入口：它会启动 PostgreSQL 和 MinIO、初始化私有 bucket、执行尚未应用的 migration、在容器中安装 Console/Docs 依赖，并启动两个 API 和 Web 应用。只有在仅开发依赖服务时才使用 dev-up.sh。wait-for-services.sh 和 e2e-all.sh 要求两个 API 的依赖组件都为 ready；仅有 /healthz 通过不构成验收证据。

常见错误

• 服务健康前不要运行 E2E。
• 不要用 /healthz 证明 PostgreSQL 或对象存储可用；应检查 /readyz。
• 本地 Alpha 不要复用生产对象存储或数据库凭证。
• 不要把 shell smoke 通过当成 Console 浏览器验证。

下一步

阅读完整 本地 Docker Compose 指南。