ajuda

Persona é um hub de saúde mental — pra psiquiatras, psicólogos e pacientes em acompanhamento. A ideia é centralizar prontuário, agenda, escalas, evoluções, prescrições e canal de comunicação clínico em um só lugar, mantendo cada paciente como sujeito (não número) e cada profissional acolhido (não cobrado).

Três motes guiam a plataforma: humanizar o cliente (paciente é pessoa), confortar o profissional (clinical é trabalho duro), e personalizar tudo que puder (cada pessoa é singular).

O acesso é por email + senha. O profissional cadastra o paciente vinculando ao próprio perfil; o paciente recebe email de boas-vindas com link pra confirmar acesso e definir senha.

Na primeira entrada o paciente aceita os Termos LGPD (consentimento explícito registrado com IP + user agent) e, se for o caso, os contratos terapêuticos do(s) profissional(is) com quem tem vínculo.

A subrole do profissional (psiquiatra ou psicólogo) é definida no cadastro e fica vinculada ao perfil — quem é psicólogo não vê emissão de receita médica, por exemplo, conforme limites do CFP. Se um mesmo CPF tem mais de uma atuação (multi-persona), o switcher na sidebar permite alternar entre elas.

Em /profissional/clientes (e em /admin/clientes pra secretária), o botão + novo paciente abre um diálogo com 3 campos mínimos: nome completo, email e telefone. Esses são os únicos dados obrigatórios pra começar.

Após criar, o app abre uma página de pré-visualização (/profissional/clientes/[id]/intake-preview ou /admin/...) com os 3 emails que o paciente vai receber: solicitação de cadastro completo, contrato terapêutico aplicável, e manual de primeira consulta. Nada é enviado automaticamente ainda — o pro/admin revisa o conteúdo antes de qualquer disparo.

O conteúdo dos emails sai automaticamente: o contrato é qualquer um marcado com aplica-se a: primeira consulta em /profissional/contratos; o manual é qualquer um marcado igual em /profissional/manuais. Se nenhum estiver marcado, a preview avisa.

↳ criar paciente cria um perfil ghost (sem login) + vínculo ativo com o pro. quando o paciente fizer signup com o mesmo email, o vínculo é reconciliado (essa parte está em desenvolvimento).

Cada profissional tem um link público /marcar/<slug> que pode compartilhar com pacientes novos. A pessoa preenche nome, email, telefone, data de nascimento, escolhe um slot disponível e envia.

CAPTCHA Turnstile bloqueia bots. Após enviar, ela recebe email pra confirmar e ativar a conta — o profissional vê a solicitação no painel e aprova (ou não).

A agenda é o coração do dia a dia: vista de semana ou mês, drag-and-drop nos slots, criação rápida de consulta clicando em um horário livre.

Cada consulta tem tipo (1ª consulta, retorno, terapia, EMDR, brainspotting, terapia de casal, etc), modalidade (presencial ou online), duração e valor. O default da modalidade vem das suas configurações; o valor propaga por (paciente, tipo) — se você cobrou 400 da Maria pra terapia ano passado, o próximo agendamento de terapia dela já vem com 400.

Botão direito (ou contextual) em uma consulta dá: editar, mover, cancelar (preserva histórico, status muda) ou remover (delete, pra marcação errada). Repetir consulta também: cadência semanal/mensal, "a cada N", quantas ocorrências, tratamento de feriados nacionais (pular ou marcar).

Cada cancelamento registra automaticamente quem cancelou e quando (data + horário). Aparece no card da agenda quando "mostrar canceladas" está ligado, e no popup de edição da consulta — útil em disputas ou pra verificar erros (foi você, a secretária, ou o próprio paciente?).

↳ a sala de videoconsulta abre 15 minutos antes do horário marcado. o paciente vê o botão "entrar" no dashboard quando faltam 15min.

Cada consulta vira uma instância de prontuário usando o template escolhido (1ª consulta, retorno, EMDR, brainspotting, etc). O conteúdo é blocado: cada bloco é um campo (textarea rich, número, escala, ICES, série SUDS, etc).

Auto-save a cada 1.2s — você não perde nada. Algumas chaves se propagam automaticamente entre consultas: resumo do caso e plano da última aparecem pré-populados na próxima evolução com o conteúdo da anterior. Você pode editar livremente.

Quando termina, dois botões de finalização: salvar e fechar (volta editável depois) ou salvar e assinar (vira imutável com hash encadeado e assinatura ICP-Brasil — audit trail forte).

