Files
agenciapsilmno/src/docs/doc_therapist_dashboard.json
2026-03-17 21:08:14 -03:00

90 lines
22 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"titulo": "Dashboard do Terapeuta",
"categoria": "Agenda",
"pagina_path": "/therapist",
"tipo_acesso": "usuario",
"exibir_no_faq": true,
"ativo": true,
"ordem": 1,
"medias": [
{
"tipo": "imagem",
"url": ""
}
],
"conteudo": "<h2>O que é o Dashboard?</h2><p>O Dashboard é a tela inicial do terapeuta — o ponto de partida de cada dia de trabalho. Ele reúne em um único lugar as informações mais importantes da sua agenda: os compromissos de hoje, solicitações pendentes de pacientes, alertas de recorrências que precisam de atenção e um panorama visual da semana. A ideia é simples: abriu o sistema, já sabe o que te espera.</p><p>A tela é dividida em duas grandes áreas: uma <strong>barra lateral fixa à esquerda</strong> (o aside) e o <strong>conteúdo principal à direita</strong>. Juntas, elas cobrem tanto o detalhe do dia quanto a visão estratégica da semana.</p><h2>Barra lateral — Aside</h2><p>O aside fica fixo enquanto você rola o conteúdo principal. Ele tem três seções empilhadas:</p><h3>Mini Calendário</h3><p>Um calendário compacto do mês corrente. Cada dia com eventos tem um pontinho colorido embaixo do número — verde para dias tranquilos, amarelo para dias cheios e vermelho para dias com 5 ou mais eventos. Clique em qualquer dia para ver os eventos dele listados logo abaixo.</p><div style='background:#f8fafc;border-radius:10px;padding:1rem;margin:1rem 0;border:1px solid #e2e8f0;font-family:sans-serif;'><div style='display:grid;grid-template-columns:repeat(7,1fr);margin-bottom:4px;'><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>D</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>S</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>T</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>Q</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>Q</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>S</span><span style='text-align:center;font-size:0.58rem;font-weight:700;color:#94a3b8;'>S</span></div><div style='display:grid;grid-template-columns:repeat(7,1fr);gap:1px;'><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;color:#cbd5e1;'>-</div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;background:#6366f1;color:#fff;font-weight:700;position:relative;'>16<span style='position:absolute;bottom:1px;right:2px;width:4px;height:4px;border-radius:50%;background:#22c55e;'></span></div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;position:relative;background:#f1f5f9;color:#6366f1;font-weight:700;'>17<span style='position:absolute;bottom:1px;right:2px;width:4px;height:4px;border-radius:50%;background:#f59e0b;'></span></div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;'>18</div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;position:relative;'>19<span style='position:absolute;bottom:1px;right:2px;width:4px;height:4px;border-radius:50%;background:#ef4444;'></span></div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;'>20</div><div style='aspect-ratio:1;display:flex;align-items:center;justify-content:center;font-size:0.68rem;border-radius:5px;'>21</div></div></div><p>O dia atual fica destacado em roxo. O dia selecionado fica com fundo roxo claro. Dias de outros meses aparecem em cinza desbotado e não são clicáveis.</p><h3>Eventos do Dia</h3><p>Logo abaixo do calendário, aparece a lista de eventos do dia selecionado. Cada item mostra o horário de início, a duração, o nome do paciente, a modalidade (presencial ou online) e um ícone de status. A borda esquerda colorida indica o tipo: roxo para sessões padrão, azul para reuniões, verde para confirmados.</p><div style='background:#f8fafc;border-radius:8px;padding:0.75rem;margin:1rem 0;border:1px solid #e2e8f0;font-family:sans-serif;display:flex;flex-direction:column;gap:6px;'><div style='display:flex;align-items:center;gap:8px;padding:6px 8px;border-radius:7px;background:#fff;border-left:3px solid #6366f1;'><div style='display:flex;flex-direction:column;align-items:flex-end;min-width:38px;'><span style='font-size:0.7rem;font-weight:700;'>09:00</span><span style='font-size:0.57rem;color:#64748b;'>50min</span></div><div style='flex:1;'><span style='display:block;font-size:0.68rem;font-weight:600;'>Maria Souza</span><div style='display:flex;gap:3px;margin-top:2px;'><span style='font-size:0.55rem;background:#e2e8f0;color:#64748b;padding:1px 4px;border-radius:3px;font-weight:600;'>Presencial</span><span style='font-size:0.6rem;color:#6366f1;'>↻</span></div></div><span style='font-size:0.65rem;color:#94a3b8;'>🕐</span></div><div style='display:flex;align-items:center;gap:8px;padding:6px 8px;border-radius:7px;background:#fff;border-left:3px solid #22c55e;'><div style='display:flex;flex-direction:column;align-items:flex-end;min-width:38px;'><span style='font-size:0.7rem;font-weight:700;'>10:00</span><span style='font-size:0.57rem;color:#64748b;'>50min</span></div><div style='flex:1;'><span style='display:block;font-size:0.68rem;font-weight:600;'>João Lima</span><div style='display:flex;gap:3px;margin-top:2px;'><span style='font-size:0.55rem;background:#e2e8f0;color:#64748b;padding:1px 4px;border-radius:3px;font-weight:600;'>Online</span></div></div><span style='font-size:0.65rem;color:#22c55e;'>✓</span></div></div><p>O símbolo <strong>↻</strong> ao lado da modalidade indica que a sessão faz parte de uma recorrência. Se não houver nenhum evento no dia selecionado, aparece uma mensagem amigável com ícone de sol.</p><h3>Recorrências Ativas</h3><p>A terceira seção do aside lista até 8 recorrências ativas, com o nome abreviado do paciente, a frequência (Semanal, Quinzenal, Mensal ou Personalizado), os dias da semana e o horário. A coluna da direita mostra quando é a próxima sessão — <strong>Hoje</strong> fica destacado em roxo.</p><h2>Conteúdo Principal</h2><h3>Barra de Saudação e Quick Stats</h3><p>No topo do conteúdo principal, o sistema te cumprimenta com bom dia, boa tarde ou boa noite (baseado no horário real) e mostra um resumo textual do dia: quantas sessões você tem e se há solicitações aguardando. Ao lado, quatro números rápidos:</p><ul><li><strong>Hoje</strong> — total de eventos do dia</li><li><strong>Pendentes</strong> — soma de solicitações do agendador + cadastros externos aguardando triagem (fica vermelho quando há itens)</li><li><strong>Semana</strong> — total de eventos da semana corrente</li><li><strong>Presença</strong> — taxa de presença do mês até agora, calculada entre sessões realizadas e o total de encerradas (fica verde quando acima de 85%)</li></ul><h3>Linha do Tempo — Hoje</h3><p>Um dos recursos mais visuais do dashboard. A linha do tempo mostra todos os seus eventos de hoje dispostos proporcionalmente em uma régua de horas (das 7h às 20h). Cada bloco representa um evento — a largura é proporcional à duração e a posição horizontal é o horário de início.</p><div style='background:#fff;border-radius:10px;padding:14px 18px;border:1px solid #e2e8f0;font-family:sans-serif;margin:1rem 0;'><div style='display:flex;justify-content:space-between;margin-bottom:4px;'><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>7h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>9h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>11h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>13h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>15h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>17h</span><span style='font-size:0.57rem;color:#94a3b8;font-weight:600;'>19h</span></div><div style='position:relative;height:40px;background:#f8fafc;border-radius:7px;overflow:visible;'><div style='position:absolute;top:3px;height:34px;border-radius:5px;background:#6366f1;display:flex;align-items:center;padding:0 6px;left:15.4%;width:5.9%;'><span style='font-size:0.58rem;font-weight:700;color:#fff;white-space:nowrap;'>Maria</span></div><div style='position:absolute;top:3px;height:34px;border-radius:5px;background:#22c55e;display:flex;align-items:center;padding:0 6px;left:23.1%;width:5.9%;'><span style='font-size:0.58rem;font-weight:700;color:#fff;white-space:nowrap;'>João</span></div><div style='position:absolute;top:3px;height:34px;border-radius:5px;background:#0ea5e9;display:flex;align-items:center;padding:0 6px;left:46.1%;width:5.9%;'><span style='font-size:0.58rem;font-weight:700;color:#fff;white-space:nowrap;'>Reunião</span></div><div style='position:absolute;top:0;height:100%;left:38%;display:flex;flex-direction:column;align-items:center;pointer-events:none;z-index:20;'><div style='width:2px;height:100%;background:#ef4444;opacity:0.8;'></div><div style='position:absolute;top:-2px;width:7px;height:7px;border-radius:50%;background:#ef4444;'></div></div></div></div><p>A linha vermelha vertical mostra o horário atual em tempo real — ela se move conforme o relógio avança. Passe o mouse sobre um bloco para ver o tooltip com o horário completo, nome do paciente e modalidade. Blocos azuis são reuniões, verdes são sessões confirmadas e roxos são sessões agendadas. O emoji 📱 aparece nos eventos online.</p><h3>Cards de Notificação</h3><p>Quatro cards dispostos em grid 2×2 monitoram áreas críticas da sua operação:</p><h4>Agendador Online <a data-highlight=\"card-agendador\" data-route=\"/therapist\" href=\"#\">Ver na tela</a></h4><p>Mostra solicitações de agendamento recebidas pelo portal externo (pacientes que pediram horário pelo link público). Cada item mostra o nome, tipo (primeira consulta ou retorno), modalidade e data solicitada. Você pode aceitar ou recusar diretamente no card. Quando há solicitações, o card ganha uma borda vermelha e um badge com a contagem. Clicar em <em>Ver todas →</em> leva para a página completa de solicitações.</p><div style='background:#fff;border-radius:10px;border:1.5px solid #fca5a5;box-shadow:0 0 0 3px rgba(239,68,68,0.07);font-family:sans-serif;margin:1rem 0;overflow:hidden;'><div style='display:flex;align-items:center;gap:10px;padding:12px 14px 8px;border-bottom:1px solid #f1f5f9;'><div style='width:32px;height:32px;border-radius:8px;background:rgba(239,68,68,0.1);color:#ef4444;display:flex;align-items:center;justify-content:center;font-size:0.9rem;'>📥</div><div style='flex:1;'><span style='display:block;font-size:0.78rem;font-weight:700;'>Agendador Online</span><span style='display:block;font-size:0.62rem;color:#64748b;'>Solicitações do portal externo</span></div><span style='border-radius:99px;padding:2px 7px;font-size:0.65rem;font-weight:700;background:#fef2f2;color:#ef4444;border:1px solid #fca5a5;'>2</span></div><div style='padding:8px 14px;display:flex;flex-direction:column;gap:6px;'><div style='display:flex;align-items:center;gap:8px;'><div style='width:28px;height:28px;border-radius:50%;background:linear-gradient(135deg,#6366f1,#0ea5e9);color:#fff;font-size:0.6rem;font-weight:700;display:flex;align-items:center;justify-content:center;'>CA</div><div style='flex:1;'><span style='display:block;font-size:0.72rem;font-weight:600;'>Carlos Andrade</span><span style='display:block;font-size:0.6rem;color:#64748b;'>Primeira consulta · Presencial · 18/03</span></div><div style='display:flex;gap:3px;'><button style='display:flex;align-items:center;gap:3px;padding:3px 9px;border-radius:5px;border:none;background:#dcfce7;color:#16a34a;font-size:0.6rem;font-weight:700;cursor:pointer;'>✓ Aceitar</button><button style='padding:3px 7px;border-radius:5px;border:none;background:#fef2f2;color:#ef4444;font-size:0.6rem;cursor:pointer;'>✕</button></div></div></div><div style='padding:6px 14px;font-size:0.65rem;font-weight:700;color:#6366f1;border-top:1px solid #f1f5f9;'>Ver todas →</div></div><h4>Cadastros Externos <a data-highlight=\"card-cadastros\" data-route=\"/therapist\" href=\"#\">Ver na tela</a></h4><p>Pacientes que preencheram o formulário de cadastro pelo portal e aguardam triagem. O badge azul indica quantos estão esperando. Clique na setinha ao lado de cada nome para ir direto à ficha de triagem daquele paciente. O link <em>Gerenciar triagem →</em> abre a lista completa.</p><h4>Recorrências — Atenção Necessária <a data-highlight=\"card-recorrencias\" data-route=\"/therapist\" href=\"#\">Ver na tela</a></h4><p>Este card monitora automaticamente suas recorrências ativas e exibe alertas quando algo precisa de ação. Há três tipos de alerta:</p><ul><li><strong>Limite próximo</strong> (vermelho) — quando uma recorrência com número máximo de sessões já usou mais de 75%. Uma barra de progresso mostra visualmente o quanto foi consumido.</li><li><strong>Encerramento próximo</strong> (azul) — quando a data de fim da recorrência está nos próximos 30 dias.</li><li><strong>Conflito</strong> (amarelo) — quando a recorrência tem algum conflito de horário.</li></ul><div style='background:#fff;border-radius:10px;border:1px solid #e2e8f0;font-family:sans-serif;margin:1rem 0;overflow:hidden;'><div style='display:flex;align-items:center;gap:10px;padding:12px 14px 8px;border-bottom:1px solid #f1f5f9;'><div style='width:32px;height:32px;border-radius:8px;background:rgba(245,158,11,0.1);color:#f59e0b;display:flex;align-items:center;justify-content:center;'>🔁</div><div style='flex:1;'><span style='display:block;font-size:0.78rem;font-weight:700;'>Recorrências</span><span style='display:block;font-size:0.62rem;color:#64748b;'>Atenção necessária</span></div><span style='border-radius:99px;padding:2px 7px;font-size:0.65rem;font-weight:700;background:#fffbeb;color:#f59e0b;border:1px solid #fde68a;'>1</span></div><div style='padding:8px 14px;'><div style='display:flex;align-items:center;gap:10px;padding:4px 0;'><div style='flex:1;'><span style='display:block;font-size:0.7rem;font-weight:600;'>Ana Ferreira</span><span style='display:block;font-size:0.6rem;font-weight:600;color:#ef4444;'>Limite próximo</span></div><div style='display:flex;align-items:center;gap:6px;'><div style='width:55px;height:5px;border-radius:3px;background:#e2e8f0;overflow:hidden;'><div style='width:82%;height:100%;border-radius:3px;background:#ef4444;'></div></div><span style='font-size:0.58rem;color:#64748b;'>16/20</span></div></div></div><div style='padding:6px 14px;font-size:0.65rem;font-weight:700;color:#6366f1;border-top:1px solid #f1f5f9;'>Ver recorrências →</div></div><h4>Radar da Semana</h4><p>Um gráfico de barras simples mostrando o volume de eventos em cada dia da semana atual. A cor de cada barra representa o status predominante do dia: roxo/azul para dias com boa presença, vermelho para dias com muitas faltas e amarelo para dias com reposições. O dia atual fica com o rótulo destacado em roxo. Abaixo do gráfico, uma legenda explica as cores.</p><h3>Compromissos Especiais</h3><p>No rodapé do conteúdo principal, a seção de Compromissos Especiais lista os próximos eventos do tipo <em>bloqueio</em> que possuem título — reuniões, supervisões, eventos externos, ou qualquer compromisso que você tenha registrado fora das sessões de pacientes. Cada item mostra o título, a modalidade, a data e o status (Agendado, Confirmado, Pendente). A barra colorida à esquerda de cada item é apenas visual para facilitar a leitura. Clique em <em>Ver todos →</em> para acessar a lista completa de compromissos.</p><h2>Atualização dos dados</h2><p>O dashboard carrega os dados automaticamente ao abrir a página. O relógio e a linha do tempo se atualizam a cada minuto sem precisar recarregar. Para atualizar os dados de agenda manualmente, basta fechar e reabrir a página ou navegar para outra seção e voltar.</p>",
"_faq_itens": [
{
"pergunta": "O que aparece no Dashboard quando abro o sistema?",
"resposta": "O Dashboard carrega automaticamente os eventos do mês atual, as solicitações de agendamento pendentes, os cadastros externos aguardando triagem e as regras de recorrência ativas. No topo você vê a saudação com um resumo do dia, os quatro números rápidos (Hoje, Pendentes, Semana e Presença) e logo abaixo a linha do tempo visual com os eventos de hoje.",
"ordem": 0,
"ativo": true
},
{
"pergunta": "Como aceito ou recuso uma solicitação de agendamento pelo Dashboard?",
"resposta": "No card <a data-highlight=\"card-agendador\" data-route=\"/therapist\" href=\"#\">Agendador Online</a>, cada solicitação tem dois botões: o verde <strong>Aceitar</strong> e o vermelho <strong>Recusar</strong>. Clique diretamente no card. Ao aceitar, o status muda para 'autorizado' e ela some da lista. Ao recusar, muda para 'recusado'. Para ver todas as solicitações com mais detalhes, clique em <strong>Ver todas →</strong> no rodapé do card ou acesse <strong>Agendador → Solicitações</strong> (<code>/therapist/agendador/solicitacoes</code>).",
"ordem": 1,
"ativo": true
},
{
"pergunta": "O que significa o pontinho colorido embaixo dos dias no mini calendário?",
"resposta": "O pontinho indica que aquele dia tem eventos. A cor varia conforme a quantidade: verde para dias com poucos eventos (1-2), amarelo para dias moderados (3-4) e vermelho para dias intensos (5 ou mais). Clique no dia para ver a lista de eventos daquele dia na seção 'Eventos do Dia' logo abaixo do calendário.",
"ordem": 2,
"ativo": true
},
{
"pergunta": "O que é a linha vermelha na linha do tempo?",
"resposta": "A linha vermelha vertical indica o horário atual. Ela se move automaticamente a cada minuto, então você sempre sabe em qual ponto do dia está em relação à sua agenda. Qualquer evento à esquerda da linha já passou, qualquer evento à direita ainda está por vir.",
"ordem": 3,
"ativo": true
},
{
"pergunta": "O que são os 'Cadastros Externos'?",
"resposta": "São pacientes que se cadastraram pelo portal público e ainda não foram triados. Aparecem no card <a data-highlight=\"card-cadastros\" data-route=\"/therapist\" href=\"#\">Cadastros Externos</a> com o status 'novo'. Clique na seta ao lado do nome para abrir diretamente a ficha de triagem daquele paciente, ou acesse a lista completa em <strong>Gerenciar triagem →</strong> no rodapé do card (<code>/therapist/pacientes/triagem</code>).",
"ordem": 4,
"ativo": true
},
{
"pergunta": "O que significa o alerta 'Limite próximo' no card de Recorrências?",
"resposta": "Significa que uma recorrência com número máximo de sessões já utilizou mais de 75% das sessões disponíveis. Por exemplo, se você configurou 20 sessões e já foram realizadas 16, o sistema alerta automaticamente. Veja o card <a data-highlight=\"card-recorrencias\" data-route=\"/therapist\" href=\"#\">Recorrências</a> para identificar quais precisam de atenção. Para gerenciar todas as recorrências ativas, clique em <strong>Ver recorrências →</strong> no rodapé do card ou acesse <code>/therapist/agenda/recorrencias</code>.",
"ordem": 5,
"ativo": true
},
{
"pergunta": "O que é o 'Radar da Semana'?",
"resposta": "É um gráfico de barras no card <a data-highlight=\"card-radar\" data-route=\"/therapist\" href=\"#\">Radar da Semana</a> que mostra o volume de eventos em cada dia da semana atual. A cor de cada barra indica o status predominante: roxo/azul para dias com boa presença, vermelho para dias com muitas faltas e amarelo para dias com reposições. O dia atual fica com o rótulo destacado em roxo. É uma forma rápida de visualizar como foi a semana sem precisar abrir a agenda.",
"ordem": 6,
"ativo": true
},
{
"pergunta": "O que são os 'Compromissos Especiais'?",
"resposta": "São eventos do tipo 'bloqueio' com título — reuniões, supervisões, cursos ou qualquer compromisso registrado fora das sessões de pacientes. O dashboard lista os próximos 5, ordenados por data. Clique em <strong>Ver todos →</strong> para acessar a lista completa em <code>/therapist/compromissos</code>.",
"ordem": 7,
"ativo": true
},
{
"pergunta": "Como é calculada a taxa de presença nos Quick Stats?",
"resposta": "A taxa de presença considera todos os eventos do mês atual que já foram encerrados (com status 'presente', 'realizado', 'faltou' ou 'cancelado'). A porcentagem é calculada dividindo os eventos com presença confirmada pelo total de eventos encerrados. Fica verde quando está acima de 85% e aparece como '—' se ainda não há eventos encerrados no mês.",
"ordem": 8,
"ativo": true
},
{
"pergunta": "O símbolo ↻ ao lado de um evento na lista do dia significa o quê?",
"resposta": "Indica que aquela sessão faz parte de uma recorrência — ou seja, é uma sessão repetida de uma série já configurada. Sessões avulsas (sem recorrência) não exibem esse símbolo.",
"ordem": 9,
"ativo": true
},
{
"pergunta": "Os dados do Dashboard atualizam automaticamente?",
"resposta": "O relógio e a posição da linha do tempo atualizam a cada minuto automaticamente. Os dados de agenda, solicitações e recorrências são carregados uma vez ao abrir a página. Para ver novos dados (como uma nova solicitação que chegou enquanto você estava na tela), recarregue a página ou navegue para outra seção e volte.",
"ordem": 10,
"ativo": true
},
{
"pergunta": "Posso aceitar uma solicitação e ela já entra na minha agenda?",
"resposta": "Aceitar uma solicitação pelo Dashboard apenas muda o status dela para 'autorizado' — ela ainda não cria um evento automaticamente na agenda. Para concluir o agendamento e definir o horário exato, acesse a página de Solicitações: no card <strong>Agendador Online</strong> do Dashboard, clique em <a data-highlight=\"card-agendador\" data-route=\"/therapist\" href=\"#\">Ver na tela</a> e depois em <strong>Ver todas →</strong> no rodapé do card, ou navegue diretamente pelo menu em <strong>Agendador → Solicitações</strong> (<code>/therapist/agendador/solicitacoes</code>). Lá você verá todos os detalhes da solicitação, poderá escolher o horário e confirmar o agendamento completo.",
"ordem": 11,
"ativo": true
}
]
}