docs(dev): armadilha .env.production.local (clube67.com) que causou 503 no login

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

projetos/newwhats.clube67.com/ambiente-dev.md

@@ -49,6 +49,14 @@ DOCKER_HOST=unix:///run/user/1000/docker.sock docker compose -f docker-compose.d
 - **`NEXT_PUBLIC_API_URL` = raiz** (`https://dev.newwhats.clube67.com`), **sem `/api`** — o código já prefixa `/api`
   nas chamadas REST; o Socket.IO usa `new URL(url).origin`.
 
+> ⚠️ **Armadilha (causou 503 no login em 28/jun/2026):** o `frontend/.env.production.local` tinha
+> `NEXT_PUBLIC_API_URL=https://clube67.com` (valor de PROD). O Next inlina `NEXT_PUBLIC_*` em **build time**
+> e, com `NODE_ENV=production` (caso do container `newwhats-frontend-dev`), carrega `.env.production.local`.
+> Rodar `npx next build` **dentro do container sem passar a env** fez o login do dev bater em `clube67.com`
+> → 503. **Sempre** rebuildar com a env explícita:
+> `docker exec -e NEXT_PUBLIC_API_URL=https://dev.newwhats.clube67.com -w /app newwhats-frontend-dev npx next build`.
+> A cópia dev já teve o `.env.production.local` corrigido para o domínio dev.
+
 ## Conexões — credenciais no `docker-compose.dev.yml`
 
 - **Banco (isolado):** `postgresql://devadmin:<senha>@pgdev:5432/newwhats_dev` — banco `newwhats_dev` no