Contas e perfis de usuário

OfferHub separa identidade do usuário, contas financeiras, e aplicação de custódia (escrow) em sistemas distintos.

Essa separação é intencional e necessária para:

• minimizar o risco de custódia,

• evitar armazenar dados financeiros sensíveis,

• manter compatibilidade com o escopo da API da Airtm,

• manter o Trustless Work focado na aplicação (enforcement).

---

Responsabilidades do Sistema

OfferHub + Supabase (Identidade & Perfil)

Gerenciado por Supabase.

Responsabilidades:

• registro e login do usuário

• autenticação e sessões

• dados de perfil do marketplace

• papéis de usuário (comprador / vendedor)

• vinculação de contas externas (referência Airtm)

Recomenda-se Supabase porque fornece:

• auth (email, OAuth, magic links)

• segurança em nível de linha

• auditabilidade

• integração fácil com serviços de backend

---

Airtm (Conta Financeira & KYC)

Totalmente gerenciado por Airtm.

Responsabilidades:

• KYC e conformidade

• criação de conta financeira

• saldos

• depósitos (recargas)

• saques (pagamentos)

• contas bancárias virtuais e conexões locais

OfferHub faz não armazenar:

• documentos de identidade

• detalhes bancários

• saldos

---

Trustless Work (Escrow & Aplicação)

Gerenciado por Trustless Work na Stellar.

Responsabilidades:

• criação de custódia por pedido

• rastreamento de marcos

• estados de disputas

• aplicação de liberação e reembolso

O Trustless Work nunca gerencia usuários diretamente. Ele apenas aplica papéis e assinaturas.

---

Fluxo de Criação de Usuário (Referência)

Passo 1 — Registro & Login

Usuário → Interface OfferHub
Interface OfferHub → Supabase Auth
Supabase → Sessão do usuário estabelecida

Neste ponto:

• o usuário existe no OfferHub

• o usuário tem um registro de perfil

• ainda não são permitidas ações financeiras

Passo 2 — Vinculação de Conta Airtm (KYC)

Quando o usuário tenta uma ação financeira (recarga, venda, saque):

OfferHub → Verificar: Airtm vinculado?
Se NÃO:
  → Redirecionar o usuário para o onboarding hospedado pela Airtm

O usuário completa na Airtm:

• registro ou login

• verificação de identidade (KYC)

• prontidão da conta

---

Passo 3 — Callback & Vinculação da Airtm

Airtm → Redirecionamento/callback para o OfferHub
OfferHub recebe:
  - airtm_user_id (ou referência)

OfferHub armazena a referência no Supabase:

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

Nenhuma credencial ou saldo é armazenado.

---

Passo 4 — Usuário Está Habilitado Financeiramente

Após a vinculação:

• o usuário pode recarregar o saldo

• o usuário pode financiar custódias

• o usuário pode receber pagamentos

Todas as ações financeiras são orquestradas através das APIs da Airtm usando a identidade vinculada.

---

Por Que Este Modelo é Usado

Por Que o Supabase Gerencia Perfis

• Identidade do marketplace ≠ identidade financeira

• Controle de acesso mais limpo

• Gerenciamento de papéis mais fácil (comprador / vendedor)

• Evita aumento do escopo de conformidade

Por Que a Airtm Gerencia o KYC

• Entidade regulada

• Projetada para conformidade financeira

• Evita duplicar fluxos de KYC

Por Que o OfferHub Apenas Orquestra

• Reduz o risco legal e técnico

• Mantém a arquitetura modular

• Torna o modelo reutilizável com outros provedores

---

Diagrama de Sequência (Simplificado)

Usuário → UI → Supabase (registro/login)
Usuário → UI → Airtm (onboarding KYC)
Airtm → OfferHub (referência do usuário)
OfferHub → Supabase (vínculo armazenado)

---

Restrição de Design (Importante)

OfferHub não deve:

• criar usuários Airtm via API

• armazenar documentos de KYC

• atuar como custodiante

Se uma plataforma exigir controle custodial completo, OfferHub não é o padrão correto.

---

Resumo

OfferHub trata:

• Supabase como o sistema de registro para usuários

• Airtm como o sistema de registro para dinheiro

• Trustless Work como o sistema de registro para aplicação de custódia

O próprio OfferHub permanece como uma camada de orquestração.