Médicos

Para que serve

Este módulo guarda o registo dos médicos da clínica: dados pessoais, número de licença, especialidade, horário de trabalho e fotografia.

O horário de trabalho registado aqui é o que a agenda usa para saber quando cada médico atende.

Quando usar

• Quando entra um médico novo na clínica.
• Quando um médico muda de horário ou de especialidade.
• Quando é preciso consultar o contacto ou o número de licença de um médico.
• Quando um médico quer ver as suas próximas consultas.

Quem pode usar

Ação	Permissão	Perfis que têm
Ver a lista e a ficha de um médico	view-doctors	admin, superadmin, médico, enfermeiro, receção
Criar um médico	create-doctor	admin, superadmin
Editar um médico	edit-doctor	admin, superadmin
Apagar um médico	delete-doctor	admin, superadmin
Mudar a própria fotografia	—	O próprio médico, sempre

Nota: o perfil médico vê a lista de médicos, mas não pode criar nem editar outros médicos. Cada médico pode, no entanto, mudar a sua própria fotografia.

Ecrãs e funcionalidades

1. Lista de médicos

Endereço: /doctor

[CAPTURA: lista de médicos, com o campo de pesquisa em cima e a tabela com as colunas Médico, Género, Idade, Papel e Ações]

• Título: Médicos
• Campo de pesquisa: Pesquisar por nome…
• Botão Novo médico, no canto superior direito
• Tabela com as colunas: Médico, Género, Idade, Papel, Ações
• Se não houver resultados: «Nenhum médico encontrado.»
• Em baixo: «A mostrar X–Y de Z», com os botões Anterior e Seguinte

Ao clicar no nome de um médico, abre uma janela Perfil do médico com um resumo.

2. Ficha do médico

Endereço: /doctor/{id}

Mostra o nome do médico, a etiqueta Médico e:

• Atalhos Email e Ligar.
• Cartão Informações do médico, com uma ligação Editar e os campos: Nº de licença, Especialidade, Horário da clínica, Telefone, Endereço e BI. Os campos vazios aparecem com um travessão (—).
• Cartão Horário de atendimento. Se não estiver definido, aparece «Não definido.»
• Cartão Próximas consultas, com as colunas Paciente, Data, Hora e Motivo. Se o próprio médico tiver permissão de marcações, aparece ainda a coluna Ação, com os botões Atender e Ver. Se não houver nada: «Sem consultas agendadas.»

[CAPTURA: ficha do médico, com o cartão de informações à esquerda e as próximas consultas em baixo]

Cada botão, o que faz

Na lista de médicos

Botão	O que faz
Novo médico	Abre a janela Registo de novo médico
Nome do médico (na tabela)	Abre a janela Perfil do médico
Ícone Ver detalhes	Abre a ficha completa do médico
Ícone Editar	Abre o formulário de edição
Ícone Excluir	Pergunta «Tem a certeza que deseja excluir este médico?» e, se confirmar, apaga
Anterior / Seguinte	Muda de página na lista

Na ficha do médico

Botão	O que faz
Email	Abre o programa de correio eletrónico com o endereço preenchido
Ligar	Inicia uma chamada para o número do médico
Editar	Abre o formulário de edição
Ícone da máquina fotográfica	Muda a fotografia. Ao passar o rato aparece Mudar foto. Só aparece ao próprio médico ou a quem tem edit-doctor
Atender (em Próximas consultas)	Abre o ecrã de atendimento clínico dessa consulta
Ver (em Próximas consultas)	Abre os detalhes da marcação

No formulário

Botão	O que faz
Criar médico / Guardar médico	Grava o médico novo. Enquanto grava, mostra A guardar…
Guardar alterações	Grava as alterações
Cancelar	Fecha sem gravar

Cada campo do formulário

Janela Registo de novo médico

