# Página Inicial — indicadores, atalhos e configuração

A Página Inicial fica em `/inicio`. Ela resume informações do espaço de trabalho selecionado e oferece links para abrir telas operacionais. Os cartões são leituras dos registros disponíveis no período; não são previsões, metas, avaliações clínicas nem garantias de resultado.

## Antes de começar

1. Confira o nome e a marca do espaço exibidos junto à saudação. Se não for o espaço desejado, troque-o pelo seletor de espaços e retorne a `/inicio`.
2. Veja a data apresentada no cabeçalho. A seção **Agenda do dia** usa a data de hoje.
3. Se os dados parecerem incompletos, confira se há registros no espaço e se você tem acesso a eles. Os cartões podem ficar sem valor quando ainda não há dados.

## Os quatro cartões de resumo

### Pacientes

**Pacientes** conta cadastros associados ao espaço. O subtítulo é **Cadastrados no espaço**. Selecione o número para abrir `/pacientes`. A contagem é de cadastros, não de pessoas atendidas no mês, pacientes ativos, tratamentos concluídos ou vagas restantes do plano. Para uso do cadastro clínico, veja a orientação específica de prontuários antes de alterar dados de atendimento.

### Faturamento ou Meus repasses

- Para o titular do espaço, **Faturamento** abre `/financeiro` e resume a receita do mês. Quando disponível, mostra também a variação **vs mês ant.**.
- Para integrantes que não são titulares, o cartão aparece como **Meus repasses**, com `—` e **Em breve**. Esse cartão não apresenta um valor atual de repasse. Não use o traço como zero nem como valor calculado.
- O botão **Ocultar valores** / **Mostrar valores** alterna a privacidade visual dos valores financeiros no dashboard. Ocultar o número na tela não altera os lançamentos, a permissão ou os dados armazenados.

Leia o detalhe financeiro dentro do módulo correspondente e considere o período e os lançamentos usados no cálculo. Variação percentual compara os dados disponíveis; não significa aumento garantido nem previsão.

### Atendimentos

**Atendimentos** é a contagem de compromissos concluídos no mês corrente e abre `/agenda/historico`. É calculada pelos registros com estado **Concluído** no recorte usado pela Página Inicial. Se um atendimento estiver com outro estado, ele não entra nessa contagem. Para alterar um compromisso, abra a agenda e revise o registro; não altere status apenas para mudar o indicador.

### Pendências

**Pendências** mostra quantidades de itens que precisam de revisão conforme dados disponíveis e permissões. Clique no cartão para navegar até a seção **Precisa de atenção** (âncora `#atencao`). A seção separa tipos de atenção; a contagem combinada não representa necessariamente tarefas atribuídas a você.

## Barra de ações do dashboard

Na barra superior ficam ações de leitura:

- **Mostrar valores financeiros** / **Ocultar valores financeiros**: alterna a máscara de valores financeiros visíveis na página.
- **Atualizar dados**: solicita nova leitura dos dados do dashboard. A tela pode mostrar carregamento e resultados incompletos enquanto atualiza.
- **Tentar novamente**: aparece junto da mensagem **Não foi possível atualizar os dados. Exibindo a última consulta.** Use para repetir a leitura. Seções também podem mostrar uma ação de nova tentativa própria.

Se a tentativa falhar novamente, confira conexão e espaço selecionado, aguarde um pouco e tente outra vez. O dashboard preserva a última consulta quando consegue fazê-lo; uma mensagem de erro não confirma que os dados estejam atualizados.

## Agenda do dia

O bloco **Agenda do dia** lista compromissos previstos para a data corrente e informa o total carregado. Os cartões mostram informações do compromisso e seu status quando disponível. Selecione um item para abrir o contexto correspondente na agenda.

