ER_001 - Login e Home BACE

Essa é uma revisão anterior do documento!

A funcionalidade Login e Home BACE é responsável por:

Autenticar os usuários no sistema BACE, garantindo acesso controlado conforme perfil e unidade técnica.
Estabelecer a sessão de trabalho do usuário, vinculando-a ao setor selecionado quando houver mais de uma unidade técnica associada.
Exibir, após o login, a tela inicial (Home) com contextualização do sistema, mural de avisos e central de notificações, facilitando o acesso às demais funcionalidades (Painel, Cadastros, Consultas e Administração).

A autenticação é obrigatória para qualquer uso do BACE, e o conteúdo exibido na Home é filtrado conforme o perfil (Usuário, Auditor, Gestor, Administrador) e unidade técnica do usuário logado.

Usuário:

Pode executar os Fluxos 01 e 02 (Login e visualização da Home).

Auditor:

Pode executar os Fluxos 01 e 02.
Visualiza contadores de Em Elaboração e Propostas com Acórdão na Central de Notificações.

Gestor:

Pode executar os Fluxos 01 e 02.
Visualiza contadores de Em Elaboração, Enviados p/ Revisão e Propostas com Acórdão na Central de Notificações.

Administrador:

Pode executar os Fluxos 01 e 02.
Visualiza todos os indicadores da Central de Notificações.
Pode gerenciar Links Úteis e configurar avisos pela área administrativa do sistema.

Elemento	Tipo	Obrigatório	Valores Possíveis	Valor Padrão	Observação
Usuário	Alfanumérico	Sim	Login institucional	—	Identificação institucional do colaborador.
Senha	Alfanumérico (oculto)	Sim	Livre	—	Campo secreto para autenticação.
Setor	Lista de seleção	Não (condicional)	Unidades técnicas vinculadas ao usuário	—	Exibido somente quando o usuário possui mais de um setor.
Lembrar senha	Checkbox	Não	Marcado / Desmarcado	Desmarcado	Permite manter usuário/senha salvos na estação do usuário.
Esqueceu sua senha?	Link	Não	—	—	Direciona para recuperação/alteração de senha (Keycloak).
Entrar	Botão	—	—	Desabilitado	Habilitado apenas após preenchimento dos campos obrigatórios.

Elemento	Tipo	Obrigatório	Valores Possíveis	Valor Padrão	Observação
Título do Aviso	Alfanumérico	Sim	Texto livre definido na configuração do aviso	—	Identificação principal do aviso exibido ao usuário.
Mensagem do Aviso	Texto longo	Sim	Texto livre definido na configuração do aviso	—	Conteúdo detalhado do aviso; pode conter orientações, comunicados ou lembretes.
Período de Vigência	Informação de datas	Sim	Data inicial e final configuradas na administração do sistema	—	Exibido no canto superior direito; define o intervalo em que o aviso poderá ser apresentado aos usuários.
“Não mostrar novamente”	Checkbox	Não	Marcado / Desmarcado	Desmarcado	Quando marcado, registra preferência para não exibir novamente este aviso ao usuário durante a vigência ou período configurado.
Botão “OK”	Botão	Sim	—	—	Fecha o aviso e registra internamente a leitura; caso o checkbox esteja marcado, registra também a opção de não exibir novamente.
Fechar (X)	Botão/Ícone	Não	—	—	Fecha o aviso sem alterar a vigência; comportamento de registro de leitura segue mesma regra do botão “OK” (conforme definição da regra RN-H11).