Campo	Obrigatório	Notas
Nome	Sim, na prática	—
E-mail	Sim, na prática	Serve para o médico iniciar sessão
Senha	Não	Se deixar em branco, é gerada automaticamente. O campo diz «Deixe em branco para gerar automaticamente». Há um ícone para mostrar ou esconder
Nº de licença	Não	A cédula profissional
Papéis	Sim, na prática	Etiquetas que se ligam e desligam com um clique
Especialidade	Não	Lista. A opção vazia diz «Selecione uma especialidade»
Início do expediente	Não	Data e hora
Fim do expediente	Não	Data e hora
Escala	Não	Blocos de horário por dia da semana. Ver abaixo

Atenção. O servidor não verifica os campos deste formulário na criação. Não há aviso se o e-mail já existir, se o nome ficar vazio ou se a senha for demasiado curta. Preencha com cuidado e confirme depois na lista se o médico foi criado corretamente.

Formulário de edição

Aqui, sim, o servidor verifica os campos.

Campo	Obrigatório	Regras
Nome	Sim	Até 255 caracteres
E-mail	Sim	Tem de ser um e-mail válido, até 255 caracteres
Nº de licença	Não	Até 255 caracteres
Telefone	Não	—
Género	Não	—
Data de nascimento	Não	Tem de ser uma data válida
Estado civil	Não	—
Nacionalidade	Não	—
Etnia	Não	—
Ocupação profissional	Não	—
Endereço	Não	—
Bairro	Não	—
Cidade	Não	—
Município	Não	—
Data de registo	Não	Tem de ser uma data válida
Início do expediente	Não	—
Fim do expediente	Não	—
Observações	Não	Campo de texto livre
Papéis	—	Etiquetas que se ligam e desligam
Escala	Não	Ver abaixo

Ao gravar aparece a mensagem: «Dados do médico atualizados com sucesso.»

Campo Escala (horário de atendimento)

A escala define, para cada dia da semana, a hora de início e a hora de fim em que o médico atende.

1. Clique em Adicionar escala.
2. Aparece um bloco chamado Escala #1.
3. Escolha o Dia da semana (de Domingo a Sábado).
4. Preencha a Hora de início e a Hora de fim.
5. Repita para os outros dias.
6. Para apagar um bloco, use o ícone do caixote do lixo.

Regra que causa confusão: se a escala estiver preenchida mas não tiver um bloco para um determinado dia, o médico é considerado indisponível nesse dia. Não há recurso ao horário geral da clínica.

Se a escala estiver completamente vazia, o sistema usa, por esta ordem:

1. Início do expediente e Fim do expediente do médico;
2. os limites de horário definidos nas configurações do calendário;
3. como último recurso, das 08h00 às 17h00.

Fotografia

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

Se falhar, aparece: «Não foi possível carregar a foto.»

Exemplo prático

Situação: entra na clínica a Dra. Luísa Cardoso, pediatra. Trabalha às segundas, quartas e sextas, das 08h00 às 13h00.

1. A administradora vai a Clínica → Lista de Médicos.
2. Clica em Novo médico.
3. Preenche:
   • Nome: Luísa Cardoso
   • E-mail: luisa.cardoso@aclinica.ao
   • Senha: deixa em branco, para ser gerada automaticamente
   • Nº de licença: AO-12345
4. Nos Papéis, liga a etiqueta doctor.
5. Em Especialidade, escolhe Pediatria.
6. Na Escala, clica três vezes em Adicionar escala e preenche:
   • Escala #1 — Dia: Segunda-feira, Início: 08:00, Fim: 13:00
   • Escala #2 — Dia: Quarta-feira, Início: 08:00, Fim: 13:00
   • Escala #3 — Dia: Sexta-feira, Início: 08:00, Fim: 13:00
7. Clica em Criar médico.
8. Volta à lista e confirma que a Dra. Luísa Cardoso aparece.
9. Abre a ficha dela e verifica o cartão Horário de atendimento.
10. Comunica à Dra. Luísa o e-mail e a palavra-passe de acesso.