Templates definem a estrutura dos blocos que aparecem ao escrever uma consulta. Você pode editar os defaults ou criar os seus em /profissional/templates.

Cada bloco tem um tipo (textarea, numérico, escala, select, multi-select, ICES, série SUDS, etc), um título visível, um hint opcional (mostra como linha cinza abaixo do título — ótimo pra script clínico) e uma chave estável pra propagação cross-template.

Macros são textos pré-prontos que você insere em qualquer editor digitando /slug. Ex: /criteriostdah insere os critérios DSM em uma evolução; /checkin insere perguntas mínimas de checkin.

Crie e edite em /profissional/macros. Cada macro tem um slug (digitado precedido de /), um nome e um conteúdo rich text.

Variáveis dinâmicas dentro do conteúdo são substituídas no momento da inserção:

• {{date}} — data de hoje (DD/MM/AAAA)
• {{today_long}} — data por extenso
• {{time}} — hora atual
• {{my_name}} — seu nome
• {{patient_name}} — nome do paciente em contexto (vazio fora do prontuário)
• {{patient_first_name}} — primeiro nome do paciente

Em /profissional/emissao você gera receita médica, laudo psiquiátrico/psicológico, atestado, encaminhamento, declarações, relatório de evolução. Tudo com hash encadeado e assinatura ICP-Brasil quando aplicável (CFM 2.314/2022 pra prescrição médica; CFP 001/2022 pra laudo psicológico).

O menu filtra por subrole automaticamente: psicólogo não vê receita médica nem atestado de afastamento (escopo restrito ao CFP), só laudo psicológico, encaminhamento, declaração e relatório.

Persona inclui ferramentas clínicas integradas. Pra EMDR (/profissional/ferramentas/emdr): editor de sessão com fases 1-7 estruturadas, ICES (Imagem/Cognição/Emoção/Sensação) modular, séries SUDS repetíveis, cross-session prefill (alvo, CN/CP, último SUDS) automaticamente pra próxima sessão enquanto você marcar como "incompleta" ou "em andamento".

Pra brainspotting (/profissional/ferramentas/brainspotting): visualizador de gaze com pointer em tempo real durante a videochamada, identificação de pontos de foco e ativação corporal.

Balanças decisórias compartilhadas também aparecem como material auxiliar na aba de evolução do prontuário. Se forem criadas ou abertas na videochamada, ficam vinculadas à consulta correspondente.

A paleta EMDR (src/data/emdrProtocolBlocks.ts) tem 13 macros prontos com scripts de cada fase — fase 1 história, fase 2 preparação + estado seguro, fase 3-6 reprocessamento, fechamento (completa/incompleta), reavaliação, projeção pro futuro, DIR (recursos), gestacional, dilema.

/profissional/alertas consolida três tipos de sinal pra você não perder:

• escalas atrasadas — paciente passou da data de devolução de questionário designado
• resposta com gravidade alta — escore severo nos últimos 30 dias (PHQ-9, GAD-7)
• risco de crise — itens críticos do C-SSRS (suicídio) ou expressões em diário/checkin

Cada alerta é acknowledge-able. Quando você confirma que entrou em contato ou tomou conduta, fica registrado. Não some — vai pra área de "resolvidos".

O sino fixo no canto superior direito agrega tudo que precisa da sua atenção operacional, com badge vermelho pros casos urgentes:

• urgência — agendamentos solicitados como urgentes pelo paciente em /marcar/<slug>
• agendamentos — pedidos normais aguardando aprovação
• encaixe — fila de espera (alguém aguardando vaga ou com vaga oferecida pendente de aceite)
• contato de urgência — paciente solicitou criar/editar/remover contato de emergência (precisa sua aprovação)
• balanças decisórias — paciente compartilhou um rascunho ou finalizou uma balança para revisar sem popup invasivo

Aprovar/rejeitar é inline no popup. Pra ver detalhe ou contexto clínico, há link pra abrir o perfil do paciente.

Em /profissional/escalas você designa questionários (PHQ-9, GAD-7, C-SSRS, escalas customizadas) ao paciente com frequência (uma vez, diário, semanal, quinzenal, mensal) e data de vencimento. Status: pendente / atrasado / recorrente.

O paciente vê os designados em /cliente/escalas, responde, e o resultado entra na linha do tempo dele e nas curvas no dashboard. Se atrasar, aparece na sua lista de alertas.

/profissional/interacoes é o painel agregado de potenciais interações entre medicações dos seus pacientes. Filtro por severidade (warning / error). Útil pra revisão antes de adicionar uma droga nova ou mudar dose.