- Com itens, use o botão/link **Ver todos N agendamentos** para abrir a lista do dia.
- Sem itens, use **Abrir agenda** para planejar ou consultar outro dia.
- Para criar, remarcar ou atualizar um agendamento, confira os campos e as validações em [Registre e acompanhe compromissos na agenda](https://sysfisio-central-ajuda.vercel.app/ajuda/primeiros-passos/10-agenda-operacional).

O resumo depende de compromissos registrados e carregados para o espaço. Não trata um horário livre como cancelamento ou confirmação.

## Renovações próximas

**Renovações próximas** reúne itens dentro dos próximos 14 dias: ciclos de Pilates com renovação prevista e pacotes que têm duas sessões ou menos restantes. A lista é um lembrete operacional. Ela não cobra, renova ou contata automaticamente o paciente por si só.

1. Abra o item para navegar ao paciente ou à área relacionada ao ciclo/pacote.
2. Confira se a data e a quantidade de sessões restantes estão corretas no registro de origem.
3. Em itens de Pilates, o controle **Renovação automática** pode aparecer por matrícula. Alterar o controle de uma matrícula não altera os demais itens.
4. Para ajustar o padrão de renovação, abra **Configurações do espaço > Agenda** e revise a opção de ciclos do Pilates.

Exemplo: se um pacote tiver duas sessões restantes, ele pode aparecer neste bloco mesmo sem uma data de cobrança. Trate-o como lembrete para verificar o registro, não como confirmação de renovação.

## Precisa de atenção

O bloco pode ser omitido quando não há alertas aplicáveis. Quando aparece, os grupos de atenção incluem:

- **Evoluções pendentes**: abre itens do fluxo clínico. O artigo de entrada não ensina registro clínico; siga o procedimento clínico autorizado da equipe.
- **Atendimentos a atualizar**: aponta compromissos cujo estado merece atualização. Abra o compromisso e confira o que ocorreu antes de registrar um status.
- **Contas a receber vencidas**: aponta lançamentos financeiros vencidos. Consulte o módulo financeiro para verificar data e situação do recebível.
- **Produtos com estoque baixo**: pode aparecer como link para **Configurações do espaço > Produtos** (`/configuracoes-espaco?tab=products`). Confira saldo e limite mínimo do produto.

Selecione uma categoria para abrir a lista de itens. A lista pode oferecer links para o registro de origem e **Tentar novamente** se houve erro de carregamento. Uma pendência pode depender de acesso; se não puder abrir o item, peça ao titular/administrador para revisar as permissões.

## Nesta semana

O bloco **Nesta semana** tem duas abas:

- **Aniversariantes**: usa datas de nascimento cadastradas nos perfis de pacientes e mostra quem faz aniversário na semana. Selecione a pessoa para abrir o cadastro. O nome pode ser ocultado quando a privacidade do dashboard estiver ligada.
- **Datas e eventos**: mostra feriados nacionais que caem na semana. Use a data como referência; essa lista não cria bloqueios na agenda automaticamente.

Se alguém não aparece, confira se o nascimento foi preenchido no cadastro correto e se a semana exibida é a atual.

## Complete sua configuração

Quando há itens de configuração pendentes, o bloco **Complete sua configuração** mostra etapas e um progresso. Quando todos os requisitos identificados pelo dashboard estão completos, o título pode mudar para **Seu espaço está pronto**.

As etapas podem variar conforme modalidade e dados existentes. O dashboard pode apresentar tarefas como:

| Etapa mostrada | O que revisar | Destino |
|---|---|---|
| Complete seu perfil | Nome e telefone de contato da conta | `/perfil` |
| Dados do espaço | Telefone e localização do espaço | `/configuracoes-espaco?tab=space` |
| Cadastre seus serviços | Serviços disponíveis e dados básicos | `/configuracoes-espaco?tab=services` |
| Configure planos de Pilates | Planos e configurações de Pilates, quando aplicável | `/configuracoes-espaco?tab=services` |
| Horários de atendimento | Horários e dias operacionais | `/configuracoes-espaco?tab=agenda` |

Abra uma etapa e preencha apenas dados corretos. O progresso mede a presença de dados definidos pelo produto; não é uma avaliação da qualidade do espaço ou de desempenho comercial.

## Acesso rápido flutuante

O atalho flutuante de acesso rápido reúne links para telas usadas com frequência:

| Atalho | Destino | Como ler o número/badge |
|---|---|---|
| **Ir para a agenda** | `/agenda` | Quantidade de compromissos associada ao atalho; abra a agenda para ver o período e os itens. |
| **Todos os pacientes** | `/pacientes` | Badge relacionado a status de atenção; não representa total de cadastros. |
| **Financeiro** | `/financeiro` | Aparece apenas quando a permissão financeira permite. O badge pode contar itens vencidos. |
| **Evoluções** | Tela de evoluções no fluxo clínico | Badge indica itens do fluxo; vermelho pode identificar atraso e âmbar outra pendência. |

Os badges servem como entradas rápidas e não são novos KPIs independentes. Se um atalho não aparecer, pode depender de função/permissão ou do estado de carregamento.

## Perguntas frequentes

### Por que eu vejo “Meus repasses” sem valor?

O cartão de integrante aparece como **Em breve** e não calcula um valor de repasse na Página Inicial. Para valores de titular, consulte o módulo financeiro conforme sua permissão.

### “Atendimentos” é o total de agendamentos criados?

Não. O indicador considera atendimentos concluídos no mês. Para consultar a agenda do dia ou outros estados, abra `/agenda`.

### Ocultar valores remove o acesso financeiro?

Não. O controle mascara valores exibidos no dashboard. A permissão de acesso ao módulo é independente.

### Um card aparece como traço ou vazio. Isso quer dizer zero?

Não necessariamente. Pode indicar que não há dados carregados, que a consulta ainda está pendente ou que aquela informação não é exibida à sua função. Abra a área de origem.

### Um aniversário ou compromisso está faltando. O que conferir?

Confira espaço ativo, data/período, dados do registro e se a lista terminou de carregar. Use **Atualizar dados** ou a tentativa de novo da seção.

### Posso tratar as pendências do dashboard como uma fila de tarefas designada?

Não. O dashboard consolida sinais dos módulos. Ele não informa necessariamente atribuição, prazo ou responsável. Abra o item e verifique o contexto.

## Solução de problemas

- **O número financeiro não aparece:** verifique se você é titular, se o cartão está mascarado e se a consulta carregou. Integrantes veem o cartão **Meus repasses — Em breve**.
- **A agenda do dia está vazia:** confirme a data atual e o espaço. Clique em **Abrir agenda** para consultar outras datas.
- **O progresso não muda depois de salvar:** retorne à Página Inicial e clique **Atualizar dados**; confirme que o dado foi salvo no espaço correto.
- **Não consigo abrir uma pendência:** o destino pode exigir permissão específica. Peça revisão ao titular/administrador sem compartilhar dados sensíveis em canais públicos.
- **Os dados seguem desatualizados:** use **Tentar novamente** e anote horário, espaço e seção para relatar ao suporte.

## Veja na tela

### Página Inicial do espaço

![Painel demonstrativo com indicadores, agenda do dia, pendências e conclusão da configuração.](https://sysfisio-central-ajuda.vercel.app/ajuda/imagens/pagina-inicial.anotada.svg)

1. Os cartões abrem os registros de origem. Confira o espaço antes de interpretar os totais.
2. Agenda do dia reúne os horários previstos e permite acessar cada atendimento.
3. Renovações próximas indica planos ou pacotes que precisam de conferência.
4. Pendências e configuração ajudam a organizar as próximas ações da equipe.