Utilizadores e permissões

Para que serve

Este módulo trata de quem entra no sistema e do que cada pessoa pode fazer.

Tem duas partes:

• Utilizadores — as contas das pessoas: nome, e-mail, palavra-passe e dados pessoais.
• Papéis — os perfis de acesso (médico, enfermeiro, receção, etc.) e as permissões de cada um.

Antes de trabalhar com este módulo, leia o capítulo 04 — Perfis e permissões. Explica a diferença entre perfil e permissão.

Quando usar

• Quando entra uma pessoa nova na clínica.
• Quando alguém sai e é preciso retirar-lhe o acesso.
• Quando alguém muda de funções e precisa de outras permissões.
• Quando é preciso criar um perfil de acesso novo, com um conjunto de permissões diferente dos existentes.

Quem pode usar

Ação	Permissão	Perfis que têm
Ver a lista de utilizadores	view-users	admin, superadmin, médico, enfermeiro, receção
Criar utilizador	create-user	admin, superadmin, receção
Editar utilizador	edit-user	admin, superadmin, receção
Apagar utilizador	delete-user	admin, superadmin, receção
Ver papéis	view-roles	admin, superadmin
Criar papel	create-role	admin, superadmin
Editar papel	edit-role	admin, superadmin
Apagar papel	delete-role	admin, superadmin
Criar permissões	manage-permissions	admin, superadmin

Aviso. Os botões deste módulo estão escondidos a quem não tem permissão, mas não foi possível confirmar que exista bloqueio efetivo do lado do servidor em todas as operações. Ver a secção «Por confirmar».

Ecrãs e funcionalidades

1. Lista de utilizadores

Endereço: /users Menu: grupo Administração → Lista de Usuários

[CAPTURA: lista de utilizadores, com o botão "Novo utilizador" em cima à direita e a tabela com as colunas Utilizador, Género, Idade, Papel e Ações]

• Linha pequena: Administração
• Título: Utilizadores
• Botão Novo utilizador, no canto superior direito
• Campo de pesquisa: Pesquisar por nome…
• Tabela com as colunas: Utilizador, Género, Idade, Papel, Ações
• O papel aparece como etiqueta colorida
• Se não houver resultados: «Nenhum utilizador encontrado.»
• Paginação: «A mostrar X–Y de Z», com Anterior e Seguinte

Ao clicar no nome de um utilizador, abre a janela Informações do utilizador.

2. Janela Novo utilizador

Abre ao clicar no botão Novo utilizador.

3. Página Editar utilizador

Abre ao clicar em Editar numa linha da lista.

4. Página Papéis e permissões

Endereço: /role Menu: grupo Administração → Lista de Papeis

[CAPTURA: página de papéis, com os separadores "Papéis" e "Permissões" e a tabela de papéis]

• Linha pequena: Administração
• Título: Papéis e permissões
• Botão Novo papel, no canto superior direito
• Dois separadores: Papéis e Permissões

Separador Papéis: tabela com as colunas #, Nome e Ações. As ações são Ver, Editar e Apagar. Se não houver nada: «Nenhum papel encontrado.»

Separador Permissões: um formulário Criar permissão, com o campo Nome da permissão e o botão Criar permissão.

5. Página Novo papel / Editar papel

• Campo Nome do papel (o exemplo sugerido é «ex.: recepcionista»).
• Bloco Permissões, com todas as permissões em forma de etiquetas. Clique numa etiqueta para a ligar ou desligar.
• Botão Criar papel ou Guardar alterações.

6. Página de detalhe de um papel

Mostra o nome do papel e a lista das suas Permissões, em etiquetas com um visto. Se não tiver nenhuma: «Sem permissões atribuídas.» Tem um botão Editar papel.

Cada botão, o que faz

Na lista de utilizadores

Botão	O que faz
Novo utilizador	Abre a janela de criação
Nome do utilizador	Abre a janela Informações do utilizador
Editar	Abre a página de edição
Excluir	Pergunta «Tem a certeza que deseja excluir este utilizador?» e, se confirmar, apaga
Anterior / Seguinte	Muda de página

Nos formulários de utilizador

Botão	O que faz
Guardar utilizador	Cria o utilizador. Enquanto grava, mostra A guardar…
Guardar alterações	Grava a edição
Cancelar	Volta atrás sem gravar
Ícone do olho (no campo Senha)	Mostra ou esconde a palavra-passe

