Hub Experiências

VIVA MOMENTOS ÚNICOS

❤❤❤❤❤❤❤❤❤
MenuTodos os menus

ExperienceHub

Documentação

Documentação — Plataforma Experiências HUB

Missão: Transformamos talentos, saberes e paixões em experiências inesquecíveis. Domínio: experienciashub.com.br Stack: Base44 (entidades, CRUD, funções de backend) + React + Tailwind CSS + Vite

1. Visão Geral

O Experiências HUB é um marketplace de vivências que combina marketplace de experiências, loja de ofertas, serviços, gamificação social, recrutamento (HUB Talentos), treinamento de equipes (Curso DNA), um passaporte de cidade (Passaporte HUB), mídia/publicidade (Mídia HUB), um feed social (Jornal HUB) e um sistema completo de ingressos para eventos.

A plataforma atende 3 grandes mundos:

  • Participante — explora, reserva, avalia, favorita, vive em grupo.
  • Anfitrião — publica experiências e ofertas, recebe reservas e pagamentos.
  • Arquiteto de Experiências — programa (business-in-a-box) para representar a plataforma na cidade e ganhar comissão.

2. Sistemas e Funcionalidades Implementados

2.1 Chave Dourada

Caça ao tesouro do Passaporte HUB via QR Codes secretos espalhados pela cidade.

  • Turista escaneia o QR (ou abre experienciashub.com.br/ChaveDourada).
  • Câmera mostra uma chave dourada flutuante em AR sobre o ambiente.
  • "Pegar a Chave" valida e contabiliza a experiência como vivida no Passaporte (selo + progresso).
  • Quem não tem Passaporte é conduzido ao cadastro.
  • Admin gera e imprime QR Codes a partir de desbloqueios secretos (AdminChaveDourada).
  • Impressão: arte sofisticada (fundo roxo, logo, rodapé), layout A4 (1 ou 4 por folha), sem bordas arredondadas.

2.2 HUB Talentos (vertical de recrutamento)

Conecta candidatos a empresas parceiras com funil de 4 estágios: Candidato HUB → Em Preparação → Preparado HUB → Sinergético.

  • Candidatos: menu Passaporte Profissional — perfil gratuito; primeiro passo é seguir o @experienciashub.com.br. Preenche cargo, experiência, disponibilidade, mobilidade, idiomas e competências.
  • Empresas/RH: cadastro em CadastrarEmpresa, publicação de vagas em PublicarVaga (IA traduz cargo em tarefa, competências e impacto esperado), pipeline em GerenciarVagas.
  • Modelos: HUBVaga e HUBCandidato.
  • Processos seletivos segregados por vaga (job-scoped), sem estados de funil globais.
  • Matching com motivos concretos e lacunas — sem scores inventados.
  • Perfil do candidato estruturado como argumento de contratação por evidências (não currículo).
  • Sinergéticos com 30% de progresso no curso recebem selo "Sinergético em avanço".

2.3 Curso "Equipes que crescem" (Curso DNA da Experiência)

Treinamento oficial estilo Netflix: trilhas de cursos → módulos → aulas (vídeo ou texto).

  • Progresso salvo automaticamente, favoritos, comentários, certificado.
  • Lives com lembretes automáticos e avisos no painel.
  • ProdutorDNA cria cursos, módulos, aulas e agenda lives.
  • Acesso por inscrição (PIX, com turmas/vagas) ou concedido pelo admin/Arquiteto a funcionários sinergéticos.
  • Validação de acesso em AcessoCurso.

2.4 Campanha do livro "Como criar uma experiência em sua empresa" (Crowdfunding)

  • Menu Compre o livro / /crowdfunding.
  • Recompensas por nível de apoio; a partir de R$ 100 recebe o livro digital "As Sinergias".
  • Meta, orçamento, transparência e Mural de Fundadores.
  • Pagamento por PIX/cartão, recompensa entregue digitalmente.

2.5 Camada social "Experiência HUB" (Feed / Jornal HUB)

Feed social da plataforma com 3 formatos de publicação:

  • Memória — relato de experiência vivida, com foto/vídeo e vínculo (botão Quero Viver).
  • Evento na cidade — divulgação de evento público (data, local, categoria), selo "Acontecerá".
  • Notícia — link externo com título, fonte e link original.
  • Visibilidade (público/só amigos/privada), comentários, compartilhamento.
  • Faixa de amigos no topo do feed.
  • Vagas do HUB Talentos caem automaticamente no Jornal.

2.6 Repórter HUB

