WBM Assistente Financeiro: Consultas Bancárias Inteligentes via Linguagem Natural 💳🤖

Arquitetura de Aplicações Financeiras, Integração Plaid Sandbox e Desenvolvimento Low-Code com Lovable

O WBM Assistente Financeiro é uma aplicação demonstrativa moderna que redefine a forma como interagimos com dados financeiros. Ao combinar uma interface conversacional intuitiva em linguagem natural com arquiteturas reativas de ponta, o projeto permite consultar contas, saldos, transações detalhadas e despesas categorizadas de forma fluida.

A aplicação está publicada e pronta para testes em wbm-assistente-financeiro.lovable.app, servindo como excelente referência de arquitetura para o ecossistema financeiro digital.

1. Principais Funcionalidades 🌟

O assistente foi projetado para oferecer uma experiência rica e acessível, dividida em pilares centrais de interação:

Conversação Natural: Faça perguntas diretas sobre suas contas, saldos atuais, transações recentes ou histórico completo, além de resumos de movimentações financeiras.
Modo Dual (Demonstração vs. Plaid Sandbox): Alterne facilmente entre dados fictícios integrados para testes rápidos e o ambiente real de simulação da Plaid Sandbox.
Sugestões Contextuais: Utilize sugestões prontas de perguntas para iniciar ou dinamizar a conversa com o assistente.
Segurança de Acesso: A aplicação é protegida por senha compartilhada, garantindo controle de acesso ao ambiente de demonstração.

Nota importante: O modo Demonstração utiliza dados puramente fictícios sem conexão com contas bancárias reais. O Plaid Sandbox funciona exclusivamente como ambiente de testes homologado.

2. Pilares Tecnológicos do Projeto 📊

A arquitetura do projeto une ferramentas de alta performance no desenvolvimento web moderno:

Camada TecnológicaFerramentas e Bibliotecas UtilizadasPropósito no ProjetoFrontend & RoteamentoReact, TypeScript, TanStack Start & TanStack RouterRenderização reativa de alta performance e navegação tipada.Estilização & BuildVite & Tailwind CSSEmpacotamento ultra-rápido e design responsivo com utilitários CSS.Backend & ServidorSupabase (Edge Functions & Recursos de Servidor)Gerenciamento de backend, segurança de senhas e rotinas de servidor.Integração FinanceiraPlaid SandboxSimulação de dados bancários de demonstração para testes de integração.

3. Guia de Desenvolvimento Local 💻

Para executar e desenvolver o projeto localmente em sua máquina, certifique-se de possuir o Node.js e o npm instalados (você pode utilizar o nvm para gerenciamento de versões).

Siga os passos abaixo no terminal:

Bash

# 1. Clone o repositório oficial
git clone https://github.com/WashingtonBM/wbm-assistente-financeiro.git

# 2. Acesse o diretório do projeto
cd wbm-assistente-financeiro

# 3. Instale as dependências
npm i

# 4. Inicie o servidor de desenvolvimento local
npm run dev

O terminal exibirá o endereço local da aplicação para testes em tempo real.

4. Comandos Disponíveis no Repositório ⚙️

O arquivo package.json disponibiliza comandos essenciais para a operação e manutenção do código:

npm run dev — Inicia o servidor de desenvolvimento local.
npm run build — Gera a versão otimizada para produção.
npm run preview — Visualiza a versão de produção localmente.
npm run lint — Executa a verificação estática de código com ESLint.
npm test — Executa a suíte de testes unitários.
npm run test:watch — Executa os testes em modo de observação contínua.

5. Configuração do Sandbox e Sincronização com Lovable 🔄

Configuração do Ambiente

O modo Plaid Sandbox depende de credenciais de teste e da senha compartilhada configuradas no ambiente de servidor do Supabase. Nunca insira segredos ou credenciais no código-fonte público. Caso não configure o ambiente Plaid, utilize o modo Demonstração com dados fictícios.

O Ecossistema Lovable & GitHub

O projeto foi integralmente gerado e estruturado com o auxílio do Lovable, mantendo sincronia bidirecional com o repositório GitHub (main):

Desenvolvimento Ágil: Descreva novas funcionalidades no editor Lovable para implementação automática.
Controle Total do Código: O código-fonte pertence a você. Envie alterações diretamente para o branch main no GitHub para sincronizá-las de volta ao Lovable de forma contínua.