Tutorial: usar o dashboard "Meus números"¶

Diátaxis: tutorial. Aprenda fazendo, em ~5 minutos.

Este tutorial mostra como abrir o dashboard de produção do Anotae, filtrar por período e copiar os top códigos CIAP-2/CID-10 para uso em relatórios de produção da APS.

O que você vai aprender¶

Abrir Meus números pela GUI ou pelo atalho.
Filtrar atendimentos por período.
Identificar seus principais diagnósticos e procedimentos.
Copiar dados para colar em relatórios externos.

Pré-requisitos¶

Anotae 0.9.0-beta4+ instalado.
Vault aberto com pelo menos alguns atendimentos cadastrados (use fixtures sintéticas se estiver experimentando — nunca dados reais de paciente em ambiente de teste).

Passo 1 — Abrir o dashboard¶

Há duas formas:

Menu: Vault → Meus números…
Atalho: Ctrl+J

A janela "Meus números — Produção" abre com filtro padrão dos últimos 30 dias já aplicado.

Passo 2 — Ler o sumário¶

A faixa azul-clara no topo mostra:

3 atendimentos entre 2026-04-08 e 2026-05-07.
CIAP-2 distintos: 5 · CID-10 distintos: 5 · Procedimentos distintos: 0

Use isso para confirmar que o período capturou o que você esperava. Se está em zero, amplie o período no próximo passo.

Passo 3 — Trocar de período¶

De / Até — escolha datas específicas no calendário.
Botão Últimos 30 dias — janela móvel.
Botão Este ano — desde 1º de janeiro até hoje.
Botão Tudo — sem filtro temporal.

Cada mudança recarrega imediatamente as 5 abas abaixo.

Passo 4 — Explorar as abas¶

Aba	O que mostra
CIAP-2	Top-20 motivos de consulta (Classificação Internacional da APS, 2ª ed).
CID-10	Top-20 diagnósticos formais.
Procedimentos	Top-20 códigos SIGTAP cadastrados.
Tipo de atendimento	Distribuição entre primeira consulta, retorno, urgência etc.
Função do profissional	Útil quando o vault contém atendimentos de mais de um profissional.

Cada aba tem 3 colunas: chave, contagem, % do total.

Passo 5 — Copiar para relatório¶

Selecione a faixa de linhas que quer copiar (clique + Shift-clique).
Ctrl+C copia em formato TSV (tabulado).
Cole no Excel, LibreOffice Calc, Google Docs ou no relatório do GestãoAPS / Sistema da Secretaria — cada coluna vai para uma célula.

Próximos passos¶

Para gerar XLSX completo, use Arquivo → Exportar XLSX (Ctrl+E) com filtros e templates específicos.
Para comparar trimestres, troque o período manualmente e anote os totais — não há comparativo lado-a-lado nesta versão (planejado para o futuro).
Para entender como os contadores são calculados, consulte o módulo anotae/core/statistics.py no repositório — é puro Python sem ML.

Privacidade: todos os cálculos rodam localmente. Os números nunca saem da sua máquina. O sumário não contém PII por desenho — só códigos agregados.