Canal de contribuição cidadã — "você vive, você registra, o HUB revela".

  • Categorias de descoberta: Riqueza invisível, Descubra isso, Curiosidade, Aconteceu aqui, Segredo da cidade, além de Experiência acontecendo, Novidade, História local, Dica, Bastidores, Alerta, Achado HUB, Agenda, Relato.
  • Fluxo de moderação: submitted → under_review → approved → published.
  • Consentimentos obrigatórios (autoria, direitos, análise editorial, publicação).
  • Selo editorial (informação verificada, conteúdo revisado, relato pessoal).
  • Minhas Contribuições no perfil do autor.

2.7 Batalha HUB (gamificação social)

Duas experiências lado a lado; a comunidade escolhe qual viveria.

  • Votos entram no placar; categorias configuráveis pelo admin (battle_categories em Settings).
  • Janelas de votação (start_at/end_at), status (draft/scheduled/active/finished/archived).
  • Imagem OpenGraph temática gerada por IA (generateBattleOGImage).
  • Pode nascer de um Repórter HUB (source_report_id).
  • Meta tags próprias de compartilhamento na página /BatalhaHub.

2.8 Controles de governança de conteúdo no Feed

  • Autores têm controle de edição e deleção (menu de 3 pontinhos) em todos os itens.
  • Selo discreto de tipo de post (Notícia, Evento, Vaga, Memória, Postagem).
  • Moderação de vídeos (AdminFeedVideos), anúncios do feed (AdminFeedAds).

2.9 Newsletter para seguidores de empresas

  • Empresas são seguidas (botão "Seguir" no perfil público e em cards de experiência).
  • Canais de notificação ativos por padrão: In-app + Push + E-mail.
  • Ao publicar nova experiência, seguidores são notificados (notifyCompanyFollowers).

2.10 Gate de Premium Conheça

  • Empresas precisam de plano Premium Conheça ativo para criar e vender Gifts (configurável).

2.11 Gift Experience HUB

Módulo de vales-presente para empresas.

  • Planos: Ondemand (pay-per-sale) ou mensais (Start R$97/5%, Pro R$197/3,5%, Premium R$397/2%).
  • Gift criado a partir de uma experiência, com preço, validade e termos.
  • Cada compra gera voucher com código único e QR Code (GiftVoucher).
  • Resgate validado em /gift/validate/:token.
  • Marketplace público (GiftMarketplace), página pública /gift/:slug.
  • Auditoria completa (GiftAuditLog).
  • Painéis: GerenciarGifts (empresa) e AdminGifts (admin).

2.12 QUERO VIVER (motor de descoberta pessoal)

  • Botão QUERO VIVER em cada experiência (ao lado de COMPRAR) → lista de desejos.
  • Sinaliza estados de desejo que guiam recomendações (Roleta, Home, Perfil).
  • MeuQueroViver reúne tudo o que você sonha em viver.

2.13 Listas Sociais

Grupo decide juntos o que viver (fim de semana, aniversário, rolê).

  • Criar lista com título, descrição e capa (upload ou gerada por IA — cover_url).
  • Adicionar experiências candidatas, convidar membros por e-mail.
  • Acesso segregado: só dono e membros convidados conseguem abrir a lista (RLS por member_emails).
  • Votação (Quero Viver / Não); a mais votada vira a escolhida.
  • Compartilhamento por link com domínio customizado.
  • Dono pode arquivar, reservar ou apagar (com confirmação no GreenDialog — remoção em cascata de votos).
  • Backend experienceListAction (criação, adicionar item, votação, detalhe, deleção).

2.14 Momentos da Vida

Fluxo guiado para montar uma Lista Social a partir de uma ocasião.

  • Escolhe a ocasião, ajusta cidade/orçamento, dá título/capa, cura experiências sugeridas → lista pronta para convidar e votar.

2.15 Perfil de Experiências (DNA de Viajante)

Retrato pessoal de explorador: categorias mais vividas, cidades, total de vivências, avaliações e o DNA de Viajante.

  • Alimenta Roleta da Experiência e a Home.

2.16 Integração do DNA na Roleta / Home / Passaporte HUB

  • DNA de Viajante é usado pela Roleta, pela Home e pelo Passaporte para recomendações personalizadas.

