> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nextmed.med.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Primeiro acesso
> Fluxo de onboarding e configuração inicial no primeiro acesso à plataforma.
Documentação Revisada
## Primeiro Acesso — Fluxo de Onboarding
## O que este módulo faz?
O módulo de Primeiro Acesso é o fluxo de boas-vindas e configuração inicial que o médico percorre logo após realizar seu cadastro no NextMed. Ele é disparado automaticamente na primeira vez que o profissional entra no sistema e conduz o usuário por etapas obrigatórias — como confirmar a identidade, criar uma assinatura digital, selecionar a especialidade e definir o valor da consulta particular— antes de liberar o acesso completo à plataforma. O fluxo é apresentado no formato de cards centralizados na tela, um passo por vez, tornando o processo leve e guiado.
***
## Visão geral do fluxo
O módulo é composto por **5 etapas sequenciais**, exibidas uma de cada vez em um card central:
| Etapa | Tela | O que acontece |
| ----- | ------------------------------------ | -------------------------------------------------------- |
| 1 | Boas-vindas | Apresenta o nome do médico e solicita início do processo |
| 2 | Criar Assinatura Digital | O médico desenha sua assinatura com o mouse ou toque |
| 3 | Confirmar Especialidade | O médico seleciona qual especialidade deseja usar |
| 4 | Definir Valor da Consulta particular | O médico informa o preço cobrado por consulta |
| 5 | Sair (Modal de confirmação) | Aparece ao tentar abandonar o fluxo antes de concluir |
***
## Etapa 1 — Boas-vindas
### O que você vê nesta tela
* **Ilustração do mascote**: Personagem médico animado no topo do card, transmitindo leveza e acolhimento.
* **Mensagem de boas-vindas**: Exibe "Bem-vindo!" seguido do nome do médico logado (ex: "Dr. Fábio").
* **Subtítulo**: Informa que é necessário confirmar a identidade antes de continuar ("Estamos quase lá / Precisamos confirmar sua identidade"). Na variante dark mode, a mensagem é: "Complete seu cadastro, é rápido e prático...".
* **Botão Iniciar**: Botão verde centralizado que inicia o fluxo.
* **Ícone de sair** (canto inferior esquerdo): Permite tentar abandonar o fluxo.
* **Ícone de tema** (canto inferior direito): Alterna entre modo claro e escuro.
### O que cada botão faz
**Guia de botões e ações**
| Botão / Ícone | O que faz |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Iniciar** | Avança para a próxima etapa do fluxo (Criar Assinatura Digital). |
| **Ícone de saída** ↗ (canto inferior esquerdo) | Abre o modal de confirmação de saída, perguntando se o médico realmente deseja sair do fluxo antes de concluir. |
| **Ícone de lua / sol** 🌙☀️ (canto inferior direito) | Alterna o tema visual entre modo claro (light) e modo escuro (dark). |
***
## Etapa 2 — Criar Assinatura Digital
### O que você vê nesta tela
* **Título da etapa**: "Criar Assinatura digital" com ícone de assinatura à esquerda.
* **Área de desenho**: Espaço retangular tracejado com a instrução "Assine aqui" ao centro — é nesta área que o médico faz o traço da assinatura com o mouse ou dedo (em touch).
* **Botão Limpar**: Apaga o que foi desenhado na área, permitindo refazer a assinatura.
* **Botão Cancelar**: Volta para a etapa anterior sem salvar.
* **Botão Salvar**: Confirma a assinatura desenhada e avança para a próxima etapa. Fica desabilitado (acinzentado) enquanto a área de assinatura estiver vazia.
* **Ícone de ajuda** ❓ (canto superior direito do card): Abre informações de suporte ou dicas sobre a assinatura digital *(inferido)*.
### O que cada botão faz
**Guia de botões e ações**
| Botão / Ícone | O que faz |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Área de assinatura** | Campo interativo onde o médico desenha a própria assinatura usando o mouse ou toque na tela. |
| **Limpar** | Apaga toda a assinatura desenhada, permitindo que o médico refaça do zero. |
| **Cancelar** | Retorna à etapa anterior sem salvar nenhuma assinatura. |
| **Salvar** | Registra a assinatura e avança para a etapa de seleção de especialidade. *Disponível somente quando uma assinatura tiver sido desenhada na área.* |
| **❓ Ajuda** | Exibe informações de suporte sobre como criar a assinatura digital *(inferido)*. |
**Fique de olho**
* **Botão Salvar desabilitado:** O botão "Salvar" aparece acinzentado e não pode ser clicado enquanto nenhum traço for feito na área de assinatura. É necessário desenhar algo para ativá-lo.
* **Assinatura permanente:** Uma vez salva, a assinatura ficará vinculada ao perfil do médico e será usada para assinar documentos e prontuários no sistema.
***
## Etapa 3 — Confirmar Especialidade (Caso haja mais de uma especialidade)
### O que você vê nesta tela
* **Título da etapa**: "Confirme qual especialidade deseja utilizar".
* **Lista de especialidades**: Cada especialidade disponível no perfil do médico aparece como uma opção com checkbox.
* **Estado selecionado**: A especialidade escolhida fica destacada com fundo verde claro e o checkbox marcado em verde.
* **Estado não selecionado**: As demais especialidades ficam com fundo cinza e checkbox vazio.
* **Botão Cancelar**: Volta para a etapa anterior.
* **Botão Confirmar**: Confirma a especialidade selecionada e avança para a próxima etapa. Fica em verde quando uma opção está marcada.
* **Ícone de ajuda** ❓ (canto superior direito do card).
**Atenção!**
* As especialidades são fornecidas pelo CFM através de um serviço via API.
* Essa tela só é mostrada caso o médico tenha junto ao CFM mais de uma especialidade.
### O que cada botão faz
**Guia de botões e ações**
| Botão / Ícone | O que faz |
| ----------------------------- | ------------------------------------------------------------------------------------------- |
| **Checkbox de especialidade** | Seleciona a especialidade correspondente. |
| **Cancelar** | Retorna à etapa de criação de assinatura sem salvar a seleção. |
| **Confirmar** | Registra a especialidade escolhida e avança para a etapa de definição do valor da consulta. |
| **❓ Ajuda** | Exibe informações de suporte sobre a seleção de especialidade *(inferido)*. |
**Fique de olho**
* **Especialidades pré-carregadas:** As opções exibidas correspondem às especialidades já vinculadas ao cadastro do médico no CFM. Não é possível adicionar ou remover da lista novas especialidades, pois a lista é fornecida com base no CFM automaticamente.
***
## Etapa 4 — Definir Valor da Consulta
### O que você vê nesta tela
* **Ilustração do mascote** com ícone de moeda 💰.
* **Instrução**: "Defina o valor da sua consulta".
* **Campo de valor**: Campo de texto com prefixo "R\$" onde o médico digita o preço da consulta.
* **Referência de mercado**: Abaixo do campo, o sistema exibe a média de valor praticado por outros especialistas da mesma área (ex: "R\$ 250,00"). O número digitado aparece em verde quando preenchido.
* **Botão Cancelar**: Volta para a etapa anterior.
* **Botão Salvar**: Confirma o valor e conclui o fluxo de primeiro acesso. Fica desabilitado (acinzentado) até que um valor seja digitado; torna-se verde quando o campo está preenchido.
* **Ícone de ajuda** ❓ (canto superior direito do card).
### O que cada botão faz
**Guia de botões e ações**
| Botão / Ícone | O que faz |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Campo R\$** | Campo para o médico digitar o valor que cobra por consulta particular. |
| **Cancelar** | Retorna à etapa de confirmação de especialidade. |
| **Salvar** | Registra o valor informado e conclui o fluxo de primeiro acesso, liberando o acesso completo ao sistema. *Disponível somente quando o campo de valor estiver preenchido.* |
| **❓ Ajuda** | Exibe orientações sobre como definir o valor da consulta *(inferido)*. |
### Campos desta tela
| Campo | O que preencher | Obrigatório |
| ----------------------- | ------------------------------------------------------------------ | :---------: |
| Valor da consulta (R\$) | Valor numérico em reais que o médico cobra por consulta particular | Sim |
**Dicas de preenchimento**
* O sistema sugere uma referência de mercado logo abaixo do campo ("Média de valor praticado por outros especialistas"). O médico pode usar esse número como base, mas está livre para definir o valor que preferir.
* O valor digitado aparece em verde no campo para facilitar a leitura antes de salvar.
***
## Modal — Confirmação de Saída
### O que você vê nesta tela
Este modal aparece quando o médico clica no **ícone de saída** (canto inferior esquerdo) durante qualquer etapa do fluxo, antes de concluí-lo.
* **Ícone do NextMed** centralizado.
* **Mensagem de confirmação**: "Tem certeza que deseja sair?".
* **Botão Voltar**: Fecha o modal e retorna para a etapa atual do fluxo.
* **Botão Confirmar**: Encerra o fluxo de primeiro acesso e sai do sistema (ou redireciona para o login) *(inferido)*.
* **Ícone X** (canto superior direito do modal): Fecha o modal sem sair.
### O que cada botão faz
**Guia de botões e ações**
| Botão / Ícone | O que faz |
| ------------- | ------------------------------------------------------------------------------------------ |
| **Voltar** | Fecha o modal e retorna para a etapa do fluxo onde o médico estava. |
| **Confirmar** | Confirma a saída, encerrando a sessão ou redirecionando para a tela de login *(inferido)*. |
| **✕ Fechar** | Fecha o modal sem nenhuma ação, retornando para o fluxo. |
**Fique de olho**
* **Fluxo incompleto:** Se o médico confirmar a saída antes de concluir todas as etapas, o primeiro acesso não estará completo. Na próxima entrada no sistema, o fluxo provavelmente será reiniciado.
* O médico com o fluxo incompleto não poderá criar solicitações ou realizar atendimentos na plataforma.
***
## Como usar este módulo — passo a passo
1. Ao entrar no sistema pela primeira vez, o card de boas-vindas aparece automaticamente no centro da tela, exibindo seu nome.
2. Leia a mensagem de boas-vindas e clique no botão verde **Iniciar** para começar.
3. Na tela de **Assinatura Digital**, use o mouse (ou o dedo, se estiver em um dispositivo touch) para desenhar sua assinatura dentro da área tracejada. Se não gostar do resultado, clique em **Limpar** e tente novamente.
4. Quando estiver satisfeito com a assinatura, clique em **Salvar** para continuar.
5. Na tela de **Especialidade**, clique na sua especialidade principal para selecioná-la (ela ficará destacada em verde). Depois clique em **Confirmar**.
6. Na tela de **Valor da Consulta**, digite o valor que você cobra por consulta no campo "R\$". Você pode usar o valor de referência exibido abaixo como guia. Clique em **Salvar** para concluir.
7. Após salvar, o fluxo de primeiro acesso estará completo e você terá acesso à plataforma NextMed.
> **Dica:** Se precisar sair antes de terminar, clique no ícone de saída no canto inferior esquerdo. Um modal de confirmação aparecerá para evitar saídas acidentais.
***
## De onde vem e para onde vai
```
Tela de Login / Cadastro → primeiro login do médico → este fluxo
→ [Concluir todas as etapas] → Dashboard Principal
→ [Clicar em sair] → Modal de Confirmação de Saída
→ [Confirmar saída] → Tela de Login
→ [Voltar] → retorna para a etapa atual do fluxo
```
* **Como chegar aqui:** O fluxo é acionado automaticamente após o primeiro login do médico no sistema. Não é acessível via menu.
* **Após concluir todas as etapas:** Dashboard Principal
* **Ao confirmar saída:** SOBRE/PLATAFORMA DE ATENDIMENTO/2. Módulo Login/2.1 Acesso ao Sistema
***
## Atenções e regras importantes
**Fique de olho**
* **Fluxo obrigatório:** O médico não consegue realizar solicitações ou atendimentos na plataforma sem concluir todas as etapas do primeiro acesso.
* **Assinatura digital:** A assinatura criada será usada para assinar prontuários e documentos dentro do sistema. Recomenda-se que seja fiel à assinatura real do profissional.
* **Especialidade pode ser alterada depois:** A seleção feita aqui pode ser modificada nas configurações do perfil após o primeiro acesso.
* **Valor da consulta pode ser alterado depois:** O preço definido nesta etapa é um valor inicial e pode ser atualizado na área de configurações.
* **Tema claro/escuro:** O ícone no canto inferior direito alterna o tema visual em qualquer etapa. A preferência é aplicada imediatamente.
***
## Observações adicionais
* O fluxo usa um mascote médico animado como elemento visual de engajamento, reforçando a identidade amigável da plataforma.
* Todas as telas do fluxo são apresentadas em um card centralizado com fundo neutro, isolando o usuário do restante da interface até a conclusão.
* O sistema suporta **modo escuro** nativo, ativável pelo ícone no canto inferior direito em qualquer etapa.
* O botão **Salvar** utiliza o padrão de desabilitação visual (acinzentado) para indicar quando uma ação obrigatória ainda não foi realizada — seja desenhar a assinatura ou preencher o valor da consulta.
***