Elemento	Tipo	Obrigatório	Valores Possíveis	Valor Padrão	Observação
Contextualização do Sistema	Texto informativo	Não	—	—	Exibe mensagem institucional sobre o BACE e seus objetivos.
Mural de Avisos	Componente de lista dinâmica	Não	Avisos filtrados por perfil, unidade técnica e vigência	—	Usuário pode marcar como “Lido” ou “Não exibir novamente”.
Central de Notificações	Painel de indicadores	Não	Contadores de: Em Elaboração, Enviados p/ Revisão, Propostas com Acórdão	—	Cada indicador possui ação para redirecionar para a tela de consulta correspondente.
Notificação: “Em Elaboração”	Indicador / Link	Não	Número de benefícios em elaboração do auditor logado	—	Visível para Auditor, Gestor e Administrador; redireciona para Consulta BACE filtrando setor, usuário e situação = Em Elaboração.
Notificação: “Enviados p/ Revisão”	Indicador / Link	Não	Total de benefícios em Enviados p/ Revisão do setor do Gestor	—	Visível para Gestor e Administrador; redireciona para Consulta BACE filtrando setor e situação = Enviados p/ Revisão.
Notificação: “Propostas com Acórdão”	Indicador / Link	Não	Contagem de processos com benefício Proposta e acórdão vinculado	—	Visível para Auditor, Gestor e Administrador; redireciona para tela “Pendentes de registro BACE”, filtrando por tipo de documento = Acórdão.
Links Úteis	Lista de links	Não	URLs diversas cadastradas pela Administração	—	Públicos para todos os perfis; apenas Administrador pode incluir/editar/excluir.
Barra Lateral	Menu de navegação	Sim	Menus variam conforme perfil	—	Acesso às funcionalidades: Painel, Cadastros, Consulta BACE, Configurações, etc.
Avisos (🔔)	Botão / indicador	Não	—	—	Exibe notificações recentes e permite acesso ao histórico de avisos.

Passo	Ação	Regra	Tela
01	Usuário acessa o sistema BACE pela URL institucional.	RN-L01	Tela 01
02	Sistema exibe a tela de Login com os campos Usuário, Senha e, quando aplicável, Setor.	RN-L02	Tela 01
03	Usuário informa os campos Usuário e Senha.	RN-L03	Tela 01
04	Caso o usuário tenha mais de um Setor vinculado, o sistema exibe o campo de seleção de Setor para escolha da unidade técnica.	RN-L05	Tela 01
05	Usuário marca ou desmarca a opção Lembrar Senha, se desejar.	RN-L04	Tela 01
06	Sistema habilita o botão Entrar apenas quando os campos obrigatórios estiverem preenchidos.	RN-L03	Tela 01
07	Usuário clica no botão Entrar.	RN-L03	Tela 01
08	Sistema valida credenciais e perfis no Keycloak.	RN-L06	Tela 01
09	Se usuário ou senha estiverem incorretos, o sistema exibe: “Usuário ou senha incorretos.” e mantém o usuário na Tela 01.	RN-L07	Tela 01
10	Se o usuário possuir múltiplos setores, o sistema exibe alerta: “Este usuário tem mais de um setor. Selecione o setor para continuar.” e exige a seleção.	RN-L05	Tela 01
11	Com credenciais válidas e setor definido, o sistema cria sessão do usuário com seu perfil e unidade técnica selecionada.	RN-L08	Tela 01
12	Sistema verifica se já existe sessão ativa com o mesmo usuário em outra unidade; se houver, a nova sessão sobrepõe a anterior.	RN-L09	Tela 01
13	Após autenticação bem-sucedida, o sistema redireciona para a Home BACE.	RN-L10	Tela 02

