Modelos clínicos e assinatura digital

Para que serve

Este módulo trata de duas coisas ligadas entre si:

Modelos. Textos e conjuntos de medicamentos guardados para reutilizar. Em vez de escrever de novo a mesma receita ou o mesmo bloco de exame físico, o médico aplica um modelo com um clique.

Assinatura digital. Marca eletrónica que o médico aplica a receitas, prontuários e documentos (atestados, declarações, relatórios). Cada documento assinado recebe um código de verificação, que permite a qualquer pessoa confirmar a autenticidade do documento numa página pública.

Esta funcionalidade depende do plano contratado (a partir do plano Avançado). Sem esse plano, as páginas de modelos e de documentos devolvem erro 404 — página não encontrada.

Exceção importante: a página pública de verificação de documentos funciona sempre, mesmo que a clínica mude de plano. Um documento assinado continua verificável.

Quando usar

Modelos:

• Receitas que repete muitas vezes (por exemplo, o esquema padrão para uma infeção urinária simples).
• Blocos de texto de prontuário: anamnese-tipo, exame físico normal, condutas.
• Atestados, declarações e relatórios recorrentes.

Assinatura:

• Sempre que emitir um atestado, uma declaração ou um relatório clínico.
• Quando quiser dar valor formal a uma receita ou a um prontuário.

Quem pode usar

Ação	Permissão	Perfis que têm
Ver e gerir modelos	manage-clinical-templates	admin, superadmin, médico
Aplicar um modelo de receita a uma consulta	manage-clinical-templates	admin, superadmin, médico
Assinar receitas e prontuários	sign-clinical-documents	admin, superadmin, médico
Ver documentos emitidos	view-clinical-reports	admin, superadmin, médico, receção
Emitir e editar documentos	create-clinical-report	admin, superadmin, médico
Apagar documentos	delete-clinical-report	admin, superadmin, médico
Verificar um documento pelo código	nenhuma — página pública	Qualquer pessoa

Além das permissões, há três regras que não se contornam:

1. Só quem tem perfil de médico pode assinar. Caso contrário aparece «Sem perfil de médico.»
2. Só o médico da consulta pode assinar os documentos dessa consulta. Caso contrário aparece «Apenas o médico da consulta pode assinar.»
3. É preciso ter a imagem da assinatura carregada antes de assinar seja o que for. Caso contrário aparece «Configure a sua assinatura antes de assinar documentos.»

Ecrãs e funcionalidades

1. Página Modelos clínicos

Endereço: /modelos Menu: grupo Clínica → Modelos

[CAPTURA: página Modelos clínicos, com o cartão da assinatura no topo e as três secções de modelos por baixo]

A página tem, de cima para baixo:

Botão Novo modelo, no canto superior direito.

Cartão A minha assinatura (só aparece a quem tem perfil de médico). Mostra um de dois estados:

• «Configurada — usada nos documentos assinados.» (a verde)
• «Ainda não configurada. Necessária para assinar receitas/prontuários.»

Com um botão Carregar assinatura (ou Substituir, se já existir).

Três secções de modelos:

Secção	Para que serve	Texto quando está vazia
Receitas	Conjuntos de medicamentos	«Crie modelos de receita (conjuntos de fármacos) para aplicar num clique.»
Prontuário	Blocos de texto reutilizáveis	«Crie blocos de texto reutilizáveis (anamnese, exame físico, condutas).»
Relatórios / Atestados	Modelos de documentos	«Crie modelos de atestados, declarações e relatórios para reutilizar.»

Cada modelo aparece numa linha, com uma etiqueta que indica o âmbito:

• Pessoal — só o médico que o criou o vê.
• Clínica — partilhado por todos. Só a administração pode criar modelos deste tipo.

2. Janela Novo modelo / Editar modelo

Abre ao clicar em Novo modelo ou no ícone de editar de um modelo.

3. Documentos emitidos (atestados, declarações, relatórios)

Este bloco aparece dentro do ecrã da consulta / ficha do paciente, não no menu.

• Botão Emitir documento, no canto superior direito.
• Se não houver nada: «Sem documentos emitidos. Emita atestados, declarações ou relatórios.»
• Cada documento aparece com o título, e — se estiver assinado — a etiqueta verde Assinado e a linha «{tipo} · Verificação: {código}».

[CAPTURA: bloco de documentos emitidos, com um atestado já assinado e o respetivo código de verificação]

4. Página pública de verificação

Endereço: /verificar/{código}

Qualquer pessoa pode abrir esta página, sem iniciar sessão. Serve para confirmar que um documento em papel é autêntico.

Se o código for válido:

• Título: Documento autêntico
• Texto: «Assinado digitalmente e emitido por esta clínica.»
• Dados: Tipo de documento, Assinado por, Cédula (se existir), Data da assinatura e Código de verificação.

Se o código não existir:

• Título: Código inválido
• Texto: «Não encontrámos nenhum documento com este código de verificação. Confirme o código impresso no documento.»

