Pacientes

Para que serve

O módulo Pacientes guarda a ficha de cada pessoa que é atendida na clínica: nome, contactos, morada, documento de identificação, dados demográficos e histórico de consultas.

É a base de tudo. Sem paciente registado não se marca consulta, não se faz prontuário e não se emite fatura.

Quando usar

• Quando chega um paciente novo à clínica.
• Quando é preciso corrigir ou atualizar contactos e morada.
• Antes de marcar uma consulta, para confirmar que o paciente já existe.
• Para consultar o histórico de consultas de um paciente.
• Para registar sinais vitais (triagem) antes da consulta.
• Para ver ou registar vacinas.

Quem pode usar

Endereço principal: /patient.

Ação	Permissão	Perfis que têm
Ver a lista e a ficha do paciente	view-patients	admin, superadmin, médico, enfermeiro, receção, laboratório
Criar paciente	create-patient	admin, superadmin, médico, enfermeiro, receção
Editar paciente	edit-patient	admin, superadmin, médico, enfermeiro, receção
Eliminar paciente	delete-patient	admin, superadmin, médico, receção
Ver cartão de vacinas	view-vaccine-records	admin, superadmin, médico, enfermeiro, receção
Registar vacina	record-vaccine-administration	admin, superadmin, médico, enfermeiro
Registar triagem (sinais vitais)	perfil enfermeiro (nurse)	enfermeiro (e admin/superadmin)

Os botões que não pode usar não aparecem no ecrã.

Ecrãs e funcionalidades

1. Lista de pacientes (/patient)

[CAPTURA: página Pacientes com a caixa de pesquisa, a tabela de pacientes e a paginação em baixo]

Chega-se por Pacientes → Lista de Pacientes.

Tem:

• Título Pacientes (com a etiqueta Gestão por cima).
• Botão Novo paciente (canto superior direito) — só com create-patient.
• Caixa de pesquisa Pesquisar por nome…
• Tabela com quatro colunas: Paciente, Género, Idade, Ações.
• Paginação em baixo: A mostrar X–Y de Z, com Anterior, os números das páginas e Seguinte.

Se não houver resultados, aparece "Nenhum paciente encontrado."

2. Janela "Informações do paciente"

Abre quando clica no nome do paciente na tabela. Mostra a fotografia, nome, e-mail, telefones e as informações adicionais que estiverem preenchidas: Endereço, Cidade, Bairro, Município, País, Género, Estado civil, Nacionalidade, BI, Etnia, Profissão, Grupo sanguíneo e Sobre.

Só mostra os campos que têm valor. Se não houver nenhum, aparece "Sem informações adicionais."

3. Ficha do paciente (/patient/{id})

[CAPTURA: ficha do paciente com a coluna esquerda (perfil e informações pessoais) e a coluna direita (triagem, histórico, consultas)]

Abre-se com o botão Ver na lista. Divide-se em duas colunas.

Coluna esquerda:

• Cartão de perfil com fotografia, nome, e-mail e a etiqueta Paciente. Pode substituir a fotografia clicando nela.
• Bloco Informações pessoais, com: Nome, Email, Telefone, Endereço, B.I. e Alergias. Os campos vazios aparecem com um travessão (—).
• Botões Vacinas e Editar.

Coluna direita:

• Triagem — sinais vitais: mostra os últimos valores registados — Pressão arterial, Freq. cardíaca, Temperatura, Peso, Altura, Saturação O₂, Glicemia e Tipo sanguíneo. Botão Registar (perfil enfermeiro).
• Histórico médico: texto livre. Se estiver vazio mostra "Sem histórico registado."
• Consultas recentes: tabela com Médico, Especialidade, Procedimento, Data e a coluna Ação, com os botões Atender e Ver. Se não houver nenhuma, aparece "Sem consultas registadas."

4. Editar paciente (/patient/{id}/edit)

Formulário completo com os dados pessoais. Ver a lista de campos mais abaixo.

5. Cartão de vacinas (/patient/{id}/vacinas)

