Gestão de Usuários
Este guia explica como gerenciar os usuários do PCH-SIG.
Visão geral
Os usuários são gerenciados via:
- Interface de administração (Parâmetros > Usuários)
- Comandos de console Symfony
- API REST
Criar um usuário
Via interface
- Acesse Parâmetros > Usuários
- Clique em Novo usuário
- Preencha o formulário:
- Email: Endereço de email único
- Nome completo: Nome e sobrenome
- Função: Selecione a função apropriada
- Senha: Mínimo 8 caracteres
- Clique em Salvar
Via console
# Criar um administrador
docker exec -it pch_backend php bin/console app:create-admin email@example.com Senha123!
# Criar um usuário com um papel específico
docker exec -it pch_backend php bin/console app:create-user email@example.com Senha123! ROLE_DATA_ENTRY
Via fixtures
# Carregar usuários de teste
docker exec -it pch_backend php bin/console doctrine:fixtures:load --group=users --no-interaction
Usuários padrão
| Função | Senha | Descrição | |
|---|---|---|---|
| admin@pch-sig.sn | Admin | Admin123! | Conta de administrador principal |
| makhtar.gueye@axone-sn.com | Admin | Admin123! | Administrador técnico |
Segurança
Altere as senhas padrão após o primeiro acesso.
Modificar um usuário
Via interface
- Acesse Parâmetros > Usuários
- Clique no usuário a modificar
- Modifique as informações
- Clique em Salvar
Campos modificáveis
| Campo | Descrição | Modificável |
|---|---|---|
| Identificador de login | Sim | |
| Nome completo | Nome exibido | Sim |
| Função | Permissões concedidas | Sim |
| Senha | Autenticação | Sim |
| Ativo | Conta ativa/inativa | Sim |
Desativar um usuário
Via interface
- Acesse Parâmetros > Usuários
- Clique no usuário
- Desmarque Conta ativa
- Salve
Efeito da desativação
- O usuário não pode mais se conectar
- Suas sessões ativas são invalidadas
- Seu histórico é conservado
- A conta pode ser reativada
Redefinir uma senha
Via interface (administrador)
- Acesse Parâmetros > Usuários
- Clique no usuário
- Clique em Redefinir senha
- Digite a nova senha
- Comunique a senha ao usuário
Via console
docker exec -it pch_backend php bin/console app:reset-password email@example.com NovaSenha123!
Via interface do usuário
O usuário pode redefinir sua senha:
- Na página de login, clicar em Esqueci minha senha
- Digitar seu endereço de email
- Receber um email com um link de redefinição
- Definir uma nova senha
Excluir um usuário
Atenção
A exclusão de um usuário é irreversível. Prefira a desativação.
Via interface
- Acesse Parâmetros > Usuários
- Clique no usuário
- Clique em Excluir
- Confirme a exclusão
Restrições de exclusão
Um usuário não pode ser excluído se:
- Ele criou domicílios
- Ele validou pagamentos
- Ele tem ações de auditoria associadas
Neste caso, desative a conta em vez disso.
Pesquisar usuários
Filtros disponíveis
| Filtro | Descrição |
|---|---|
| Pesquisa por email | |
| Nome | Pesquisa por nome |
| Função | Filtrar por função |
| Status | Ativo / Inativo |
Exemplo de pesquisa API
curl -X GET "http://localhost:8000/api/users?search=makhtar" \
-H "Authorization: Bearer $TOKEN"
Exportar usuários
Via interface
- Acesse Parâmetros > Usuários
- Clique em Exportar
- Selecione o formato (CSV, Excel)
- Baixe o arquivo
Campos exportados
- Nome completo
- Função
- Data de criação
- Última conexão
- Status (ativo/inativo)
Histórico de conexões
Consultar o histórico
- Acesse Parâmetros > Usuários
- Clique em um usuário
- Aba Histórico
Informações registradas
| Campo | Descrição |
|---|---|
| Data/Hora | Momento da conexão |
| Endereço IP | IP do cliente |
| Navegador | User-Agent |
| Resultado | Sucesso / Falha |
Boas práticas
Segurança das contas
- Usar senhas fortes (8+ caracteres, maiúsculas, números, símbolos)
- Alterar as senhas regularmente
- Não compartilhar contas entre usuários
- Desativar contas não utilizadas
Gestão de funções
- Atribuir a função mínima necessária
- Verificar regularmente as permissões
- Documentar as atribuições de funções
Auditoria
- Consultar regularmente as conexões falhadas
- Verificar contas inativas há muito tempo
- Monitorar atividades incomuns