Bloco operatório

Para que serve

O bloco operatório é o mapa cirúrgico da clínica. Serve para:

• marcar cirurgias, com data, hora, sala e equipa;
• ver o mapa do dia;
• acompanhar o estado de cada cirurgia, do agendamento à conclusão;
• gerir as salas do bloco.

O sistema impede que duas cirurgias fiquem marcadas para a mesma sala à mesma hora.

Quando usar

• Quando se marca uma cirurgia.
• Ao início do dia, para ver o mapa cirúrgico.
• Quando uma cirurgia é confirmada, começa, acaba ou é cancelada.
• Quando é preciso acrescentar ou desativar uma sala.

Quem pode usar

Ação	Permissão	Perfis que têm
Ver o mapa cirúrgico	view-surgery-schedule	admin, superadmin, médico, receção
Marcar cirurgias	schedule-surgery	admin, superadmin, médico
Alterar o estado de uma cirurgia	schedule-surgery	admin, superadmin, médico
Remover cirurgias	schedule-surgery	admin, superadmin, médico
Criar e ativar/desativar salas	schedule-surgery	admin, superadmin, médico

O perfil receção vê o mapa, mas não pode marcar nem alterar nada.

Os perfis enfermeiro e laboratório não têm acesso.

Ecrãs e funcionalidades

Endereço: /bloco Menu: grupo Clínica → Bloco operatório

[CAPTURA: página do bloco operatório, com a barra de datas em cima, os quatro cartões de resumo e a lista de cirurgias do dia]

Cabeçalho

• Título: Bloco operatório
• Subtítulo: «Mapa cirúrgico e agendamento.»
• Botões Salas e Agendar cirurgia, no canto superior direito

Barra de datas e filtros

• Setas para trás e para a frente, e um campo de data, para escolher o dia.
• Lista Todas as salas, para ver só uma sala.
• Lista Todos os estados, para ver só um estado.

Os quatro cartões de resumo

Cartão	O que conta
Total do dia	Todas as cirurgias do dia escolhido
Agendadas	As que ainda estão marcadas
Em curso	As que estão a decorrer
Concluídas	As que já terminaram

Lista de cirurgias do dia

Cada cirurgia aparece num cartão, com:

• A hora de início e a hora de fim.
• A descrição da cirurgia.
• A etiqueta de estado.
• O paciente, o cirurgião, a sala e o procedimento.
• A linha Anestesia: {tipo}.
• A linha Equipa: {nome} ({função}), ….
• As notas, se houver.
• Os botões de ação disponíveis nesse estado.

Se não houver nada: «Sem cirurgias marcadas para este dia.»

Janela Salas do bloco

Abre ao clicar em Salas. Permite acrescentar salas e ativar ou desativar as existentes.

Janela Agendar cirurgia

Abre ao clicar em Agendar cirurgia.

Cada botão, o que faz

No topo da página

Botão	O que faz
Salas	Abre a janela Salas do bloco
Agendar cirurgia	Abre a janela de marcação

Nos cartões de cirurgia, conforme o estado

Estado atual	Botões disponíveis
Agendada	Confirmar, Iniciar, Cancelar
Confirmada	Iniciar, Cancelar
Em curso	Concluir
Concluída	nenhum
Cancelada	nenhum

Há ainda, em todos os cartões, um ícone de caixote do lixo, que remove a cirurgia. Pergunta primeiro «Remover esta cirurgia?»

Todos estes botões só aparecem a quem tem schedule-surgery.

Na janela Salas do bloco

Botão	O que faz
Adicionar	Cria a sala
Ativar / Desativar	Liga ou desliga a sala. Salas desativadas deixam de aparecer na marcação
Fechar	Fecha a janela

Na janela Agendar cirurgia

Botão	O que faz
+ membro	Acrescenta uma linha à equipa
Ícone X (numa linha de equipa)	Remove esse membro
Cancelar	Fecha sem gravar
Agendar	Cria a cirurgia

Cada campo do formulário

Janela Agendar cirurgia

