ADR 0005 — Proxy Vite com fallback

Status

Aceito.

Contexto

Em npm run dev, o browser muitas vezes chama same-origin /api para evitar preflight CORS. Os backends locais podem estar em :3000/:3001 ou só no host remoto.

Decisão

O vite.config.ts:

• classifica o path (governança vs Central vs ABECS)
• encadeia alvos (env → localhost → fallback de produção)
• faz fallback em 404/502/503/504 (e DELETE 405 em rotas Default-only)

WebSocket /socket.io segue o alvo da API Central.

Consequências

• Dev “funciona” mesmo com um dos backends down, mas pode mascarar 404 reais
• Rotas Default-only (ex. /api/companies/:id/block, form-fields de cadastro) não devem ir para a Central