Vergo — SaaS Starter (Go)

Boilerplate de SaaS multi-tenant escrito em Golang, projetado para servir como base sólida em aplicações modernas.
Inclui autenticação JWT, RBAC, auditoria, webhooks, billing (Stripe), integração com S3 e observabilidade (OpenTelemetry).

---

✨ Features (MVP)

• Estrutura em camadas: handlers → services → repo
• Autenticação/JWT com refresh tokens
• RBAC por organização (multi-tenant)
• Postgres + sqlc para queries tipadas
• Docker Compose para ambiente local
• CI/CD com GitHub Actions (build + test + CodeQL + Dependabot)
• Observabilidade preparada (tracing/metrics/logging)

---

🚀 Quickstart

Clone e rode:

git clone git@github.com:Ulpio/vergo.git
cd vergo

go mod tidy
go run ./cmd/api

# API disponível em http://localhost:8080/healthz

Para subir Postgres + PgAdmin:

docker compose up -d db pgadmin

---

🧱 Estrutura do projeto

cmd/api/main.go                # entrypoint da API
internal/
  http/router/router.go        # rotas
  http/middleware/             # middlewares (auth, rbac, tenant)
  domain/{user,org,project}/   # serviços de domínio
  pkg/config/                  # configuração (env)
  repo/                        # código gerado pelo sqlc
db/
  migrations/                  # migrations SQL
  queries/                     # queries do sqlc
scripts/seed/                  # seed de dados
.github/workflows/             # CI/CD

---

🧭 Roadmap

✅ Concluído

• Estrutura inicial do projeto (boilerplate Go + Gin).
• CI/CD com GitHub Actions (build, test, CodeQL, Dependabot).
• Auth (signup/login/refresh) com JWT (in-memory).
• Integração com Postgres (docker-compose + .env).
• CRUD de Projects persistido no Postgres.
• Organizations + Memberships (owner/admin/member).
• Tenant Middleware (validação de membership por X-Org-ID).
• RBAC real baseado em role (owner | admin | member).
• Endpoints de gestão de membros (PATCH, DELETE).
• Endpoint /me (dados do usuário autenticado).
• Audit Log persistente.

🚧 Em andamento

• Context API (/context) para org ativa sem header.
• Persistência de refresh tokens (logout, revogação).
• Upload com S3 (presigned URLs).

📌 Próximos passos

• Integração com Stripe (planos, checkout, webhook).
• Observabilidade com OpenTelemetry (traces, métricas, logs).
• Refatorar queries com sqlc para tipagem forte.

🌟 Futuro

• Templates multi-tenant (boas práticas SaaS).
• Deploy em cloud (AWS ECS/Fargate + RDS + S3).
• Documentação via Swagger/OpenAPI.

---

📜 Licença

MIT