Ir para o conteúdo

Arquitetura ​

O GMPay Edge opera como um único contêiner Worker ou um contêiner Bun/Nitro. Ambos os ambientes de execução compartilham as mesmas superfícies de produto e o núcleo de pedidos/pagamentos; apenas os adaptadores de infraestrutura são diferentes.

Superfícies de produtos ​

  • Os clientes comerciais utilizam as fronteiras compatíveis com GMPay ou EPay.
  • Os pagadores utilizam a plataforma de checkout hospedada.
  • Os operadores utilizam /admin.
  • Os usuários do Telegram interagem através do bot configurado.

Serviços de tempo de execução ​

CapacidadeCloudflare WorkersBun/Nitro Docker
Banco de dadosD1SQLite em GMPAY_DATA_DIR
CacheKVCache de execução local
Objetos pessoaisR2Armazenamento local de objetos persistente
Trabalho de fundoCloudflare QueuesFilas locais duráveis
AgendamentoCron TriggersAgendador eficiente

O diretório de dados Bun também contém arquivos carregados e o estado durável da fila. É necessário que seja montado em um volume persistente e incluído em backups.

Bindings da Cloudflare ​

BindingProdutos da CloudflareFinalidade
DBD1Dados autoritativos de aplicação, pagamento, autorização e entrega.
CACHEKVCaches validadas de curta duração e telemetria complementar.
FILESR2Evidências de revisão de pagamentos privados e exportações geradas.
PAYMENT_QUEUEFilasEscaneamento de pagamentos assíncronos
WEBHOOK_QUEUEFilasEntrega assíncrona de Webhooks de comerciantes.

Trabalho de fundo ​

Filas e agendadores duráveis específicos para a execução, juntamente com a movimentação de verificações de pagamento e tentativas de Webhook fora de solicitações sincronizadas, também lidam com a expiração de pagamentos, limpeza, verificações de saúde da conexão e sincronização de taxa.

A entrega de webhooks utiliza uma caixa de saída durável com histórico de tentativas, redefinição manual e registros de auditoria em ambas as etapas.

Modelo de dados e segurança ​

  • D1 ou SQLite são considerados a referência para o ambiente de execução selecionado.
  • O armazenamento em cache e o armazenamento de objetos privados utilizam os adaptadores da execução selecionada.
  • Os adaptadores de pagamento são somente de leitura.
  • A administração utiliza o Better Auth, TOTP e RBAC (controle de acesso baseado em função) dinâmico e multi-funções.

Limites do protocolo ​

O GMPay utiliza assinaturas HMAC-SHA256. A compatibilidade com EPay permanece como uma fronteira de MD5 herdada. As chamadas de retorno (outbound callbacks) mantêm o formato de assinatura do protocolo original.