Tela de Seleção de Contexto (Login)

• Data de publicação: 25 de Março de 2026
• Versão necessária: WebClient 2.0.0

Objetivo

Disponibilizar uma tela de seleção de contexto no sistema RUB, permitindo ao usuário definir o ambiente de acesso (Central ou Loja) antes do processo de autenticação.
Essa funcionalidade garante que o login seja direcionado corretamente conforme o contexto escolhido.

Contexto da Demanda

Anteriormente, o acesso ao sistema dependia diretamente de URLs específicas ou parâmetros previamente definidos, o que podia gerar inconsistências de navegação e dificuldades para o usuário ao acessar diferentes contextos.

Com isso:

• O usuário precisava conhecer previamente a URL correta;

• A interface para escolha do contexto não era intuitiva;

• Erros de acesso poderiam ocorrer com parâmetros inválidos.

Com a nova implementação, o RUB passa a oferecer uma tela dedicada para seleção de contexto, tornando o acesso mais intuitivo, seguro e padronizado.

Solução Implementada

Foi criada uma Tela de Seleção de Contexto, apresentada ao acessar o sistema sem um contexto definido ou quando a URL informada é inválida.

A tela permite ao usuário:

• Selecionar o contexto Central;

• Selecionar o contexto Loja;

• Escolher a unidade da loja (quando aplicável);

• Definir o idioma da interface.

Requisitos

• Usuário com acesso ao sistema RUB;
• Contextos devidamente configurados (Central e/ou Loja);
• URLs corretamente configuradas;
• Idiomas disponíveis no sistema.

Comportamento de Acesso por URL

O sistema passa a tratar diferentes cenários de acesso:

• URL correta: direciona para o contexto correspondente ou apresenta a seleção;
• URL incompleta: o sistema ajusta automaticamente e direciona corretamente;
• Contexto inexistente: remove o contexto inválido e exibe a tela de seleção;
• Contexto válido: direciona diretamente para o login do contexto informado.

Funcionamento da Seleção de Contexto

🔹 Contexto Central

Ao selecionar o contexto Central, o sistema direciona o usuário diretamente para a tela de login correspondente.

🔹 Contexto Loja

Ao selecionar o contexto Loja, o sistema:

• Exibe a lista de unidades disponíveis;
• Exige a seleção de uma unidade válida;
• Direciona para o login da loja selecionada.

📌 Caso nenhuma unidade seja selecionada, o sistema impede o avanço.

Seleção de Idioma

A tela permite a escolha do idioma da interface.

Comportamento:

• Estão disponiveis os idiomas Português Br e Espanhol LATAM.
• O idioma selecionado é aplicado em todo o sistema;
• O idioma é mantido mesmo ao alternar entre contextos.

Comportamentos Adicionais

• Ao retornar à tela de seleção após escolher uma loja, o sistema limpa automaticamente a unidade selecionada anteriormente;
• Garante consistência na navegação entre diferentes contextos;
• Evita persistência indevida de dados de sessão.

Benefícios

• Melhor experiência do usuário com navegação mais intuitiva;
• Redução de erros de acesso por URLs incorretas;
• Padronização do processo de login;
• Flexibilidade na escolha de contexto e idioma;
• Maior controle e clareza no acesso ao sistema.