README

Diagnóstico inteligente de erros para APIs — detecta, explica e sugere correções em tempo real.

debugassist.com.br · Docs · Dashboard

O que é

O DEBUG_Assist analisa erros de APIs (requisições HTTP, queries SQL, erros de frontend) e retorna um diagnóstico legível com causa, severidade e sugestões de correção — em português.

curl -X POST https://debugassist.com.br/v1/diagnosticos \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "http_500",
    "mensagem": "Cannot read properties of undefined",
    "contexto": { "url": "/users", "method": "POST" }
  }'

{
  "problema": "Acesso a propriedade de objeto indefinido",
  "causa": "A variável está undefined antes de ser acessada — possivelmente retorno inesperado de banco de dados ou API externa",
  "nivel": "alto",
  "categoria": "backend",
  "sugestoes": [
    "Verifique se o retorno da query existe antes de acessar propriedades",
    "Adicione optional chaining: objeto?.propriedade",
    "Valide o payload de entrada antes de processar"
  ],
  "confianca": 0.91
}

SDKs

Planos

Stack

• Backend: Node.js + Express
• Banco de dados: Supabase (PostgreSQL)
• Pagamentos: Stripe
• E-mail: Resend
• Deploy: Render
• CI/CD: GitHub Actions

Estrutura do projeto

src/
  engines/      # Motores de diagnóstico (frontend, backend, sql)
  routes/       # Endpoints da API
  middleware/   # Auth, rate limiting, validação
  db/           # Cliente Supabase
  email/        # Templates e envio via Resend
sdk/            # SDKs por linguagem
public/         # Landing page e dashboard
tests/          # Testes automatizados

Desenvolvimento local

git clone https://github.com/mirutee/debug-assist.git
cd debug-assist
npm install
cp .env.example .env
# Preencha as variáveis no .env
npm run dev

Testes

npm test

API Reference

Documentação completa: debugassist.com.br/docs

Spec OpenAPI: swagger.yaml

Endpoint principal

POST /v1/diagnosticos
Authorization: Bearer <API_KEY>

Categorias suportadas: frontend · backend · sql

Licença

Proprietário — © 2026 DEBUG_Assist. Todos os direitos reservados.