[CAPTURA: página pública de verificação, com o escudo verde e os dados do documento autêntico]

Cada botão, o que faz

Na página Modelos clínicos

Botão	O que faz
Novo modelo	Abre a janela de criação
Carregar assinatura / Substituir	Abre o seletor de ficheiros para escolher a imagem da assinatura. Enquanto envia, mostra A enviar…
Ícone de editar (numa linha de modelo)	Abre a janela de edição
Ícone de apagar (numa linha de modelo)	Pergunta «Apagar o modelo "…"?» e, se confirmar, apaga
Guardar (na janela)	Grava o modelo. Enquanto grava, mostra A guardar…
Cancelar (na janela)	Fecha sem gravar

No bloco de documentos emitidos

Botão	O que faz	Condição
Emitir documento	Abre a janela de criação de documento	—
Ícone de editar	Abre a janela de edição	Desaparece depois de o documento estar assinado
Ícone de PDF	Abre o documento em PDF numa nova janela	—
Assinar	Aplica a assinatura digital e gera o código de verificação	Desaparece depois de assinado
Ícone de apagar	Pergunta «Apagar "…"?» e, se confirmar, apaga	—

Cada campo do formulário

Janela Novo modelo / Editar modelo

Campo	Obrigatório	Regras	Notas
Título	Sim	—	Se ficar vazio, aparece «Indique um título.»
Tipo	Sim	Um de: Receita, Prontuário, Relatório / Atestado	Só aparece ao criar. Não se pode mudar depois
Escopo	Sim	Pessoal ou Clínica	Só aparece ao criar. A opção Clínica só está disponível à administração

Se o tipo for Receita, aparece uma tabela de medicamentos com quatro colunas por linha:

Coluna	O que se escreve
Medicamento	O nome do fármaco
Dosagem	Por exemplo, 500 mg
Frequência	Por exemplo, de 8 em 8 horas
Duração	Por exemplo, 7 dias

Com a ligação adicionar fármaco para acrescentar linhas e remover em cada linha.

Se o tipo for Prontuário ou Relatório / Atestado, aparece um único campo Texto, com editor de texto formatado.

Janela Emitir documento / Editar documento

Campo	Obrigatório	Regras	Notas
Tipo	Sim	Um de: Atestado médico, Declaração, Relatório clínico, Termo / Consentimento, Outro documento	Só aparece ao criar
Inserir modelo	Não	Lista dos modelos disponíveis	Só aparece se existirem modelos. A opção vazia diz — escolher modelo —
Título	Sim	—	Exemplo sugerido no campo: «Ex.: Atestado de repouso médico». Se ficar vazio: «Indique um título.»
Conteúdo	—	—	Editor de texto formatado

Carregar a assinatura

Requisito	Valor
Formatos aceites	PNG, JPG, JPEG, WEBP
Tamanho máximo	2 MB

Se o ficheiro não cumprir, aparece: «Não foi possível guardar a assinatura (use PNG/JPG até 2MB).»

Exemplo prático

Situação: a Dra. Fernanda passa muitas vezes a mesma receita para infeções urinárias simples. Quer criar um modelo e, no fim, emitir um atestado assinado.

Parte 1 — Configurar a assinatura (só uma vez)

1. A Dra. Fernanda assina numa folha branca, fotografa a assinatura e guarda a imagem no computador.
2. Vai a Clínica → Modelos.
3. No cartão A minha assinatura, lê «Ainda não configurada. Necessária para assinar receitas/prontuários.»
4. Clica em Carregar assinatura e escolhe a imagem.
5. O botão mostra A enviar… e, no fim, o cartão passa a «Configurada — usada nos documentos assinados.»

Parte 2 — Criar o modelo de receita

6. Na mesma página, clica em Novo modelo.
7. No campo Título, escreve ITU simples — adulto.
8. Em Tipo, escolhe Receita.
9. Em Escopo, escolhe Pessoal.
10. Na primeira linha de medicamento, escreve:
    • Medicamento: Nitrofurantoína
    • Dosagem: 100 mg
    • Frequência: de 12 em 12 horas
    • Duração: 5 dias
11. Clica em adicionar fármaco e acrescenta:
    • Medicamento: Paracetamol
    • Dosagem: 1000 mg
    • Frequência: de 8 em 8 horas, se dor
    • Duração: 3 dias
12. Clica em Guardar.
13. O modelo aparece na secção Receitas, com a etiqueta Pessoal.

Parte 3 — Usar o modelo numa consulta

14. Durante o atendimento da Sra. Kiala, a Dra. Fernanda abre a prescrição e aplica o modelo ITU simples — adulto.
15. Os dois medicamentos aparecem preenchidos. Ajusta a duração do paracetamol para 5 dias.

Parte 4 — Emitir um atestado assinado