Na página de papéis

Botão	O que faz
Novo papel	Abre a página de criação de papel
Ver	Abre o detalhe do papel, com as suas permissões
Editar	Abre a página de edição do papel
Apagar	Pergunta «Tem a certeza que deseja apagar este papel?» e, se confirmar, apaga
Criar papel / Guardar alterações	Grava o papel
Criar permissão	Cria uma permissão nova

Cada campo do formulário

Janela Novo utilizador

Campo	Obrigatório	Notas
Nome	Sim, na prática	—
E-mail	Sim, na prática	Serve para iniciar sessão
B.I.	Não	Bilhete de Identidade
Telefone	Não	—
Telefone alternativo	Não	—
Género	Não	—
Data de nascimento	Não	—
Estado civil	Não	—
Nacionalidade	Não	—
Etnia	Não	—
Ocupação profissional	Não	—
Grupo sanguíneo	Não	—
Endereço	Não	—
Endereço 2	Não	—
Bairro	Não	—
Cidade	Não	—
Município	Não	—
Data de registo	Não	—
Senha	Não	Se ficar em branco, é gerada automaticamente. O campo diz «Deixe em branco para gerar automaticamente»
Papéis	Sim, na prática	Etiquetas que se ligam e desligam com um clique

Atenção. Tal como no registo de médicos, o servidor não verifica os campos deste formulário na criação. A única coisa que impede é o e-mail repetido: nesse caso aparece a mensagem técnica «User already exists», em inglês.

Página Editar utilizador

Aqui, sim, o servidor verifica os campos.

Campo	Obrigatório	Regras
Nome	Sim	—
E-mail	Sim	Tem de ser um e-mail válido e não pode já estar a ser usado por outra pessoa
Papéis	Sim	Tem de ter pelo menos um papel
Restantes campos pessoais	Não	Texto livre

O formulário de edição tem ainda os campos País e Observações, que não existem no formulário de criação.

Ao gravar aparece a mensagem «Dados do médico atualizados com sucesso.» — a mensagem diz «médico» mesmo quando o utilizador não é médico. É um erro de texto do sistema, não um sinal de que algo correu mal.

Página Novo papel / Editar papel

Campo	Obrigatório	Regras
Nome do papel	Sim	Até 250 caracteres. Não pode repetir um nome já existente
Permissões	Sim	Tem de escolher pelo menos uma

Formulário Criar permissão

Campo	Obrigatório	Regras
Nome da permissão	Sim	Não pode repetir uma permissão já existente

Ao gravar aparece: «Permissão criada com sucesso!»

Exemplo prático

Situação: entra na receção a Sra. Mariana Bumba. Precisa de acesso para marcar consultas e faturar.

Parte 1 — Criar a conta

1. A administradora vai a Administração → Lista de Usuários.
2. Clica em Novo utilizador.
3. Preenche:
   • Nome: Mariana Bumba
   • E-mail: mariana.bumba@aclinica.ao
   • B.I.: 004567890LA041
   • Telefone: 923 456 789
   • Data de nascimento: 12/03/1995
4. Deixa a Senha em branco, para ser gerada automaticamente.
5. Nos Papéis, liga a etiqueta reception.
6. Clica em Guardar utilizador.
7. Confirma na lista que a Sra. Mariana aparece, com a etiqueta reception na coluna Papel.
8. Comunica-lhe o e-mail e a palavra-passe.

Parte 2 — Verificar o que ela pode fazer

9. A administradora vai a Administração → Lista de Papeis.
10. No separador Papéis, localiza reception e clica em Ver.
11. Vê a lista de permissões desse papel, em etiquetas com visto.
12. Confirma que estão lá create-appointment, manage-billing e view-invoices.

Parte 3 — Quando a Sra. Mariana sair da clínica

13. A administradora vai a Administração → Lista de Usuários.
14. Procura Mariana no campo Pesquisar por nome….
15. Clica em Excluir e confirma na pergunta «Tem a certeza que deseja excluir este utilizador?».

Fluxo completo

Dar acesso a uma pessoa nova

1. Ir a Administração → Lista de Usuários.
2. Clicar em Novo utilizador.
3. Preencher nome, e-mail e dados pessoais.
4. Escolher os Papéis adequados à função.
5. Clicar em Guardar utilizador.
6. Confirmar na lista que a pessoa aparece com o papel certo.
7. Entregar os dados de acesso à pessoa.