A base ainda é básica e experimental: ausência de alerta não significa ausência de risco. Ela apoia a checagem, mas não substitui avaliação clínica, bula, bases especializadas e contexto do paciente.

Por paciente, em /profissional/clientes/[id]/medicacoes, você vê as interações específicas dele inline — toda vez que adicionar medicação nova o sistema avalia conflitos com o que já existe.

Em /profissional/clientes/[id]/genomica você registra/visualiza o perfil farmacogenético do paciente — CYP2D6, CYP2C19, MTHFR, etc. Suporta entrada por painel (Bioarcheia, Genera) ou manual.

Quando você prescreve, o sistema avalia compatibilidade — CYP2D6 metabolizador rápido + ISRS de metabolismo lento gera alerta de risco de subdosagem, por exemplo. Lê na regra clínica baseada em CPIC (Clinical Pharmacogenetics Implementation Consortium).

/profissional/biblioteca reúne artigos de psicoeducação, técnicas terapêuticas e papers clínicos. Você pode marcar "curar pra esse paciente" — o artigo aparece na seção de leituras dele com um destaque do tipo "selecionado pra você".

Bom pra reforçar entre sessões: técnica de respiração diafragmática depois de uma de manejo de ansiedade, leitura sobre reestruturação cognitiva, etc.

Trabalho clínico é pesado. /profissional/self-care é tua área privada — micro check-in fim de consulta (dificuldade, satisfação clínica), escalas validadas (MBI, ProQOL), heatmap de exaustão por dia/turno, e "espelho clínico" comparando padrão de agenda com estado mental.

↳ privacidade total. nem admin acessa esses dados. é tua sessão de cuidado.

Em /profissional/contratos você cria documentos de termos (consultas, terapias, ou personalizado) que ficam disponíveis pros pacientes vinculados aceitarem. Cada edição substancial do corpo incrementa a versão; aceites antigos ficam preservados na versão exata aceita.

Cada contrato tem o campo aplica-se a — uma ou mais modalidades de consulta (primeira, retorno, sessão emdr, etc). Quando um paciente é cadastrado, o pacote de boas-vindas inclui automaticamente os contratos que tenham "primeira consulta" marcado. Isso permite ter um contrato unificado, ou contratos separados por modalidade — o profissional escolhe.

O paciente vê os contratos pendentes em /cliente/profissionais e clica em "li e aceito". O snapshot do corpo aceito + IP + user agent ficam imutáveis — auditoria forte.

↳ realizar uma consulta sem aceite formal indica concordância tácita com os termos. o paciente é avisado disso no banner persistente do app.

Em /profissional/manuais o profissional cadastra manuais de orientação que o paciente recebe junto com o contrato — pode ser PDF do consultório ou texto digitado no app. Política de cancelamento, custos, prazos pra emissão de documentos, instruções pra primeira consulta, contato de urgência. Cada manual tem um campo aplica-se a igual ao dos contratos: o de "primeira consulta" entra no pacote de boas-vindas dos novos pacientes.

É opcional ter mais de um manual — o pro pode unificar tudo em um só ou separar (ex: um pra psiquiatria, outro pra EMDR/Brainspotting com o protocolo específico).

O sistema lê automaticamente a frase "retorno em N meses/dias/semanas/anos" do plano da última consulta de cada paciente e calcula a previsão de retorno.

Quatro classes de regularidade:

• regular · dentro do prazo de retorno
• em risco · passou do prazo, ainda dentro da margem de tolerância (default: 14 dias, configurável em settings)
• irregular · passou da margem mas ainda dentro de um ciclo de retorno
• inativo · passou um ciclo de retorno inteiro além do prazo (provavelmente abandonou)

A margem é configurável por profissional em /profissional/configuracoes e pode ser sobrescrita por paciente na ficha individual (badge no header da ficha).

O paciente também vê seu próprio status no dashboard — countdown do prazo, data limite pra manter regularidade, ou aviso de abandono. A secretaria/admin vê o quadro consolidado em /admin/follow-ups.

/profissional/estatisticas agrega métricas da prática: clientes ativos, consultas no mês/ano, distribuição por tipo de atendimento nos últimos 90d, comparações temporais.

/profissional/financeiro mostra receita por período, distribuição por tipo de consulta, faltosos (no-shows não cobrados), recibos assinados e exportação fiscal pra contabilidade.

A home (/cliente) é a primeira coisa que o paciente vê: próxima consulta agendada, status de regularidade, check-in de humor, escalas pendentes, curvas dos questionários, linha do tempo do tratamento, diário e leituras curadas pelo profissional.