16. No bloco de documentos, clica em Emitir documento.
17. Em Tipo, escolhe Atestado médico.
18. Em Título, escreve Atestado de repouso — 3 dias.
19. Escreve o conteúdo no campo Conteúdo.
20. Clica em Guardar.
21. O documento aparece na lista. Clica em Assinar.
22. Aparece a etiqueta verde Assinado e a linha «Atestado médico · Verificação: K7M2P9XQ4T».
23. Clica no ícone de PDF e imprime o atestado para a paciente.

Parte 5 — Alguém verifica o atestado

24. A entidade patronal da Sra. Kiala recebe o atestado e quer confirmar que é verdadeiro.
25. Abre .../verificar/K7M2P9XQ4T no navegador.
26. Vê Documento autêntico, com o tipo, o nome da médica, a cédula e a data da assinatura.

Fluxo completo

Modelos

1. Ir a Clínica → Modelos.
2. Clicar em Novo modelo.
3. Preencher Título, Tipo e Escopo.
4. Preencher os medicamentos (receita) ou o texto (prontuário e relatórios).
5. Clicar em Guardar.
6. Usar o modelo durante o atendimento.

Documentos assinados

1. Carregar a imagem da assinatura, uma vez (A minha assinatura → Carregar assinatura).
2. Durante ou depois da consulta, clicar em Emitir documento.
3. Escolher o Tipo e, se quiser, aplicar um modelo em Inserir modelo.
4. Preencher Título e Conteúdo.
5. Clicar em Guardar.
6. Rever o documento com atenção.
7. Clicar em Assinar.
8. Clicar no ícone de PDF e imprimir ou enviar.

Erros comuns e como resolver

Mensagem ou situação	Porquê	O que fazer
A página /modelos dá 404	O plano contratado não inclui modelos e assinatura	Fale com o administrador da clínica
«Configure a sua assinatura antes de assinar documentos.»	Ainda não carregou a imagem da assinatura	Vá a Clínica → Modelos e use Carregar assinatura
«Sem perfil de médico.»	A sua conta não está associada a um registo de médico	Fale com o administrador
«Apenas o médico da consulta pode assinar.»	Está a tentar assinar documentos de uma consulta de outro médico	Só o médico marcado na consulta pode assinar
«Sem permissão para modelos da clínica.»	Tentou criar um modelo de âmbito Clínica sem ser administrador	Crie o modelo como Pessoal, ou peça à administração
«Sem perfil de médico para criar modelos pessoais.»	A sua conta não está associada a um registo de médico	Fale com o administrador
«Um documento já assinado não pode ser editado.»	Está a tentar alterar um documento já assinado	Emita um documento novo. O ícone de editar desaparece depois da assinatura, de propósito
«O modelo não é de receita.»	Tentou aplicar como receita um modelo que é de outro tipo	Escolha um modelo da secção Receitas
«Não foi possível guardar a assinatura (use PNG/JPG até 2MB).»	O ficheiro não é imagem, ou é maior que 2 MB	Reduza a imagem ou converta-a para PNG/JPG
«Indique um título.»	O campo Título ficou vazio	Escreva um título
«Não foi possível guardar o modelo.» / «Não foi possível guardar o documento.»	Falha ao gravar	Tente de novo. Se persistir, contacte o administrador
«Não foi possível assinar. Configure a sua assinatura em Modelos.»	Falta a imagem da assinatura	Carregue a assinatura em Clínica → Modelos
Código inválido na página de verificação	O código foi mal escrito, ou o documento não existe	Confirme o código impresso, letra a letra
Não consigo editar um documento que emiti há minutos	Já foi assinado	Emita um documento novo

Dicas e boas práticas

• Reveja sempre o documento antes de assinar. Depois de assinado não pode ser editado, e isso é intencional.
• Fotografe a assinatura sobre papel branco, com boa luz. Uma imagem escura ou tremida fica má no PDF impresso.
• Use modelos Pessoais para o seu estilo de escrita e modelos Clínica para textos que toda a equipa deve usar de forma igual (consentimentos, por exemplo).
• Dê nomes claros aos modelos. ITU simples — adulto é útil; Modelo 3 não é.
• Um modelo é um ponto de partida, não um destino. Ajuste sempre ao paciente concreto.
• Imprima ou escreva o código de verificação no documento em papel. Sem ele, ninguém consegue confirmar a autenticidade.
• A página de verificação continua a funcionar mesmo que a clínica mude de plano. Documentos antigos não perdem valor.

Por confirmar

• Os modelos são blocos de texto e listas de medicamentos fixos. Não foi encontrado nenhum mecanismo de preenchimento automático (por exemplo, inserir sozinho o nome do paciente ou a data). Se precisa desses dados, tem de os escrever.
• Não foi possível confirmar exatamente onde, dentro do ecrã de atendimento, aparece o bloco de documentos emitidos e o seletor de modelos de receita.
• Não foi possível confirmar se existe uma entrada no menu para a lista geral de documentos emitidos (/relatorios), ou se ela só se alcança a partir da consulta.
• Não foi possível confirmar se a assinatura é apagada quando o médico deixa a clínica, nem o que acontece aos documentos já assinados nesse caso.