Mudar o que alguém pode fazer

1. Ir a Administração → Lista de Usuários.
2. Localizar a pessoa e clicar em Editar.
3. Alterar os Papéis.
4. Clicar em Guardar alterações.
5. Pedir à pessoa que termine sessão e volte a entrar.

Criar um perfil de acesso novo

1. Ir a Administração → Lista de Papeis.
2. Clicar em Novo papel.
3. Escrever o Nome do papel.
4. Ligar as Permissões necessárias, uma a uma.
5. Clicar em Criar papel.
6. Atribuir esse papel às pessoas, na lista de utilizadores.

Erros comuns e como resolver

Mensagem ou situação	Porquê	O que fazer
«User already exists»	Já existe uma conta com esse e-mail	Use outro e-mail, ou procure a conta existente na lista
Criei um utilizador e ele não aparece na lista	O formulário de criação não avisa quando falha	Volte a criar, com todos os campos preenchidos
A pessoa não consegue iniciar sessão	Palavra-passe errada, ou nenhum papel atribuído	Edite o utilizador e confirme os Papéis. Peça uma nova palavra-passe ao administrador
Alterei os papéis e a pessoa continua a ver o mesmo menu	As permissões só são recarregadas quando a sessão recomeça	Peça à pessoa para terminar sessão e voltar a entrar
«USER DOES NOT HAVE THE RIGHT PERMISSIONS»	Está a tentar editar ou apagar alguém que não pode	Use uma conta com perfil de administrador
«SUPER ADMIN ROLE CAN NOT BE DELETED»	O papel de superadministrador não pode ser apagado	É intencional. Não o apague
«CAN NOT DELETE SELF ASSIGNED ROLE»	Está a tentar apagar o papel que a sua própria conta tem	Peça a outro administrador que o faça, ou retire primeiro o papel à sua conta
«Usuário não encontrado»	O utilizador já não existe	Recarregue a lista
«Não foi possível carregar a foto.»	O ficheiro não é imagem, ou passa dos 5 MB	Reduza a imagem
Mensagens em inglês («New role is added successfully.», «Role is updated successfully.», «Role deleted successfully.»)	O sistema ainda não traduziu estas mensagens	Significam sucesso: papel criado, atualizado ou apagado
A mensagem diz «Dados do médico atualizados» mas eu editei uma rececionista	Erro de texto do sistema	A gravação correu bem. Ignore a palavra «médico»
Ao apagar uma permissão aparece «Plano de saúde excluído com sucesso.»	Erro de texto do sistema	A permissão foi apagada. A mensagem está errada
Não encontro Lista de Permissões no menu	Foi retirada de propósito	As permissões geram-se dentro dos Papéis

Dicas e boas práticas

• Use os papéis que já existem. admin, doctor, nurse, reception e lab cobrem quase todas as situações e já vêm com as permissões corretas.
• Crie um papel novo apenas quando nenhum dos existentes servir. Um papel mal construído dá acesso a mais do que devia, ou impede o trabalho.
• Antes de apagar um papel, confirme que ninguém o está a usar. As pessoas com esse papel ficam sem as permissões correspondentes.
• Uma conta por pessoa, sempre. Ver o capítulo 04 — Perfis e permissões.
• Quando alguém sai da clínica, trate do acesso no próprio dia.
• Depois de mudar papéis, avise a pessoa para terminar sessão e voltar a entrar.
• Não crie permissões novas a não ser que o responsável técnico o peça. Uma permissão criada aqui não faz nada sozinha: tem de estar ligada a uma funcionalidade do programa.

Por confirmar

• As páginas de criar, editar e apagar utilizadores e permissões não parecem ter bloqueio de permissões do lado do servidor. Os botões estão escondidos a quem não tem permissão, mas não foi possível confirmar que exista proteção efetiva. Isto deve ser comunicado ao responsável técnico da clínica.
• Não foi possível confirmar como é que se redefine a palavra-passe de um utilizador já existente. O formulário de edição não mostra campo de senha, embora o servidor o aceite.
• O módulo chamado Authorization existe no sistema, mas está vazio e não tem qualquer ecrã. A gestão de papéis e permissões faz-se toda a partir de Administração → Lista de Papeis.
• Não existem testes automáticos para este módulo. Confirme sempre à mão o resultado das operações.
• Não foi possível confirmar o que acontece às marcações, prontuários e faturas de um utilizador que seja apagado.