Todos os artigos
41 artigos organizados por categoria e seção.
Visão geral
Ver categoriaComo ler esta documentaçãoObjetivo, origem e convenções da Documentação Técnica Consolidada do Projeto Baita, que substitui o PDF de 08/07/2026. 4 min24/08/2026Escopo do Projeto BaitaPanorama de tudo que existe hoje no Baita: pagamentos, integrações, parceiros, sorteios, relatórios e canais de entrada. 6 min24/08/2026Contexto de negócio do BaitaTrês modelos de negócio simultâneos (assinatura paga, base GZH e códigos de acesso) e as regras que atravessam todos os fluxos. 6 min24/08/2026Whitelabels e IDs do BaitaOs dois IDs de whitelabel que representam o Baita, o clube RBS de origem do catálogo e como agrupá-los em cada repositório. 4 min24/08/2026
Identificação e gates
Ver categoriaIntegrações externas
Ver categoriaBaitaIntegration — verificação de assinante GZHEndpoint, contrato, tratamento de erros e o bug histórico de normalização subscriber → isSubscriber, corrigido em produção. 5 min24/08/2026Salesforce Marketing Cloud — Data ExtensionsAuth OAuth2, migração para Data Extension única, payload, bugs corrigidos e o padrão fire-and-forget sem retry. 7 min24/08/2026Metryca — rastreamento de leads e renovaçõesEvento de lead, o novo evento de renovação disparado em 3 pontos e o casamento com o lead capturado no front. 5 min24/08/2026Nova Vida — enriquecimento cadastralPrefill de cadastro exclusivo do Baita, token criptografado por whitelabel e uso resiliente no Saque e Pague. 3 min24/08/2026NFe.io — nota fiscal de serviçoOnde a emissão de NFS-e está ativa hoje e por que ela segue comentada no webhook PIX. 2 min24/08/2026Saque e Pague — assinatura em dinheiroTerceira forma de pagamento do Baita: endpoints, autenticação por API key, concorrência com advisory lock e ciclo de vida. 8 min24/08/2026Baratão Combustíveis — parceiro de posto de gasolinaAutenticação federada por JWT, webhook de compra, onboarding com cupons no Clube e a correção de segurança da accessKey. 7 min24/08/2026Exclusões confirmadas — o que não é BaitaInfoline e a citação de Baratão em template de e-mail: por que ambos não fazem parte do escopo do projeto. 3 min24/08/2026
Cadastro e assinatura (Clube)
Ver categoriaDuas portas de entrada: /assinar e /cadastroDiferença entre o funil exclusivo do Baita e o fluxo unificado config-driven, com a configuração aplicada ao clube. 4 min24/08/2026Reestruturação do fluxo Baita RBSHeader com 3 estados, seletor "já é cliente?", cadastro inline no modal de código e a separação dos componentes de pagamento. 7 min24/08/2026Planos exclusivos ocultosRegra de visibilidade de planos no Baita e os 3 casos explícitos de resolveBaitaPlansFilter. 3 min24/08/2026Rastreamento de origem PDV (origin)Como o parâmetro ?pdv= vira comissão: gravação em User.origin, propagação pelo metadata da Pagar.me e uso nos relatórios. 4 min24/08/2026Lead capture — captura de leads parciaisComo o funil salva nome e e-mail antes da conclusão para permitir remarketing de quem abandona o cadastro. 3 min24/08/2026Endereço colapsado no cadastro (ADR-0006)Campo único somente-leitura no step de endereço e as duas válvulas de escape que impedem o usuário de travar. 3 min24/08/2026Confirmação de dados cadastrais antes de sorteio federalExigência regulatória da SPA aplicada a sorteios federais e como ela afeta o modal de sorteio do Baita. 4 min24/08/2026
Pagamentos e ciclo de vida
Ver categoriaPIX via Pagar.me e o webhook de pagamentoOrdem avulsa em vez de recorrência, criação de usuário só na confirmação, idempotência e o gap de HMAC. 8 min24/08/2026Webhook de invoices de cartãoO endpoint de recorrência de cartão, sua idempotência explícita e o problema dos +30 dias fixos. 4 min24/08/2026Relatórios fiscais e unificadosEndpoints que cruzam Pagar.me com dados locais para apuração financeira mensal, com exportação em Excel. 5 min24/08/2026Reativação manual na Data ExtensionEndpoint administrativo criado para corrigir dessincronizações causadas pelo padrão fire-and-forget sem retry. 2 min24/08/2026Jobs e crons de assinaturaRotinas que expiram PIX/cash, reconciliam cartão, renovam token Nova Vida e expiram access codes — e a divergência de branch. 6 min24/08/2026
Sorteios
Ver categoriaRegra de elegibilidade mensal de sorteioCada compra ou renovação dá direito apenas ao sorteio do mês correspondente, com derivação diferente por forma de pagamento. 3 min24/08/2026Bilhete único por sorteio (conformidade regulatória)Cada usuário recebe um único número de 5 dígitos válido para todos os prêmios, ativado por tipo de sorteio e não por UUID. 4 min24/08/2026Geração automática de bilhete (planejado)PRD que propõe eliminar o clique manual "Participar" — não implementado, com pré-requisitos ainda pendentes. 3 min24/08/2026Endpoint dedicado de bilhete no onboardingComo o número da sorte é entregue logo após cadastro ou ativação de código, sem clique manual nesse ponto. 2 min24/08/2026Apuração Oficial de Sorteios no ManagerWorkflow guiado em 4 etapas, modos bidirectional e upward, reservas de aproximação e exportação de planilha via S3/CDN. 9 min24/08/2026PIX exclusivo e configuração de planos no ManagerPor que o método PIX só aparece para o Baita no formulário de planos e o que some quando ele é selecionado. 2 min24/08/2026"Códigos de Acesso" no Manager — pausadoItem de menu exclusivo do Baita desativado na navegação e a branch histórica com QR Code pronta para reativar. 2 min24/08/2026
Access codes e catálogo
Ver categoriaRiscos e débitos técnicos
Ver categoria🔴 Branch local com regressão pronta para ser mescladaO branch fix/gzh-flow-baita reintroduz o bug que classifica assinantes GZH legítimos como não encontrados. 4 min24/08/2026🔴 Webhooks de pagamento sem validação de assinaturaDois webhooks públicos da Pagar.me sem HMAC, mitigados apenas por idempotência, e o padrão correto já existente na base. 3 min24/08/2026🟡 +30 dias fixos em vez de addMonths no webhook de invoiceDivergência de cálculo de vencimento que afeta a elegibilidade de sorteio em bordas de mês. 3 min24/08/2026🟡 Divergência main × develop no urbis-api72 commits em develop que main não tem e 46 no sentido oposto — alinhe antes de assumir o que está em produção. 2 min24/08/2026Débitos já conhecidos desde o PDF anteriorCinco débitos que continuam válidos: nome de plano frágil, example.env incompleto, UUIDs hardcoded, idempotência e logs sensíveis. 3 min24/08/2026
Referência técnica
Ver categoriaVariáveis de ambiente (checklist consolidado)Todas as envs BAITA_*, SAQUE_PAGUE_*, BARATAO_* e afins, com a finalidade de cada uma. 5 min24/08/2026Apêndice — nomenclatura e discrepâncias entre repositóriosComo o mesmo conceito é nomeado em urbis-api, urbis-manager e urbis-club, e por que "Baita RBS" não é um terceiro clube. 3 min24/08/2026