# É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: 1. As clínicas com vínculo ativo, na lista normal de seleção (comportamento já existente, inalterado) 2. 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: 1. Atualiza o vínculo existente — `UsuarioCliente.Situacao` passa de 'C' para 'V' (mesmo mecanismo do item 1 de RN-CIU-014; não cria um registro novo) 2. 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) 3. 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._