Lição: Autenticação, Segurança e Permissões

Esta lição cobre como o usuário entra no sistema, como recupera a senha, como gerencia o próprio perfil e — o ponto central — como o Rabi controla quem pode ver e fazer o quê. Ao final você deverá dominar o fluxo de login via Keycloak (SSO), a recuperação de senha, a rota Minha Conta, o logout seguro e o modelo de permissões: a base papel (Role) + 4 ações por módulo e, desde setembro/2026, as permissões granulares por funcionalidade/ação.

✅ ATUALIZAÇÃO IMPORTANTE ✅ Novo — set/2026. As PERMISSÕES GRANULARES (#395) FORAM ENTREGUES em 15/09/2026 e estão em produção: permissões finas por funcionalidade/ação, além da base papel (Role) + 4 ações (VIEW / CREATE / UPDATE / DELETE) por módulo. Versões anteriores desta lição diziam que era "apenas roadmap" — isso não vale mais. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Como acessar o sistema

O Rabi é uma aplicação web (SPA em React/Vite), acessível por qualquer navegador moderno, sem instalação. Endereço de produção:

http://app.rabisistemas.com.br/

Ao abrir o endereço sem estar autenticado, você é redirecionado automaticamente para a tela de login (/login). Navegadores recomendados: Chrome, Edge ou Firefox em versão recente.

⚠️ Acesso não é público. É preciso ter conta previamente cadastrada pelo administrador da clínica. Usuários sem cadastro não conseguem entrar.

A tela de login é gerenciada pelo Keycloak. Elementos:

Elemento	Função
Campo E-mail	E-mail vinculado à conta
Campo Senha	Senha criada no cadastro ou última redefinição
Botão "Entrar"	Confirma as credenciais e inicia a sessão
Link "Esqueci minha senha"	Inicia a recuperação por e-mail

Acesse app.rabisistemas.com.br.
Você é redirecionado para /login.
Informe o e-mail cadastrado pelo administrador.
Informe a senha.
Clique em Entrar.
Validadas as credenciais, você vai ao Dashboard principal.

✅ Novo — ago/2026 Sessão única (#482): o sistema não permite mais o acesso do mesmo usuário em 2 locais ao mesmo tempo. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

⚠️ Segurança de acesso. Nunca compartilhe sua senha. Cada usuário deve ter acesso individual para garantir a rastreabilidade das ações.

Recuperação de senha

É possível redefinir a senha de forma autônoma pelo fluxo do Keycloak:

Na tela de login, clique em "Esqueci minha senha".
Você vai à página de recuperação do Keycloak.
Informe o e-mail da conta e confirme.
Verifique a caixa de entrada (e o spam/lixo eletrônico).
Abra o e-mail e clique no link de redefinição.
Crie a nova senha nos dois campos e confirme.
Volte ao login e entre com a nova senha.

ℹ️ Validade do link. O link de redefinição expira por segurança (geralmente 5 minutos). Se expirar, repita o processo para receber um novo.

⚠️ Conta bloqueada. Muitas tentativas com senha incorreta podem bloquear a conta — o bloqueio por excesso de tentativas é proteção padrão do login, além do limite por IP. Aguarde alguns minutos ou peça desbloqueio ao administrador.

✅ Novo — 13/10/2026 Quem trabalha em mais de uma clínica (#663): a senha e o e-mail desse usuário só podem ser trocados por ele mesmo, pelo "Esqueci minha senha" na tela de login — o administrador da clínica não consegue mais ("Este usuário também tem acesso a outra clínica. A senha e o e-mail só podem ser trocados por ele mesmo…"). Para quem é só de uma clínica, nada muda.

Minha Conta (perfil do usuário)

Após logar, o usuário acessa seus dados de perfil, gerenciados pelo Keycloak. Rota: /portal/minha-conta. A página exibe:

Nome completo do usuário
E-mail cadastrado
Dados de login e segurança
Opção de alterar a senha diretamente
Sessões ativas (dispositivos conectados)
Foto de perfil (upload de avatar) e histórico de atividades — ✅ Novo — 23/10/2026 a própria pessoa pode trocar ou remover a foto
✅ Novo — 23/10/2026 Abas Certificado Digital (cadastrar o certificado ICP-Brasil A1 para assinar receitas) e Numeração SNCR (pedir à Anvisa os números das receitas controladas, entrando com o gov.br) — ver Receitas e SNCR. O acesso do gov.br é usado só no pedido e não fica guardado; o certificado fica guardado criptografado, com autorização do médico (LGPD).

✅ Novo — 23/10/2026 A Home mostra Atividades Recentes e a foto/profissão do usuário; o sistema pode pedir a atualização do perfil ou da senha no próximo login.

ℹ️ Alteração de dados. Alterar nome de exibição/e-mail pode exigir confirmação do administrador conforme a configuração da clínica. A alteração de senha fica disponível diretamente ao usuário.

Logout seguro

Encerre a sessão pela função de logout no menu do perfil — não basta fechar a aba, pois a sessão pode permanecer ativa.

Clique na foto/nome do usuário no canto superior direito (topbar).
No menu, clique em "Sair" (ícone de saída).
Você é desconectado e volta à tela de login.

⚠️ Sempre faça logout. Em computadores compartilhados, deixar a sessão ativa expõe dados sensíveis de pacientes (LGPD) e informações financeiras.

✅ Novo — 13/10/2026 O que o "Sair" faz desde 13–14/10 (#663/#666):

Apaga do navegador tudo o que o Rabi guardou: rascunhos de prontuário, a clínica escolhida e as preferências locais — tema e colunas escolhidas nas listas (Orçamentos/Autorizações voltam ao padrão).
Encerra o acesso em todas as clínicas de uma vez (não fica mais um acesso próprio por clínica no navegador).
Se só a sessão expirou (sem clicar em Sair), os rascunhos válidos ficam; rascunho com mais de 12 horas é descartado.

O sistema também confere o vínculo a cada ação: se a pessoa perdeu o acesso à clínica escolhida, aparece "Seu usuário não tem acesso a esta clínica." e a tela volta sozinha para a clínica do login.

Autenticação com Keycloak (SSO)

O Rabi usa o Keycloak como provedor de identidade centralizado, com o padrão OAuth2 / OpenID Connect. Consequências práticas:

Usuários, senhas e sessões são geridos pelo Keycloak, não pelo Rabi diretamente.
As credenciais nunca trafegam para a aplicação — o Rabi recebe apenas um token de acesso validado.
Suporta Single Sign-On (SSO): uma autenticação dá acesso a sistemas do mesmo realm.
Usa browser flow; Direct Access Grants é desabilitado por segurança.
As sessões expiram após período de inatividade configurado pelo administrador.

Realms por ambiente: rabisystems-dev, rabisystems-hmg (homologação) e rabisystems (produção). Cliente: rabi.client.sistemas.*. Homologação: Keycloak em login.hmg.rabisistemas.dev, app em sistema.hmg.rabisistemas.dev.

Sistema de permissões (modelo em produção)

✅ Em produção. A base do modelo: cada usuário recebe um papel (Role) e, por módulo, um dos 4 níveis de ação. Desde set/2026, sobre essa base atuam as permissões granulares (#395) — permissões finas por funcionalidade/ação (ver seção abaixo).

As permissões organizam-se em dois eixos: o grupo (o módulo) e o nível de ação dentro dele.

Níveis de ação (4 fixos)

Nível	O que permite
NONE	Sem acesso — não vê nem acessa o módulo
VIEW	Visualizar / consultar; não cria, edita ou exclui
CREATE	Criar novos registros (requer VIEW)
UPDATE	Editar registros existentes (requer VIEW)
DELETE	Excluir registros — conceda com cautela (pode ser irreversível)

Ordem de menos a mais permissivo: NONE < VIEW < CREATE < UPDATE < DELETE.

✅ Novo — 23/10/2026 Lista de permissões redesenhada (15–16/10/2026): com busca e os níveis com nomes simples na tela —

Na tela	Equivale a
Sem Permissão	NONE
Visualizar	VIEW
Criar	CREATE
Editar	UPDATE
Total	DELETE (inclui todos os anteriores)

Nova ação Ver Valores (excepcional), para colaborador com conselho: quem tem conselho + Ver Valores pode aprovar orçamento (21/10). Receitas: assinar exige Assinatura Digital (incluir); fazer e emitir para papel, Atendimentos (alterar).

Grupos de funcionalidade (módulos)

Grupo	Módulo correspondente
AGENDAMENTO	Consultas, procedimentos e agenda dos profissionais
ATENDIMENTO	Atendimentos, prontuários e acolhimento
PACIENTES	Cadastro e manutenção de pacientes
FINANCEIRO	Lançamentos, contas a pagar/receber, fluxo de caixa
FATURAMENTO	Guias, faturamento de convênios e cobrança
CONFIGURACOES	Parametrização e cadastros auxiliares
ESTOQUE	Produtos, entradas e saídas
RELATORIOS	Relatórios gerenciais e operacionais
DASHBOARD	Painel de indicadores e métricas

ℹ️ Ajuste de permissão. ✅ Atualização 15/10: hoje, colaborador sem nenhuma configuração num módulo ainda vê as telas dele (o "negar por padrão", #667, não entrou) — configure cada módulo no perfil. Se não conseguir acessar algo que deveria, procure o administrador da clínica. Somente administradores alteram perfis de acesso (em Configurações → Colaboradores, no cadastro de cada colaborador → perfis e permissões).

🟢 Permissões granulares (#395) — EM PRODUÇÃO ✅ Novo — set/2026

🟢 ENTREGUE em 15/09/2026 (GitLab #395, Sprint 10). O refactor do controle de permissões foi promovido a produção: além da base Role + 4 ações por módulo, o administrador passa a configurar permissões finas por funcionalidade/ação. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Comparativo entre o modelo anterior e o modelo granular entregue:

Aspecto	Antes (modelo básico)	Agora — granular (#395, set/2026)
Granularidade	Por módulo	Por funcionalidade/ação
Ações	4 fixas (VIEW/CREATE/UPDATE/DELETE)	Ações finas configuráveis por funcionalidade
Customização	Hard-coded	Configurável pelo administrador

Na prática: o administrador consegue liberar ou bloquear ações específicas dentro de um módulo — e não mais apenas o módulo inteiro em 4 níveis. Confira no seu ambiente como os perfis da sua clínica foram mapeados após a atualização.

Novidades de julho/2026 — recursos transversais ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Guard de edição (#401/#404): confirmação ao sair de uma tela com alterações não salvas — evita perda de dados por navegação acidental.
Idempotência anti-duplo-clique (#408): proteção contra registros duplicados por duplo clique.
Busca global (#456): busca por parte de nome, telefone, e-mail ou CPF.
Setas próximo/anterior (#459): navegação por setas no topo das telas.

Novidades de agosto/2026 ✅ Novo — ago/2026

Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Sessão única (#482): não permite acesso do mesmo usuário em 2 locais ao mesmo tempo.
Revisão da área de permissões (#512): a permissão configurada agora reflete exatamente o que o usuário pode fazer.
Aprovações por nível de alçada (#557/#558, épico #571) — ENTREGUE (13/08): renomeado de "nível de desconto" para "nível de alçada"; as solicitações de aprovação notificam todos os usuários do nível e, quando um responde, a pendência é resolvida para todos. Saiu do roadmap.
Proteção dos dados pessoais do paciente (#592) — 26/08: os dados pessoais do paciente (nome, CPF etc.) ficam bloqueados para edição nas telas — regra de proteção de dados alinhada à LGPD, que evita alteração indevida de cadastro.

Novidades de setembro/2026 ✅ Novo — set/2026

Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Pendências de alçada na Central de Notificações (#559): quem tem alçada passa a ver as aprovações pendentes (descontos, compras etc.) de forma unificada na Central de Notificações — não é mais preciso caçar as pendências tela a tela.
Correção no login (Keycloak): corrigido o timeout que travava a tela quando o login demorava a responder.
PERMISSÕES GRANULARES (#395) — ENTREGUE 15/09: permissões finas por funcionalidade/ação, além da base Role + 4 ações por módulo. Saiu do roadmap (ver seção própria acima).
Tela de Auditoria no sistema (#185) — ENTREGUE: os logs de auditoria ganharam tela própria dentro do sistema (client) — consulta de quem fez o quê e quando, sem depender só do relatório.
✅ Novo — 30/09/2026 Convênio em modo consulta (#632) — em produção desde 29/09/2026: todo convênio existente abre só para consulta (nada é gravado ao sair do campo, Enter ou clique); para alterar, o botão Liberar para edição (um clique; aparece a faixa de aviso e o botão Bloquear edição; vale só nesta visita — sair, trocar de convênio ou recarregar volta ao modo consulta). O usuário sem permissão de alterar convênio só consulta ("Você não tem permissão para alterar convênios"). Não há bloqueio automático por tempo nem registro de quem liberou. A API externa não muda.

LGPD do paciente (épico #596) ✅ em produção desde 28/09/2026

No SERVIDOR em produção desde 28/09/2026. Não há tela própria no sistema da clínica para anonimizar, exportar ou registrar consentimento: são ações administrativas, pedidas ao time Rabi/administrador (DPO). Na tela, desde 29/09/2026: os campos do responsável legal (nome, CPF, parentesco) no cadastro do paciente menor de idade, exigidos pela idade calculada da data de nascimento.

Anonimização (#598): feita pelo administrador; troca nome, CPF, RG, telefone, e-mail e endereço por valores anonimizados. O prontuário e o histórico clínico são preservados (retenção exigida pelo CFM).
Exportação/portabilidade (#599): feita pelo administrador/DPO; gera um JSON estruturado com cadastro, agendamentos, prontuário, autorizações, orçamentos e faturamento — e fica registrada em log.
Consentimento (#600): termo eletrônico com data, versão e 4 consentimentos específicos, com revogação individual. Para paciente menor de idade, exige o responsável legal (nome, CPF e parentesco).
Log de acesso/leitura ao prontuário (#601): registra quem acessou, quando e o quê; a consulta do log é restrita a Admin/DPO; o acesso do próprio paciente pelo portal é registrado à parte.

✅ Novo — 29/09/2026 MFA (#602) — correção de status: MFA/código no celular para administradores: a exigência automática foi testada e retirada em 29/09/2026 — hoje não é obrigatório pelo sistema; confirme com o time Rabi a configuração do seu ambiente. O bloqueio por excesso de tentativas continua (proteção padrão do login). Continua existindo também o limite por IP. (Correção de 29/09/2026: esta lição dizia "MFA obrigatório para perfis administrativos, concluído em 25/09" — em 29/09 a exigência automática de configurar o código ao tornar alguém administrador entrou e foi retirada no mesmo dia.)

✅ em produção desde 28/09/2026 Integrações da clínica — saíram da homologação:

TalkMe isolada por clínica (#597): a clínica habilita a integração TalkMe em Configurações › Parâmetros › Integrações; sem habilitação, a TalkMe recebe 403 — não lê dados de outra clínica nem trocando cabeçalho.
Tokens de integração self-service (#624): no mesmo lugar, a clínica gera, vê, renova e revoga tokens rbt_… (valor exibido uma única vez; validade opcional; tudo auditado; limite de requisições). Tipos: Implantação e manutenção (API externa, com as permissões escolhidas — mesmo catálogo da chave rbk_) e TalkMe (IA). A chave rbk_ emitida pelo time Rabi no portal comercial continua valendo. ✅ Novo — 30/09/2026 Decisão de 30/09/2026: para implantar/manter a clínica pela API (inclusive o kit de Implantação com IA), o caminho recomendado é o token rbt_ da própria clínica, tipo "Implantação e manutenção", só com as permissões da implantação; a rbk_ fica como alternativa para quem já tem.
✅ Novo — 30/09/2026 TalkMe (IA) — correções no servidor em 30/09/2026: a IA confere a duração do serviço ao marcar (não sobrepõe agendamentos), só oferece especialidades por convênio quando há grade que aceite o convênio, filtra os horários pelo serviço pedido e recusa serviço inativo. 🟠 Roadmap A consulta única de disponibilidade para a IA é o #633 (Sprint 12) — desde já, mantenha em dia Atende convênio no profissional, serviços e convênios na grade, Utiliza/Atende no convênio e convênio ativo na unidade. ✅ Atualização 13/10: o #633 está em produção desde 09/10/2026 (a IA já usa essa consulta; o cadastro em dia continua valendo). A IA ainda não abre autorização nem orçamento (#660, roadmap).

🔐 Cuidados com o token: ele aparece uma única vez — guarde em local seguro; nunca cole em documento, chamado, e-mail, manual ou conversa com IA que fique salva; token de uma clínica não acessa outra; suspeita de vazamento → revogue e gere outro.

🟠 Roadmap Seguem no roadmap as travas de edição entre usuários (#407) (✅ Atualização 13/10: desde 02/10 o sistema já recusa gravar por cima do que outra pessoa alterou — ver abaixo) e, na Sprint 12 (✅ Atualização 13/10: passou para a Sprint 14, 09–16/10), o log de auditoria guardando só o campo alterado (#627 — antes/depois, quem e quando; nada muda nas telas; o histórico antigo não será perdido: será convertido, e o original arquivado compactado fora do banco, com acesso restrito — LGPD).

🟠 Roadmap Segurança geral (#663–#669) — correções em preparação para a Sprint 14 (09–16/10); ainda não estão em produção. ✅ Atualização 15/10: #663, #666 e #669 entraram em produção em 13–14/10 (e #668 em parte); o "negar por padrão" (#667) não entrou — ver a seção de 13–15/10.

Novidades de outubro/2026 (01–13/10) ✅ Novo — out/2026

Conferidas no código de produção em 13/10/2026.

Salvar o perfil aplica a todos (#636, 01/10): a alteração do perfil vale para todos os colaboradores ativos dele ("Alteração aplicada a N usuário(s)"); o perfil guarda também as ações elevadas (EDIT_ALHEIO/CANCELAR/EXCLUIR), e as dadas individualmente a um usuário são preservadas. Salvar as permissões de um colaborador muda só ele.
Quem alterou primeiro (#640, 02/10): em quase todo o sistema (convênio, agendamento, atendimento, autorização, financeiro, pré-faturamento/lote, compras, estoque, aprovações) a gravação é recusada se outra pessoa gravou depois que a sua tela abriu: "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." A tela só libera edição depois de carregar tudo. Na API externa a conferência de versão ainda é opcional.
Colaborador desativado é barrado na hora em qualquer ação: "Seu usuário está desativado nesta clínica. Procure o administrador do sistema." (admin não é bloqueado).
E-mail que já tem acesso (#642): o usuário é só vinculado à clínica e entra com a senha que já usa ("A senha informada não foi aplicada e o cadastro dele não foi alterado."). Se esqueceu, "Esqueci minha senha".
Tokens rbt_ (#653, 02/10): "Editar permissões" no token de implantação (o valor do token não muda; vale na chamada seguinte; o log registra quem alterou e os escopos antes/depois) e Renovar revisando permissões e validade; o token envia X-ApiKey-Expires-At; o erro 403 traz escopoFaltante e onde liberar (ex.: "Serviços > Excluir"). Não é preciso gerar outro token para ganhar permissão.
Histórico do convênio por subaba (#638, 02/10): quem alterou, quando, a operação e os campos antes/depois — inclusive alterações feitas por integração/API externa.
Financeiro (#650, 12/10): 9 ações novas em CONTAS CAIXAS (CONFERIR_CAIXA, REABRIR_CAIXA, RECEBER_OUTRA_CONTA, ALTERAR_RECEBEDOR, BAIXA_RETROATIVA, CONCILIAR, DESCONCILIAR, EXCLUIR_COMPROVANTE, ESTORNAR) — ninguém as recebe sozinho; "líder" = admin ou quem tem EDIT_ALHEIO em CONTAS CAIXAS. O estorno é feito pelo líder: exige a ação Estornar (CONTAS CAIXAS) e alçada Nível 2 ou 3; o administrador também pode.

Novidades de 13–15/10/2026 — segurança ✅ Novo — 15/10/2026

Conferidas no código de produção em 15/10/2026. Proteções internas (cabeçalhos, infraestrutura) não mudam nada na tela e não são detalhadas aqui.

O quê	Como fica	Desde
Troca de senha/e-mail de quem tem outra clínica	Só pelo próprio usuário ("Esqueci minha senha"); pelo cadastro, só se vincula o usuário à clínica atual; busca de e-mail exata	13/10 (#663)
Mensagem de erro técnico	"Ocorreu um erro inesperado. Tente novamente em instantes. (código XXXX)" — informe o código no chamado; mensagens de regra de negócio não mudam	13/10 (#663)
Senha de aprovação de desconto	5 erradas em 15 min → "Muitas tentativas de autenticação. Aguarde 15 minutos e tente novamente."; senha errada → mensagem genérica	13/10 (#663)
Aprovação presencial (senha de outro colaborador)	5 erradas em 15 min travam aquele aprovador: "Muitas tentativas de senha para este aprovador. Aguarde 15 minutos ou peça a aprovação remota."	14/10 (#669)
Importação de planilha	Só .xlsx/.xls, até 10 MB, um arquivo por vez	13/10 (#663)
ZIP de NF-e de fornecedor	Até 200 XMLs, 2 MB por XML, 50 MB no total	13/10 (#663)
Portal do paciente	O paciente só mexe nos próprios dados; código de verificação de uso único, 10 min, 5 tentativas; só paciente ou colaborador da clínica acessa; profissional aparece só pelo nome	13–14/10 (#663/#668)
Impressões e PDFs	Abrem sobre a tela, sem aba nova; o que foi digitado é tratado como texto	13/10 (#663)
Sair do sistema	Apaga rascunhos, clínica escolhida e preferências (inclusive colunas das listas) e encerra em todas as clínicas	13–14/10 (#663/#666)
Listas e exportações	Até 100 itens por página (seletores 500; exportações 10.000; API externa 200) — acima do teto, reduz sem erro	14/10 (#669)
Lista de administradores	Só administrador altera	13/10 (#663)
Permissão no servidor em rotas que estavam abertas	Registros/movimentação financeira, duplicatas, glosas (salvar = GLOSAS UPDATE), guias, orçamentos, auditoria, assinatura digital, parâmetros, editar XML (UPDATE em Administrar Lote ou Faturamento)… — quem já usa com o perfil normal continua usando	13–14/10 (#663/#667)
Histórico de alterações das telas	Aberto a qualquer colaborador; a permissão AUDITORIA fica só na Auditoria geral e no log de acesso ao prontuário	13/10
Log de erros	Configurações › Log de erros, só administrador (não é permissão de perfil), com o código de rastreio e os dados enviados (sensíveis mascarados)	14/10
Permissões TISS	`TISS_INTEGRACAO` (VIEW/UPDATE) e `TISS_ELEGIBILIDADE` (VIEW/CREATE), grupo Configurações	15/10 (#619)

⚠️ O que NÃO entrou (apesar de issue fechada) — não conte com isso:

"Negar por padrão" (#667): hoje, colaborador sem nenhuma configuração num módulo continua vendo as telas desse módulo (só leitura). Antes dessa mudança, o administrador deve conferir se o perfil de cada colaborador tem os módulos que usa (inclusive aprovações pelo app).
E-mail confirmado no portal do paciente (#668): desligado — o vínculo automático da conta nova ainda não exige e-mail confirmado.
Uploads (#672): o anexo continua aceitando imagens (inclusive SVG) e PDF com limite único de 50 MB — não há limite por tipo de envio.
Usuário sem colaborador na clínica: o bloqueio não está ligado; a mensagem "Seu usuário não está vinculado a esta clínica…" não aparece hoje na tela do sistema.
LGPD com trilha imutável e CPF/RG criptografados (#670) 🟠 Roadmap.

Rastreabilidade e LGPD

Como cada usuário tem acesso individual, o sistema mantém Logs de Auditoria (em Relatórios) registrando quem fez o quê e quando. Desde 23/10/2026 (#627) o histórico mostra só o campo alterado (antes/depois, quem, quando); salvar sem mudar nada não gera registro; registros antigos são convertidos clínica a clínica. ✅ Novo — 23/10/2026 Isso é essencial para a LGPD: dados pessoais de pacientes são protegidos e as ações ficam rastreáveis. Por isso o compartilhamento de senha é proibido — ele quebra a rastreabilidade.

✅ Novo — set/2026 Tela de Auditoria no sistema (#185): além do relatório, os logs de auditoria agora têm tela própria no client — a consulta de auditoria fica acessível dentro do sistema, com a mesma regra de acesso restrito a administradores.

✅ Novo — ago/2026 Reforço de proteção: com o #592, os dados pessoais do paciente ficam bloqueados para edição nas telas, reduzindo o risco de alteração indevida de dados protegidos pela LGPD.

Erros comuns e como resolver

Sintoma	Causa provável	Solução
Não consigo entrar	Conta não cadastrada / e-mail errado	Peça cadastro ao administrador; confira o e-mail
Conta bloqueada	Várias tentativas com senha errada (bloqueio por excesso de tentativas — proteção padrão do login)	Aguarde alguns minutos ou peça desbloqueio ao administrador
O login passou a pedir um código (MFA/TOTP)	Código configurado no seu ambiente (o MFA não é obrigatório pelo sistema hoje — a exigência automática foi retirada em 29/09/2026, #602)	Use o código do aplicativo autenticador; em dúvida (ou para configurar), fale com o administrador ou com o time Rabi
A TalkMe (IA) recebe erro 403	Integração TalkMe não habilitada pela clínica (#597)	Habilite em Configurações › Parâmetros › Integrações e gere o token do tipo TalkMe (IA)
"Seu usuário está desativado nesta clínica." ✅ Novo — 02/10/2026	O colaborador foi desativado	Procure o administrador da clínica
Erro 403 com `escopoFaltante` numa integração ✅ Novo — 02/10/2026	O token `rbt_` não tem a permissão daquela rota	Em Parâmetros › Integrações, use "Editar permissões" no token (o valor não muda)
Colei um token `rbt_` num chamado, e-mail ou conversa com IA	Suspeita de vazamento	Revogue o token em Parâmetros › Integrações e gere outro
Link de redefinição não funciona	Link expirado (≈5 min)	Refaça "Esqueci minha senha"
Não vejo um módulo que deveria	Nível NONE naquele grupo (ou sem a permissão que passou a valer no servidor em 13–14/10)	Peça ajuste de permissão ao administrador
Erro 403 ao tentar uma ação	Nível insuficiente (ex.: tem VIEW, precisa de UPDATE)	Solicite nível maior no grupo correspondente
Sessão continua ativa após fechar aba	Não fez logout	Use sempre "Sair" no menu do perfil
"Este usuário também tem acesso a outra clínica. A senha e o e-mail só podem ser trocados por ele mesmo…" ✅ Novo — 13/10/2026	O administrador tentou trocar senha/e-mail de quem trabalha em mais de uma clínica (#663)	O próprio usuário usa "Esqueci minha senha" no login
"Ocorreu um erro inesperado. Tente novamente em instantes. (código XXXX)" ✅ Novo — 13/10/2026	Erro técnico	Tente de novo; no chamado, informe o código (o administrador o encontra em Configurações › Log de erros)
"Seu usuário não tem acesso a esta clínica." e a tela voltou para outra clínica ✅ Novo — 14/10/2026	O acesso àquela clínica foi retirado (ou outro usuário usa o mesmo navegador) (#666)	Normal: o sistema voltou para a clínica do login; peça o acesso ao administrador, se precisar
Depois de sair, as colunas das listas e o rascunho do prontuário sumiram ✅ Novo — 13/10/2026	O Sair apaga o que o Rabi guardou no navegador (#663)	Salve antes de sair; arrume as colunas de novo
Colaborador sem permissão configurada ainda vê um módulo ✅ Novo — 15/10/2026	O "negar por padrão" (#667) não entrou	Configure o módulo no perfil do colaborador

Pontos-chave

A autenticação é feita pelo Keycloak (OAuth2/OIDC, SSO, browser flow, Direct Access Grants desabilitado).
Recuperação de senha é autônoma por e-mail; o link expira em ~5 min.
Cada usuário tem acesso individual — nunca compartilhe senha (rastreabilidade e LGPD).
Base das permissões = Role + 4 ações por módulo: NONE < VIEW < CREATE < UPDATE < DELETE — na tela redesenhada (15–16/10): Sem Permissão < Visualizar < Criar < Editar < Total, com busca e a ação Ver Valores (excepcional). ✅ Novo — 23/10/2026
São 9 grupos (módulos): AGENDAMENTO, ATENDIMENTO, PACIENTES, FINANCEIRO, FATURAMENTO, CONFIGURACOES, ESTOQUE, RELATORIOS, DASHBOARD.
Permissões granulares (#395) FORAM ENTREGUES em 15/09/2026 — permissões finas por funcionalidade/ação, em produção.
Entregues em julho/2026 (transversais): guard de edição (#401/#404), idempotência anti-duplo-clique (#408), busca global (#456) e setas próximo/anterior (#459).
Entregues em agosto/2026: sessão única (#482) — sem acesso simultâneo em 2 locais —, revisão da área de permissões (#512) e aprovações por nível de alçada (épico #571), que notificam todos do nível e se resolvem para todos quando um responde.
Entregues em setembro/2026: permissões granulares (#395), Tela de Auditoria no sistema (#185), pendências de aprovação por alçada unificadas na Central de Notificações (#559) e correção do timeout do login (Keycloak).
LGPD (épico #596) — ✅ no servidor em produção desde 28/09/2026, sem tela própria (pedido ao time Rabi/DPO): anonimização pelo administrador (#598 — prontuário e histórico clínico preservados, retenção CFM), exportação/portabilidade em JSON pelo administrador/DPO com log (#599), consentimento eletrônico com data, versão, 4 consentimentos e revogação individual — responsável legal para menor (#600) — e log de acesso ao prontuário, consultado só por Admin/DPO (#601). Na tela, desde 29/09: responsável legal obrigatório do menor de idade.
MFA (#602): a exigência automática para administradores foi testada e retirada em 29/09/2026 — hoje não é obrigatório pelo sistema (confirme com o time Rabi a configuração do seu ambiente); o bloqueio por excesso de tentativas continua. Em produção desde 28/09/2026: TalkMe habilitada por clínica (#597) e tokens rbt_ da clínica (#624 — aparecem uma vez; nunca colar em documento, chamado, e-mail ou conversa com IA salva; vazou → revogue). Desde 30/09/2026 o token rbt_ "Implantação e manutenção" é o caminho recomendado para implantar por API/IA (a rbk_ segue como alternativa). Roadmap: travas de edição entre usuários (#407), log de auditoria só com o campo alterado (#627) e consulta única de disponibilidade para a IA (#633). Atualização 23/10: #627 em produção desde 23/10. ✅ Atualização 13/10: o #633 está em produção desde 09/10; o #627 está na Sprint 14 (em produção desde 23/10); a conferência de versão (#640) já impede gravar por cima do que outra pessoa alterou; segurança geral (#663–#669) em preparação. ✅ Atualização 15/10: #663/#666/#669 em produção desde 13–14/10; #667 (negar por padrão) não entrou.
✅ Desde 29/09/2026 (#632): convênio existente abre em modo consulta; alterar exige Liberar para edição (vale só na visita) e permissão de alterar convênio — quem não tem só consulta.
✅ Novo — out/2026 Salvar o perfil aplica a todos os colaboradores dele (#636); "Este registro foi alterado por outra pessoa" (#640); colaborador desativado barrado na hora; e-mail existente só vincula e mantém a senha (#642); tokens rbt_ com Editar permissões e Renovar (#653); 9 ações novas de CONTAS CAIXAS que ninguém recebe sozinho (#650).
✅ Novo — 15/10/2026 Desde 13–14/10: quem trabalha em mais de uma clínica troca senha/e-mail só ele mesmo; erro técnico com "(código XXXX)" e Log de erros só para administrador; 5 tentativas de senha em 15 min na aprovação de desconto e na presencial; Sair apaga rascunhos, clínica escolhida e preferências (inclusive colunas) e encerra em todas as clínicas; listas até 100 por página, exportações até 10.000. Não entrou: negar por padrão (#667) — quem não tem configuração num módulo continua vendo.

O que a prova vai cobrar

✅ Novo — 23/10/2026 Os nomes dos níveis na tela nova (Sem Permissão < Visualizar < Criar < Editar < Total), a ação Ver Valores (excepcional), as abas Certificado Digital e Numeração SNCR de Minha Conta e o log só com o campo alterado (#627).
Qual é o modelo de permissões em produção: base Role + 4 ações por módulo, a ordem dos níveis e, desde set/2026, as permissões granulares (#395) por funcionalidade/ação.
Que a autenticação é via Keycloak (SSO, OAuth2/OIDC, browser flow) e não guarda senha no Rabi.
O fluxo de recuperação de senha e a validade limitada do link.
Por que cada usuário deve ter acesso individual (rastreabilidade e LGPD).
Reconhecer que as permissões granulares (#395) FORAM ENTREGUES (set/2026) — a resposta antiga ("é só roadmap") está desatualizada — e que a Tela de Auditoria (#185) está no sistema.
Distinguir o status em 29/09/2026: MFA (#602) não é obrigatório pelo sistema (exigência automática retirada em 29/09); LGPD (#598–#601) no servidor em produção desde 28/09 (sem tela própria — pedido ao time Rabi/DPO; responsável legal do menor na tela desde 29/09); TalkMe por clínica (#597) e tokens rbt_ (#624) em produção desde 28/09, com os cuidados com o token — e que, desde 30/09/2026, o rbt_ "Implantação e manutenção" é o caminho recomendado para a implantação por API/IA.
O modo consulta do convênio (#632, em produção desde 29/09/2026) como proteção contra alteração acidental: Liberar para edição vale só na visita; usuário sem permissão só consulta; não há registro de quem liberou.
✅ Novo — out/2026 Que salvar um perfil aplica a alteração a todos os colaboradores dele, que o token rbt_ tem as permissões editáveis sem trocar o valor e que as ações novas de CONTAS CAIXAS precisam ser liberadas pelo administrador.
✅ Novo — 15/10/2026 O que o Sair faz desde 13/10 (apaga do navegador rascunhos, clínica escolhida e preferências; encerra em todas as clínicas), quem troca a senha de quem tem outra clínica (o próprio usuário), o limite de 5 tentativas de senha de aprovação em 15 minutos, onde fica o Log de erros (só administrador) — e que o "negar por padrão" (#667) não está em produção.