Laboratório

Para que serve

O ecrã do Laboratório é o posto de trabalho do técnico. Mostra a fila dos exames pedidos pelos médicos e permite:

• registar os valores de cada parâmetro;
• guardar os resultados;
• validar o resultado, dando-o por definitivo.

Depois de validado, o resultado fica bloqueado e passa a estar visível para o médico e para o paciente (no portal do paciente).

Atenção. Existem no sistema dois ecrãs com o título Laboratório: este (/labs) e o dos Pedidos de exame (/examorders). Este é o que tem registo estruturado por parâmetros e validação. Ver a secção «Por confirmar».

Quando usar

• Quando chegam amostras para processar.
• Ao longo do dia, para registar os valores obtidos.
• No fim, para validar os resultados.

Quem pode usar

Ação	Permissão	Perfis que têm
Abrir a página	Nenhuma além de ter sessão iniciada	Todos os utilizadores internos
Registar e validar resultados	Nenhuma além de ter sessão iniciada	Todos os utilizadores internos

Nota importante. Esta página não verifica permissões. Qualquer pessoa com conta no sistema pode abrir o laboratório e validar resultados. O item Laboratório só aparece no menu a quem tem view-lab-tests, mas isso apenas esconde o menu, não bloqueia o acesso. Comunique isto ao responsável técnico da clínica.

Ecrãs e funcionalidades

Endereço: /labs Menu: grupo Laboratório → Laboratório

[CAPTURA: ecrã do laboratório, com a fila de exames à esquerda e o painel de resultados à direita]

A fila de exames

• Campo de pesquisa: Procurar paciente, exame ou código
• Lista de filtro com três opções: Pendentes (por omissão), Concluídos e Todos
• Cada linha mostra o paciente, o exame e o botão Processar
• Se não houver nada: «Nenhum exame nesta fila.»
• Enquanto carrega: «A carregar exames…»
• Se falhar: «Erro ao carregar os exames.»

O painel de resultados

Abre ao clicar em Processar. Mostra uma tabela de parâmetros, com o nome do parâmetro e o campo para escrever o valor.

Se não houver parâmetros: «Sem parâmetros. Use "Adicionar parâmetro" para começar.»

Quando o resultado já está validado, aparece um aviso:

«Resultado validado em {data} — bloqueado para edição.»

e todos os campos ficam bloqueados.

Cada botão, o que faz

Botão	O que faz	Quando fica indisponível
Processar	Abre o painel de resultados desse exame	—
Voltar à fila	Fecha o painel e volta à lista	—
Adicionar parâmetro	Pergunta «Nome do parâmetro (ex.: Hemoglobina):» e acrescenta uma linha	Desaparece depois de validado
Ícone do caixote do lixo (numa linha)	Remove esse parâmetro	Desaparece depois de validado
Guardar	Grava os valores escritos	—
Validar	Dá o resultado por definitivo e bloqueia-o	Fica bloqueado enquanto o resultado não estiver no estado Concluído. Ao passar o rato aparece «Guarde os resultados antes de validar»

Antes de validar, o sistema pergunta:

«Validar este resultado? Após validado não pode ser editado.»

Cada campo do formulário

Filtros da fila

Campo	O que faz
Procurar paciente, exame ou código	Filtra a lista pelo nome do paciente, pelo tipo de exame ou pelo código
Lista de estado	Pendentes, Concluídos ou Todos

Linhas de parâmetro

Campo	Obrigatório	Notas
Nome do parâmetro	Sim	Escrito na janela de Adicionar parâmetro
Valor	Não	Texto livre. Bloqueado depois de validado

O sistema guarda também, para cada parâmetro, a unidade e os valores de referência (mínimo, máximo ou texto). Esses valores vêm do catálogo de exames da clínica.

Estados de um resultado

Etiqueta	Significado
Recebido	A amostra chegou ao laboratório
Em análise	Está a ser processada
Concluído	Os valores estão registados. É a partir daqui que se pode validar
Validado	Definitivo. Bloqueado para edição e visível para o paciente
Rejeitado	A amostra ou o resultado foram recusados

Estados de um pedido de exame

Etiqueta	Significado
Pendente	Ainda não processado
Concluído	Já processado
Cancelado	Cancelado

Prioridades

Etiqueta	Significado
Normal	Sem urgência
Urgente	A processar com prioridade
Emergência	A processar de imediato

Marcas nos valores

Quando um valor sai fora dos valores de referência, aparece uma marca ao lado:

Marca	Significado
Baixo	Abaixo do valor mínimo de referência
Alto	Acima do valor máximo de referência
Normal	Dentro dos valores de referência

Esta marca é calculada automaticamente pelo sistema, a partir dos valores de referência do parâmetro.

Exemplo prático

Situação: chegou ao laboratório uma amostra de sangue da Sra. Mbala, com pedido de hemograma.

