Descubra como o MongoDB Atlas e o ObjectBox mantêm uma carteira pessoal, e seu assistente de IA, funcionando com conectividade zero.
Casos de uso: Edge e Mobile, Busca Inteligente, Pagamentos
Setores: Serviços financeiros
Produtos e ferramentas: MongoDB Atlas banco de dados, MongoDB Atlas Vector Search, MongoDB MCP servidor, MongoDB Search, MongoDB Triggers, Voyage AI
Parceiros: ObjectBox, LangChain
Visão Geral da Solução
Aplicativos tradicionais de carteira e serviços bancários geralmente dependem de uma conexão estável com a internet. Quando os usuários estão em sistemas de trânsito, áreas rurais ou locais com redes móveis instáveis, eles podem não conseguir visualizar seu saldo, revisar transações, gerenciar contatos, enviar dinheiro e acessar sua carteira quando mais precisam.
Os usuários precisam de uma carteira que continue útil durante breves períodos de desconexão. Os usuários devem ser capazes de acessar sua carteira e concluir tarefas financeiras sem serem bloqueados por uma interrupção temporária da rede. Quando a conectividade retornar, a carteira deverá sincronizar a conta do usuário.
Esta solução aborda a perda de acesso a funções essenciais da carteira quando a conectividade é limitada. Ela mantém os dados da carteira disponíveis quando o usuário está offline e permite que as principais interações, como revisar transações, gerenciar contatos e enviar dinheiro, continuem sem exigir uma resposta imediata da rede. Ela também inclui um assistente de IA que ajuda os usuários a acessar informações da carteira e preparar ações de pagamento, tanto online quanto offline. Assim que a conectividade é restaurada, a solução sincroniza as alterações mais recentes com o backend. O valor principal é a continuidade: os usuários podem gerenciar seu dinheiro e receber assistência durante interrupções temporárias de rede.
O MongoDB oferece uma base de dados flexível para essa abordagem. Ele modela as informações da carteira, incluindo saldos, transações, contatos, solicitações de pagamento e ações pendentes, em uma camada de dados unificada. A camada de dados unificada ajuda o aplicativo a manter o estado da carteira necessário durante a desconexão e a reconciliar as atualizações quando o usuário se reconecta. A mesma base de dados também fornece contexto relevante da carteira para o assistente de IA, ajudando-o a dar suporte a essas interações em estados conectados e desconectados.
Figura 1. Arquitetura de alto nível da solução
Arquiteturas de referência
Esta solução usa um dispositivo de borda e MongoDB Atlas como seus componentes principais, integrando-os com um PSP externo. Cada componente tem uma função claramente definida na arquitetura geral. O dispositivo de borda oferece suporte a interações offline-first, o MongoDB Atlas fornece persistência centralizada e serviços de dados acessíveis por IA, e o PSP lida com operações de pagamento regulamentadas.
Figura 2. Visão geral da arquitetura de referência
Na borda, o aplicativo móvel armazena dados em um banco de dados ObjectBox local e executa o Ollama para inferência no dispositivo. Um modelo Voyage AI executa em paralelo com ele, fazendo o embedding de notas de transação no dispositivo para que a recuperação semântica continue funcionando sem uma rede. O ObjectBox Sync Server espelha o esquema do MongoDB Atlas, de modo que o aplicativo lê e grava as mesmas estruturas lógicas online e offline.
O MongoDB Atlas armazena os dados operacionais da carteira: transações, contatos, solicitações, notificações e bate-papos. As seguintes funcionalidades do Atlas são construídas sobre esses dados:
MongoDB Atlas Vector Search: recupera notas de transação por significado, usando embedding do Voyage AI.
Pesquisa Híbrida no MongoDB Atlas: combina os resultados do vetor com uma query de pesquisa lexical em um único
$rankFusionpipeline. Essa configuração retorna a transação correta para um nome de comerciante exato e uma descrição vaga.Atlas Triggers: reaja a cada inserção e atualização na coleção
transactionse faça um upsert de um registro de histórico durável, indexado pela referência de transferência do PSP.MongoDB MCP servidor: expõe FERRAMENTAS de leitura, permitindo que o assistente de IA faça uma query diretamente no MongoDB Atlas.
O PSP externo permanece como o sistema de registro para execução de pagamentos e identidade. Ele autoriza e liquida transferências, enquanto o aplicativo armazena apenas as referências e os dados do aplicativo necessários para oferecer suporte à experiência do usuário.
Essa separação de responsabilidades combina capacidade de resposta local, inteligência baseada em nuvem e execução de pagamentos segura.
Fluxo de processo arquitetural
Esses fluxos de processo demonstram como os subsistemas interação para fornecer resiliência arquitetural e assistência inteligente. O fluxo de pagamento offline garante a continuidade das operações financeiras críticas mesmo com a perda de conectividade, mantendo a confiabilidade da carteira. O fluxo assistido por chatbot aproveita a inteligência local para simplificar as interações, demonstrando que uma interface conversacional pode permanecer responsiva sem depender constantemente da nuvem. Juntos, esses processos oferecem uma experiência de usuário consistente em qualquer ambiente de rede.
Fluxo de pagamento off-line
Este fluxo garante a confiabilidade financeira ao desacoplar a interação do usuário da disponibilidade da rede em tempo real. Ao colocar as transações em fila localmente, o sistema mantém uma experiência de pagamento perfeita, mesmo em ambientes restritos, sincronizando com a plataforma central apenas quando a conectividade é restaurar.
Figura 3. Sequência de pagamento off-line
O aplicativo continua funcionando quando o dispositivo perde a conectividade. Em um fluxo de pagamento offline:
O usuário inicia um pagamento.
O aplicativo valida o valor em relação ao último saldo sincronizado armazenado no ObjectBox.
A transação é colocada na fila localmente com um status
local_pending.Quando a conectividade retorna, o aplicativo detecta a reconexão e recupera todas as transação pendentes.
Cada transação pendente é enviada ao PSP para liquidação.
Após a liquidação, o aplicativo armazena a referência PSP e marca a transação como liquidada.
O servidor de sincronização ObjectBox propaga o estado da transação atualizado para o MongoDB Atlas.
Este padrão preserva a continuidade do aplicativo durante a perda de conectividade, garantindo que a liquidação do pagamento ocorra apenas por meio do PSP externo.
Fluxo de pagamento assistido por chatbot
Este fluxo conversacional usa IA local, baseada em edge, para fornecer assistência inteligente sem depender de uma conexão persistente com a nuvem. Ele processa a intenção do usuário localmente, permitindo a preparação de pagamentos e a resolução de contatos, e em seguida, executa com segurança as transações confirmadas quando o sistema se reconecta.
Figura 5. Sequência de pagamento assistida por chatbot
A solução criar o assistente de IA em um agente LangGraph. O fluxo de trabalho para o chatbot funciona da seguinte forma:
O usuário envia uma solicitação como Enviar 20 para Luis para o jantar.
O agente determina o contato pretendido:
Quando online, ele consulta o MongoDB Atlas pelo servidor MongoDB MCP.
Quando offline, ele resolve o contato diretamente do ObjectBox.
O agente elabora o pagamento e apresenta um cartão de confirmação ao usuário.
Os fundos não são movimentados até que o usuário confirme explicitamente a transação.
Após a confirmação, ele executa as seguintes ações:
No modo online, o aplicativo envia a transferência para o PSP e grava um registro de enriquecimento no MongoDB Atlas.
No modo offline, o aplicativo enfileira a transação localmente para reprodução posterior.
O usuário recebe uma notificação assim que o pagamento for enviado ou colocado na fila.
Este modelo de interação combina a iniciação de pagamento em linguagem natural com a aprovação explícita do usuário, preservando os mesmos limites de execução online e offline definidos pela arquitetura principal.
Abordagem do modelo de dados
Esta solução usa um document model espelhado. Este padrão de design mantém as mesmas entidades de carteira e estruturas de documento em todo o MongoDB Atlas e o armazenar ObjectBox no dispositivo. O modelo oferece suporte a uma carteira offline criada em cima de um PSP externo compatível com BIAN.
O PSP permanece o sistema de registro para execução de pagamentos e identidade, enquanto o aplicativo armazena referências e enriquecimento em nível de aplicativo para oferecer suporte à experiência do usuário. Este enriquecimento inclui notas, embeddings semânticos e sincronização ou estado do ciclo de vida. Usar o mesmo esquema lógico no MongoDB Atlas e no ObjectBox permite que o aplicativo trabalhe de forma consistente tanto online quanto offline.
As coleções abaixo mostram como esta solução modela os dados do seu aplicativo para oferecer suporte à experiência de pagamento offline.
collection | Descrição |
|---|---|
| Armazena movimentos de dinheiro concluídos e pendentes, indexados ao PSP por referência, em vez de armazenar saldos ou credenciais diretamente. |
| Mantém um histórico pesquisável exclusivo do Atlas. Um Atlas Trigger realiza upserts de cada transferência liquidada aqui, indexado por referência PSP, para que a pesquisa híbrida seja executada sobre um corpus estável que a sincronização do dispositivo não pode fragmentar. |
| Representa as pessoas para as quais um usuário pode pagar ou fazer uma solicitação de dinheiro, resolvidas a partir de referências de arranjos de PSP em registros de contato amigáveis para carteiras. |
| Acompanha as solicitações de pagamento durante todo o seu ciclo de vida, desde a criação até a liquidação ou disputa. |
| Entrega eventos de pagamento e carteira voltados para o usuário, incluindo atualizações de status para ações enfileiradas e concluídas. |
| Armazena o histórico de conversas do assistente de IA, com escopo definido para o usuário proprietário e vinculado à experiência de carteira. |
Toda coleção, exceto walletTransactionsHistory, espelha o banco de dados ObjectBox. O MongoDB Atlas armazena os dados do histórico e fornece os índices de vetor e texto necessários para a pesquisa híbrida.
Abaixo, você encontra o document model para uma transação de carteira, armazenado na coleção walletTransactions. Isso representa um único pagamento enviado ou recebido através do PSP externo. O documento captura os dados operacionais necessários para acompanhar a transferência e os dados de enriquecimento (embedding, estado de sincronização) necessários para alimentar a pesquisa, a reprodução offline e o assistente de IA.
{ "_id": { "$oid": "unique_id" }, "leafyPayTransferReference": "string", "ownerPartyRef": "string", "counterpartyArrangementReference": "string", "amount": "number", "currency": "string", "note": "string", "noteEmbedding": [ "number", "..." ], "direction": "sent | received", "leafyPayStatus": "pending | settled | failed | exception", "localSyncStatus": "local_pending | synced", "createdAt": { "$date": "ISODate" }, "settledAt": { "$date": "ISODate" }}Este modelo unifica o contexto operacional e o enriquecimento, simplificando a implantação em ambientes de nuvem e de dispositivos. O aplicativo renderiza a atividade pendente, reproduz operações de gravar offline e suporta a recuperação de transações assistida por IA usando uma única leitura. Você pode realizar essas operações, porque o estado de sincronização (localSyncStatus), o estado de liquidação (leafyPayStatus) e o vetor de pesquisa semântica (noteEmbedding) residem no mesmo documento.
A execução financeira sensível permanece no PSP, enquanto o MongoDB Atlas e o ObjectBox armazenam apenas os dados do aplicativo de carteira necessários para capacidade de resposta, pesquisa e experiência do usuário. Em um sistema de produção, você pode estender essas coleções com validação mais rigorosa, controles de acesso e trilhas de auditar.
Construir a solução
Implante a solução em duas etapas para executá-la localmente. Primeiro, inicie o PSP, que lida com SSO, consentimento e execução de pagamentos. Em seguida, inicie o Leafy Wallet, que executa a IU do aplicativo, serviços de backend, ObjectBox, Ollama, Voyage AI e componentes de sincronização.
Para implantação local, clone ambos os repositórios lado a lado:
Siga as instruções no IMPLANTAÇÃO LOCAL no Github
Implante o modelo
Implante a solução como uma coleção de serviços em contêiner para oferecer suporte a uma experiência resiliente e que funciona primeiro offline. Como mostra o diagrama, o frontend, o backend em FastAPI e o MongoDB Atlas gerenciam o fluxo conectado à nuvem, enquanto o ObjectBox Sync Server faz a ponte entre o armazenamento local do ObjectBox no dispositivo e o Atlas.
Esse configurar permite que a carteira armazenar dados localmente para resposta instantânea durante a desconexão e envie automaticamente as transações na fila para a nuvem assim que a conectividade for retomada. Use este modelo conteinerizado para manter uma estrutura de dados lógica consistente entre o dispositivo de borda e seu cluster Atlas.
Configurar o ambiente
Clone os repositórios PSP e Leafy Wallet lado a lado.
git clone https://github.com/mongodb-industry-solutions/leafy-wallet.gitgit clone https://github.com/mongodb-industry-solutions/sec-fsi-pci-dss.gitConfigure os arquivos de ambiente separados para o frontend e o backend antes de iniciar. Esses arquivos gerenciam strings de conexão essenciais, credenciais de API e pontos de extremidade de serviço, permitindo uma comunicação segura entre o frontend, o backend e seus serviços externos.
#frontendCLIENT_ID=<id>CLIENT_SECRET=<secret>PSP_BASE_URL=http://host.docker.internal:8081PSP_FRONTEND_URL=http://localhost:8083APP_BASE_URL=http://localhost:8080REDIRECT_URI=http://localhost:8080/api/auth/callbackLOOKUP_DIGEST_KEY=<key>
#backendMONGODB_URI="<your-atlas-connection-string>"DATABASE_NAME="<db-name>"APP_NAME=leafy-wallet-backendOLLAMA_BASE_URL=http://localhost:11434OLLAMA_EMBEDDING_MODEL=nomic-embed-textLOOKUP_DIGEST_KEY="<key>"A configuração do frontend deve apontar PSP_BASE_URL para http://host.docker.internal:8081 para que o aplicativo conteinerizado possa alcançar o PSP executado localmente.
Inicie o aplicativo Leafy Wallet
Depois que o PSP estiver em execução, crie o índice de pesquisa vetorial do MongoDB e inicie a Leafy Wallet com o Docker Compose:
cd leafy-wallet/backenduv run python scripts/create_vector_index.pycd ..docker compose up -d --buildA Leafy Wallet inicia em http://localhost:8080, com os serviços de backend, ObjectBox, Ollama e sincronização sendo executados em contêineres.
Assim que ambas as pilhas estiverem em execução, abra o Leafy Wallet no seu navegador e continue com o SSO.
Principais Aprendizados
Mantenha os recursos da carteira utilizáveis quando a conectividade cai: Trate o acesso à rede como um aprimoramento em vez de um requisito. Um armazenamento local com suporte do MongoDB Atlas mantém saldos, transações, contatos, solicitações e fluxos de bate-papo disponíveis durante curtas desconexões e depois reconcilia assim que o dispositivo estiver online novamente.
Mantenha o contexto do aplicativo no MongoDB Atlas e deixe a liquidação para o PSP: O Atlas armazena os aliases, notas, estado de sincronização e embedding que moldam a experiência do usuário, enquanto o provedor de pagamento permanece o sistema de registro para identidade, autorização e liquidação. Esta divisão mantém a camada de experiência flexível sem trazer a execução regulamentada para ela.
Leia e grave o mesmo modelo de dados lógico no dispositivo e na nuvem: espelhe estruturas de coleção do MongoDB Atlas em um armazenamento incorporado e sincronize alterações em segundo plano. Esquemas idênticos em ambos os lados removem a camada de tradução que os recursos offline normalmente exigem, de modo que o código do aplicativo não se ramifica com base na conectividade.
Manter o contexto operacional e o enriquecimento juntos no document model: Armazenar detalhes de transferência, notas, estado de sincronização e embedding no mesmo documento para simplificar leituras, oferecer suporte a atualizações atômicas e facilitar os dados para experiências assistidas por IA.
Combine a capacidade de resposta local com a inteligência na nuvem: o Atlas Vector Search, o servidor MCP do MongoDB e o armazenamento no dispositivo permitem que os assistentes lidem com a descoberta de transações em linguagem natural e a elaboração de pagamentos. Os usuários obtêm o mesmo comportamento, esteja o dispositivo online ou não.
Autores
Felipe Trejos, MongoDB
Miguel Aréjula Aísa, MongoDB