Cada bloco é só uma janela — clicando vai pra página completa daquele tema. Uma sidebar à esquerda dá acesso direto a cada seção.

Se a próxima consulta é online e tá nas próximas 48h, o card de topo conta o tempo restante e libera o botão "entrar na sala" 15min antes do horário.

O check-in é uma rápida bateria de humor, energia, sono e ansiedade — leva uns 30 segundos. Aparece direto no dashboard. Vira gráfico de evolução que tu vê na linha do tempo e o profissional consulta antes da consulta.

O diário (/cliente/diario) é mais aberto: título + texto livre + humor opcional. Fica entre as sessões. Bom pra registrar gatilho, sonho, insight, pergunta que quer levar pra próxima conversa. Profissional pode ver se ele tem vínculo ativo.

Quando o profissional designa um questionário, ele aparece em /cliente/escalas com prazo. PHQ-9 mede sintomas depressivos, GAD-7 mede ansiedade, C-SSRS avalia risco de suicídio, etc.

Responder leva 2-5 minutos cada. O resultado vira ponto na curva do dashboard, permitindo ver progresso ao longo do tempo. O profissional usa pra ajustar conduta.

Em /cliente/medicacoes você vê todos os fármacos prescritos atualmente pelo seu(s) profissional(is) — nome, dose, frequência, horário, quem prescreveu, desde quando.

O sistema também detecta interações entre as medicações da sua lista e mostra alerta se houver — pra você poder perguntar pro médico antes de uma mudança.

Se você fez teste farmacogenético (Bioarcheia, Genera ou similar), pode importar em /cliente/genomica. O Persona usa esse perfil pra ajudar seu psiquiatra a escolher medicações que combinam melhor com seu metabolismo.

Não é obrigatório — funciona sem. Mas se você tem, é uma camada a mais de personalização.

Ferramenta da TCC pra decisões difíceis: você organiza ganhos e custos de manter ou mudar, dá peso de 1 a 10 para cada item e vê a decisão com mais calma. /cliente/balanca-decisoria.

A balança fica privada até você escolher compartilhar com um profissional vinculado ao seu perfil. Pode ser só o terapeuta, só o psiquiatra ou outro profissional ativo.

Quando você finaliza, ela vira modo leitura; se precisar, dá para reabrir edições. Na videochamada, vocês podem abrir ou criar uma balança da sessão sem sair da sala; quando isso acontece, ela também aparece no prontuário como material auxiliar vinculado à consulta.

Em /cliente/exames você vê o histórico de exames laboratoriais e de imagem pedidos pelo seu psiquiatra (TSH, função hepática, MTHFR, ressonância, etc) com resultado e interpretação anotada.

Se ainda não fez, o status fica como "solicitado" e te lembra. Quando subir o PDF, o sistema tenta extrair os valores principais automaticamente.

/cliente/linha-do-tempo é a cronologia integrada do tratamento: sessões, escalas respondidas, medicações iniciadas/alteradas, notas do profissional, marcos clínicos. Tudo numa só vista, do mais recente pro mais antigo.

Útil pra revisar o caminho percorrido — especialmente em momentos de dúvida sobre se está progredindo.

/cliente/leituras mostra artigos selecionados pra você pelo seu profissional — psicoeducação sobre o seu diagnóstico, técnicas de manejo, papers acessíveis. Tag de tempo de leitura ajuda a planejar.

Se um artigo foi marcado especificamente "pra você", aparece com destaque. Os demais são da biblioteca geral curada por tópico.

Em /cliente/sessoes você vê todas as consultas agendadas e passadas — tipo, data, duração, modalidade. Se for online, o link da sala fica disponível 15min antes.

Pra remarcar ou cancelar, pode fazer direto até 24h antes. Depois disso, entra em contato com o profissional.

Em /cliente/perfil você ajusta seus próprios dados: nome completo (livre — útil se importou abreviado, casou, ou prefere outro nome), data de nascimento, gênero, vários telefones, CPF, RG, endereço completo (com auto-fill por CEP) ou endereço fora do Brasil.

A capitalização é corrigida automaticamente quando você digita tudo MAIÚSCULO ou tudo minúsculo — vira "Capitalização Padrão" pra ficar legível no prontuário. Mistura intencional ("Da Silva", "iPhone") é preservada.

Email NÃO é editado aqui — ele vira seu login, então tem fluxo separado em /cliente/configuracoes.

↳ tags de acompanhamento e dados clínicos (diagnósticos, medicações) são definidos pelo seu profissional — pra ajustar, fale com ele.