1. A técnica vai a Laboratório → Laboratório.
2. Na lista de estado, deixa Pendentes.
3. Escreve Mbala no campo Procurar paciente, exame ou código.
4. Na linha do hemograma, clica em Processar.
5. Abre o painel com os parâmetros do hemograma.
6. Preenche os valores obtidos no aparelho:
   • Hemoglobina: 10,2
   • Hematócrito: 31
   • Leucócitos: 7500
   • Plaquetas: 240000
7. Repara que falta um parâmetro. Clica em Adicionar parâmetro.
8. Na janela que aparece, escreve VS e confirma.
9. Preenche o valor: 28.
10. Clica em Guardar.
11. Aparece a mensagem «Resultados guardados.» e o estado passa a Concluído.
12. O valor da hemoglobina aparece marcado como Baixo.
13. A técnica confere os valores com a folha do aparelho.
14. Clica em Validar.
15. O sistema pergunta «Validar este resultado? Após validado não pode ser editado.» Ela confirma.
16. Aparece «Resultado validado.» e o painel passa a mostrar «Resultado validado em 12/02/2026 — bloqueado para edição.»
17. A partir deste momento, o médico vê o resultado, e a Sra. Mbala também o vê no portal do paciente.

Fluxo completo

1. Ir a Laboratório → Laboratório.
2. Deixar a lista de estado em Pendentes.
3. Localizar o exame, usando a pesquisa se for preciso.
4. Clicar em Processar.
5. Preencher os valores de cada parâmetro.
6. Se faltar algum parâmetro, clicar em Adicionar parâmetro.
7. Clicar em Guardar.
8. Conferir tudo com atenção.
9. Clicar em Validar e confirmar.
10. Clicar em Voltar à fila e passar ao exame seguinte.

Erros comuns e como resolver

Mensagem ou situação	Porquê	O que fazer
O botão Validar está cinzento	O resultado ainda não está no estado Concluído	Clique primeiro em Guardar
«O resultado ja foi validado e nao pode ser alterado.»	Está a tentar alterar um resultado já validado	Não é possível. Contacte o responsável do laboratório
«So resultados concluidos podem ser validados.»	O resultado ainda não foi guardado	Clique em Guardar primeiro
«Não foi possível carregar o resultado.»	Falha ao abrir o exame	Recarregue a página
«Não foi possível guardar os resultados.»	Falha ao gravar	Tente de novo. Não feche a página sem confirmar que gravou
«Não foi possível validar.»	Falha ao validar	Confirme que gravou primeiro
«Erro ao carregar os exames.»	Falha de ligação ao servidor	Verifique a internet e recarregue
«Nenhum exame nesta fila.»	Não há exames pendentes, ou o filtro está a esconder	Mude a lista de estado para Todos
Validei o resultado por engano	Os resultados validados não se podem alterar, de propósito	Contacte o responsável técnico da clínica
O paciente não vê o resultado no portal	Só aparecem resultados Validados	Valide o resultado
Duas pessoas estão a escrever no mesmo exame	O sistema não bloqueia o exame enquanto está a ser preenchido	Combine com a equipa quem processa cada exame

Dicas e boas práticas

• Guardar não é validar. Guardar permite continuar a trabalhar; validar fecha o resultado para sempre.
• Confira sempre antes de validar. Não há forma de corrigir depois.
• Preencha os valores à medida que os obtém e clique em Guardar com frequência. Se o navegador fechar, o que não estiver guardado perde-se.
• Use Adicionar parâmetro apenas para parâmetros que faltem de facto. Um parâmetro escrito à mão, com o nome errado, não fica ligado aos valores de referência e não recebe a marca Baixo ou Alto.
• Escreva os nomes dos parâmetros sempre da mesma maneira. Hemoglobina e HB no mesmo laboratório dificultam qualquer comparação futura.
• Trate primeiro os exames marcados como Urgente e Emergência.
• Valide os resultados no próprio dia. Um resultado por validar não chega ao médico nem ao paciente.

Por confirmar

• Existem dois ecrãs com o título Laboratório. Este (/labs), com registo estruturado e validação, e o dos Pedidos de exame (/examorders), com um registo mais simples. Não foi possível confirmar qual é o ecrã oficial. Confirme com o responsável da clínica qual deve usar.
• Esta página não verifica permissões do lado do servidor. Qualquer conta autenticada pode abrir e validar resultados. Comunique ao responsável técnico.
• Não foi possível confirmar como se cria o catálogo de exames e os respetivos parâmetros, unidades e valores de referência.
• Não foi possível confirmar se existe forma de imprimir ou descarregar o boletim de resultados a partir deste ecrã.
• Não foi possível confirmar como se muda o estado de um resultado para Rejeitado.
• Não existem testes automáticos para este módulo. Confirme sempre à mão o resultado das operações.