Ir al contenido

Arquitectura ​

GMPay Edge se ejecuta ya sea como un único Worker o dentro de un contenedor Bun/Nitro. Ambos entornos de ejecución comparten las mismas superficies de producto y el núcleo de pedidos/pagos; solo las adaptadoras de infraestructura difieren.

Superficies de producto ​

  • Los clientes comerciales se refieren a los límites compatibles con GMPay o EPay.
  • Los pagadores utilizan el sistema de pago alojado.
  • Los operadores utilizan /admin.
  • Los usuarios de Telegram interactúan a través del bot configurado.

Servicios de ejecución ​

CapacidadCloudflare WorkersBun/Nitro Docker
Base de datosD1SQLite en GMPAY_DATA_DIR
CacheKVAlmacenamiento en caché local
Objetos privadosR2Almacenamiento local persistente
Trabajo de fondoCloudflare QueuesColas locales duraderas
ProgramaciónCron TriggersProgramador de tareas eficiente.

El directorio de datos de Bun también contiene archivos subidos y el estado duradero de la cola. Debe montarse en un volumen persistente e incluirse en las copias de seguridad.

Bindings de Cloudflare ​

BindingProducto de CloudflareFinalidad
DBD1Datos autorizados de aplicación, pago, autorización y entrega.
CACHEKVCachés validadas de corta duración y telemetría complementaria.
FILESR2Evidencia de revisión de pagos privados y exportaciones generadas.
PAYMENT_QUEUEColasEscaneo de pagos asíncronos
WEBHOOK_QUEUEColasEntrega asíncrona de Webhooks de comercio electrónico.

Trabajo de fondo ​

Las colas y los programadores duraderos específicos para cada ejecución permiten mover los escaneos de pagos y los reintentos de Webhook fuera de las solicitudes sincrónicas. Además, gestionan la expiración de pagos, la limpieza, las comprobaciones de estado de la conexión y la sincronización de tasas.

La entrega de webhooks utiliza una salida duradera con historial de reintentos, reintentos manuales y registros de auditoría en ambas etapas.

Modelo de datos y seguridad ​

  • D1 o SQLite son la fuente de autoridad para el entorno de ejecución seleccionado.
  • Cache y el almacenamiento privado utilizan los adaptadores de la ejecución seleccionada.
  • Los adaptadores de pago son de solo lectura.
  • La administración utiliza Better Auth, TOTP y RBAC de roles múltiples dinámicos.

Límites del protocolo ​

GMPay utiliza firmas HMAC-SHA256. La compatibilidad con EPay requiere seguir una frontera de MD5 heredada. Las llamadas de retorno (callbacks) mantienen el formato de firma del protocolo original.