Na Azos Softhouse, seguimos evoluindo o Superapp com as necessidades dos provedores e de seus clientes. Hoje apresentamos a Release 3.17.5.
Depois da chegada do Superapp Web na 3.10.0, esta entrega amplia a experiência no aplicativo e no navegador: o Clube de Vantagens Urbis chegou, a apresentação passa a ser configurada pelo painel e a senha provisória ganha um fluxo próprio de troca.
🎁 Clube de Vantagens Urbis
Anunciado na release anterior, o Clube Urbis agora faz parte do Superapp. O cliente pode descobrir parceiros, consultar benefícios e acessar descontos diretamente no app e no Superapp Web.
- Parceiros organizados por categoria, com busca e destaques;
- Página do parceiro com informações, benefícios e acesso ao site;
- Consulta e geração de vouchers para os benefícios disponíveis;
- Na web, ativação de cashback com link rastreado, consulta de saldo e extrato;
- Banners próprios do clube e atalhos na home.
 |  |
Controle pelo painel
O painel reúne a ativação do módulo, a seleção dos parceiros, a gestão dos clientes e os banners do clube. O provedor pode escolher quais parceiros aparecem para sua base e personalizar o visual com os novos tokens de tema.
Dashboard do clube
Uma nova área de acompanhamento reúne indicadores de visitas, usuários, estabelecimentos e utilizações, evolução da base e rankings de engajamento. Os filtros de período e a exportação em CSV ajudam a acompanhar os resultados do clube por provedor.
Também no Superapp Web
O clube também está disponível no navegador, com páginas de parceiros e benefícios, vouchers e recursos de cashback. A navegação recebeu ajustes para facilitar o retorno às telas anteriores e manter o item ativo dos menus consistente.
🖼️ Apresentação do app configurável
O painel ganhou um editor para a apresentação inicial e o tour guiado. Agora o provedor pode ajustar a recepção do cliente sem alterar o código do aplicativo.
- Personalização de títulos, descrições, ícones e imagens;
- Ajustes de cor do texto e degradê;
- Inclusão, organização e ativação dos slides de apresentação;
- Configuração dos passos disponíveis do tour;
- Prévia da apresentação no próprio painel;
- Aplicação das configurações no app e no Superapp Web.
🔐 Troca de senha provisória
Quando a senha é definida pelo painel, o cliente passa a receber a solicitação de criar sua própria senha no app e na web. O fluxo também contempla senhas automáticas baseadas no documento quando a opção de troca obrigatória está habilitada.
Depois que o cliente define a nova senha, a pendência é encerrada. A experiência usa uma tela específica para orientar a troca.
✨ Ajustes de experiência
- Segmentação do Descubra Mais pelos planos consultados diretamente no IXC, com validação também na API;
- Ajustes nos cards da home, na escala da pesquisa NPS e nos ícones do perfil do app;
- Melhorias de responsividade e aplicação da cor primária no painel;
- Lista e abas do clube refinadas no painel administrativo.
🎁 O que já está a caminho
Aceite eletrônico
Retomamos o aceite eletrônico entre os próximos passos do Superapp. O módulo segue em desenvolvimento, com a base de consulta das assinaturas pendentes, para permitir o aceite de contratos e termos diretamente pelo aplicativo. A conclusão desse fluxo será apresentada em uma próxima release.
⚙️ Evoluções técnicas
Gateway Urbis
- Novo serviço em Bun, Elysia e Zod, centralizando o cliente HTTP e a validação das respostas da Urbis;
- Autenticação entre serviços com segredo do gateway e identificação do tenant, mantendo as credenciais da Urbis no servidor;
- Reuso da sessão, renovação antecipada do token e uma única autenticação compartilhada entre chamadas concorrentes;
- Timeout nas requisições e uma nova tentativa de autenticação em respostas 401 da sessão do gestor;
- Agregações do dashboard isoladas por tag do tenant, com cache em memória de 30 segundos;
- Exportação CSV usando o mesmo tratamento de sessão e erros das chamadas JSON.
API
- Camada de integração api-app → urbis-gateway → Urbis com limite de 20 segundos nas chamadas ao gateway;
- Normalização das falhas de integração no contrato de erros da API, sem confundir um 401 do gateway com expiração da sessão do cliente;
- Novo canal clube no WebSocket e propagação das alterações pelo webhook;
- Novo campo mustChangePassword nas respostas de autenticação;
- Configuração da apresentação entregue pela API com URLs assinadas das imagens.
Painel administrativo
- Editor de apresentação com validação por Zod e verificação de permissões no servidor;
- Persistência da configuração com jsonb_set, atualizando a chave de onboarding;
- Upload de imagens para S3 e URLs assinadas para prévia;
- Funções de servidor para o dashboard e a integração do clube;
- Novos tokens de tema e componente de degradê para as interfaces do clube.
Aplicativo e Superapp Web
- Novas rotas, serviços e componentes para parceiros, benefícios e vouchers;
- Atualização do clube por WebSocket no app e por SSE na web, com invalidação do router e das consultas React Query;
- Normalização da configuração de onboarding e adaptação da apresentação e do tour nas duas interfaces;
- Tratamento de HTML dos benefícios em utilitários próprios;
- Atualização do estado de autenticação após a troca de senha;
- Atualização das dependências do aplicativo, incluindo exigência de Axios 1.20.0 ou posterior.
📲 Atualização do aplicativo
Para receber os novos recursos no aplicativo, solicite o upgrade para versão 3.17.5 ou posterior.
🚀 Seguimos evoluindo
A Release 3.17.5 amplia o Superapp com benefícios integrados e mais autonomia para personalizar a experiência do cliente.
Seguimos evoluindo nossa tecnologia com cada jornada.
Carlos David Romão B. — CTO, Azos Softhouse