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 anteriores está implementado, mas a homologação manual em ambientes reais e a revisão completa para a versão 1.0 ainda estão em andamento.
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
Providers oficiais têm recursos e permissões diferentes. 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 painel de chat não é o workflow guiado da v0.12.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
As versões registram escopo funcional; a conclusão de uma fase não substitui validação manual em ambientes reais.
v0.5–v0.8Escopo funcional arquivado
Fluxo MongoDB básico, autocomplete determinístico e trabalho com arquivos/workspace.
v0.9Prioridade atual · IA local e produtividade
Escopo automatizado implementado; inferência local continua experimental e faltam gates de homologação.
v0.10Em desenvolvimento
Administração, índices e transferência lógica de bancos ainda não devem ser anunciados como recursos concluídos.
v0.11Integração de agentes · prioridade adiada
Há implementação parcial; a homologação e a revisão das permissões continuam abertas.
v0.12Chat guiado · planejado
Workflow técnico predefinido, com ações revisáveis e escopo fechado.
v0.13–v1.0Homologação e estabilidade · planejadas
Validação em ambientes reais, revisão completa e critérios para a primeira versão estável.
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.