Módulo Core
Núcleo financeiro do sistema: contas, transações, categorias, orçamentos, metas, relatórios, consultoria PDF e integração com IA (Gemini).
Propósito
O Core é o módulo central do Vertex Contas. Contém toda a lógica de gestão financeira: contas, transações, categorias 50/30/20, orçamentos, metas, Minha Renda, relatórios (fluxo de caixa, categorias, extrato), consultoria em PDF com IA, importação CSV assistida por IA, projeções e faturas. Inclui ainda o InspectionGuard para privacidade durante inspeção de suporte.
Principais Recursos
- Contas bancárias e carteiras (CRUD)
- Transações (receitas/despesas) com categorias e pilares 50/30/20
- Transferências entre contas
- Categorias com type_group (essential, lifestyle, financial)
- Orçamentos por categoria
- Metas financeiras com prazo
- Minha Renda (fontes de receita recorrente)
- Relatórios: fluxo de caixa, ranking de categorias, extrato, consultoria PDF (PRO)
- Importação de extratos CSV com categorização assistida por IA (PRO)
- Projeções financeiras interativas
- Faturas PRO
- InspectionGuard (mascaramento de dados financeiros durante inspeção)
- Documentos legais (LegalDocument), Wiki, Settings
Services Principais
| Service | Descrição |
|---|---|
| ReportService | Relatórios, consultoria, 50/30/20, score financeiro |
| GeminiService | Integração Google Gemini: insights, conclusão PDF, projeção, categorização CSV |
| GamificationService | Insights do Vertex Bot, medalhas, conquistas |
| FinancialHealthService | Cálculo de saúde financeira e 50/30/20 |
| InspectionGuard | Mascaramento de dados quando inspeção ativa e show_financial_data = false |
| TransferService | Transferências entre contas |
| SettingService | Configurações do sistema |
| SubscriptionLimitService | Verificação de limites do plano |
Modelos / Entidades
| Model | Descrição |
|---|---|
| Account | Contas bancárias/carteiras |
| Transaction | Receitas e despesas |
| Category | Categorias (type_group: essential, lifestyle, financial) |
| Budget | Orçamentos por categoria |
| Goal | Metas financeiras |
| Inspection | Sessão de inspeção remota (suporte) |
| LegalDocument | Termos, privacidade, cookies |
| Setting | Configurações do sistema |
| AiConsultingReport | Histórico de consultorias geradas |
Controllers e Rotas Principais
Prefixos: /dashboard, /accounts, /transactions, /goals, /categories, /budgets, /minha-renda, /reports, /invoices. Rotas de consultoria e extrato exigem middleware pro.
Integrações
- PanelUser — Interface do usuário para todas as operações financeiras
- Gamification — GamificationService usa dados do Core para insights e medalhas
- PanelSuporte — InspectionGuard mascara dados durante inspeção
- PanelAdmin — SettingsService, gestão de planos e limites
Configurações
O Core utiliza SettingService para configurações dinâmicas. Integração com Gemini via Admin → Configurações → IA ou variável GEMINI_API_KEY no .env.