ÉPICO 6 — SELEÇÃO DE CLÍNICA
Funcionalidade pai: Check-in de Usuários no Sistema Persona principal: Profissional com mais de um vínculo ativo (ou com convite pendente somado a vínculo(s) ativo(s)) Versão: 0.1 (em definição — Seção 1 iniciada) Data: 27/08/2026
SEÇÃO 1 — DEFINIÇÃO
Objetivo
Permitir que um profissional autenticado com mais de um vínculo ativo escolha em qual clínica quer entrar, e — quando há um convite pendente para uma nova clínica — aceitar esse convite sem sair da tela, sem repetir a leitura das regras básicas de uso já lidas no primeiro vínculo (RN-CIU-014, em CIU-E3).
Escopo
Dentro do escopo (nesta revisão):
- Tela de seleção de clínica, exibida quando o roteamento pós-autenticação (RN-CIU-022, no guarda-chuva) chega a “múltiplos vínculos ativos” ou a “convite pendente + ao menos um vínculo ativo”
- Card em destaque para convite pendente, com aceite direto (RN-CIU-025)
Fora do escopo nesta revisão — a especificar depois:
- Layout detalhado da tela (Seção 3 — Protótipo HTML, ainda não produzida)
- Comportamento após o aceite do card: se a clínica recém-aceita é selecionada automaticamente ou só passa a aparecer na lista para escolha manual (sinalizado como proposta em RN-CIU-025 — a confirmar)
- Se a verificação de Perfil de acesso (RN-CIU-015) roda no momento do aceite do card ou só depois, ao selecionar a clínica na lista (também sinalizado em RN-CIU-025)
Personas
- Profissional com mais de um vínculo ativo — usa esta tela normalmente, toda vez que faz login, para escolher a clínica.
- Profissional com um vínculo ativo e um convite pendente simultâneo — normalmente iria direto ao cockpit (RN-CIU-009, 1 vínculo); passa a ver esta tela só para poder aceitar o convite via card (RN-CIU-022, item 2).
Workflow do Profissional
Resumo: um profissional que atende em mais de uma clínica faz login uma única vez (E1) — a conta é global, compartilhada entre clínicas (RN-CIU-001, em CIU-E1). Depois do login, em vez de cair direto num cockpit, ele escolhe em qual clínica quer trabalhar naquele momento. Se uma clínica nova o convidou nesse meio tempo, ele quer ver e aceitar esse convite no mesmo lugar onde já escolhe a clínica — não numa tela separada, com leitura de regras que ele já leu.
Touchpoint — Seleção de clínica após login:
- Momento do workflow: imediatamente após autenticar-se (E1), quando o roteamento (RN-CIU-022) resulta em múltiplos vínculos ativos, ou em convite pendente com ao menos um vínculo ativo.
- Necessidade do profissional: entrar rápido na clínica certa, sem passos extras; e, se houver um convite novo, não ser forçado a uma tela cheia de regras que ele já conhece.
- O que a funcionalidade oferece: lista das clínicas com vínculo ativo + card em destaque para convite pendente, aceito com um clique.
- Decisão de design justificada: o card fica separado da lista normal (destaque visual) porque representa uma ação pendente do profissional, não uma opção de navegação — evita que ele confunda “aceitar convite” com “selecionar clínica”.
Regras de Negócio
- RN-CIU-022 (transversal, redação completa no guarda-chuva) — define quando o roteamento pós-autenticação chega a esta tela.
- RN-CIU-025 — Aceite de convite pendente na tela de seleção de clínica (redação completa abaixo, específica deste épico).
RN-CIU-025 — Aceite de convite pendente na tela de seleção de clínica
Quando o profissional autenticado já tem ao menos um vínculo ativo (UsuarioCliente.Situacao = 'V') e possui, ao mesmo tempo, um convite pendente (Situacao = 'C') para uma nova clínica, o aceite desse convite acontece nesta tela — não na tela de aceite do vínculo do E3 (RN-CIU-014, que a partir desta revisão só se aplica a quem não tem nenhum vínculo ativo).
A tela de seleção de clínica exibe:
- As clínicas com vínculo ativo, na lista normal de seleção (comportamento já existente, inalterado)
- Um card em destaque, separado da lista, para cada convite pendente
Diferente da tela de aceite do E3 (RN-CIU-014), este card não exige a leitura das regras básicas de uso da aplicação — o profissional já as leu no momento em que aceitou seu primeiro vínculo. O aceite é uma ação direta no card (ex.: botão “Aceitar”).
Ao aceitar:
- Atualiza o vínculo existente —
UsuarioCliente.Situacaopassa de ‘C’ para ‘V’ (mesmo mecanismo do item 1 de RN-CIU-014; não cria um registro novo) - O card sai da área de destaque e a clínica passa a fazer parte da lista normal de seleção
[PROPOSTA — não confirmado pelo solicitante] Dois pontos não descritos explicitamente, sinalizados para confirmação:
- Se, ao aceitar o card, a nova clínica é selecionada automaticamente (entra direto nela) ou só passa a aparecer na lista, exigindo uma segunda ação de seleção.
- Se a verificação de Perfil de acesso (RN-CIU-015, hoje rodada no aceite do E3) roda no momento do aceite do card, ou só depois, quando o profissional efetivamente seleciona essa clínica na lista — tratando-a, a partir do aceite, como qualquer outra clínica da lista.
[PROPOSTA — extensão de consistência não descrita explicitamente pelo solicitante] Esta regra assume que “outras clínicas vinculadas” (nas palavras do solicitante) inclui o caso de exatamente 1 vínculo ativo — ou seja, mesmo um profissional que hoje vai direto para o cockpit (RN-CIU-009, 1 vínculo ativo) passa a ver esta tela quando há um convite pendente simultâneo, só para poder ver e aceitar o card. Sem essa extensão, esse profissional nunca veria o convite. Extensão sinalizada para confirmação — ver RN-CIU-022, item 2, no guarda-chuva.
Pendências para as próximas seções
- Seção 2 (restante): histórias de usuário, critérios de aceitação, fluxos de exceção, validações de campos, mapeamento de componentes de interface, integração com backend, catálogo de mensagens do sistema e termos de interface (i18n)
- Seção 3: Protótipo HTML da tela de seleção de clínica (lista + card de convite)
- Seção 4: Mapeamento de Banco de Dados (tabelas já mapeadas em CIU-E1/E3 — Usuario, UsuarioCliente — a confirmar se há necessidade de campo adicional específico deste épico)
HISTÓRICO DE VERSÕES
- v0.1 (27/08/2026) — Seção 1 (Definição) iniciada a partir da descrição do fluxo de login com múltiplas clínicas e do card de aceite de convite, fornecida pelo solicitante. Criada RN-CIU-025. Documento ainda não cobre Seção 2 completa, Seção 3 nem Seção 4 — ver “Pendências para as próximas seções”.
Documento elaborado em 27 de agosto de 2026. As informações contidas são de responsabilidade do solicitante.