Passo	Ação	Regra	Tela
01	Após autenticação bem-sucedida, o sistema verifica se existem avisos configurados para exibição em popup pós-login e válidos para o perfil/unidade técnica do usuário.	RN-H01, RN-H02, RN-H03, RN-H11	Tela 02
02	Havendo ao menos um aviso elegível, o sistema exibe a Tela 02 - Aviso pós Login com Título, Mensagem, checkbox “Não mostrar novamente” e botão “OK”.	RN-H01, RN-H11	Tela 02
03	Usuário lê o conteúdo do aviso e, opcionalmente, marca o checkbox “Não mostrar novamente”.	RN-H04, RN-H11, RN-H12	Tela 02
04	Usuário clica no botão “OK” (ou no ícone de fechar).	RN-H11, RN-H12	Tela 02
05	Sistema registra a leitura do aviso para o usuário logado; caso o checkbox esteja marcado, registra também a preferência de não exibir novamente esse aviso durante a vigência/período configurado.	RN-H04, RN-H12, RN-H13	Tela 02
06	Sistema fecha o aviso e redireciona/retorna à Home BACE (Tela 03), exibindo mural, central de notificações e demais componentes normalmente.	RN-L10, RN-H01	Tela 03
07	Em futuros logins dentro da mesma vigência, se houver registro de “Não mostrar novamente” para aquele aviso, o sistema não exibe novamente o popup para esse usuário, mas mantém o aviso disponível no Mural de Avisos (quando configurado).	RN-H03, RN-H04, RN-H12, RN-H13	Tela 03.1
08	Caso existam múltiplos avisos configurados como popup pós-login, o sistema poderá exibi-los sequencialmente, respeitando as mesmas regras de vigência e preferência de “Não mostrar novamente”.	RN-H11, RN-H13	Tela 02

Passo	Ação	Regra	Tela
01	Após login bem-sucedido (ou após fechamento dos avisos pós-login), o sistema exibe o painel inicial com contextualização do BACE.	RN-H01, RN-L10	Tela 03
02	Sistema carrega o Mural de Avisos conforme perfil do usuário e unidade técnica.	RN-H02	Tela 03.1
03	Sistema aplica o período de vigência dos avisos, exibindo apenas aqueles ativos.	RN-H03	Tela 03.1
04	Usuário pode marcar avisos como “Lido” ou “Não mostrar novamente”.	RN-H04	Tela 03.1
05	Sistema registra a ação individual de leitura/ocultação para o usuário logado.	RN-H04	Tela 03.1
06	Sistema carrega a Central de Notificações com contadores automáticos de Benefícios (Em Elaboração, Enviados p/ Revisão, Propostas com Acórdão) conforme perfil.	RN-H05	Tela 03.1
07	Usuário clica em “Ver” em algum indicador da Central de Notificações.	RN-H06	Tela 03.1
08	Sistema redireciona para a tela de Consulta BACE ou Pendentes de registro BACE, aplicando automaticamente filtros de setor, usuário, situação ou tipo de documento conforme o indicador selecionado.	RN-H06, RN-H08, RN-H09, RN-H10	Tela 03
09	Usuário rola a tela até a seção Links Úteis.	RN-H07	Tela 03
10	Sistema exibe a lista de Links Úteis disponíveis.	RN-H07	Tela 03
11	Usuário acessa os menus da barra lateral conforme permissões (Usuário, Auditor, Gestor, Administrador).	RN-L08	Tela 03

Regra	Descrição
<a name=“rn-l01”></a>RN-L01	A autenticação é obrigatória para acessar qualquer funcionalidade do BACE.
<a name=“rn-l02”></a>RN-L02	A tela de Login deve exibir os campos Usuário, Senha e, quando aplicável, Setor.
<a name=“rn-l03”></a>RN-L03	O botão “Entrar” só é habilitado após o preenchimento obrigatório de Usuário e Senha.
<a name=“rn-l04”></a>RN-L04	A opção “Lembrar Senha” permite armazenar dados de sessão localmente; o usuário pode ativar ou desativar essa opção.
<a name=“rn-l05”></a>RN-L05	Usuários vinculados a múltiplos setores devem selecionar a unidade técnica (Setor) antes da conclusão do login; o sistema alerta quando houver mais de um setor.
<a name=“rn-l06”></a>RN-L06	A autenticação é validada pelo Keycloak, incluindo verificação de credenciais, perfis e unidade técnica associada.
<a name=“rn-l07”></a>RN-L07	Em caso de falha de autenticação (usuário ou senha inválidos), o sistema deve exibir a mensagem “Usuário ou senha incorretos.” e não prosseguir para a Home.
<a name=“rn-l08”></a>RN-L08	Cada sessão é iniciada com o perfil e unidade técnica definidos conforme cadastro no SINI e seleção feita na tela de login.
<a name=“rn-l09”></a>RN-L09	Não é permitido uso simultâneo das mesmas credenciais em múltiplas unidades técnicas de forma concorrente; a sessão mais recente sobrepõe a anterior.
<a name=“rn-l10”></a>RN-L10	Login bem-sucedido redireciona o usuário para a Tela Inicial (Home BACE).