Abre com o botão Vacinas na ficha do paciente. Lista as vacinas administradas e permite registar novas doses.

6. Janela do paciente a partir da Agenda

Em Agenda → Procurar → Procurar consultas, ao escolher um paciente abre uma janela com atalhos de impressão: Ver perfil, Editar, Cartão, Prontuário e Prescrição.

Cada botão, o que faz

Na lista de pacientes

Botão	O que faz	Condição
Novo paciente	Abre a janela de criação	create-patient. Fica cinzento se o limite de pacientes do plano estiver esgotado
Nome do paciente (na tabela)	Abre a janela Informações do paciente	—
Editar	Abre o formulário de edição	edit-patient
Ver	Abre a ficha completa do paciente	view-patients
Excluir	Elimina o paciente. Pergunta "Tem a certeza que deseja excluir este paciente?"	delete-patient
Anterior / números / Seguinte	Muda de página na lista	—

⚠️ Excluir é definitivo. Não há caixote de reciclagem. Use com muito cuidado.

Na ficha do paciente

Botão	O que faz	Condição
Vacinas	Abre o cartão de vacinas do paciente	view-vaccine-records
Editar	Abre o formulário de edição	edit-patient
Registar (na Triagem)	Abre a janela Registar triagem	Perfil enfermeiro
Atender (nas consultas)	Abre o atendimento clínico dessa consulta	create-appointment
Ver (nas consultas)	Abre os detalhes dessa consulta	create-appointment
Fotografia do perfil	Permite carregar uma nova fotografia	—

No formulário de edição

Botão	O que faz
Voltar	Regressa à lista sem guardar
Cancelar	Regressa à lista sem guardar
Guardar alterações	Grava os dados. Enquanto grava mostra "A guardar…"

No cartão de vacinas

Botão	O que faz
Registar vacina (formulário)	Grava uma nova dose no cartão
Ícone Remover numa dose	Apaga esse registo de vacina

Cada campo do formulário

Formulário "Novo paciente"

Campo	Obrigatório	Notas
Nome	Sim	Nome completo
E-mail	Sim	Endereço de e-mail
Senha	Não	Diz "Deixe em branco para gerar automaticamente"

Botão: Criar paciente.

⚠️ Atenção: ver a secção Por confirmar no fim deste capítulo. Não foi possível confirmar que este formulário crie efetivamente o paciente. O caminho seguro é Administração → Lista de Usuários → Novo utilizador, escolhendo o papel patient.

Formulário "Editar paciente"

Os campos aparecem por esta ordem. A coluna "Obrigatório" reflete as regras que o servidor aplica ao gravar.

Campo no ecrã	Obrigatório	Tipo
Nome	Sim	Texto
E-mail	Sim	E-mail válido
B.I.	Não	Texto
Telefone	Sim	Texto
Telefone secundário	Não	Texto
Género	Sim	Texto
Data de nascimento	Sim	Data
Estado civil	Não	Texto
Nacionalidade	Sim	Texto
Etnia	Sim	Texto
Ocupação profissional	Sim	Texto
Grupo sanguíneo	Sim	Texto
Endereço	Sim	Texto
Endereço secundário	Não	Texto
Bairro	Sim	Texto
Cidade	Sim	Texto
Município	Sim	Texto
País	Não	Texto
Data de registo	Sim	Data
Observações	Não	Texto longo

Muito importante: o formulário tem 14 campos obrigatórios. Se algum deles estiver vazio, o sistema não grava nada e mostra a mensagem de erro por baixo do campo em falta. Preencha todos antes de clicar em Guardar alterações.

Formulário "Registar triagem" (sinais vitais)

Campo	Marcado como obrigatório no ecrã	Exemplo
Pressão arterial	Sim	120/80
Freq. cardíaca (bpm)	Sim	72
Temperatura (°C)	Sim	36.5
Peso (kg)	Sim	70
Altura (cm)	Não	170
Saturação O₂ (%)	Sim	98
Glicemia (mg/dL)	Sim	90
Tipo sanguíneo	Sim	O+
Alergias	Sim	Nenhuma

