Layout 100%, Notificações, SetupWizard

src/docs/doc_agenda_terapeuta.json

@@ -0,0 +1,90 @@
+{
+  "titulo": "Agenda · Gerenciamento de Compromissos",
+  "conteudo": "<h2>Como funciona a Agenda</h2>\n<p>A Agenda é o coração operacional do sistema. Ela exibe todos os seus compromissos em três modos de visualização — Dia, Semana e Mês — e se divide em três colunas no desktop: calendário mini à esquerda, grade principal no centro e resumo do dia à direita.</p>\n\n<h3>Barra de controles (topbar)</h3>\n<p>A barra superior fica fixada ao topo da página enquanto você rola. Ela contém todos os controles de navegação e filtros:</p>\n<ul>\n  <li><strong>Seta ‹ / ›</strong> — navega para o período anterior ou seguinte</li>\n  <li><strong>Data pill</strong> — clique na data exibida no centro para abrir o seletor de mês e ir direto para qualquer período</li>\n  <li><strong>Hoje</strong> — retorna imediatamente para o dia atual</li>\n  <li><strong>Dia / Semana / Mês</strong> — alterna o modo de visualização da grade principal</li>\n  <li><strong>24h / 12h / Meu Horário</strong> — define o intervalo de horas exibido. \"Meu Horário\" usa as regras de jornada configuradas</li>\n  <li><strong>Apenas Sessões / Tudo</strong> — oculta ou exibe bloqueios e outros tipos de compromisso</li>\n  <li><strong>Buscar</strong> — pesquisa por nome de paciente, título ou observação nos eventos do período ou mês inteiro</li>\n  <li><strong>+ (Novo compromisso)</strong> — abre o formulário de criação diretamente</li>\n  <li><strong>Bloquear</strong> — cria bloqueios de horário, período, dia inteiro ou por feriados</li>\n  <li><strong>↻ Recorrências</strong> — navega para a página de gerenciamento de séries recorrentes</li>\n  <li><strong>⚙ Configurações</strong> — acessa as configurações da agenda (jornada, duração de sessão, etc.)</li>\n</ul>\n\n<h3>Grade principal (centro)</h3>\n<p>É onde o FullCalendar exibe os eventos. Você pode:</p>\n<ul>\n  <li><strong>Clicar em um horário vazio</strong> para criar um novo compromisso naquele slot</li>\n  <li><strong>Arrastar um evento</strong> para mover de horário</li>\n  <li><strong>Redimensionar um evento</strong> pelas bordas para alterar a duração</li>\n  <li><strong>Clicar em um evento</strong> para abrir o dialog de edição</li>\n</ul>\n\n<div style=\"border:1px solid #e2e8f0;border-radius:6px;overflow:hidden;margin:12px 0;\">\n  <div style=\"background:#6366f1;color:#fff;padding:6px 10px;font-size:12px;font-weight:700;\">Sessão — 09:00</div>\n  <div style=\"padding:8px 10px;font-size:12px;background:#f8fafc;\">\n    <div style=\"font-weight:600;\">Leonardo Alves</div>\n    <div style=\"opacity:.6;font-size:11px;\">Presencial · 50min</div>\n  </div>\n</div>\n<div style=\"border:1px solid #fecaca;border-radius:6px;overflow:hidden;margin:12px 0;\">\n  <div style=\"background:#ef4444;color:#fff;padding:6px 10px;font-size:12px;font-weight:700;opacity:.8;\">Bloqueio — 13:00</div>\n  <div style=\"padding:8px 10px;font-size:12px;background:#fff5f5;\">\n    <div style=\"font-weight:600;\">Almoço</div>\n    <div style=\"opacity:.6;font-size:11px;\">60min</div>\n  </div>\n</div>\n\n<h3>Coluna esquerda — Calendário mini</h3>\n<p>Exibe o mês atual com indicadores visuais por dia:</p>\n<ul>\n  <li><strong>Fundo verde claro</strong> — dia com jornada de trabalho configurada</li>\n  <li><strong>Fundo vermelho suave</strong> — dia de folga (sem jornada)</li>\n  <li><strong>Fundo vermelho forte</strong> — dia com bloqueio total</li>\n  <li><strong>Pontinho colorido</strong> no canto inferior direito do número — dia tem eventos agendados</li>\n</ul>\n<p>Clique em qualquer dia para navegar diretamente até ele na grade principal.</p>\n\n<h3>Coluna direita — Resumo do dia</h3>\n<p>Exibe um painel com quatro contadores (Total, Agendado, Realizado, Faltou) e a lista de sessões do dia atual ordenadas por horário. Cada sessão tem uma barra colorida lateral indicando o status. Clicar em uma sessão navega até ela na grade.</p>\n\n<h3>Atalhos rápidos (coluna direita)</h3>\n<p>Abaixo das sessões ficam cards de acesso rápido a <strong>Pacientes</strong> (lista, novo cadastro e link de cadastro externo) e <strong>Agendador Online</strong> (solicitações e link público para compartilhar com pacientes).</p>\n\n<h3>Aviso de compromissos fora da jornada</h3>\n<p>Quando há eventos agendados fora do seu horário de trabalho e você está no modo \"Meu Horário\", aparece um alerta amarelo com o botão <strong>Ver 24h</strong> para expandir a grade e visualizar todos os eventos.</p>\n\n<h3>Mobile (telas menores)</h3>\n<p>Em telas menores que 1280px, as colunas laterais somem e aparecem dois elementos:</p>\n<ul>\n  <li>Um botão <strong>\"Calendário · Sessões de hoje\"</strong> abre um drawer deslizante com todo o conteúdo das colunas esquerda e direita</li>\n  <li>O botão <strong>Ações</strong> no canto da topbar concentra todas as funções de navegação e filtro</li>\n</ul>",
+  "categoria": "Agenda",
+  "exibir_no_faq": true,
+  "tipo_acesso": "usuario",
+  "pagina_path": "/therapist/agenda",
+  "ordem": 2,
+  "ativo": true,
+  "medias": [
+    {
+      "tipo": "imagem",
+      "url": ""
+    }
+  ],
+  "_faq_itens": [
+    {
+      "pergunta": "Como crio um novo compromisso?",
+      "resposta": "Você pode criar de três formas: clique no botão <strong>+</strong> na topbar para abrir o formulário com os dados em branco; clique em um horário vazio na grade do calendário para criar já com o horário pré-preenchido; ou selecione um intervalo arrastando na grade para definir início e fim automaticamente.",
+      "ordem": 0,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como movo ou altero a duração de uma sessão?",
+      "resposta": "Diretamente na grade: <strong>arraste o evento</strong> para mover de horário ou dia. Para alterar a duração, <strong>arraste a borda inferior</strong> do evento. Ao soltar, o sistema salva automaticamente. Você também pode editar clicando no evento e alterando os campos no dialog.",
+      "ordem": 1,
+      "ativo": true
+    },
+    {
+      "pergunta": "O que significa o fundo colorido nos dias do mini calendário?",
+      "resposta": "Verde claro indica dia com jornada de trabalho configurada. Vermelho suave indica folga (sem jornada naquele dia da semana). Vermelho forte indica que o dia está bloqueado por inteiro — sessões não são permitidas. O pontinho no canto inferior direito do número indica que há eventos agendados naquele dia.",
+      "ordem": 2,
+      "ativo": true
+    },
+    {
+      "pergunta": "O que é o modo 'Meu Horário' e como configurá-lo?",
+      "resposta": "O modo <strong>Meu Horário</strong> faz a grade exibir apenas o intervalo de horas da sua jornada de trabalho — por exemplo, de 08h às 18h — ocultando os horários fora do expediente. Para configurar sua jornada, clique no botão <strong>⚙ Configurações</strong> na topbar. Se houver eventos fora do horário configurado, um aviso amarelo aparece com o botão <strong>Ver 24h</strong>.",
+      "ordem": 3,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como bloquear um horário ou dia inteiro?",
+      "resposta": "Clique no botão <strong>Bloquear</strong> (vermelho) na topbar e escolha o tipo: <em>Por Horário</em> bloqueia um intervalo específico; <em>Por Período</em> bloqueia vários dias seguidos; <em>Por Dia</em> bloqueia o dia inteiro impedindo agendamentos; <em>Por Feriados</em> gera bloqueios automáticos nos feriados dos próximos 30 dias que ainda estiverem abertos.",
+      "ordem": 4,
+      "ativo": true
+    },
+    {
+      "pergunta": "O que é o sino de feriados e quando ele aparece?",
+      "resposta": "O sino 🔔 aparece na topbar quando há feriados nos próximos 30 dias em dias de trabalho. Se estiver vermelho com número, indica feriados sem bloqueio — ou seja, pacientes poderiam agendar nesses dias. Clique no sino para ver a lista e bloquear individualmente ou todos de uma vez.",
+      "ordem": 5,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como funciona a busca na agenda?",
+      "resposta": "Digite o nome do paciente, título do compromisso ou uma observação no campo de busca da topbar. A busca pode ser feita no <em>Período atual</em> (eventos visíveis na grade) ou no <em>Mês inteiro</em>. Os resultados aparecem em uma lista acima do calendário. Clique em um resultado para navegar até o evento. A busca ignora maiúsculas e acentos.",
+      "ordem": 6,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como gerencio sessões recorrentes?",
+      "resposta": "Ao criar ou editar um compromisso, você pode ativá-lo como recorrente definindo frequência e número de sessões. Eventos recorrentes aparecem com o símbolo <strong>↻</strong> na lista do dia. Para gerenciar todas as séries ativas — ver quantas sessões foram realizadas, editar ou encerrar uma série — clique no botão <strong>↻ Recorrências</strong> na topbar.",
+      "ordem": 7,
+      "ativo": true
+    },
+    {
+      "pergunta": "O que acontece quando aceito uma solicitação pelo Agendador Online?",
+      "resposta": "Aceitar uma solicitação pelo card de atalho muda o status para <em>autorizado</em>, mas ainda não cria o evento na agenda. Para concluir o agendamento, acesse <strong>Agendador → Solicitações</strong> (<code>/therapist/agendador/solicitacoes</code>), onde você define o horário exato e confirma o agendamento completo.",
+      "ordem": 8,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como compartilho o link do agendador com meus pacientes?",
+      "resposta": "Na coluna direita da agenda, no card <strong>Agendador Online</strong>, há um campo com o link público já gerado e um botão de copiar ao lado. Cole esse link no WhatsApp, e-mail ou onde preferir. O paciente acessa uma página pública onde escolhe o horário disponível e envia a solicitação. Se o link não aparecer, verifique se o agendador está ativado em Configurações.",
+      "ordem": 9,
+      "ativo": true
+    },
+    {
+      "pergunta": "Como adiciono um paciente direto pela agenda?",
+      "resposta": "No card <strong>Pacientes</strong> da coluna direita, clique em <strong>Novo paciente</strong> para abrir o formulário de cadastro manual. Para compartilhar o formulário de auto-cadastro com o próprio paciente, copie o <strong>Link de cadastro externo</strong> exibido no mesmo card e envie para ele.",
+      "ordem": 10,
+      "ativo": true
+    },
+    {
+      "pergunta": "No mobile, como acesso o mini calendário e as sessões do dia?",
+      "resposta": "Em telas menores que 1280px, as colunas laterais ficam ocultas para dar mais espaço ao calendário. Toque no botão <strong>Calendário · Sessões de hoje</strong> que aparece acima da grade — ele abre um drawer deslizante com o mini calendário, a jornada do dia, os feriados próximos, os contadores do dia e a lista de sessões. Tocar em uma sessão na lista fecha o drawer e navega até o evento na grade.",
+      "ordem": 11,
+      "ativo": true
+    }
+  ]
+}