branding.manage
Cria, edita e remove parametrizações de identidade visual para clientes do tenant.
Rota /branding
Configuração de Identidade Visual.
O módulo de branding permite customizar a interface visual (white-label) do portal de benefícios para cada cliente. Você pode definir paletas de cores exclusivas, logotipos e mensagens personalizadas por empresa contratante.
customers.read
Permite carregar a lista de clientes para associar as configurações de marca.
Recursos de customização
Branding por Cliente
1. White-labeling Dinâmico
As configurações de branding são carregadas com base no cliente selecionado. Quando o beneficiário daquele cliente faz login, o portal se adapta inteiramente às cores e logos dele.
2. Customizador de Cores
O formulário possui seletores visuais nativos (color picker) para Cor Primária, Destaque, Fundo e Texto, aplicando a visualização em tempo real.
3. Pré-visualização
Ajuda a testar o contraste de legibilidade das fontes contra os fundos antes de efetivar e salvar o branding no banco.
Campos principais
Campos do Formulário de Branding
| Campo | API / Payload | Descrição |
|---|---|---|
| Cliente Vinculado | customerId | Obrigatorio. Define qual cliente receberá a identidade visual personalizada. |
| Nome de Exibição | displayName | Obrigatorio. Nome principal do cliente exibido no cabeçalho do portal. |
| Nome Curto | shortName | Opcional. Abreviação usada em áreas de espaço restrito (como menus compactos). |
| Texto de Boas-Vindas | welcomeText | Opcional. Texto descritivo exibido na tela de login do portal do beneficiário. |
| Cor Primária | primaryColor | Obrigatorio. Código hexadecimal (Ex: #178A43) para botões e menus principais. |
| Cor de Destaque | accentColor | Obrigatorio. Código hexadecimal (Ex: #008CA4) para badges, links e hovers. |
| Cor de Fundo | backgroundColor | Obrigatorio. Código hexadecimal (Ex: #F5F9F6) para o fundo da página do portal. |
| Cor do Texto | textColor | Obrigatorio. Código hexadecimal (Ex: #0F172A) para títulos e corpo do texto. |
| Logotipo Personalizado | logoDataUrl | Opcional. Imagem em Base64 que substitui o logo Harper padrão no portal. |
Regras de integridade
Validações importantes
Limite do Logotipo
O logotipo deve ser carregado como imagem válida (PNG, JPG, SVG) com tamanho limite de 350 KB para preservar a performance de rede do portal.
Contraste de Acessibilidade
Evite utilizar cores com baixo contraste (ex: texto amarelo sobre fundo branco) para assegurar que beneficiários consigam ler a carteirinha digital.
Branding Ativo
Somente parametrizações com isActive como true serão aplicadas. Você pode desativar temporariamente para voltar ao padrão Harper.
Checklist Operacional
Revisão antes de aplicar
O cliente associado foi selecionado corretamente no campo de busca.
O logotipo está centralizado, sem cortes e dentro do limite de 350KB.
O contraste entre a 'Cor do Texto' e a 'Cor de Fundo' foi revisado visualmente.
A 'Cor Primária' e a 'Cor de Destaque' estão alinhadas com o manual de marca do cliente.
O switch 'Ativo' foi ligado antes de salvar para aplicar a identidade ao portal do beneficiário.