Nota: o servidor aceita uma triagem com apenas alguns valores preenchidos. Uma triagem pode registar só o que foi de facto medido.

Formulário "Registar vacina"

Campo	Obrigatório	Notas
Vacina	Sim (ou o campo de texto)	Escolhe do catálogo da clínica
Campo de texto "…ou escrever o nome da vacina"	Obrigatório se não escolher do catálogo	Máximo 255 caracteres
Dose nº	Sim	Número inteiro entre 1 e 20
Data	Sim	Data da administração
Lote	Não	Texto
Validade	Não	Data
Via	Não	Intramuscular (IM), Subcutânea (SC), Intradérmica (ID) ou Oral
Local	Não	Ex.: deltoide E
Próxima dose	Não	Data
Notas	Não	Máximo 2000 caracteres

Exemplo prático

Situação: o Sr. João Baptista vem pela primeira vez à clínica. A rececionista Marta vai registá-lo e o enfermeiro Alberto vai fazer a triagem.

Parte 1 — Registar o paciente (receção)

1. A Marta vai a Pacientes → Lista de Pacientes.
2. Na caixa Pesquisar por nome… escreve João Baptista. Aparece "Nenhum paciente encontrado." — é mesmo novo.
3. Cria a conta em Administração → Lista de Usuários → Novo utilizador, preenchendo Nome João Baptista, E-mailjoao.baptista@exemplo.ao, Senha, e escolhendo o papel patient.
4. Volta a Pacientes → Lista de Pacientes e pesquisa João. O paciente já aparece na lista.
5. Clica em Editar na linha do João Baptista.
6. Preenche o formulário:
   • Nome: João Baptista
   • E-mail: joao.baptista@exemplo.ao
   • B.I.: 004567890LA041
   • Telefone: 923456789
   • Género: Masculino
   • Data de nascimento: 12/03/1978
   • Nacionalidade: Angolana
   • Etnia: Bantu
   • Ocupação profissional: Motorista
   • Grupo sanguíneo: A+
   • Endereço: Rua das Acácias, 45
   • Bairro: Maianga
   • Cidade: Luanda
   • Município: Luanda
   • Data de registo: 02/02/2026
7. Clica em Guardar alterações.

Parte 2 — Triagem (enfermagem)

8. O enfermeiro Alberto vai a Pacientes → Lista de Pacientes, pesquisa João Baptista e clica em Ver.
9. No bloco Triagem — sinais vitais, clica em Registar.
10. Preenche: Pressão arterial 135/85, Freq. cardíaca (bpm) 78, Temperatura (°C) 36.8, Peso (kg) 84, Altura (cm) 176, Saturação O₂ (%) 97, Glicemia (mg/dL) 102, Tipo sanguíneo A+, Alergias Penicilina.
11. Grava. Os valores passam a aparecer na ficha, e o médico vê-os na consulta.

Parte 3 — Consulta

12. A Marta marca a consulta na Agenda (ver Agenda).
13. Depois da consulta, ao voltar à ficha do João, a consulta aparece em Consultas recentes.

Fluxo completo

PACIENTE NOVO
  1. Pacientes → Lista de Pacientes
  2. Pesquisar pelo nome (confirmar que não existe já)
  3. Criar a conta com o papel "patient"
  4. Abrir Editar e preencher a ficha completa
  5. Guardar alterações

ANTES DA CONSULTA
  6. Ficha do paciente → Triagem → Registar (enfermagem)
  7. (se aplicável) Vacinas → Registar vacina

NA CONSULTA
  8. Ficha do paciente → Consultas recentes → Atender
     (ou pela Agenda — ver o capítulo Agenda)

DEPOIS
  9. Ficha do paciente → Consultas recentes → Ver

Erros comuns e como resolver

