Admin - Histórico Clínico de Vínculo

Descrição

Rota relacionada: /admin/anamnesis/forms.

Essa tela permite gerenciar o histórico clínico dinâmico usado como requisito mínimo para vínculo de clientes com orientadora.

Quando usar

• Para criar uma nova versão de formulário.
• Para ajustar perguntas e regras condicionais sem deploy de frontend.
• Para publicar uma versão ativa para clientes.

Passo a passo

1. Abra Admin > Histórico Clínico.
2. Clique em Criar draft.
3. Selecione o draft na lista de formulários.
4. No Editor visual, adicione/edite perguntas e ordem.
5. Configure obrigatoriedade, opções e regras condicionais (required_if).
6. Clique em Salvar perguntas.
7. Revise a flag Aceitar para vínculo ao publicar.
8. Clique em Publicar formulário.

Editor visual x JSON avançado

• Editor visual: recomendado para operação diária.
• JSON avançado: útil para ajustes pontuais e manutenção técnica.

Compatibilidade de versões

• A versão publicada mais recente vira ativa.
• Versões anteriores podem continuar aceitas para vínculo quando marcadas para compatibilidade.
• Isso evita exigir refação imediata do histórico clínico para todas as clientes.

Tour guiado

A página possui tour contextual com os blocos:

• ajuda rápida
• lista de formulários
• editor
• ações de salvar/publicar

Use o atalho de tour no cabeçalho para revisar o fluxo quando necessário.

Problemas comuns

• Nenhum formulário na cliente: confirme se existe versão publicada ativa.
• Falha ao publicar: verifique se o formulário está em draft e se as perguntas foram salvas.
• Campos condicionais não acionam: valide required_if.question_key e required_if.value.

Operação - Observação Assistida (Admin)

Rota relacionada: /admin/support/observation.

Use esse fluxo quando for necessário investigar o cenário de uma cliente em modo de leitura.

Passo a passo

1. Abra Admin > Configurações > Observação Assistida.
2. Informe target_user_id da cliente.
3. Preencha reason (obrigatório).
4. Preencha ticket_ref apenas se houver chamado (opcional).
5. Clique em Iniciar Sessão.
6. Durante a sessão, consulte os dados permitidos em modo leitura.
7. Ao concluir, clique em Encerrar Sessão.

Regras operacionais

• reason é obrigatório para abrir sessão.
• ticket_ref é opcional.
• Fluxo de observação é somente leitura.
• Abertura, acessos e encerramento ficam registrados em auditoria interna.

Exemplos de justificativa aceitável (reason)

• Investigação de inconsistência no dashboard da cliente
• Validação de erro relatado no status de fertilidade
• Análise de divergência entre ciclo e observações