Regras do sistema — Psico Agenda
1. Visão geral — o caminho de uma avaliação
- Guia de exames sobe no sistema (upload com leitura por IA).
- Se a guia tem exame psicossocial e a clínica está bloqueada, o motor agenda AUTOMATICAMENTE com a nossa equipe: escolhe data e psicóloga, cria o link do Meet e convida o paciente por WhatsApp.
- O paciente entra pela página de acesso (CPF), responde o questionário e assina com selfie — a confirmação no WhatsApp, quando acontece, é só informativa.
- A psicóloga atende pela Sala, preenche anamnese/observações e gera o ATESTADO + PRONTUÁRIO assinados.
- O laudo vai sozinho para o site de gestão (Arquivo Digital) e para os contatos da clínica; a sessão vira item pagável no financeiro.
2. Clínicas bloqueadas e detecção do psicossocial
- Bloquear uma clínica em [psico_clinicas] significa: TODO psicossocial dela passa a ser feito pela nossa equipe.
- A detecção procura variações de "avaliação de fatores psicossociais" (qualquer exame contendo "psicossoc", sem diferenciar acento/caixa).
- Ao bloquear: as guias dos últimos 14 dias da clínica são reavaliadas, e a linha de preço "Psicossocial" dela é DESATIVADA na tabela de custos (o custo passa a ser o da psicóloga). Desbloquear reativa o preço (exceto linha que você inativou manualmente).
- Cada clínica bloqueada pode ter e-mails e WhatsApps de contato: o laudo CONCLUÍDO e assinado é enviado a eles automaticamente.
3. Agendamento automático (empilhador)
- Data: O QUANTO ANTES — de hoje até a véspera dos demais exames, em ordem crescente; sem vaga antes, tenta do dia dos exames em diante, dentro de 30 dias.
- Psicóloga: distribuição IGUAL — entre as que têm vaga na data, ganha a de MENOR carga futura; empate vai para quem está há mais tempo sem receber. 5 guias e 5 psicólogas livres = 1 para cada; só 1 livre = leva todas.
- Duração da sessão: 10 min; ASO de RETORNO AO TRABALHO usa duração própria de 30 min.
- Intervalo entre sessões (colchão): 5 min; nos primeiros 10 dias de operação o intervalo é de 10 min (rampa).
- Horário útil da agenda: 08:00 às 18:00 (configurável no card Geral).
- Regras livres por IA: nenhuma cadastrada (vale só a regra fixa acima).
- Guia re-subida NUNCA duplica: processo com sessão PENDENTE ou REALIZADA é ignorado (com registro no log). Para REAGENDAR um processo: cancele (ou mande à lixeira) a sessão na agenda e clique em "Reavaliar esta guia" em [psico_clinicas] (ou suba a guia de novo).
- Bloquear uma clínica reavalia as guias dela dos últimos 14 dias, mas NÃO remarca sozinho processo cuja sessão foi cancelada — isso fica registrado no log para a gestão decidir.
4. Fila e log — onde olhar quando "nada aconteceu"
- Toda guia de CLÍNICA BLOQUEADA deixa rastro no card "Últimos processamentos" de [psico_clinicas]: agendada, sem vaga (fila), já tem sessão, sem psicossocial na lista da IA, sem CPF válido. Guias comuns (de clínicas não bloqueadas e sem psicossocial) não geram linha — seria ruído de centenas por dia.
- O mesmo card mostra até que número o motor já leu as guias e quantas ainda faltam; "Reavaliar esta guia" reprocessa uma guia específica na hora (pelo nº da guia ou do agendamento) e diz o que o sistema decidiu.
- Sem vaga em nenhuma data: a guia entra na FILA (ordem de chegada) e é reprocessada quando alguém libera horários na escala, quando uma clínica muda, ou na próxima vez que alguém usar o sistema (respeitando um intervalo mínimo de 10 minutos entre tentativas).
- O botão "Rodar motor agora" força uma varredura imediata (avisa se outra já está em andamento).
5. Escala da psicóloga ([psico_disponibilidade])
- Escala por MÊS FECHADO, navegável; cada dia é uma RÉGUA de quadradinhos de 10 min: pinte de verde os horários em que atende (clique ou clique-e-arraste; clicar de novo fecha). O resumo do dia ("08:00-12:00, 13:30-14:30") aparece ao lado, ao vivo. Horário picotado é só arrastar. Tudo começa fechado — só o que ela pintar vira capacidade.
- Atalhos: Dia todo e Limpar por dia; Repetir nos dias úteis copia o desenho do dia para o mês inteiro (pula fds/feriado); no topo, o Horário padrão aceita quantos períodos picotados precisar (botão + período) e "Aplicar aos dias úteis"/"a todos" pinta o mês com esse desenho; "Limpar o mês" zera. Quadradinho escuro tem sessão marcada. Nada disso grava — o botão Salvar é o único gravador.
- Dias passados ficam travados; salvar só altera o mês aberto.
- Fechar um horário que tem sessão PENDENTE dentro é RECUSADO (o aviso lista os horários) — transfira ou remarque a sessão antes.
6. Agenda e bloqueios ([agenda_psicologa])
- Cada cartão mostra "#processo · nome · empresa". Cores por status (legenda no rodapé da agenda).
- Bloqueio: dia inteiro ou faixa de horas; para UMA psicóloga ou GERAL (todas). Bloqueio com sessões no período (pendentes ou já realizadas) é RECUSADO e o aviso lista os horários. Sessão pendente: use TRANSFERIR no modal (valida a agenda de destino e atualiza o Meet), remarque ou cancele. Sessão já realizada: bloqueie apenas as horas livres do dia (o histórico não se apaga).
- O agendamento automático respeita bloqueios, sessões existentes (com a duração de cada uma), o colchão e a escala. Criar/remarcar/transferir/restaurar À MÃO e o webhook também: horário bloqueado é RECUSADO — e sessão SEM psicóloga é travada por QUALQUER bloqueio no horário (escolha uma psicóloga livre ou outro horário).
- Lixeira: restaurar devolve a sessão (e reenvia convite se pendente futura não confirmada), mas é RECUSADO se o processo já ganhou outra sessão ativa nesse meio-tempo. Sessão na lixeira ou cancelada libera o motor a remarcar o processo quando a guia é re-subida ou reavaliada.
7. WhatsApp e confirmação do paciente
- Anti-bloqueio: a 1ª mensagem NÃO tem link — pede resposta (OK). O link de acesso só sai DEPOIS que o paciente responde. SAIR/PARAR = não recebe mais.
- A confirmação vale por agendamento: só resposta POSTERIOR ao convite confirma (resposta antiga não conta). Remarcação zera e pede confirmação de novo. IMPORTANTE: a confirmação é só INFORMATIVA — o questionário e a videochamada do paciente NÃO dependem dela.
- Limite de envios: 50 por dia, com intervalo entre mensagens (anti-ban). Guia sem telefone: o convite NÃO sai — o log avisa.
- ATENÇÃO (shadowban): se a GreenAPI não entrega para números desconhecidos, o paciente NÃO recebe a URL da página de acesso por WhatsApp. A página é FIXA (a mesma para todos — o paciente se identifica pelo CPF): distribua a URL por qualquer outro canal (e-mail, SMS, WhatsApp pessoal da equipe) que o fluxo segue normal.
8. Paciente — acesso, questionário e assinatura
- Entrada pela página de acesso digitando o CPF (sem senha). O questionário abre direto — sem depender de confirmação no WhatsApp.
- Questionário em carrossel (uma pergunta por vez); ao enviar, o paciente ASSINA com selfie obrigatória (câmera frontal) + GPS + IP — evidência gravada no prontuário (Lei 14.063/2020).
- O botão da videochamada fica no FINAL da página e habilita quando o questionário é enviado (não há trava de data: quem responde antes já vê o botão — a sala só tem gente na hora marcada).
- Sessão realizada: a página mostra "Sessão finalizada" (sem reabrir formulário).
9. Sala, atestado e prontuário (padrão CFP)
- A ficha do candidato (empresa, função, GHE, telefone, nascimento/idade) aparece no topo da Sala; abaixo dela, a tabela de passos na ordem: 1 videochamada, 2 respostas do paciente, 3 prontuário e tipo de laudo, 4 gerar e assinar, 5 documentos, 6 encerrar sessão.
- Página 1 = ATESTADO PSICOLÓGICO: veredito + cargo e Risco/NR (campo do modal) + metodologia genérica. Sem conteúdo clínico.
- PRONTUÁRIO (interno): registro da demanda completo, instrumento(s) NOMEADO(S) — vigente: Entrevista semiestruturada e questionário de rastreio de sintomas (autorrelato, compatível com o SRQ-20/OMS). —, síntese da entrevista (anamnese, NUNCA sai no atestado), questionário assinado pelo paciente e observações.
- Assinatura da psicóloga com foto ao vivo + GPS + hash; QR de autenticidade em cada laudo. REEMITIR inutiliza o PDF anterior (o QR do papel antigo responde "substituído").
10. Envio do laudo concluído
- Ao gerar e assinar: o laudo + prontuário vão para o site de gestão (Arquivo Digital), com o nº do processo no vínculo.
- Se o envio falhar (token, queda), entra na fila de REENVIO AUTOMÁTICO — sai sozinho ao abrir a Sala, sem duplicar.
- Os contatos da clínica (e-mails/WhatsApps de [psico_clinicas]) recebem o laudo APENAS quando assinado.
11. Financeiro e OS das psicólogas
- Cada psicóloga tem preço por sessão ([psico_financeiro]); sessão PAGÁVEL = realizada + laudo ASSINADO.
- As pagáveis entram na competência do MÊS SEGUINTE ao da sessão e aparecem na tela OS Fornecedores (0200) como fornecedor "PSICOLOGA-…", junto das clínicas — emissão, pagamento e impressão por lá.
- Serviço feito interno custa o preço da psicóloga (a linha "Psicossocial" da clínica bloqueada fica inativa); sessão remarcada/despagável sai sozinha da apuração.
12. Extrato, analítico e LGPD
- [psico_extrato]: tabela analítica do mês por psicóloga — cada uma vê SÓ os próprios atendimentos; gestão vê todas. Exportação CSV sem dados clínicos (corte LGPD).
- [analitico_psico]: visão de gestão com filtros, agregação por empresa/GHE, links dos PDFs e exportação.
13. Número único do processo (agendamento_id)
O nº da solicitação (ex.: #5228) acompanha TUDO: cartão da agenda, telas da psicóloga, rodapé do laudo e do prontuário, extrato, financeiro e o vínculo no site de gestão. É por ele que se busca qualquer atendimento, de ponta a ponta.
Os valores em destaque são os VIGENTES agora: duração, intervalos, rampa e horário útil ficam no card Geral de [painel_config_psico]; o limite diário de WhatsApp, no card GreenAPI; a janela de 30 dias do agendamento automático é fixa no sistema. Versão das regras: 1.0.5.