Pular para o conteúdo principal

Mapa de Dominio - G8PAY

Visao geral​

O G8PAY funciona como um backoffice operacional-comercial para uma operacao de meios de pagamento, com governanca por permissoes e segregacao por White Label.

Objetivo de negocio principal:

  • adquirir e operar carteira de estabelecimentos;
  • controlar rede comercial (colaboradores/correspondentes);
  • aplicar regras de precificacao (taxas e planos);
  • acompanhar transacoes e credenciamentos;
  • consolidar resultados financeiros (comissoes e alugueis).

Atores de negocio​

  • Admin global: visao ampla, governanca, configuracoes sensiveis.
  • White Label: administra operacao do proprio tenant.
  • Marketplace/gestor comercial: gerencia time e carteira no escopo permitido.
  • Representante/colaborador: prospeccao e gestao de base vinculada.
  • Operacao/compliance: validacao documental, controle de status e risco.

Entidades centrais (modelo conceitual)​

  • Usuario (users): identidade interna, perfil, status, vinculos hierarquicos.
  • Permissao (permissoes, permissao_usuario): autorizacao granular por chave.
  • White Label (white_labels): tenant, branding e politicas de precificacao.
  • Estabelecimento (estabelecimentos_locais e relacionados): carteira comercial.
  • Terminal/Dispositivo (terminais e vinculacoes): ativo operacional do estabelecimento.
  • Plano (planos): pacote comercial com regras de uso/custo.
  • Taxas:
    • custo efetivo (user_taxas, white_label_taxas, taxas_padrao);
    • MDR (user_mdr_taxas, white_label_mdr_taxas).
  • Transacao (modulo transacoes + consultas dashboard): eventos financeiros.
  • Credenciamento (entrepay_credenciamentos e auxiliares): onboarding adquirente.
  • Documento/assinatura (autentique): formalizacao e trilha documental.
  • Comissao/aluguel (modulo financeiro): consolidacao e repasse.

Regras de negocio transversais​

  • Escopo de dados: leitura/escrita condicionada a permissao + hierarquia + white_label_id.
  • Ciclo de vida por status: entidades operacionais usam status para habilitar/bloquear fluxo.
  • Multi-tenant: cada white label aplica identidade visual e regras proprias.
  • Heranca de taxas: novos usuarios/estruturas herdam taxas do white label ou usuario pai.
  • Governanca por aprovacao: cadastros e mudancas sensiveis passam por aprovacao/bloqueio.
  • Rastreabilidade: logs tecnicos e funcionais para auditoria e diagnostico.

Cadeia de valor (fluxo macro)​

  1. Estruturar rede comercial (usuarios e permissoes).
  2. Cadastrar/gerir estabelecimentos e vincular responsavel.
  3. Definir plano e precificacao (custo efetivo ou MDR).
  4. Vincular terminais/dispositivos e executar credenciamento externo.
  5. Processar/acompanhar transacoes e status de operacao.
  6. Consolidar comissoes, alugueis e indicadores de performance.

Integracoes externas e papel de cada uma​

  • Movingpay: dados/operacao de transacoes e componentes de cobranca.
  • Entrepay: credenciamento e status operacional de estabelecimentos/dispositivos.
  • Autentique: ciclo documental e assinaturas.

Dependencia de negocio: falhas nessas integracoes impactam onboarding, operacao e receita.

Limites de contexto (bounded contexts)​

  • Identidade e Acesso: login, sessao, RBAC, validacao de escopo.
  • Cadastros Comerciais: colaboradores, clientes, estabelecimentos, white labels.
  • Precificacao e Planos: regras de taxa, tabelas padrao e excecoes.
  • Operacao de Credenciamento: integracao e reconciliacao com adquirente.
  • Transacoes e Analytics: consulta, filtros, dashboards e exportacoes.
  • Financeiro: comissoes, alugueis e visao de resultado.
  • Documentos e Compliance: formalizacao e trilha de aprovacao.

Eventos de negocio importantes​

  • UsuarioCadastrado, UsuarioAprovado, UsuarioBloqueado.
  • EstabelecimentoCadastrado, RepresentanteTrocado.
  • PlanoVinculado, TaxaHerdada, TaxaAtualizada.
  • CredenciamentoSolicitado, CredenciamentoAprovado, CredenciamentoRejeitado.
  • TransacaoAprovada, TransacaoRecusada, TransacaoPendente.
  • ComissaoApurada, RelatorioFinanceiroExportado.
  • DocumentoGerado, DocumentoAssinado, DocumentoArquivado.

Riscos estruturais atuais (alto nivel)​

  • Regras de autorizacao parcialmente inconsistentes entre endpoints.
  • Acoplamento alto entre camada HTTP, regra de negocio e acesso a dados.
  • Duplicidade de logica de taxa/heranca em multiplos arquivos.
  • Presenca de scripts utilitarios/debug no mesmo espaco de runtime produtivo.
  • Segredos sensiveis hardcoded em arquivos de configuracao.

Direcao recomendada (produto + arquitetura)​

  • Padronizar politicas de autorizacao por contexto (middleware/servico unico).
  • Consolidar dominio de precificacao em servico dedicado.
  • Externalizar segredos e parametros de ambiente (sem hardcode).
  • Separar claramente rotinas de manutencao/debug de endpoints de producao.
  • Evoluir observabilidade orientada a eventos de negocio.

Resumo executivo​

O G8PAY e um sistema de operacao comercial de pagamentos, com modelo multi-tenant e governanca por permissoes, cuja regra de negocio central e transformar rede comercial em receita recorrente por meio de cadastro, credenciamento, transacao e consolidacao financeira com controle de risco e compliance.