Omniaflow — Sistema de Gestão Educacional

O Omniaflow nasceu para resolver o caos operacional de redes de ensino com múltiplas unidades. Onde antes imperavam planilhas isoladas e ERPs genéricos, entregamos uma solução robusta com isolamento total de dados e automação financeira de ponta.

O Desafio

A necessidade era clara: um sistema único, mas que funcionasse como instâncias independentes para cada franquia. Os pilares de complexidade eram:

1. Multi-tenancy Real: Isolamento arquitetural de dados (não apenas filtros de banco de dados).

2. Engenharia Financeira: Precisão absoluta em cobranças (PIX/Boletos) e conciliação automática via Gateway.

3. Comunicação em Tempo Real: Notificações e atualizações de status sem dependência de polling.

A Solução: Arquitetura para Escalar

Optamos por um Monolito Moderno utilizando Laravel 12 e Vue 3 (Inertia.js v2). Essa escolha elimina a latência e complexidade de APIs separadas, mantendo a experiência fluida de um SPA.

Estrutura em Camadas

• Controllers: Enxutos e focados em fluxo.

• Services: Centralização das regras de negócio.

• Actions: Casos de uso específicos e reutilizáveis.

• Gateway Pattern: Camada de abstração total para integração com o Asaas.

Módulos Principais

Destaque Técnico: Todos os valores monetários são processados em centavos (amount_cents), eliminando erros de ponto flutuante comuns em operações financeiras.

Decisões Técnicas que Fizeram a Diferença

Isolamento com Multitenancy

Utilizamos o middleware check.unidade para garantir que cada franquia opere em seu próprio contexto. O isolamento acontece por design: é impossível um usuário acessar dados de outra unidade.

Gateway Pattern (Abstração Financeira)

Toda a comunicação com o Asaas passa por um namespace dedicado (Gateways\Asaas).

• Uso de DTOs e Mappers para transitar dados.

• A Service financeira nunca "sabe" quem é o provedor, facilitando a troca de gateway no futuro sem tocar na lógica de negócio.

Tempo Real com Laravel Reverb

Substituímos o polling por WebSockets nativos. Status de pagamento e alertas de matrícula aparecem instantaneamente na tela do operador, melhorando drasticamente a experiência do usuário.

Stack Tecnológica

Resultado Final

O Omniaflow entregou uma base sólida onde novas unidades são incorporadas sem alteração de código. O sistema hoje processa cobranças reais e conciliações automáticas com zero erro de arredondamento e rastreabilidade total de eventos.

Um sistema construído para crescer junto com a operação, não para ser refeito quando ela escalar.