Inteligência operacional para Infraestrutura, Segurança, DevOps e Suporte Técnico
Plataforma · Whitepaper · Arquitetura · Roadmap · Casos de Uso · Ecossistema · Segurança
Important
Este é o repositório público de documentação do debuga.ai. O código-fonte, configurações de produção, credenciais, rotinas de deploy e procedimentos internos permanecem privados. As condições comerciais e os limites vigentes são os exibidos na aplicação e na página oficial de planos.
O debuga.ai é uma plataforma de IA operacional voltada a profissionais e equipes que lidam com infraestrutura de TI, segurança da informação, DevOps, suporte técnico, automação e documentação. A proposta é reunir, em uma experiência conversacional, contexto técnico, ferramentas especializadas, múltiplos provedores de inferência e rastreabilidade operacional.
A linha estável documentada combina:
- chat com respostas em streaming e histórico persistente;
- autenticação local e Google OAuth, conforme configuração;
- providers cloud configuráveis e inferência local opcional via Ollama;
- fallback entre providers para continuidade e controle de custo;
- geração de diagramas e assets multimodais conforme provider habilitado;
- painel administrativo para usuários, conversas, uso, providers e auditoria;
- personalização white label de marca, identidade do agente e canais de suporte;
- billing e gestão de planos integráveis ao Stripe;
- persistência em PostgreSQL e arquivos em storage S3/MinIO;
- implantação containerizada com NGINX e Docker Compose.
A plataforma não substitui a decisão humana. Ela auxilia a investigação, organiza evidências, propõe procedimentos e acelera tarefas repetitivas; mudanças em ambientes reais continuam sob responsabilidade do operador autorizado.
Capturas da linha estável de junho de 2026. Modelos, contagens, recursos e dados exibidos são demonstrativos e podem variar por plano e implantação.
 Chat Técnico Streaming, histórico, anexos, atalhos operacionais e contexto técnico. |
 White Label Identidade do agente, marca, dados legais, suporte e personalização visual. |
 Painel Administrativo Visão consolidada de usuários, conversas, mensagens e chamadas de IA. |
 Inferência Multi-Provider Providers cloud e inferência local configurável, com estratégia de fallback. |
 Fontes Técnicas Organização de logs, documentos e referências para contexto operacional. |
 Observabilidade de IA Provider, modelo, tipo de tarefa, tokens, tempo, status e rota utilizada. |