Na agenda, a partir de agora, o sistema só oferece horários da Dra. Luísa às segundas, quartas e sextas de manhã.

Fluxo completo

Registar um médico novo

1. Ir a Clínica → Lista de Médicos.
2. Clicar em Novo médico.
3. Preencher nome, e-mail e número de licença.
4. Ligar o papel doctor nos Papéis.
5. Escolher a Especialidade.
6. Preencher a Escala com os dias e horas de atendimento.
7. Clicar em Criar médico.
8. Confirmar na lista que o médico foi criado.
9. Entregar ao médico os dados de acesso.

Atualizar o horário de um médico

1. Ir a Clínica → Lista de Médicos.
2. Localizar o médico e clicar no ícone Editar.
3. Alterar os blocos da Escala.
4. Clicar em Guardar alterações.
5. Confirmar na agenda que os horários mudaram.

Erros comuns e como resolver

Situação	Porquê	O que fazer
Criei um médico mas ele não aparece na lista	O formulário de criação não verifica os campos; pode ter falhado em silêncio	Volte a criar, com todos os campos preenchidos. Verifique se o e-mail já estava a ser usado
O médico não consegue iniciar sessão	Não recebeu a palavra-passe, ou o papel doctor não foi atribuído	Edite o médico e confirme os Papéis. Peça ao administrador uma nova palavra-passe
O médico não aparece na agenda	A especialidade não foi preenchida, ou a escala não cobre o dia	Edite o médico e reveja Especialidade e Escala
A agenda diz que o médico não atende à quinta-feira	A escala tem blocos, mas nenhum para quinta-feira	Acrescente um bloco de escala para esse dia
Alterei os Papéis na edição e não ficou gravado	Ver a secção «Por confirmar»	Confirme os papéis em Administração → Lista de Usuários
«Não foi possível carregar a foto.»	O ficheiro não é imagem, ou passa dos 5 MB	Reduza a imagem ou converta-a para JPG/PNG
Um utilizador sem permissão mudou a foto de outro médico	Não deve acontecer: o sistema verifica	Se acontecer, comunique ao administrador
A ficha diz Não definido no horário	A escala está vazia	Edite o médico e preencha a Escala

Dicas e boas práticas

• Preencha sempre a Escala. Sem ela, a agenda usa horários genéricos e aparecem marcações em horas em que o médico não está.
• Confirme sempre, depois de criar um médico, que ele aparece na lista. O formulário de criação não avisa quando falha.
• Use e-mails da clínica, não pessoais. Quando o médico sair, a conta é mais fácil de gerir.
• O número de licença aparece nos documentos assinados. Preencha-o corretamente desde o início.
• Uma fotografia ajuda a receção a identificar rapidamente o médico nas listas.
• Não apague um médico que já tenha consultas registadas. Em vez disso, peça ao administrador para desativar o acesso dele.

Por confirmar

• A criação de médicos não é verificada pelo servidor. Não existem regras de validação para este formulário. Não foi possível confirmar o que acontece quando se cria um médico com e-mail repetido ou com campos em falta.
• Existem duas formas diferentes de criar um médico: uma janela a partir da lista e uma página separada (/doctor/create), com campos diferentes. Não foi possível confirmar qual delas é a oficial.
• No formulário de edição, o seletor de Papéis aparece no ecrã, mas não foi possível confirmar que as alterações aos papéis fiquem gravadas. Confirme sempre em Administração → Lista de Usuários.
• As páginas de listar, ver e apagar médicos não verificam permissões do lado do servidor. Os botões estão escondidos no ecrã a quem não tem permissão, mas não foi possível confirmar que exista bloqueio efetivo. Comunique isto ao responsável técnico da clínica.
• Existem no código duas páginas (Atendent e AtendentConfig) que estão vazias e não são alcançáveis por nenhum endereço. Parecem estar por implementar.
• Um médico tem uma só especialidade. Não foi encontrada forma de atribuir várias.