Switch Backend Stack

Passo 1 — Backup do backend atual

mv backend backend.bak.$(date +%Y%m%d-%H%M%S)

Deixa backup local pro dev recuperar se mudar de ideia.

Passo 2 — Scaffold da nova stack

Gere a estrutura minima em backend/ com:

• Entrypoint que escuta em :8080
• Rota /health na raiz (para o probe do Deployment)
• Rotas de negocio sob /api (porque o nginx do modulo proxya /api/* pro backend sem stripar o prefixo)
• Uma rota exemplo /api/example mostrando o padrao de proxy para API externa
• Dockerfile multi-stage usando imagens da img.cora.tools/dockerhub/
• .dockerignore
• Teste smoke que confirma routing

Stack: go

Estrutura alvo:

backend/
├── cmd/server/main.go     # Gin, porta 8080, rota /health, /api/example
├── internal/
│   ├── config/config.go   # env vars
│   └── handler/example.go # proxy para API externa usando net/http
├── go.mod
├── go.sum
├── Dockerfile             # multi-stage golang:1.25 → alpine
└── .dockerignore

Framework: Gin (padrao Cora). Roteamento r.Group("/api"), handler faz http.Get na URL externa lida de os.Getenv("EXAMPLE_API_URL").

Stack: python

backend/
├── src/
│   ├── main.py            # FastAPI, uvicorn na 8080
│   ├── config.py
│   └── routes/example.py
├── pyproject.toml         # uv ou poetry
├── Dockerfile
└── .dockerignore

Framework: FastAPI + uvicorn. Estrutura assincrona, rota /api/example usa httpx.AsyncClient.

Stack: kotlin

backend/
├── src/main/kotlin/
│   ├── Application.kt     # Ktor, porta 8080
│   ├── Config.kt
│   └── routes/Example.kt
├── build.gradle.kts
├── gradle.properties
├── Dockerfile             # multi-stage gradle:8 → eclipse-temurin:21-jre
└── .dockerignore

Framework: Ktor. embeddedServer(Netty, port = 8080), rota /api/example usa Ktor HttpClient.

Stack: node

Restauracao do default (caso o dev tenha rodado /remove-backend antes):

backend/
├── src/
│   ├── server.ts          # Hono, rotas /health + /api
│   ├── config.ts
│   └── routes/example.ts
├── package.json
├── tsconfig.json
├── Dockerfile
└── .dockerignore

Framework: Hono + @hono/node-server. Referencia: veja o que ja existe no platform-module-quickstart upstream.

Passo 3 — Pipeline (.woodpecker/build.yaml ou .woodpecker-templates/build.yaml)

Os steps build-backend e build-and-publish-backend ja existem no pipeline do quickstart. Ajuste apenas a imagem base do step build-backend conforme a stack:

O comando de build dentro do step muda conforme a stack (go test ./... && go build, uv run pytest, gradle build, etc).

O step build-and-publish-backend NAO muda — continua buildando a partir de backend/Dockerfile.

Passo 4 — Chart nao muda

O Helm chart referencia img.cora.tools/cora/{repo}-backend:{tag} independente da stack. Nada em charts/ precisa mudar.

Passo 5 — Verificacao local

Rode:

cd backend
<build command da stack>   # go build ./..., pytest, gradle build, npm run build

Se falhar, mostre o erro ao usuario. Se passar, faca docker build -t test backend/ para validar a imagem.

Passo 6 — Commit sugerido