diff --git a/docs/progress.md b/docs/progress.md
index c8d34ad..e9b938c 100644
--- a/docs/progress.md
+++ b/docs/progress.md
@@ -321,3 +321,13 @@ Verificado: `pnpm turbo run typecheck build` (28/28). Containers `eden-api`/`ede
 
 ### Pendências
 Client Registration (Cadastro de Cliente) ainda sem tela — `QuoteDetailPage` hoje exige colar manualmente um UUID para fechar negócio. Nenhuma tela de Contracts/Inventory/Support/HR-Timeclock/Fiscal/Billing/Documents ainda. `reseller-web`/`subscriber-web` continuam só com o shell de login (sem telas de negócio).
+
+---
+
+## Proxy same-origin dentro do próprio nginx dos 3 frontends
+
+Data: 2026-09-03. Usuário pediu para "configurar o proxy". Como a API não tem domínio público próprio (decisão do operador) e o proxy externo que termina SSL nos 3 domínios é gerenciado fora deste repositório (sem acesso daqui, e o guard de segurança do projeto bloqueia acesso a caminhos fora do projeto/`/etc`), a solução implementada foi dentro do que o repo já controla: `infra/docker/nginx-spa.conf` (usado pelos 3 containers de frontend) ganhou um `location /api/` que faz `proxy_pass` para `eden-api:8080` — os 2 containers já estão na mesma rede Docker (`eden_net`), então o roteamento é interno, sem tocar em nada externo. `resolver 127.0.0.11` (DNS embutido do Docker) usado com `proxy_pass` via variável para evitar o problema clássico de nginx cachear o IP do upstream para sempre.
+
+Com isso, o browser batendo em `https://dev-edencore.falehandix.com.br/api/v1/...` (uma vez que o proxy externo do operador já roteia o domínio inteiro para a porta 3001, como já estava configurado) chega ao nginx do container, que repassa para a API interna — fluxo 100% same-origin do ponto de vista do browser, sem CORS.
+
+Testado ao vivo: `POST /api/v1/auth/login` com credenciais reais funcionando através da porta 3001 (`eden-core`), 3002 (`eden-parceiros`) e 3003 (`eden-assinante`) — os 3 containers reconstruídos e confirmados.
diff --git a/infra/docker/nginx-spa.conf b/infra/docker/nginx-spa.conf
index d127d93..9c95b07 100644
--- a/infra/docker/nginx-spa.conf
+++ b/infra/docker/nginx-spa.conf
@@ -1,9 +1,32 @@
+# Docker's embedded DNS (127.0.0.11) — required so nginx re-resolves
+# `eden-api` per request instead of caching its IP once at worker start
+# (the classic Docker+nginx gotcha: a static `proxy_pass http://eden-api:8080`
+# would keep routing to a stale IP forever after eden-api is recreated).
+resolver 127.0.0.11 valid=30s;
+
 server {
     listen 80;
     server_name _;
     root /usr/share/nginx/html;
     index index.html;
 
+    # Same-origin API proxy — the API has no public domain of its own
+    # (operator decision: internal-only), so the browser always calls
+    # /api/... on THIS domain, and this container's own nginx forwards it
+    # internally to eden-api over the shared `eden_net` Docker network.
+    # No path rewrite: eden-api's own global prefix is "api"
+    # (main.ts's setGlobalPrefix("api")), so the incoming /api/... URI is
+    # forwarded byte-for-byte.
+    location /api/ {
+        set $eden_api_upstream eden-api:8080;
+        proxy_pass http://$eden_api_upstream;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
     location / {
         try_files $uri $uri/ /index.html;
     }