2.17 Sistema completo de gestão e venda de ingressos

  • Categorias Workshop, Música e Shows/Eventos funcionam como eventos com ingressos.
  • Venda por lotes (EventTicketLot): preço, quantidade, min/max por pedido, janela de vendas.
  • Checkout com nome completo e documento (CPF/RG) obrigatórios (EventTicket).
  • Pagamento PIX (Asaas) ou Pagamento Direto manual (admin) — campo payment_method.
  • Cada ingresso tem QR Code único (qr_token) para check-in.
  • Check-in unificado com scanner de QR e input manual (EscanearIngresso, ticketCheckIn).
  • Meus Ingressos com design temático de ticket físico, arte de capa e modal de ampliação de QR.
  • Topo dos ingressos padronizado: fundo roxo fixo + logo do HUB.
  • Recarga forçada de lotes/vendas ao expandir painel do organizador (evita dados estagnados).
  • Resgate de vouchers atômico no backend.
  • Reembolso de pedido inteiro pelo painel do organizador (refundTicketOrder).

3. Pagamentos e Financeiro

  • Gateways: Stripe (cartão) e Asaas (PIX brasileiro) + Pagar.me.
  • Split de pagamento em grupo: individual ou split bill (itens do cardápio divididos).
  • Taxas da plataforma configuráveis em Settings (experiências, serviços, gifts, ISS).
  • Administradores isentos de ativar carteira Asaas — pagamentos direcionados à conta-pai da plataforma.
  • Pagamento Direto (manual) liberado para admin no checkout de experiências e ingressos.
  • Aprovação unificada de pagamentos manuais em AdminPaymentApproval.
  • Carteira e saques do anfitrião (HostWallet, AdminWithdrawals).
  • Subcontas Asaas (createAsaasSubaccount).
  • Saques processados pelo admin.

4. Gamificação (Passaporte de Experiências)

  • XP (sobe de nível, desbloqueia títulos) e Experiência Coins (moeda social resgatável).
  • Missões Semanais e Desafios com recompensas resgatáveis.
  • Selos/medalhas (bronze à diamante).
  • Perfil público compartilhável.
  • Ranking da Cidade e Cidade vs Cidade (XP somado por cidade).
  • Mural de Memórias (feed social de fotos).
  • Convide um Amigo (indicação com código/link).
  • Cartão Pós-Experiência e Cartão Pós-Serviço (avaliação pós-vivência).

5. Passaporte HUB (passe pago da cidade)

Passe pago, válido por dias, que desbloqueia experiências e segredos pela cidade.

  • Hero da cidade ativa, preço, validade, total de experiências inclusas.
  • Abas: Descobrir, Rotas, Perto de Mim.
  • Rotas HUB — trilhas temáticas com Experiência Final; modal de clímax ao concluir.
  • Para você — recomendações inteligentes (continuar rota, afinidade de selo, categoria preferida).
  • Validação presencial via QR do parceiro.
  • Painel do Parceiro (PassaporteParceiro) para validar clientes.
  • Admin (AdminPassaporteHub): Passaportes, Rotas, Aprovações, Funil de Jornada, Validações.
  • Arquitetura de validação: módulo compartilhado passportValidation.ts (auto-desbloqueio e validação manual).
  • Reconciliação de compra (reconcilePassportPurchase).

6. Outros Módulos

| Módulo | Descrição | |---|---| | Loja de Ofertas | "Groupon" interno com cupons resgatáveis presencialmente | | Serviços | Marketplace de Parceiros Independentes (sem vínculo empregatício) | | Experience Car | Passeio de carro com preço por km, rastreio em tempo real | | Conheça | Fichas institucionais de empresas locais | | Descobrir | Guia editorial de pontos turísticos | | Patrocínio de pontos | Empresas patrocinam pontos turísticos (assinatura R$ 18,99/mês) | | Mídia HUB | Venda de espaços de banner patrocinados | | Impulsionar Instagram | Créditos + Meta Ads para Reels do @experienciashub.com.br | | Top 50 Campos do Jordão | Projeto editorial das 50 melhores experiências | | Crowdfunding | Apoio ao projeto + livro "As Sinergias" | | Amigos | Rede de conexões (solicitar, aceitar, amigos em comum) | | Feed de Vídeos | Feed de mídia curta (fotos/vídeos até 1min) com anúncios | | DNA Profissional / Liga DNA | Desempenho de funcionários, Ranking por temporada | | Contrate um Sinergético | Marketplace de profissionais com DNA avaliado | | Arquiteto de Experiências | Licença anual, comissão por vendas, captação de leads |

7. Comunidade e Rede Social

  • Amigos com avatares reais (superando RLS via backend getFriendsProfiles).
  • Avatares de amigos com destaque visual (tamanho aumentado e anéis dourados) no feed e componentes.
  • Jornal HUB, Feed de Vídeos, Mural de Memórias, Álbum Missão HUB.
  • Repórter HUB e Batalha HUB para engajamento.

