Merge pull request 'developer' (#2) from developer into main

Reviewed-on: #2

CLAUDE.md

@@ -22,12 +22,6 @@ docker compose --env-file .env up -d           # sobe Postgres + API + worker +
 docker compose --env-file .env up -d eden-postgres   # só o banco, para rodar API/apps localmente fora do container
 ```
 
-## Fluxo de Git
-
-Repositório hospedado em Gitea (`git.falehandix.com.br`). Commits/push do dia a dia vão para a branch
-`developer`, nunca direto para `main` — o merge para `main` é feito manualmente pelo Matheus via PR no
-próprio Gitea. Só empurrar para `main` diretamente se pedido explicitamente.
-
 ## Estrutura do monorepo
 
 ```

docs/runbooks/setup-vm-pre-producao.md

@@ -0,0 +1,87 @@
+# Setup de uma nova VM (pré-produção)
+
+Passo a passo mínimo para subir o EDEN do zero numa VM nova. Ver `docs/adr/0002-container-topology.md`
+para o porquê da topologia (Postgres isolado, 1 container por app).
+
+## 1. Requisitos da VM
+
+- Linux (Debian/Ubuntu), 4 vCPU / 8GB RAM como piso razoável (Chromium headless para PDF consome memória).
+- Docker Engine + plugin `docker compose` instalados.
+- Git.
+- Portas liberadas no firewall: só as que forem expostas publicamente (ver passo 5) — nunca a porta do
+  Postgres.
+
+```bash
+curl -fsSL https://get.docker.com | sh
+sudo usermod -aG docker $USER   # relogar depois disso
+```
+
+## 2. Clonar o repositório
+
+```bash
+git clone https://git.falehandix.com.br/Matheus/eden.git /opt/eden
+cd /opt/eden
+git checkout main   # pré-produção valida o que já foi mergeado — não a branch developer
+```
+
+## 3. Configurar o `.env`
+
+```bash
+cp .env.example .env
+```
+
+Preencher no `.env` (nunca commitar este arquivo):
+
+- `EDEN_DATABASE_PASSWORD` / ajustar `DATABASE_URL` com a mesma senha.
+- `JWT_SIGNING_SECRET` — `openssl rand -hex 48` (segredo próprio desta VM, nunca reaproveitar o de outro ambiente).
+- `SIGNATURE_OTP_SECRET` — `openssl rand -hex 32`.
+- `EDEN_FIELD_ENCRYPTION_KEY` — `openssl rand -hex 32`.
+- `EDEN_SUPERADMIN_EMAIL` / `EDEN_SUPERADMIN_PASSWORD` — só usado para criar o primeiro usuário se a
+  tabela `users` estiver vazia.
+- `S3_*` — credenciais do MinIO bundled (`openssl rand -hex 12`/`openssl rand -hex 24` para user/senha) ou
+  de um S3 real.
+- `SMTP_*` — se já tiver um provedor de e-mail pra este ambiente.
+- `PUBLIC_BASE_URL` — domínio público desta VM (usado em links de e-mail).
+- Portas (`EDEN_API_PORT`/`EDEN_CORE_PORT`/`EDEN_PARCEIROS_PORT`/`EDEN_ASSINANTE_PORT`) — só mudar se for
+  rodar mais de uma instância na mesma máquina.
+
+## 4. Subir os containers
+
+```bash
+docker compose --env-file .env up -d
+```
+
+Sobe Postgres, MinIO, API, worker e as 3 apps web. Cada serviço tem healthcheck — conferir com:
+
+```bash
+docker compose --env-file .env ps
+```
+
+## 5. Rodar as migrations
+
+A imagem do `eden-api` carrega o monorepo inteiro (ver `infra/docker/Dockerfile.node`), então dá pra
+rodar direto de dentro do container — `DATABASE_URL` já está no ambiente dele:
+
+```bash
+docker compose --env-file .env exec eden-api pnpm --filter @eden/database exec node-pg-migrate up
+```
+
+(Ou, se tiver Node 22 + pnpm instalados na própria VM, fora de Docker: `pnpm install && pnpm db:migrate`,
+com `DATABASE_URL` apontando pra porta mapeada do Postgres no host.)
+
+## 6. Confirmar o primeiro acesso
+
+```bash
+curl -X POST http://localhost:${EDEN_API_PORT:-8080}/api/v1/auth/login \
+  -H "Content-Type: application/json" \
+  -d "{\"email\":\"$EDEN_SUPERADMIN_EMAIL\",\"password\":\"$EDEN_SUPERADMIN_PASSWORD\",\"applicationKey\":\"core\"}"
+```
+
+Deve devolver um `accessToken`. Depois logar normalmente em `http://<host>:${EDEN_CORE_PORT}`.
+
+## 7. Proxy reverso / domínio (se for expor publicamente)
+
+- Cada app tem um domínio próprio (core/parceiros/assinante); a API **não** tem domínio público — o proxy
+  na frente de cada domínio deve rotear `/api/*` internamente para `eden-api:8080` na rede docker
+  (`eden_net`), nunca expor a API direto.
+- Nunca expor a porta do Postgres (`EDEN_POSTGRES_DEV_PORT`) fora da rede interna em pré-produção.