Regra	Descrição
<a name=“rn-h01”></a>RN-H01	A Home deve exibir informações institucionais e texto introdutório sobre o BACE logo após o login, salvo quando houver exibição de aviso em popup que é apresentado antes da Home.
<a name=“rn-h02”></a>RN-H02	Avisos (tanto no Mural quanto em popup) são filtrados conforme perfil do usuário (Usuário, Auditor, Gestor, Administrador) e unidade técnica vinculada.
<a name=“rn-h03”></a>RN-H03	Avisos só são exibidos se estiverem dentro do período de vigência (data de início e fim) configurado na administração do sistema. Fora dessa vigência não podem aparecer nem no Mural nem em popup.
<a name=“rn-h04”></a>RN-H04	O usuário pode marcar avisos como “Lido” ou “Não mostrar novamente”; essas ações são registradas individualmente por usuário para controle de exibição futura.
<a name=“rn-h05”></a>RN-H05	A Central de Notificações exibe, de forma automática, contadores de: Benefícios Em Elaboração, Benefícios Enviados p/ Revisão e Propostas com Acórdão, de acordo com as permissões do perfil.
<a name=“rn-h06”></a>RN-H06	Ao clicar em “Ver” em qualquer indicador da Central de Notificações, o sistema deve redirecionar o usuário para a tela de consulta correspondente, aplicando filtros automáticos adequados ao indicador selecionado.
<a name=“rn-h07”></a>RN-H07	Links Úteis são públicos para visualização por todos os perfis, porém apenas o perfil Administrador pode incluir, editar ou excluir esses links na área de Configurações/Administração.
<a name=“rn-h08”></a>RN-H08	Para o indicador “Em Elaboração”, o sistema deve considerar benefícios em elaboração do auditor logado, filtrando por unidade técnica, usuário e situação = Em Elaboração ao abrir a Consulta BACE.
<a name=“rn-h09”></a>RN-H09	Para o indicador “Enviados p/ Revisão”, o sistema deve considerar benefícios do setor do gestor logado, filtrando por unidade técnica e situação = Enviados p/ Revisão ao abrir a Consulta BACE.
<a name=“rn-h10”></a>RN-H10	Para o indicador “Propostas com Acórdão”, o sistema deve considerar processos com benefício em Estado Proposta que possuam acórdão vinculado, redirecionando para a tela “Pendentes de registro BACE” com filtro por tipo de documento = Acórdão.
<a name=“rn-h11”></a>RN-H11	Avisos configurados como “Exibir em popup pós-login” devem ser avaliados logo após a autenticação bem-sucedida; se estiverem vigentes e elegíveis para o usuário, o sistema deve exibi-los na Tela 02 antes de carregar a Home.
<a name=“rn-h12”></a>RN-H12	Ao marcar “Não mostrar novamente” no aviso pós-login e confirmar em “OK”, o sistema deve registrar a preferência do usuário para aquele aviso, impedindo sua reexibição em novos logins durante a vigência ou período configurado.
<a name=“rn-h13”></a>RN-H13	A leitura de avisos em popup deve ser registrada da mesma forma que a leitura no Mural, permitindo rastreamento de quem visualizou o aviso e quando.
<a name=“rn-h14”></a>RN-H14	Quando houver múltiplos avisos configurados como popup e elegíveis ao mesmo usuário, o sistema pode exibi-los de forma sequencial, garantindo que as preferências de “Não mostrar novamente” sejam respeitadas individualmente para cada aviso.