8. Mobile / App Nativo

  • Build nativo para iOS/Android a partir do mesmo código.
  • Bottom tabs nativos, transições de página, back stack nativo.
  • Marcação de usuários mobile para push via Firebase (markMobileUser).
  • Push notifications (sendPushNotification).
  • Áreas seguras (safe areas) no app nativo.
  • Upload de mídia pelo celular (MobileCapture, MobileUpload).

9. Integrações e Conectores

  • Meta Ads (ads_management, pages_manage_ads, etc.) — impulsionamento.
  • Instagram (business_basic, manage_comments, manage_messages, content_publish).
  • Google Drive (workspace connector "Google Drive - Processos", modo all).
  • Google Maps — autocomplete de endereços, mapas.
  • Asaas, Stripe, Pagar.me — pagamentos.
  • Firebase — push notifications.

10. Notificações

  • Canais: In-app (sino), Push (mobile), E-mail.
  • Workflows de notificação: nova reserva, nova candidatura, nova mensagem, nova avaliação, nova contratação de serviço.
  • Lembretes de lives (Curso DNA e lives gerais).
  • Newsletter de nova experiência para seguidores de empresa.
  • Recuperação de carrinho abandonado.

11. Funções de Backend (destaques)

  • experienceListAction — Listas Sociais (criar, adicionar, votar, detalhe, deletar).
  • createTicketPurchase / ticketCheckIn / refundTicketOrder / getEventLots / getEventTicketSales — ingressos.
  • createGiftExperience / createGiftPurchase / redeemGiftVoucher / validateGiftVoucherPublic / giftAdmin / giftPublic — Gifts.
  • createVaga / recommendCandidatesForVaga / syncHubCandidatoStage — HUB Talentos.
  • voteBattle / battleAdmin / getBattleResults / generateBattleOGImage — Batalha HUB.
  • reportSubmit / reportModeration / reportSocialContent — Repórter HUB.
  • socialFeed / socialPostAction / socialCommentAction — Feed social.
  • createPassportPurchase / usePassportUnlock / validatePassportUnlock / publishUnlock — Passaporte HUB.
  • asaasWebhook / stripeWebhook / pagarmeWebhook — webhooks de pagamento.
  • notifyCompanyFollowers / notifyEntityEvent / sendEmailNotification / sendPushNotification — notificações.

12. Segurança e RLS

Row-Level Security configurado por entidade para isolar dados por dono/membro/admin.

  • Listas Sociais: leitura restrita a dono + member_emails + admin.
  • Ingressos/Gifts/Vagas: leitura restrita ao comprador/dono/empresa + admin.
  • Escrita de registros ancorada em e-mail do auth (nunca confiado do frontend).
  • Votos e batalhas: um por usuário; recontagem atômica no backend.

13. UI/UX e Estética

  • Paleta sofisticada: roxo uva, dourado, fontes serifadas (Libre Baskerville + Inter).
  • GreenDialog — modal customizado para confirmações críticas (substitui window.confirm).
  • Categorias HUB com animação dourada (respiração + brilho).
  • Banner rotativo Ton ↔ Cora no topo das páginas de anunciante (alternância a cada 5s).
  • Toque temático em ingressos, capas de listas e passaporte.

14. Documentação e Onboarding

  • Tutorial (/Tutorial) — guia completo de cada função, com busca e atalhos por #hash.
  • Seções adicionadas: Quero Viver, Roleta da Experiência, Listas Sociais, Momentos da Vida, Perfil de Experiências, Batalha HUB, Eventos/Ingressos, Meus Ingressos, Escanear Ingresso, Gift Experience HUB.
  • Inicie Aqui — onboarding por Typebot.

15. Decisões Arquiteturais

  • Base44 como infraestrutura principal (entidades, CRUD, funções de backend).
  • Chave Dourada integrada ao Passaporte HUB.
  • Módulo compartilhado passportValidation.ts para auto-desbloqueio e validação manual.
  • Fluxos separados: Criação de Experiências (ofertas/produtos) vs Eventos (ingressos/tickets).
  • Resgate de vouchers atômico no backend.
  • Denormalização controlada para performance (contadores, títulos, capas) — sempre recalculados no backend.
  • Domínio customizado (experienciashub.com.br) em links de compartilhamento.

16. Limitações Conhecidas

  • Automação de DM no Instagram para novos seguidores não é possível via API/conector atual.
  • Facebook mantém cache antigo de prévia de compartilhamento para batalhas.
  • Campos do modal "Generate Google Play files" (Firebase/Google Services) ausentes na plataforma de build.
  • Logo do Base44 visível no login Google em builds nativos (APK/iOS).
  • Persistência de sessão no primeiro login via Google em builds APK (WebView).

Última atualização: 2026-09-24