Vertex Contas é uma plataforma financeira modular de alta performance, desenvolvida com arquitetura moderna para escalabilidade e robustez.
Este projeto utiliza nwidart/laravel-modules para manter o código desacoplado e organizado. Cada módulo fica em Modules/{NomeDoModulo}/.
| Módulo | Descrição |
|---|---|
| 🟢 Core | Núcleo financeiro: dashboard, relatórios, projeções, saúde financeira, consultoria PDF e integração com IA (Gemini). |
| 🏠 HomePage | Landing page, login, registro, recuperação de senha e apresentação pública. |
| 🛡️ PanelAdmin | Painel administrativo: gestão de usuários, configurações (e-mail, Gemini, branding) e visão geral do sistema. |
| 👤 PanelUser | Painel do cliente: contas, transações, categorias, orçamentos, metas, faturas, renda e plano/assinatura. |
| 🎧 PanelSuporte | Central de atendimento: chamados (tickets), ferramentas para agentes de suporte. |
| 🔔 Notifications | Notificações in-app e canais centralizados. |
| 💳 Gateways | Integrações de pagamento (webhooks, upgrade PRO) e processamento de assinaturas. |
| 📝 Blog | Gestão de conteúdo, artigos para SEO e engajamento (público e premium). |
| 🎮 Gamification | Vertex Bot (mentor IA), conquistas, insights didáticos e score financeiro. |
| 💬 VertexChat | Chat VIP em tempo real para assinantes PRO e suporte. |
O projeto foi construído utilizando as tecnologias mais recentes do mercado para garantir performance e manutenibilidade.
- Laravel 12.x: Framework PHP robusto e moderno.
- Spatie Permissions: Controle de acesso (RBAC) granular.
- SQLite / MySQL: Banco de dados flexível.
- Blade & Components: Motor de templating nativo e eficiente.
- Tailwind CSS 4.1: Estilização utility-first com configuração via Vite.
- Alpine.js 3.x: Interatividade leve e reativa sem complexidade de build.
- Font Awesome Pro: Ícones premium para uma interface visual rica.
- Vite 7.x: Bundler de próxima geração para desenvolvimento rápido.
O sistema possui uma biblioteca de componentes padronizados para consistência visual:
x-layout-app: Layout mestre da aplicação.x-icon: Gerenciador de ícones SVG otimizados.x-logo: Renderização adaptativa da marca.x-loading-overlay: Feedback visual de carregamento "Fintech Style".
Siga os passos abaixo para configurar o ambiente de desenvolvimento local.
- PHP 8.2+
- Composer
- Node.js & NPM
- Servidor Web (Apache/Nginx) ou
php artisan serve
-
Clone o repositório
git clone https://github.com/RabbitVisual/VertexContas.git cd VertexContas -
Instale as dependências
composer install npm install
-
Configure o ambiente
cp .env.example .env php artisan key:generate
Configure seu banco de dados no arquivo
.env. -
Migrações e Seeds
php artisan migrate --seed
-
Execute a aplicação Terminal 1 (Backend):
php artisan serve
Terminal 2 (Frontend - Hot Reload):
npm run dev
Acesse: http://localhost:8000
Os e-mails (boas-vindas, reset de senha, confirmação PRO) são enviados via fila para não travar a navegação. Configure:
- Queue: No
.env, definaQUEUE_CONNECTION=database. - Cron Job: No painel da Hostinger, adicione um Cron que rode a cada minuto:
Ou, para processar apenas a fila:
* * * * * cd /caminho/do/projeto && php artisan schedule:run >> /dev/null 2>&1
* * * * * cd /caminho/do/projeto && php artisan queue:work database --stop-when-empty --max-time=55 >> /dev/null 2>&1
Os recursos visuais oficiais do projeto estão localizados em storage/app/public/:
- Favicon:
logos/favicon.svg - Logo Principal:
logos/logo.svg - Logo Branca (Dark Mode):
logos/logo-white.svg - Logo Corporativa:
business/vertex_solutions_logo.svg
Visão geral do fluxo do usuário na plataforma (do acesso inicial ao uso dos módulos):
flowchart TB
subgraph Publico["🌐 Público"]
A[Home / Landing]
A --> B[Login]
A --> C[Registro]
A --> D[Esqueci a senha]
A --> E[Blog]
end
subgraph Auth["🔐 Autenticação"]
B --> F{Dashboard}
C --> F
end
subgraph User["👤 Painel do usuário"]
F --> G[Free]
F --> H[PRO]
G --> I[Contas & Transações]
G --> J[Categorias & Orçamentos]
G --> K[Metas & Faturas]
G --> L[Minha Renda]
G --> M[Extrato]
H --> I
H --> J
H --> K
H --> L
H --> M
H --> N[Relatórios Pro]
H --> O[Chat VIP]
end
subgraph Engajamento["🎮 Engajamento"]
I --> P[Vertex Bot IA]
J --> P
K --> Q[Conquistas]
P --> Q
end
subgraph Suporte["🎧 Suporte"]
O --> R[Chamados / Tickets]
end
E --> A
F --> E
Prints de tela oficiais do Vertex Contas. Cada imagem está em public/images/system/ com nome que descreve a tela — ao rolar a página você vê o print e a descrição abaixo.
Página inicial pública: apresentação da plataforma, benefícios e call-to-action para login ou registro.
Tela de login: acesso com e-mail e senha para usuários já cadastrados.
Tela de registro: criação de nova conta no Vertex Contas.
Recuperação de senha: fluxo "Esqueci minha senha" com envio de link por e-mail.
Dashboard do plano gratuito: visão geral financeira, métricas e dicas do Vertex Bot.
Dashboard do plano PRO: mesma base com recursos adicionais e indicadores avançados.
Dashboard com a opção "Esconder Vertex Bot" ativa, para quem prefere interface mais limpa.
Home/landing exibida para o usuário free após o login.
Home/landing exibida para o usuário PRO após o login.
Gestão de contas bancárias/carteiras no plano PRO.
Gestão de categorias de receitas e despesas.
Tela de categorias com recursos do plano PRO.
Orçamentos por categoria no plano PRO.
Metas financeiras: cadastro e acompanhamento de objetivos com valor e prazo.
Metas com recursos avançados no plano PRO.
Tela de faturas: visão de compromissos e vencimentos.
Cadastro e gestão de fontes de renda (salário, freelance, etc.).
Extrato mensal: lançamentos e saldo do período.
Relatórios avançados disponíveis para assinantes PRO.
Tela de planos e assinatura: comparação Free x PRO e upgrade.
Blog: listagem de artigos para educação financeira e SEO.
Vertex Bot: mentor financeiro com dicas contextuais e integração opcional com IA (Gemini).
Vertex Bot em outro contexto de dica (ex.: orçamento, poupança ou dica do dia).
Gamificação: conquistas desbloqueadas e progresso do usuário.
Central de chamados: tickets de suporte abertos e histórico.
Chat VIP em tempo real para assinantes PRO e equipe de suporte.
Overlay de carregamento no estilo fintech durante processamento.
Todos os prints ficam em public/images/system/. Para adicionar novos: salve o PNG com nome descritivo da tela (ex.: Nova funcionalidade X.png).
O Vertex Contas hoje oferece:
- Gestão financeira completa: contas, transações, categorias, orçamentos por categoria e metas com prazo.
- Regra 50/30/20: acompanhamento de necessários, desejos e poupança com métricas e relatórios.
- Vertex Bot (IA): mentor financeiro com dicas contextuais (Gemini opcional), insights por evento (saldo baixo, orçamento, poupança, dica do dia) e opção de esconder o assistente.
- Gamificação: conquistas, score financeiro e banco de insights didáticos/profissionais (seeders).
- Planos Free e PRO: assinatura PRO com Chat VIP, relatórios avançados, consultoria PDF e conteúdos premium.
- Blog: artigos públicos e premium para SEO e educação financeira.
- Suporte: central de chamados (tickets) e chat em tempo real para PRO.
- E-mails transacionais: boas-vindas, reset de senha e confirmação PRO, com template único e fila (queue).
- Configurações dinâmicas (Admin): driver de e-mail (SMTP, SES, etc.), teste de envio, API Gemini e branding (logo, nome).
- Relatórios e consultoria: análise de saúde financeira e geração de PDF de consultoria com conclusão via IA.
