Escopo do Projeto Baita

O Baita é um clube de benefícios whitelabel operado sobre três repositórios: urbis-api (backend), urbis-manager (gestão) e urbis-club (experiência do assinante). Este artigo resume tudo que existe dentro do escopo do projeto.

Assinatura e pagamentos

• Cartão de crédito via Pagar.me, com webhook de invoices e ciclo de vida automatizado por jobs e crons.
• PIX via Pagar.me, incluindo configuração de planos e PIX exclusivo.
• Saque e Pague — pagamento em espécie em correspondente bancário físico, autenticado por API key exclusiva do parceiro, com advisory lock por CPF.

Identificação e integrações externas

• Verificação de assinante GZH (baita-integration) como gate de identificação.
• Salesforce Marketing Cloud com Data Extension única (BAITA_ASSINANTES_FULL).
• Metryca (leads e renovações), Nova Vida (enriquecimento cadastral) e NFE.io (nota fiscal de serviço).

Parceiros e canais de entrada

• Baratão Combustíveis — webview própria, cupons de onboarding e autenticação federada com accessKey em proxy server-side.
• Access codes e canal PDV, com rastreamento de origem para comissionamento por ponto de venda.
• Duas portas de entrada no Club (assinar e cadastro), lead capture e cadastro inline no modal de código.

Sorteios

• Elegibilidade mensal, bilhete único por sorteio (um número por usuário, válido para todos os prêmios) e geração automática de bilhete.
• Apuração Oficial pela Loteria Federal no Manager, com dry-run obrigatório, fallback manual e exportação de planilha.
• Confirmação de dados cadastrais como gate regulatório antes da participação.

Relatórios e operação

• Relatórios fiscais e unificados cruzando Pagar.me com dados locais, com exportação Excel e coluna de PDV Origem.
• Reativação manual na Data Extension e pareamento RBS/Baita.