Em /cliente/perfil você lista pessoas de confiança que poderíamos ligar num momento difícil. Cada contato aceita vários telefones, parentesco e marcação de "primário".

Por questões de segurança, toda mudança aqui passa por aprovação do seu profissional ou administrador antes de valer — adicionar contato novo, editar nome/telefone, ou pedir remoção. O contato que está hoje continua valendo enquanto o pedido está em revisão.

Essa proteção evita que alguém em momento de crise modifique o contato sem revisão clínica. Se você não tem profissional vinculado no momento, a edição fica bloqueada — voltar ao acompanhamento libera.

Em /cliente/configuracoes o card "trocar email do portal" envia um link de confirmação pro email novo. Você só precisa clicar no link pra finalizar a troca — sua sessão atual continua valendo, e o próximo login passa a ser com o email novo.

Pode ser que também chegue um aviso no email atual confirmando a mudança — confirme nos dois pra ativar.

A consulta online roda em sala WebRTC peer-to-peer (criptografada de ponta a ponta — nenhum servidor de mídia armazena o vídeo). Acessível 15 minutos antes do horário marcado, via botão no dashboard ou link direto.

Funciona em Chrome, Firefox, Edge, Safari. Recomenda-se conexão estável e fones de ouvido. Se cair, basta entrar de novo — a sessão do profissional permanece aberta.

Em terapia de casal, ambos os membros entram como guests; a consulta tem dois pacientes vinculados.

Lembrete de consulta sai automaticamente 24h antes via email — com data/hora local (timezone São Paulo), tipo, modalidade e link da sala se for online.

Vínculo profissional ↔ paciente: quando o profissional convida, o paciente recebe email pra autorizar acesso ao prontuário.

Contratos pendentes geram banner persistente no dashboard do paciente até serem aceitos.

O profissional convida um paciente — ele recebe email pra autorizar. Estados do vínculo:

• pending · aguardando aprovação do paciente (sem acesso ao prontuário)
• active · paciente autorizou; profissional escreve novas evoluções e lê histórico
• revoked · paciente revogou; profissional perde acesso a NOVAS evoluções, mantém leitura do histórico que já tinha

O paciente controla isso em /cliente/profissionais — pode aprovar, revogar e re-aprovar a qualquer momento.

Multi-profissional: um paciente pode ter mais de um profissional ativo (ex: psiquiatra + psicóloga). Cada um vê as próprias evoluções; histórico é compartilhado.

Tema visual: dropdown de tema na sidebar (Miyazaki Laputa, Frida, Monet, etc). Cada tema muda a paleta inteira — texturas e cores. Persistido por usuário; sincroniza entre abas.

Sidebar: arrasta o handle ⋮⋮ que aparece no hover de cada item pra reordenar (salva direto). Clica na engrenagem no topo pra abrir o painel de mostrar/ocultar — itens ocultos vão pro menu "mais".

Configurações pessoais (/{role}/configuracoes): trocar senha, modalidade default das consultas (profissional), margem de tolerância de retorno (profissional), cores da agenda por tipo (profissional), exportar meus dados em JSON (LGPD Art. 18).

/admin/follow-ups agrupa pacientes vinculados aos profissionais administrados em quatro classes: inativos (cinza), irregulares (vermelho), em risco (âmbar), regulares (verde).

Útil pra triagem da secretaria: contatar os em risco antes de virarem irregular, retomar contato com os irregulares, e arquivar/encerrar formalmente os inativos. Cada linha mostra última consulta, plano de retorno, dias decorridos e link pra ficha.

/admin/financeiro agrega faturamento dos profissionais vinculados (via admin_links). Filtros por período e por profissional, exportação fiscal.

O Persona segue a LGPD: consentimento explícito no primeiro acesso (registrado com IP e user agent), finalidade clínica registrada, dados pessoais sensíveis isolados em uma única tabela com Row-Level Security, exportação completa em formato JSON disponível em /{role}/configuracoes (Art. 18 LGPD).

Acesso a prontuário só com vínculo aceito; revogação corta acesso a evoluções futuras imediatamente. Auditoria de aceite de termos é imutável (snapshot + IP + UA).

Sala de videoconsulta é peer-to-peer — vídeo não passa nem fica em servidor. Backups do banco têm Point-in-Time Recovery (7 dias) habilitado.

Em caso de dúvida ou problema, escreva pra suporte@librenzagarcia.com.br — respondemos em até 1 dia útil.

Sugestões de novas features ou correções são bem-vindas — o produto cresce com a prática clínica de quem usa.