O que vê	Porquê	O que fazer
O botão Novo paciente está cinzento	O limite de pacientes do plano da clínica foi atingido	Aparece uma faixa vermelha por baixo do título com a explicação. Fale com o administrador
Não aparece o botão Novo paciente	O seu perfil não tem create-patient	Peça à receção ou ao administrador
Cliquei em Criar paciente e não aconteceu nada	Ver a secção Por confirmar	Crie o paciente em Administração → Lista de Usuários → Novo utilizador com o papel patient
"Nenhum paciente encontrado." mas tenho a certeza de que existe	A pesquisa é só por nome	Tente escrever apenas parte do nome (por exemplo, o apelido). Confirme a ortografia
Cliquei em Guardar alterações e o formulário não grava	Falta preencher um campo obrigatório	Procure a mensagem a vermelho por baixo de um dos campos. Lembre-se: 14 campos são obrigatórios
Erro no campo E-mail	O e-mail está mal escrito ou já é usado por outro utilizador	Confirme o endereço; se já existir, use outro
Não vejo o botão Registar na triagem	O botão só aparece a quem tem o perfil enfermeiro	Peça à enfermagem para registar
O botão Vacinas não aparece	Falta a permissão view-vaccine-records	Fale com o administrador
Aparece erro ao registar vacina	Falta a Dose nº ou a Data, que são obrigatórias	Preencha os dois campos
A lista Consultas recentes está vazia mas houve consultas	As consultas ficam ligadas ao paciente pelas marcações; se a marcação não foi criada como consulta, não aparece aqui	Ao marcar, ligue sempre o interruptor Esta marcação é uma consulta (ver Agenda)
Cliquei em Excluir por engano	A eliminação é definitiva	Não é possível recuperar pelo sistema. Contacte imediatamente o administrador
A ficha mostra — em quase todos os campos	A ficha nunca foi completada	Abra Editar e preencha os dados

Dicas e boas práticas

• Pesquise sempre antes de criar. Pacientes duplicados dão origem a históricos clínicos partidos ao meio.
• Preencha o telefone corretamente. Sem telefone válido não é possível enviar confirmações por WhatsApp, nem o acesso ao portal do paciente, nem o link de teleconsulta.
• Registe as alergias na triagem. É o campo que o médico vê logo na ficha e na página de atendimento.
• Complete a ficha na primeira visita, enquanto o paciente está presente. Depois é muito mais difícil obter os dados em falta.
• Peça sempre a fotografia (ou tire uma). Ajuda a evitar trocas de pacientes com nomes parecidos.
• O cartão do paciente em PDF (com código QR) pode ser impresso a partir de Agenda → Procurar → Procurar consultas → escolher o paciente → Cartão.

Por confirmar

• A janela "Novo paciente" não parece criar o paciente. O formulário (campos Nome, E-mail, Senha e botão Criar paciente) envia os dados para o endereço /patient, mas o método correspondente no servidor está vazio. Não foi possível confirmar que o paciente seja de facto criado por esta via. O caminho que se confirmou funcionar é a criação de um utilizador com o papel patient, em Administração.
• O item "Novo Paciente" do menu. O menu tem uma entrada Novo Paciente que aponta para /patient/create. O método correspondente no servidor também está vazio, pelo que não foi possível confirmar que abra alguma página.
• Campo Data de nascimento. Internamente o campo chama-se age (idade), mas o formulário mostra-o como data. Não foi possível confirmar o formato exato exigido em todos os ecrãs.
• Perfis atribuídos ao gravar a edição. O formulário de edição envia automaticamente a lista de perfis carregada na página. Não foi possível confirmar o efeito disto nos perfis do paciente.
• Botão Excluir. Elimina o utilizador associado ao paciente. Não foi possível confirmar o que acontece às consultas e prontuários já registados desse paciente.
• O painel do paciente (/patient/your/dashboard) e a agenda do paciente (/patient/your/calendar), usados quando quem entra é o próprio paciente, não foram documentados nesta parte do manual.
• Os campos de seguradora, nº de apólice e contacto de emergência aparecem na janela do paciente vista a partir da Agenda, mas não foi encontrado nenhum formulário onde sejam preenchidos.