É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.2 (em definição — Seção 1 concluída) 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)
- Histórias de usuário, critérios de aceitação, fluxos de exceção, validações de campos, mapeamento de componentes, integração com backend e catálogo de mensagens (Seção 2, ainda não desenvolvida)
- Mapeamento de Banco de Dados (Seção 4, ainda não desenvolvida)
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). Isso vale mesmo quando o profissional tem exatamente 1 vínculo ativo — caso que, sem convite pendente, iria direto ao cockpit (RN-CIU-009) — pois é o único jeito de esse profissional ver e aceitar o convite (confirmado em RN-CIU-022, item 2, no guarda-chuva).
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; a clínica passa a fazer parte da lista normal de seleção — não é selecionada automaticamente. O profissional precisa de uma segunda ação, a seleção manual da clínica na lista, como faria com qualquer outra (confirmado pelo solicitante em 27/08/2026)
- A verificação de Perfil de acesso (RN-CIU-015) não roda no momento do aceite do card — roda apenas quando o profissional efetivamente seleciona essa clínica na lista, no mesmo momento em que rodaria para qualquer outra clínica selecionada (confirmado pelo solicitante em 27/08/2026)
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, com dois pontos sinalizados como proposta não confirmada. 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”.
- v0.2 (27/08/2026, mesmo dia) — RN-CIU-025 totalmente confirmada pelo solicitante, resolvendo os dois pontos em aberto da v0.1: o aceite do card não seleciona a clínica automaticamente, apenas a adiciona à lista normal de seleção (exige uma segunda ação manual); a verificação de Perfil de acesso (RN-CIU-015) não roda no aceite do card, só no momento da seleção da clínica na lista. Também dobrada para dentro do corpo da regra a confirmação, já registrada no guarda-chuva (RN-CIU-022), de que o caso de exatamente 1 vínculo ativo está coberto — removido o segundo bloco de proposta, que duplicava essa mesma questão já resolvida alhures. Seção 1 (Definição) considerada concluída. Seção 2, 3 e 4 seguem pendentes.
Documento elaborado em 27 de agosto de 2026. As informações contidas são de responsabilidade do solicitante.