RESUMO DO SISTEMA DOCCLE
O Doccle é um sistema que evoluirá para um pipeline completo de documentação e análise de aplicativos Bubble.io, porém a funcionalidade principal e prioritária no momento é a captura, transmissão e armazenamento dos comentários escritos pelo usuário dentro do editor do Bubble.io, especialmente nos Workflows. Esses comentários serão enviados automaticamente para o servidor sempre que o usuário os digitar ou editar, através de uma extensão Chrome.
O objetivo central dessa primeira fase é criar um mecanismo leve, rápido e seguro que receba os comentários em tempo real, interprete-os e os armazene no banco de dados, vinculados ao cliente, ao projeto e ao elemento correspondente dentro do Workflow.
A extensão Chrome funciona como um listener do editor Bubble. Quando o usuário digitar um comentário no campo “Comment” de qualquer ação ou bloco do Workflow, o sistema detectará essa alteração e imediatamente enviará um payload para o backend do Doccle contendo informações essenciais: o texto do comentário, o identificador do elemento (por exemplo o ID interno usado pelo Bubble), o identificador do Workflow ao qual o elemento pertence e o identificador do usuário/cliente que está editando o app. Esse envio deve ser rápido, não bloqueante e silencioso para o usuário.
A API do Doccle recebe esses dados, valida o cliente, registra a origem da requisição e grava a entrada no banco com segurança e isolamento multi-tenant. Isso significa que cada cliente do sistema possui seu próprio escopo de dados e não poderá acessar informações de outros clientes. Cada comentário registrado conterá o client_id, o project_id, o workflow_id, o element_id, o texto do comentário e metadados como timestamp e origem.
Essa funcionalidade, por si só, já permite ao Doccle criar uma base contínua e inteligente de informações sobre o funcionamento e intenção do app, pois os comentários do Bubble representam o raciocínio técnico do desenvolvedor e documentam a lógica de cada ação dentro do fluxo.
Essa captura automática abre caminho para recursos avançados no futuro, como recuperar histórico de alterações, gerar documentação automática baseada nos comentários, utilizar LLMs para interpretar e melhorar os comentários ou identificar inconsistências na lógica descrita pelo usuário. Cada comentário também pode, mais tarde, ser processado por um modelo de embeddings para permitir consultas semânticas, mas isso não é o foco imediato.
Nesta etapa inicial, não é necessário lidar com arquivos .bubble, chunking, graph generation ou RAG. A prioridade é a parte prática: coletar comentários em tempo real e persistir no banco de dados de forma organizada, segura e multi-tenant. Esse mecanismo é a fundação do restante do ecossistema Doccle, pois permite construir uma camada de conhecimento incremental mesmo antes de o parser completo ser introduzido no sistema.
Em resumo, o estado atual e foco imediato do Doccle é:
- Extensão Chrome integrada ao editor Bubble.io detecta comentários inseridos ou editados no campo “Comment”.
- Cada comentário é enviado imediatamente a um endpoint do Doccle.
- O backend valida, processa e armazena o comentário no banco com isolamento multi-tenant completo.
- As informações armazenadas serão a base para futuras funcionalidades avançadas de documentação, análise de workflows, geração de insights e assistentes baseados em LLM.
Esse documento serve como referência clara para orientar inteligências artificiais, colaboradores ou desenvolvedores que precisam entender a primeira funcionalidade oficial do Doccle antes das demais partes do pipeline serem incorporadas.