flowchart TB
U[Usuário / Navegador]
subgraph EDGE[Perímetro]
N[NGINX\nHTTPS + Reverse Proxy]
end
subgraph APP[Aplicação debuga.ai]
FE[Frontend\nReact + Tailwind]
BE[Backend\nExpress + tRPC]
ORCH[Orquestração\nContexto + Routing + Ferramentas]
ADMIN[Painel Administrativo]
end
subgraph DATA[Persistência]
PG[(PostgreSQL)]
S3[(MinIO / S3)]
end
subgraph INFERENCE[Inferência]
LOCAL[Ollama local\nopcional]
CLOUD[Providers cloud\nconfiguráveis]
end
U --> N
N --> FE
N --> BE
FE --> BE
BE --> ORCH
ADMIN --> BE
ORCH --> PG
ORCH --> S3
ORCH --> LOCAL
ORCH -. fallback .-> CLOUD
sequenceDiagram
participant U as Usuário
participant A as Aplicação
participant R as Router
participant L as Provider local
participant C as Provider cloud
participant D as PostgreSQL / S3
U->>A: Mensagem, contexto e anexos
A->>A: Autenticação, limites e classificação
A->>R: Solicita rota de inferência
alt Inferência local habilitada e disponível
R->>L: Requisição
L-->>R: Resposta em streaming
else Provider local desabilitado ou indisponível
R->>C: Requisição ao provider configurado
C-->>R: Resposta em streaming
end
R-->>A: Tokens, metadados e status
A->>D: Persiste histórico e telemetria permitida
A-->>U: Resposta incremental
Detalhes: Arquitetura Técnica.
| Domínio | Capacidades documentadas | Observação |
|---|---|---|
| Conversação | Streaming, histórico, busca e organização de conversas | Disponibilidade na linha estável |
| Identidade e acesso | Login local, Google OAuth, roles e controles de uso | Dependente da configuração |
| Providers | OpenAI, Anthropic, Gemini, OpenRouter e Ollama local | Modelos são configuráveis |
| Multimodal | Imagens, vídeos, diagramas, documentos e áudio | Depende do provider e do plano |
| Ferramentas técnicas | DNS, SSL/TLS, HTTP, WHOIS, análise web e outras rotinas autorizadas | Conforme plano e políticas |
| Administração | Usuários, conversas, providers, branding, assets, logs e auditoria | Acesso restrito a administradores |
| Conhecimento | Fontes técnicas, contexto reutilizável e evolução do RAG | Em evolução controlada |
| Billing | Planos, limites, checkout, portal e webhooks Stripe | Conforme configuração comercial |
| White label | Marca, agente, domínio, suporte, textos legais e visual | Escopo varia por implantação |
Note
Uma capacidade aparecer na arquitetura não significa que estará habilitada em todas as contas. Providers, ferramentas, limites e recursos multimodais dependem do plano, das feature flags e do ambiente contratado.
A arquitetura evita dependência rígida de um único modelo. O operador pode definir o provider primário, modelos permitidos, prioridade de inferência local e fallback cloud.
flowchart LR
Q[Solicitação] --> P{Provider local\nhabilitado e saudável?}
P -->|Sim| O[Ollama]
P -->|Não| F{Fallback configurado?}
F -->|Sim| C[Provider cloud]
F -->|Não| E[Erro controlado]
O --> M[Métricas e resposta]
C --> M
Benefícios do modelo híbrido:
- flexibilidade para equilibrar qualidade, custo e privacidade;
- possibilidade de processamento local em implantações compatíveis;
- troca de modelos por configuração, sem acoplamento da interface;
- fallback para continuidade quando o provider primário falha;
- observabilidade sobre rota, modelo, latência e consumo.
Leia Providers de Inferência e Pesquisa e Evolução LLM.
O debuga.ai foi projetado para operar com identidade própria do cliente em projetos dedicados. A personalização pode abranger:
| Área | Exemplos |
|---|---|
| Identidade | Nome da aplicação, nome e especialidade do agente |
| Visual | Logo, favicon, cor primária, textos e CSS adicional controlado |
| Institucional | Empresa, dados legais, termos e política de privacidade |
| Atendimento | E-mail, WhatsApp e canais de suporte |
| Infraestrutura | Cloud gerenciada, VM dedicada ou ambiente on-premise sob projeto |
| Inferência | Providers, modelos e prioridade local/cloud |
| Conhecimento | Fontes e instruções específicas da organização |
| Comercial | Planos, limites e billing conforme contratação |
Leia White Label Enterprise.
A documentação pública apresenta os controles em alto nível, sem divulgar segredos, topologia privada ou procedimentos de hardening operacional.
- HTTPS/TLS no perímetro e headers de segurança no reverse proxy;
- autenticação local e OAuth conforme configuração;
- autorização por perfil e procedures protegidas;
- rate limiting e controles de abuso configuráveis;
- variáveis sensíveis fora do código-fonte;
- serviços internos não publicados diretamente na Internet;
- logs estruturados para uso, providers e ações administrativas;
- storage e banco segregados da camada pública;
- recursos opcionais de CAPTCHA e verificação de contato.
Detalhes: Visão de Segurança e Política de Reporte.
| Camada | Tecnologia principal |
|---|---|
| Frontend | React 19, Tailwind CSS 4 e componentes de interface |
| Backend | Node.js, Express 4, TypeScript e tRPC 11 |
| Persistência | PostgreSQL 16 e Drizzle ORM |
| Assets | MinIO / storage compatível com S3 |
| Inferência local | Ollama, opcional |
| Providers cloud | OpenAI, Anthropic, Google Gemini e OpenRouter |
| Streaming | Server-Sent Events (SSE) |
| Perímetro | NGINX com HTTPS e reverse proxy |
| Billing | Stripe, quando habilitado |
| Implantação | Docker e Docker Compose |
O código, versões de dependências, scripts e variáveis de ambiente não são publicados neste repositório documental.
| Área | Estado documental |
|---|---|
| Chat, histórico e streaming | Estável |
| Autenticação local e Google OAuth | Estável / configurável |
| PostgreSQL, MinIO e Docker Compose | Estável |
| Providers cloud e fallback | Estável / configurável |
| Ollama local | Opcional; depende do hardware e da implantação |
| Painel administrativo e observabilidade | Estável |
| Stripe e planos | Estável / depende da configuração comercial |
| White label | Disponível sob escopo de implantação |
| Multimodal | Disponível conforme provider e plano |
| Conhecimento contextual e aprendizado | Evolução controlada |
| Conectores com NOC/SOC e automação | Roadmap |
Consulte o Roadmap Público para a separação entre recursos estáveis, opcionais, em evolução e planejados.
O debuga.ai mantém projetos públicos separados por responsabilidade: arquitetura de referência, gateway community, serving GPU e laboratório de modelos. Consulte o mapa do ecossistema para entender maturidade, escopo e limites.
| Projeto | Classificação |
|---|---|
debuga-llm-stack |
arquitetura de referência |
debuga-llm-gateway |
community preview |
debuga-vllm-engine |
reference deployment |
debuga-qwen-coder-lab |
laboratório experimental |
| Documento | Conteúdo |
|---|---|
| Índice de Documentação | Mapa completo deste repositório |
| Whitepaper PT-BR | Problema, proposta de valor e estratégia |
| Whitepaper EN | English whitepaper |
| Arquitetura PT-BR | Camadas, fluxos, dados e deploy de referência |
| Architecture EN | English architecture reference |
| Providers | Local, cloud, fallback e custos |
| Pesquisa LLM | Laboratórios e evolução de inferência |
| Segurança | Controles públicos e responsabilidades |
| Privacidade | Tratamento de dados em alto nível |
| White Label | Personalização e modelos de implantação |
| Planos | Estrutura pública de planos e capacidades |
| Casos de Uso | Infra, segurança, DevOps, MSPs e setor público |
| Roadmap | Estado e direção de evolução |
Os caminhos abaixo foram mantidos para evitar quebra de links históricos:
WHITEPAPER.mdARCHITECTURE.mddocs/WHITEPAPER.mddocs/WHITEPAPER_PT-BR.mddocs/ARCHITECTURE.mddocs/ARCHITECTURE_PT-BR.md
O debuga.ai substitui profissionais de TI?
Não. Ele apoia análise e execução assistida. Aprovação, mudança e responsabilidade
operacional continuam com pessoas autorizadas.
É obrigatório ter GPU?
Não. A inferência local é opcional. O ambiente pode operar apenas com providers cloud.
Os modelos apresentados nas capturas são fixos?
Não. As capturas documentam uma configuração de referência. Modelos e providers são
alterados conforme disponibilidade e política da implantação.
O código-fonte está neste repositório?
Não. Este repositório contém somente documentação pública e capturas sanitizadas.
É possível utilizar marca própria?
Sim, em projetos white label definidos por escopo e contrato.
Onde estão os preços atuais?
Na página debuga.ai/pricing. A aplicação é a fonte vigente.
Desenvolvido pela Sperry Tecnologia, empresa brasileira especializada em infraestrutura, segurança, automação e soluções baseadas em software aberto e IA.
- Plataforma: debuga.ai
- Empresa: sperrytecnologia.com.br
A documentação é pública para consulta, mas permanece protegida por direitos autorais. O código-fonte da plataforma é proprietário e não faz parte deste repositório. Consulte LICENSE.
Sperry Tecnologia
Documentação pública do debuga.ai