Ferramentas de DX, Health Endpoint & Scripts

Ferramentas de DX & Endpoint de Saúde

Esta seção descreve as otimizações de Developer Experience (DX) implementadas para acelerar o desenvolvimento local, auditar a infraestrutura e prevenir commits com erros.

---

⚡ 1. Execução Concorrente Única (npm run dev:all)

Para eliminar a necessidade de abrir múltiplos terminais manualmente durante o desenvolvimento:

npm run dev:all

• Funcionamento: O concurrently inicia simultaneamente o backend serverless Cloudflare (wrangler pages dev na porta 8788) e o frontend React (vite na porta 3000), exibindo logs coloridos e isolados com encerramento automático das portas ao pressionar Ctrl+C.

---

🩺 2. Endpoint de Diagnóstico da Infraestrutura (/api/health)

O endpoint /api/health realiza auditorias atômicas de conectividade e latência em tempo real nos 3 pilares do sistema:

{
  "status": "healthy",
  "timestamp": "2026-07-26T12:00:00.000Z",
  "totalLatencyMs": 14,
  "services": {
    "database": { "status": "healthy", "latencyMs": 4 },
    "ai": { "status": "healthy", "latencyMs": 1, "details": "Cloudflare Workers AI (@cf/meta/llama-3.2-1b-instruct)" },
    "whatsapp": { "status": "healthy", "latencyMs": 1, "details": "Evolution API configured" }
  }
}

---

🛡️ 3. Pre-commit Hook & Gerador de Migrações SQL

A. Pre-commit Git Hook (.githooks/pre-commit)

Valida instantaneamente o estilo de código com Biome nos arquivos modificados antes de confirmar qualquer commit, impedindo que código fora de padrão alcance o repositório.

B. Gerador de Migrações (npm run db:migrate:new)

Cria arquivos de migração com numeração e nome padronizados:

db/migrations/0015_add_client_tags.sql

npm run db:migrate:new add_client_tags

---

🔍 4. Pipeline de Integridade e Qualidade (npm run check)

Para garantir confiabilidade absoluta antes de releases ou deploys, o comando unificado executa todos os validadores em sequência:

npm run check

• TypeScript (npm run typecheck): Validação estrita de tipos para o frontend (src/) e backend Cloudflare (functions/).
• Biome Linter (npm run lint): Auditoria de qualidade de código, padrões de acessibilidade (a11y) e regras de navegação.
• Deadcode Scanner (npm run deadcode): Detecção de arquivos, dependências e exportações não utilizadas via knip.
• Vitest (npm run test): Execução de mais de 1.640 testes unitários e de integração.
• Security Audit (npm run security:audit): Script inteligente (scripts/security-audit.mjs) que analisa vulnerabilidades em pacotes npm com suporte gracioso a ambientes sandbox/offline.
• Bundle Budget (npm run budget): Assegura que o first-load bundle permaneça estritamente abaixo do orçamento de 260 kB gzip.