Campo	Obrigatório	Regras
Descrição *	Sim	Texto, até 255 caracteres. O exemplo sugerido é «ex.: Apendicectomia»
Paciente	Não	Escolhido da lista. A opção vazia diz — opcional —
Cirurgião	Não	Escolhido da lista de médicos. A opção vazia diz — opcional —
Procedimento	Não	Escolhido da lista. A opção vazia diz — opcional —
Sala	Não	Só aparecem as salas ativas. A opção vazia diz — opcional —
Início *	Sim	Data e hora
Fim	Não	Data e hora. Tem de ser depois do início
Anestesia	Não	Escolhida do cadastro de tipos de anestesia. A opção vazia diz — escolher —
Tipo de cirurgia	Não	Escolhido do cadastro de tipos de cirurgia. A opção vazia diz — escolher —
Equipa	Não	Ver abaixo
Notas	Não	Texto, até 2000 caracteres

O campo Equipa

Cada membro da equipa é um colaborador com conta no sistema. Não se escrevem nomes à mão.

Quando não há ninguém, aparece: «Sem membros. Cada membro é um colaborador com conta no sistema.»

Para cada membro escolhe-se a pessoa e a Função:

Função	Quantos pode haver
Cirurgião principal	Apenas um
Cirurgião auxiliar	Vários
Anestesista	Apenas um
Enfermeiro instrumentista	Vários
Enfermeiro circulante	Vários
Perfusionista	Vários
Técnico	Vários
Observador	Vários

Se acrescentar dois Cirurgiões principais ou dois Anestesistas, o sistema guarda apenas o primeiro. Não dá erro nem aviso — o segundo desaparece em silêncio.

Janela Salas do bloco

Campo	Obrigatório	Regras
Nova sala	Sim	Texto, até 255 caracteres

Estados de uma cirurgia

Etiqueta	Significado
Agendada	Marcada, ainda por confirmar
Confirmada	Confirmada com o paciente e a equipa
Em curso	A decorrer
Concluída	Terminada. Estado final
Cancelada	Cancelada. Estado final

Os estados Concluída e Cancelada são finais. Não é possível voltar atrás.

Verificação de sobreposição de horários

O sistema recusa marcar duas cirurgias na mesma sala à mesma hora, com a mensagem «A sala já está ocupada nesse horário.»

Esta verificação só funciona se preencher os dois campos:

1. A Sala;
2. O Fim.

Sem sala, ou sem hora de fim, o sistema não verifica nada e aceita a marcação. É a causa mais frequente de conflitos no bloco.

Cirurgias no estado Cancelada ou Concluída não bloqueiam o horário.

Cirurgias adjacentes são permitidas: uma que acaba às 10h00 e outra que começa às 10h00 não colidem.

Notificação ao cirurgião

Quando se marca uma cirurgia com Cirurgião preenchido, esse médico recebe uma notificação:

• Título: Nova cirurgia agendada
• Texto: «{descrição} — {data e hora}»

Exemplo prático

Situação: o Dr. Alberto vai operar o Sr. Kiala a uma hérnia inguinal, na próxima terça-feira às 09h00, na Sala 1, com duração prevista de duas horas.

Parte 1 — Criar a sala (só na primeira vez)

1. Ir a Clínica → Bloco operatório.
2. Clicar em Salas.
3. No campo Nova sala, escrever Sala 1.
4. Clicar em Adicionar. Aparece «Sala adicionada.»
5. Clicar em Fechar.

Parte 2 — Marcar a cirurgia

6. Clicar em Agendar cirurgia.
7. Preencher:
   • Descrição *: Herniorrafia inguinal direita
   • Paciente: Kiala Manuel
   • Cirurgião: Alberto Fernandes
   • Procedimento: Herniorrafia
   • Sala: Sala 1
   • Início *: 10/02/2026 09:00
   • Fim: 10/02/2026 11:00
   • Anestesia: Raquianestesia
   • Tipo de cirurgia: Eletiva
8. Montar a equipa, clicando em + membro para cada pessoa:
   • Alberto Fernandes — Cirurgião principal
   • Nsimba Lopes — Cirurgião auxiliar
   • Rita Domingos — Anestesista
   • Paula Neto — Enfermeiro instrumentista
   • Joana Mateus — Enfermeiro circulante
9. Em Notas, escrever Paciente hipertenso. Confirmar medicação na véspera.
10. Clicar em Agendar.
11. Aparece «Cirurgia agendada.» e o Dr. Alberto recebe a notificação.

Parte 3 — No dia

