Cuentas de usuario y perfiles

OfferHub separa identidad de usuario, cuentas financieras, y aplicación de escrow en sistemas distintos.

Esta separación es intencional y requerida para:

• minimizar el riesgo de custodia,

• evitar almacenar datos financieros sensibles,

• mantener compatibilidad con el alcance de la API de Airtm,

• mantener Trustless Work enfocado en la aplicación.

---

Responsabilidades del Sistema

OfferHub + Supabase (Identidad y Perfil)

Manejado por Supabase.

Responsabilidades:

• registro e inicio de sesión de usuarios

• autenticación y sesiones

• datos de perfil del marketplace

• roles de usuario (comprador / vendedor)

• vinculación de cuentas externas (referencia Airtm)

Se recomienda Supabase porque proporciona:

• auth (correo electrónico, OAuth, magic links)

• seguridad a nivel de fila

• auditabilidad

• fácil integración con servicios backend

---

Airtm (Cuenta Financiera y KYC)

Manejado íntegramente por Airtm.

Responsabilidades:

• KYC y cumplimiento

• creación de cuentas financieras

• saldos

• depósitos (recargas)

• retiros (pagos)

• cuentas bancarias virtuales y pasarelas locales

OfferHub no no almacena:

• documentos de identidad

• detalles bancarios

• saldos

---

Trustless Work (Escrow y Aplicación)

Manejado por Trustless Work en Stellar.

Responsabilidades:

• creación de escrow por orden

• seguimiento de hitos

• estados de disputa

• aplicación de liberaciones y reembolsos

Trustless Work nunca gestiona a los usuarios directamente. Solo aplica roles y firmas.

---

Flujo de Creación de Usuario (Referencia)

Paso 1 — Registro e Inicio de Sesión

Usuario → UI de OfferHub
UI de OfferHub → Supabase Auth
Supabase → Sesión de usuario establecida

En este punto:

• el usuario existe en OfferHub

• el usuario tiene un registro de perfil

• aún no se permiten acciones financieras

Paso 2 — Vinculación de Cuenta Airtm (KYC)

Cuando el usuario intenta una acción financiera (recarga, venta, retiro):

OfferHub → Verificar: ¿Airtm vinculada?
Si NO:
  → Redirigir al usuario al onboarding alojado por Airtm

El usuario completa en Airtm:

• registro o inicio de sesión

• verificación de identidad (KYC)

• preparación de la cuenta

---

Paso 3 — Callback y Vinculación de Airtm

Airtm → redirección/callback a OfferHub
OfferHub recibe:
  - airtm_user_id (o referencia)

OfferHub almacena la referencia en Supabase:

{
  "user_id": "offerhub_user_123",
  "airtm_user_id": "airtm_user_abc"
}

No se almacenan credenciales ni saldos.

---

Paso 4 — Usuario Habilitado Financieramente

Después de la vinculación:

• el usuario puede recargar saldo

• el usuario puede financiar escrows

• el usuario puede recibir pagos

Todas las acciones financieras se orquestan a través de las APIs de Airtm usando la identidad vinculada.

---

Por qué se usa este modelo

Por qué Supabase maneja los perfiles

• La identidad del marketplace ≠ identidad financiera

• Control de acceso más limpio

• Gestión de roles más sencilla (comprador / vendedor)

• Evita la expansión del alcance de cumplimiento

Por qué Airtm maneja KYC

• Entidad regulada

• Diseñado específicamente para el cumplimiento financiero

• Evita duplicar los flujos de KYC

Por qué OfferHub solo orquesta

• Reduce el riesgo legal y técnico

• Mantiene la arquitectura modular

• Hace que la plantilla sea reutilizable con otros proveedores

---

Diagrama de Secuencia (Simplificado)

Usuario → UI → Supabase (registro/inicio de sesión)
Usuario → UI → Airtm (onboarding KYC)
Airtm → OfferHub (referencia del usuario)
OfferHub → Supabase (vinculación almacenada)

---

Restricción de Diseño (Importante)

OfferHub no debe:

• crear usuarios de Airtm vía API

• almacenar documentos KYC

• actuar como custodio

Si una plataforma requiere control custodial completo, OfferHub no es el patrón correcto.

---

Resumen

OfferHub trata:

• Supabase como el sistema de registro para usuarios

• Airtm como el sistema de registro para el dinero

• Trustless Work como el sistema de registro para la aplicación de escrow

OfferHub en sí permanece como una capa de orquestación.