Salve um perfil
Abra Conexões, crie um perfil e informe a URI ou os campos de conexão. A URI pode referenciar uma variável de ambiente local.
GUIA DO PRODUTO · DOCUMENTAÇÃO EM PORTUGUÊS
Um guia claro para trabalhar com MongoDB.
Conheça os fluxos que já existem no KapibaraStudio, desde a conexão até a exportação dos resultados. Aqui, “implementado” não significa “homologado em todo ambiente”: cada etapa mostra também seus limites atuais.
O projeto ainda está em pré-lançamento. O escopo funcional das versões v0.5.0 a v0.8.0 está arquivado por escopo funcional. A prioridade atual é a Fase 8 / v0.12.0, seguida pela Fase 5 / v0.9.0. Polimento, homologação em ambientes reais e estabilidade ainda têm etapas planejadas antes da v1.0.0.
Ver plano de homologação ↗01 · COMEÇAR
Da conexão ao Explorer
Configure um perfil, teste o acesso e navegue pelos metadados antes de executar qualquer consulta.
Teste e conecte
Use Testar conexão para verificar o perfil e, em seguida, Abrir conexão para carregar os bancos no Explorer.
Navegue sem executar
Expanda os bancos e coleções. Abrir uma coleção prepara o contexto do Console; a consulta só roda quando você pedir.
Armazenamento local: perfis e variáveis de ambiente ficam no LiteDB local sem criptografia. Não armazene segredos sensíveis em texto puro; o cofre criptográfico ainda não está implementado.
02 · ESCREVER E EXECUTAR
Um Console para consultas explícitas
O editor trabalha com texto de consulta e script do Console. Não há construtor visual de consultas e o modo Console é o único modo de editor disponível.
- F5 executa a aba; Ctrl + Enter executa a seleção ou instrução atual.
- O fluxo básico cobre
findefindOne, filtro, ordenação, limite e deslocamento. - Autocomplete determinístico, realce de sintaxe e formatação ajudam durante a edição.
- Abas isolam cada consulta; trocar a seleção do Explorer não redireciona abas já abertas.
db.getCollection("clientes")
.find({ ativo: true })
.sort({ nome: 1 })
.limit(100)
03 · ENTENDER OS RESULTADOS
BSON preservado na visualização
Inspecione documentos em JSON ou árvore estruturada, mantenha tipos MongoDB reconhecíveis e exporte a página que já está carregada.
JSON ou árvore
Alterne entre a leitura textual e uma navegação estruturada por campos e tipos.
Tipos especiais
ObjectId, UUID e datas mantêm apresentação compatível com BSON nos fluxos cobertos.
Exportação da página
Exporte os resultados atualmente carregados em Extended JSON ou CSV. Isso não equivale a um backup completo da coleção.
Arquivos e workspace
Abra, edite e salve arquivos de texto/consulta. O workspace local trabalha com uma raiz por vez e restringe as operações aos itens dentro dela.
04 · ALTERAÇÕES COM REVISÃO
Escritas ficam sob seu controle
Inserções, atualizações e exclusões pedem confirmação. Perfis somente leitura bloqueiam alterações. Ao editar um documento pelo resultado, o app relê o documento e detecta conflitos antes de gravar.
- Sem execução ao selecionar: o Explorer navega; ele não dispara consultas automaticamente.
- Revise antes de confirmar: consultas e propostas de IA são conteúdo editável, não uma autorização para executar.
- Cancelar não é rollback: operações já enviadas ao servidor podem ter efeito mesmo após o cancelamento.
- Use credenciais restritas: o próprio projeto recomenda credenciais somente leitura e backups para dados importantes.
05 · AUTOCOMPLETE E IA
Sugestões são opcionais e revisáveis
O autocomplete determinístico não envia consultas a serviços de IA. A inferência por modelo é experimental e depende de uma configuração local.
Autocomplete determinístico
Oferece sugestões contextuais sem exigir modelo de linguagem ou conexão com serviços externos.
Modelos locais
Modelos ONNX podem ser configurados localmente; qualidade, latência e suporte de hardware ainda não foram homologados em todos os ambientes.
Painel Agente IA
A Fase 5 / v0.9.0 concentra GitHub Copilot e sua infraestrutura de agentes. O contexto da aba exige opt-in global e por conexão; o envio de JSON exige outro opt-in. Antes do pedido manual, revise a prévia do contexto. Uma proposta editável não executa a consulta. O aceite manual de ferramentas e conexões Copilot foi registrado em 06/10/2026; os demais critérios de conclusão da integração permanecem abertos.
O painel de chat não é o workflow guiado da Fase 7 / v0.11.0; esse fluxo ainda está planejado. Ferramentas administrativas da fase v0.10.0 também continuam em desenvolvimento. Modos de agregação visual e execução de mongosh entre conexões estão fora do escopo ativo.
06 · ESTADO DO PROJETO
O que está pronto e o que vem depois
Roadmap reorganizado em 03/10/2026 e conferido em 06/10/2026. As versões são alvos de escopo, não uma indicação de que todos esses recursos já foram publicados. A conclusão funcional não substitui a homologação manual.
Prioridade de entrega: primeiro IA local e produtividade contextual (Fase 8 / v0.12.0), depois GitHub Copilot (Fase 5 / v0.9.0). A numeração das fases não determina a ordem de implementação. A internacionalização em pt-BR, en, es e zh-CN foi concluída no recorte automatizado; a revisão linguística de domínio permanece na Fase 10.
Fase 1 · v0.5.0MVP · escopo funcional arquivado
Conectar, navegar, consultar, visualizar, editar e exportar. Homologação manual na Fase 10.
Fase 2 · v0.6.0Organização e autocomplete · arquivada
Separação dos núcleos e autocomplete determinístico contextual, sem exigir modelo de IA.
Fase 3 · v0.7.0Autocomplete com IA · arquivada
Sugestões locais explícitas e revisáveis, aceitas pelo usuário, com fallback determinístico.
Fase 4 · v0.8.0Arquivos e workspace · arquivada
Abrir, editar e salvar arquivos de texto, com workspace local de uma pasta.
Fase 5 · v0.9.0GitHub Copilot · após as prioridades da Fase 8
Consolidar conta, conversa, contexto, ferramentas, permissões, auditoria e propostas. Implementação parcial; aceite manual de ferramentas e conexões registrado em 06/10/2026, sem encerrar os demais critérios da fase.
Fase 6 · v0.10.0Administração e manutenção · em desenvolvimento
Coleções, views, validação, índices, estatísticas, usuários, papéis e transferência lógica. Antecipações técnicas preservadas, ainda sem entrada na interface.
Fase 7 · v0.11.0Chat por workflow · planejada
Fluxo técnico predefinido, escopo limitado e ações revisáveis, sem execução automática.
Fase 8 · v0.12.0IA local e produtividade · prioridade atual
Assistência local, sugestões inline e propostas revisáveis. Recorte automatizável implementado; inferência ONNX real e suporte de hardware continuam experimentais.
Fase 9 · v0.13.0Polimento de código, arquitetura e UI/UX · planejada
Revisar defeitos, contratos, concorrência, persistência, navegação, temas e localização antes da homologação.
Fase 10 · v0.14.0Homologação em ambientes reais · planejada
Validar Windows/Linux, acessibilidade, MongoDB/mongosh, modelos, hardware, instalação e atualizações.
Fase 11 · v1.0.0Estabilidade e revisão completa · planejada
Primeira versão estável após os aceites funcionais, o polimento da Fase 9 e a homologação da Fase 10, incluindo instalação e atualizações.
Backlog sem versão comprometida: Claude Code/Anthropic, Codex/ChatGPT, APIs externas e integração MCP com clientes externos estão no bkl-06. Implementações existentes são preservadas; essa movimentação não conclui nem desativa os providers.
Ver fases, objetivos e critérios no roadmap oficial ↗Consultar inventário e evidências no repositório ↗PRONTO PARA EXPLORAR?
Baixe o KapibaraStudio e experimente.
É software livre para Windows e Linux. Antes de conectar dados importantes, leia as limitações desta versão.