Um assistente financeiro conversacional desenvolvido para ajudar pessoas a construir uma relação mais consciente e tranquila com o próprio dinheiro através da Inteligência Artificial.
O Junta.ai é um assistente financeiro conversacional que transforma conversas em organização, contexto e decisões mais conscientes sobre dinheiro.
Em vez de depender exclusivamente de planilhas, formulários ou interfaces complexas, o usuário pode conversar naturalmente sobre sua vida financeira enquanto a aplicação organiza informações, acompanha objetivos e apresenta insights de forma simples e contextualizada.
A proposta combina Inteligência Artificial, desenvolvimento Full Stack, desenvolvimento seguro e uma experiência centrada no usuário para tornar a organização financeira mais acessível e menos intimidante.
O projeto é desenvolvido como Projeto Final da formação em Desenvolvimento Full Stack da +praTi / Codifica.
O projeto nasceu inicialmente com o nome Grana AI, refletindo sua primeira proposta como uma ferramenta de organização financeira.
À medida que o produto evoluiu, ficou claro que sua missão era maior do que simplesmente controlar gastos ou organizar planilhas.
O objetivo passou a ser criar um assistente capaz de acompanhar o usuário em sua jornada financeira, oferecendo contexto, orientação e conversas que incentivem decisões mais conscientes.
Foi dessa evolução que surgiu o nome Junta.ai.
"Junta" faz parte do vocabulário brasileiro e carrega dois significados que representam a essência do produto:
- 💰 Juntar dinheiro, incentivando hábitos financeiros mais saudáveis;
- 🤝 Estar junto, transmitindo a ideia de um assistente que acompanha o usuário, em vez de apenas registrar informações.
Mais do que um novo nome, Junta.ai representa uma nova visão de produto.
O Junta.ai não existe para controlar as finanças do usuário.
Ele existe para ajudá-lo a desenvolver uma relação mais consciente e tranquila com o próprio dinheiro.
Acreditamos que conversar pode ser mais natural do que preencher planilhas.
Por isso, a Inteligência Artificial atua como uma parceira que organiza informações, oferece contexto e apoia decisões, sempre preservando a autonomia do usuário.
- 💬 Conversa antes de formulários.
- 🔎 Clareza antes da complexidade.
- 🤖 Inteligência que apoia, não substitui.
- 🧠 Contexto antes de recomendações genéricas.
- 🔐 Segurança e privacidade desde o desenvolvimento.
- 🔎 Transparência em todas as recomendações.
- 👤 O usuário mantém sempre o controle.
- 💜 A experiência deve reduzir a ansiedade financeira.
O MVP está sendo desenvolvido em torno de uma experiência financeira conversacional.
O usuário poderá interagir com o Junta.ai utilizando linguagem natural para registrar informações e conversar sobre sua situação financeira.
Receitas e despesas poderão ser registradas através da conversa, reduzindo a necessidade de preenchimento manual de formulários.
As movimentações serão organizadas automaticamente de acordo com seu contexto.
O usuário poderá criar e acompanhar objetivos financeiros diretamente através da experiência conversacional.
A aplicação apresentará informações relevantes sobre a situação financeira do usuário através de dashboards e widgets.
O agente poderá utilizar as informações disponíveis para oferecer sugestões relacionadas ao contexto financeiro do usuário.
O sistema será capaz de organizar o histórico financeiro e utilizar essas informações para fornecer uma visão mais ampla da evolução do usuário.
A experiência conversacional do Junta.ai está sendo projetada para utilizar um agente de Inteligência Artificial baseado em CrewAI.
A proposta é que o agente não funcione apenas como uma interface de conversa, mas como uma camada de inteligência capaz de interpretar as mensagens do usuário e acionar os recursos necessários para processar as informações financeiras.
Fluxo conceitual:
Usuário
│
▼
Chat do Junta.ai
│
▼
Backend / API
│
▼
Agente de IA
│
├── Interpretação da mensagem
├── Identificação da intenção
├── Organização dos dados
├── Classificação da movimentação
└── Ações relacionadas ao contexto financeiro
│
▼
Dados estruturados
│
├── Chat
├── Metas
├── Saúde financeira
├── Dashboard
└── Histórico
A integração completa entre o agente, backend, persistência de dados e interface ainda está em desenvolvimento.
Segurança não é tratada como uma etapa posterior no Junta.ai.
Por lidar com informações financeiras e dados potencialmente sensíveis, o projeto está incorporando práticas de desenvolvimento seguro desde a fase de arquitetura e implementação.
A frente de segurança considera, entre outros aspectos:
- 🔐 Autenticação e controle de acesso;
- 🛡️ Proteção de dados e informações financeiras;
- 🔑 Gestão segura de credenciais e segredos;
- 🌐 Segurança na comunicação entre frontend, backend e serviços;
- 🤖 Segurança na integração com agentes e serviços de Inteligência Artificial;
- 🧱 Validação e tratamento seguro de entradas;
- 📋 Princípios de menor privilégio;
- 🧪 Segurança integrada ao processo de desenvolvimento e testes;
- 📚 Documentação contínua das decisões e requisitos de segurança.
A segurança está sendo tratada como uma preocupação transversal do produto, e não apenas como uma funcionalidade isolada.
A documentação de segurança está organizada em:
docs/
└── security/
As medidas específicas ainda estão sendo definidas e implementadas de acordo com a evolução da arquitetura. O projeto não considera como implementada uma prática que ainda esteja apenas planejada ou documentada.
A aplicação está sendo estruturada como uma arquitetura Full Stack, separando responsabilidades entre interface, backend, inteligência artificial, persistência de dados e requisitos de segurança.
┌──────────────────────┐
│ Junta.ai │
│ React + Vite │
└──────────┬───────────┘
│
▼
┌──────────────────────┐
│ Backend API │
│ Spring Boot │
└──────────┬───────────┘
│
┌─────────────┴─────────────┐
│ │
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ Agente de IA │ │ Banco de Dados │
│ CrewAI │ │ PostgreSQL/MySQL │
└──────────────────┘ └──────────────────┘
┌──────────────────────────────────┐
│ Segurança transversal à solução │
│ Arquitetura · Código · Dados │
│ IA · APIs · Testes │
└──────────────────────────────────┘
A arquitetura encontra-se em evolução e será refinada conforme a implementação do backend, agente, persistência e mecanismos de segurança avance.
- React
- JavaScript
- Vite
- HTML
- CSS
- Java
- Spring Boot
- API REST
- CrewAI
- Agentes de IA
- LLMs
- PostgreSQL
- MySQL
A definição do banco de dados definitivo ainda faz parte da evolução da arquitetura.
- Spring Security
- JWT
- Práticas de Secure Development
- Validação e proteção de entradas
- Princípio do menor privilégio
- Segurança integrada ao ciclo de desenvolvimento
A implementação dos mecanismos de segurança está sendo realizada de forma incremental conforme a arquitetura evolui.
- Vitest / Jest
- JUnit
A estratégia e a implementação dos testes estão em evolução junto com o desenvolvimento da aplicação.
🟡 MVP em desenvolvimento
O Junta.ai encontra-se em processo de evolução arquitetural e implementação do MVP.
Atualmente, as principais frentes incluem:
- 🎨 Design System
- 💻 Desenvolvimento da interface em React
- 💬 Experiência conversacional
- 🤖 Estruturação do agente de IA
- ⚙️ Desenvolvimento do backend
- 🗄️ Definição e implementação da persistência de dados
- 🔐 Desenvolvimento seguro
- 🧪 Estratégia de testes
- 👤 Autenticação e autorização
- Definição da visão do produto
- Prototipação inicial
- Evolução da identidade para Junta.ai
- Definição inicial do Design System
- Estruturação da experiência conversacional
- Conversação funcional com agente de IA
- Registro inteligente de receitas e despesas
- Organização automática das transações
- Acompanhamento de metas financeiras
- Dashboard financeiro
- Saúde financeira
- Recomendações financeiras contextualizadas
- Histórico financeiro
- Persistência de dados
- Autenticação e autorização
- Controles de segurança
- Testes automatizados
- MVP funcional
| Etapa | Status |
|---|---|
| 💡 Ideação | ✅ |
| 🎨 Protótipo com IA | ✅ |
| 📚 Definição da visão do produto | ✅ |
| 🔄 Evolução Grana AI → Junta.ai | ✅ |
| 📐 Arquitetura inicial | ✅ |
| 🎨 Design System | 🚧 |
| 💻 Estrutura Frontend | 🚧 |
| 💬 Experiência Conversacional | 🚧 |
| 🤖 Agente de IA | 🚧 |
| ⚙️ Backend | 🚧 |
| 🔐 Desenvolvimento Seguro | 🚧 |
| 💾 Persistência de Dados | ⏳ |
| 👤 Autenticação e Autorização | ⏳ |
| 🧪 Testes | ⏳ |
| 🚀 MVP | ⏳ |
Legenda:
- ✅ Concluído
- 🚧 Em desenvolvimento
- ⏳ Planejado
A estrutura do repositório está organizada para separar aplicação, documentação e responsabilidades técnicas.
junta-ai/
├── docs/
│ ├── ai/
│ ├── product/
│ ├── security/
│ ├── technical/
│ └── testing/
│
├── frontend-v2/
│ ├── src/
│ │ ├── app/
│ │ ├── assets/
│ │ ├── components/
│ │ ├── contexts/
│ │ ├── layouts/
│ │ ├── pages/
│ │ └── ...
│ │
│ └── ...
│
├── README.md
├── LICENSE
└── .gitignore
A estrutura continuará evoluindo conforme backend, agente e infraestrutura forem incorporados ao repositório.
As principais decisões adotadas até o momento incluem:
- Arquitetura Full Stack.
- Separação entre frontend e backend.
- API REST para comunicação entre aplicações.
- Componentização da interface.
- Design System próprio.
- Suporte a Light Mode e Dark Mode.
- Experiência centrada em IA conversacional.
- Desenvolvimento incremental.
- Documentação contínua.
- Versionamento com Git e GitHub.
- Separação entre documentação de produto, IA, segurança, arquitetura e testes.
- Agente de IA estruturado com CrewAI.
- Desenvolvimento seguro incorporado ao ciclo de desenvolvimento.
- Segurança considerada desde a arquitetura, e não apenas após a implementação.
- Evolução progressiva da arquitetura conforme o MVP é implementado.
O projeto é desenvolvido utilizando práticas inspiradas em metodologias ágeis e princípios de engenharia de software.
- Git Flow
- Versionamento com Git e GitHub
- Desenvolvimento incremental
- Evolução contínua do MVP
- Documentação viva
- Organização por milestones
- Checkpoints frequentes
- Componentização e reutilização
- Revisão contínua de decisões arquiteturais
- Secure Development Lifecycle (SDL)
- Segurança considerada durante planejamento, desenvolvimento e testes
Toda a documentação oficial está sendo organizada na pasta /docs.
| Área | Descrição |
|---|---|
| 📍 Roadmap | Evolução das funcionalidades e prioridades |
| 📐 Product | Visão, princípios e estratégia do produto |
| 🤖 AI | Comportamento, arquitetura e decisões relacionadas ao agente |
| 🔐 Security | Princípios, requisitos e decisões relacionadas à segurança |
| 🏗️ Technical | Arquitetura, APIs e infraestrutura |
| 🧪 Testing | Estratégia e documentação de testes |
| 📝 Changelog | Histórico de evolução do projeto |
A documentação de segurança acompanha a evolução da arquitetura e contempla temas como:
- Overview e princípios de segurança;
- Autenticação;
- Autorização;
- Proteção de dados;
- Privacidade;
- Desenvolvimento seguro.
Os documentos são evolutivos e distinguem claramente requisitos, decisões planejadas e controles efetivamente implementados.
O Junta.ai teve início como um protótipo desenvolvido durante um bootcamp utilizando ferramentas de Inteligência Artificial para acelerar a fase de ideação e validação da interface.
A primeira versão utilizava o nome Grana AI.
O protótipo original permanece disponível como registro da evolução do produto e da transformação da ideia inicial em uma aplicação Full Stack colaborativa.
https://grana-ai-project.vercel.app/
https://github.com/danieli-dutra/grana-ai-finance-assistant
O projeto passou por diferentes fases até chegar ao conceito atual.
Grana AI
│
▼
Protótipo com IA
│
▼
Validação da proposta
│
▼
Evolução da visão do produto
│
▼
Junta.ai
│
▼
Aplicação Full Stack
│
▼
Agente de IA + experiência conversacional
│
▼
Desenvolvimento seguro integrado ao produto
A evolução do projeto representa não apenas uma mudança de nome, mas uma mudança de visão: de uma ferramenta de organização financeira para uma experiência conversacional orientada a contexto, autonomia, clareza e segurança.
Danieli Dutra Braga — Líder da equipe e responsável pela liderança do desenvolvimento do projeto.
A equipe é multidisciplinar e a divisão de responsabilidades é definida e refinada ao longo do desenvolvimento do projeto, de acordo com as necessidades de cada etapa.
- Artur Alejandro
- Caio Firmino
- Daniel Ferreira
- Jordan Fischer
- Larissa Gama
- Maria Eduarda Pereira
- Renan Estrela
- Robert Melo
- Thais Rodrigues
O projeto é desenvolvido como parte da formação em Desenvolvimento Full Stack da +praTi / Codifica.
Este projeto está licenciado sob a licença MIT.
💜 Junta.ai
Converse. Entenda. Planeje.
Seu dinheiro. Do seu jeito.