Caso de estudio

SkyBiz Payouts

Back office de pagos con revisión de riesgo

1 pago por retiradaen pruebas, incluso con trabajos y webhooks reintentadosentrega al menos una vez con consumidores idempotentes (un único efecto)

Demo en vivo

Sin demo pública todavía: es un back office interno.

Qué es y qué resuelve

Un back office de pagos: depósitos con Stripe (modo test) y un simulador cripto, retiradas con puntuación de riesgo y revisión manual, conciliación y promociones con IA (borradores multilingües que aprueba un operador). Mete y saca dinero de Platform Core con trabajos fiables y un rastro de eventos auditable.

Versión para negocios: SkyBiz →

Arquitectura

SkyBiz Payouts: arquitecturajobsdeposit · withdrawoutboxBack officereview · reconciliationPayouts APIRabbitMQTTL retries · DLQ · VIPWorkersrisk · payoutsPostgreSQLStripe (test)crypto simulatorPlatform CoreKafkaevents
  • Back office → Payouts API
  • Payouts API → RabbitMQ (jobs)
  • RabbitMQ → Workers
  • Workers → Stripe (test)
  • Workers → Platform Core (deposit · withdraw)
  • Workers → PostgreSQL
  • PostgreSQL → Kafka (outbox)

Simplificado a partir de la descripción del proyecto; el repositorio es privado.

Tres decisiones técnicas

  1. RabbitMQ para trabajos, Kafka para eventos

    Los trabajos van a RabbitMQ (reintentos con TTL, dead-letter, prioridad VIP, ack manual) con entrega al menos una vez y consumidores idempotentes, así cada petición tiene un único efecto. Los hechos a los que se suscriben otros servicios salen por un outbox transaccional hacia Kafka.

  2. Puntuación de riesgo con revisión humana

    Las retiradas se puntúan y las arriesgadas esperan revisión manual, así la automatización acelera el caso normal sin aprobar el peligroso.

  3. La conciliación como funcionalidad

    Los registros del proveedor y el libro mayor se comparan a propósito, así cualquier descuadre aparece en vez de descubrirse tarde.

Pruebas, con cifras

  • 57 tests con PostgreSQL y RabbitMQ reales.
  • 7 fallos introducidos a propósito, todos detectados; por ejemplo, un worker caído a mitad de trabajo, un mensaje que agota los reintentos y un webhook duplicado.

Verificado

  • Integrado con Platform Core.

Lo que no se afirma

  • Stripe funciona en modo test; la parte cripto es simulada.
  • Las cifras salen de pruebas, no de tráfico en producción.

Stack

  • NestJS
  • PostgreSQL
  • RabbitMQ
  • Kafka
  • Stripe (test)
  • Docker

Repositorio privado · revisión del código bajo petición