12. Na véspera, depois de falar com o paciente, alguém clica em Confirmar. O estado passa a Confirmada.
13. Às 09h05, ao entrar no bloco, clica-se em Iniciar. O estado passa a Em curso.
14. Às 10h50, no fim, clica-se em Concluir. O estado passa a Concluída.
15. Em cada passo aparece «Estado atualizado.»

Parte 4 — Um conflito

16. Alguém tenta marcar outra cirurgia na Sala 1, das 10:00 às 12:00 do mesmo dia.
17. O sistema recusa, com a mensagem «A sala já está ocupada nesse horário.»

Fluxo completo

Preparar o bloco (uma vez)

1. Ir a Clínica → Bloco operatório.
2. Clicar em Salas e acrescentar todas as salas existentes.
3. Confirmar que os tipos de anestesia e de cirurgia estão nos Cadastros base.

Marcar uma cirurgia

1. Agendar cirurgia.
2. Preencher a Descrição * e o Início *.
3. Preencher sempre a Sala e o Fim — sem eles não há verificação de conflitos.
4. Escolher paciente, cirurgião, procedimento, anestesia e tipo.
5. Montar a Equipa, uma linha por pessoa.
6. Escrever as Notas relevantes.
7. Clicar em Agendar.

Acompanhar no dia

1. Escolher o dia na barra de datas.
2. Ler o mapa e os quatro cartões.
3. Confirmar → Iniciar → Concluir, à medida que a cirurgia avança.
4. Se for desmarcada, clicar em Cancelar.

Erros comuns e como resolver

Mensagem ou situação	Porquê	O que fazer
«A sala já está ocupada nesse horário.»	Já existe outra cirurgia nessa sala, nesse período	Escolha outra sala ou outro horário. Se a outra cirurgia já foi desmarcada, marque-a como Cancelada
Marquei duas cirurgias à mesma hora na mesma sala e o sistema deixou	Faltou preencher a Sala ou o Fim	Preencha sempre os dois campos
Não vejo os botões de ação nos cartões	Falta-lhe a permissão schedule-surgery	Fale com o administrador da clínica
Uma sala não aparece na lista	Está desativada	Vá a Salas e clique em Ativar
Pus dois cirurgiões principais e um desapareceu	Só pode haver um Cirurgião principal e um Anestesista por cirurgia	Mude a função do segundo para Cirurgião auxiliar
Não consigo escolher uma pessoa para a equipa	Só se podem escolher colaboradores com conta no sistema	Crie a conta em Administração → Lista de Usuários
O campo Fim não é aceite	Tem de ser depois do Início	Corrija a hora
Não consigo voltar atrás numa cirurgia Concluída	Os estados finais não têm volta	Se foi engano, remova a cirurgia e marque de novo
O cirurgião não recebeu notificação	O campo Cirurgião ficou vazio	Preencha o cirurgião ao marcar
Removi uma cirurgia por engano	O sistema pergunta antes de remover	Marque-a de novo

Dicas e boas práticas

• Preencha sempre a Sala e a hora de Fim. Sem eles, o sistema não deteta conflitos, e o mapa deixa de servir de mapa.
• Use o estado Confirmada com sentido: só depois de falar com o paciente e com a equipa. É a diferença entre uma cirurgia provável e uma cirurgia certa.
• Cancele em vez de remover. Uma cirurgia cancelada fica no histórico e liberta o horário. Uma cirurgia removida desaparece sem rasto.
• Monte a equipa completa no sistema, mesmo que já esteja combinada verbalmente. É o que permite, mais tarde, saber quem esteve em cada cirurgia.
• Use as Notas para o que a equipa precisa de saber antes de entrar: alergias, medicação, material especial.
• Escolha um dia e verifique o mapa logo de manhã. É mais rápido do que telefonar a toda a gente.

Por confirmar

• Não foi possível confirmar se existe uma vista semanal ou mensal do mapa cirúrgico. A página mostra um dia de cada vez.
• A janela de salas aceita, do lado do servidor, uma descrição para cada sala, mas não foi encontrado o campo no ecrã.
• Não foi possível confirmar se é possível editar uma cirurgia já marcada (por exemplo, mudar a hora). Só se encontraram as ações de mudar de estado e de remover.
• Não foi possível confirmar se a cirurgia gera faturação, nem como.
• Não foi possível confirmar o que acontece à equipa quando se remove uma cirurgia com soft-delete.