Changelog

​

Redesign da Documentação

• Nova paleta de cores: Tema slate escuro (#0f172a) substituindo o verde
• Tipografia: Fonte Inter em toda a documentação
• Blocos de código: Realce de sintaxe GitHub Light/Dark
• Navegação aprimorada: Breadcrumbs e sidebar melhorada
• Rodapé estruturado: Links rápidos para Dashboard, GraphiQL e documentação principal

​

Documentação em Português Completa

• ✅ Começar (3 páginas)
• ✅ Guias (3 páginas)
• ✅ Tipos de Entidade (13 páginas)
• ✅ Referência da API (3 páginas)

​

Suporte Multi-Empresa

• Hierarquia de empresas: Organizações agora podem conter múltiplas empresas
• Contexto de empresa: Escopo automático de todas as queries e mutations por empresa
• Roteamento inteligente: Contexto de empresa baseado em URL (ex: /acme/principal/transacoes)
• Migração de dados: Ferramentas de migração automatizadas para organizações existentes
• Compatível com versões anteriores: Organizações com uma única empresa funcionam perfeitamente

​

Chat Financeiro com IA

• Compreensão de consultas: Faça perguntas sobre seus dados financeiros em linguagem simples
• Otimização inteligente: Otimização de consultas com Google Gemini
• Respostas em tempo real: Obtenha respostas imediatas sobre fluxo de caixa, receita, despesas
• Consciente do contexto: Entende sua organização e contexto da empresa
• Feedback de mensagens: Avalie respostas para melhorar a precisão

​

Snapshots de Saldo

• Snapshots diários: Registre saldos de contas em datas específicas
• Detecção de duplicatas: Prevenção automática de entradas duplicadas
• API GraphQL: Operações CRUD completas para rastreamento de saldos
• Importação CSV: Importação em massa de dados históricos de saldo

​

Ajustes de Caixa

• Tipos de ajuste: Entradas, saídas e correções
• Alocação completa: Atribua a categorias, centros de custo e departamentos
• Importação CSV: Importação em massa de ajustes de caixa
• Relatórios financeiros: Ajustes aparecem em todos os relatórios de fluxo de caixa

​

Filtros Predefinidos & Filtros Avançados

• Filtros predefinidos: Salvar, carregar, fixar e excluir configurações de filtro personalizadas
• Predefinições do sistema: Filtros pré-configurados para cenários comuns (vencidos, este mês, etc.)
• Compartilhamento de URL: Compartilhe configurações de filtro via URL com membros da equipe
• Mais de 20 tipos de entidade: Filtros consistentes em todas as páginas de listagem
• Operadores estilo MongoDB: gt, gte, lt, lte, in, contains, eq
• Filtros de intervalo de datas: Seleções rápidas (hoje, esta semana, este mês, este ano)

​

Dashboard Financeiro & Pulsos

• Cards inteligentes: Alertas de vencidos, documentos não alocados, aprovações pendentes
• Métricas em tempo real: Indicadores financeiros principais de relance
• Insights acionáveis: Links diretos para resolver problemas
• Suporte móvel: Dashboard responsivo para monitoramento em movimento

​

Melhorias em Relatórios Financeiros

• Relatório de Documentos Financeiros: Visão abrangente de todos os documentos financeiros (CR, CP, orçamentos) com filtros, agrupamento e exportação
• Demonstração de Resultado: DRE completo com grupos de categorias e diferimentos
• Diferimentos contábeis: Suporte para diferimento de receita/despesa ao longo do tempo
• Separação de orçamentos: Orçamentos agora separados de faturas para maior clareza
• Alocação de centro de custo: Alocação automática usando motor de regras
• Função de entradas financeiras: Função de banco de dados otimizada para consultas mais rápidas
• Visualização de saldos: Saldos atuais de contas e resumos diários de transações

​

Notificações & Comentários

• @menções: Marque membros da equipe em comentários com @menções
• Notificações em tempo real: Seja notificado quando mencionado
• Comentários encadeados: Discussão rica sobre documentos financeiros
• Trilha de auditoria: Rastreie todas as comunicações relacionadas a documentos

​

Nova Integração: ContaAzul

• Fluxo OAuth: Conexão com um clique para contas ContaAzul
• Sincronização automática: Sincronize clientes, fornecedores, faturas e transações
• Credenciais seguras: Tokens OAuth armazenados com Active Record Encryption
• Por empresa: Cada empresa pode ter conexões ContaAzul separadas
• Pipeline ETL: Suporte completo de extração-transformação-carregamento com tratamento de erros

​

Arquitetura de Integração

• Padrão Provider: Interface padronizada para todas as integrações ERP
• Mappers: Separação limpa entre dados externos e modelos internos
• Cache de referência: Cache em memória para reduzir carga do banco durante ETL
• Suporte a webhooks: Atualizações em tempo real de sistemas integrados

​

Gerenciamento de Chaves de API

• UI no Dashboard: Gere, visualize e revogue chaves de API nas Configurações
• Gerenciamento de escopos: Defina permissões read_only ou read_write por chave
• Datas de expiração: Configuração opcional de expiração
• Rastreamento de uso: Monitore uso de chaves e limites de taxa
• Segurança: Geração e armazenamento seguro de chaves

​

Melhorias no Sistema de Importação

• Importação de usuários: Importe membros da equipe com atribuições de função (novo tipo: USER)
• Aplicações de pagamento: Vincule pagamentos a faturas via entidade PAYMENT_APPLICATION
• Lógica de retry: Retry automático para importações falhas com backoff exponencial
• Substituição de importações: Substitua dados existentes com novas importações
• Rastreamento de status de sincronização: Monitoramento de progresso em tempo real para integrações
• Validação aprimorada: Melhores mensagens de erro e validação por campo
• Histórico de importação: Rastreie todas as tentativas de importação e resultados
• Criação inline: Crie categorias, centros de custo e outros dados mestre diretamente dos formulários

​

Desempenho de Integrações

• Limitação de taxa: Limitador de taxa inteligente por IP, chave de app e método de API
• Requisições concorrentes: Limite de 4 requisições concorrentes (conforme documentação Omie)
• Lógica de retry: Backoff exponencial para requisições falhas
• Cache de referência: Cache em memória para reduzir consultas ao banco durante ETL
• Jobs de sincronização diária: Limpeza automática de registros de sincronização antigos

​

Desempenho & Infraestrutura

• React Query SSR: Migradas 19 páginas de listagem para renderização do lado do servidor com hidratação
• Cache Turbo: Cache remoto para builds e testes mais rápidos
• CI paralelo: Paralelização de GitHub Actions reduzindo tempo de CI em 60%
• Validação GraphQL: Validação automática de schema no pipeline de CI
• Persistência de organização: LocalStorage lembra sua última organização visitada

​

Padrão Repository & Autorização

• Padrão Repository: Camada de acesso a dados usando padrão Result do dry-monads
• ActionPolicy: Autorização granular com classes de política
• Escopo de organização: Todas as queries automaticamente escopadas à organização do usuário
• Cobertura de testes: Testes RSpec abrangentes para todos os repositories e políticas

​

Experiência do Desenvolvedor

• Suite de testes E2E: Testes Playwright abrangentes para 24 tipos de entidade
• Títulos dinâmicos: Títulos de abas do navegador refletem o contexto da página atual
• Verificações TypeScript: Script typecheck adicionado para validação do frontend
• CLAUDE.md: Diretrizes e padrões para desenvolvimento assistido por IA
• Validação de campos GraphQL: Previne uso de campos inexistentes em consultas

​

Autenticação com Chave de API

• Gerar chaves via Dashboard (Configurações → Chaves de API)
• Escopos: read_only e read_write para permissões granulares
• Expiração: Datas de expiração opcionais para segurança aprimorada
• Limitação de taxa: 1000 requisições por hora por chave
• Autenticação por header: Authorization: Bearer SUA_CHAVE_API

​

Gerenciamento de Orçamentos

• Tipos de orçamento: Previsões de receita e despesa
• Suporte a importação: Importação CSV para BUDGET_RECEIVABLE e BUDGET_PAYABLE
• Planejamento financeiro: Relatórios separados de orçado vs realizado
• API GraphQL: Operações CRUD completas via budgetCreate, budgetUpdate, budgetDelete

​

Lançamento Inicial

• 12 tipos de entidade: Transações, faturas, orçamentos, dados mestres e mais
• Validação de teste: Teste importações antes de confirmar
• Processamento assíncrono: Jobs em background com rastreamento de progresso
• Tratamento de erros: Feedback de validação detalhado por linha
• Multi-idioma: Documentação em inglês e português

​

Tipos de Entidade Suportados

• Financeiro: Transações, Contas a Pagar/Receber, Orçamentos
• Dados Mestres: Categorias, Centros de Custo, Departamentos, Contas
• Avançado: Ajustes de Caixa, Diferenças, Regras de Alocação, Usuários

​

Ferramentas para Desenvolvedores

• GraphiQL Playground: Explorador interativo da API em api.novagestao.xyz/graphiql
• Schema SpectaQL: Documentação de referência auto-gerada
• Exemplos de código: Amostras em JavaScript, cURL e GraphQL
• Recuperação de erros: Guias abrangentes de solução de problemas