Gestão de Utilizadores

A Gestão de Utilizadores centraliza o controlo de acesso ao sistema, permitindo gerir quem pode aceder e com que permissões.

Layout da Página

Lista de Utilizadores

Cada utilizador mostra:

Informação Principal

• Avatar — Foto ou iniciais
• Nome — Nome completo
• Email — Endereço de email
• Departamento — Se definido

Estados e Badges

Informação Adicional

• Criado em — Data de criação da conta
• Último acesso — Última vez que entrou
• Role — Função na organização

Estatísticas (Painel Direito)

Convidar Utilizador

Quem Pode Convidar

Apenas administradores podem convidar novos utilizadores.

Como Convidar

1. Clique em "Convidar Utilizador"
2. Introduza o email do novo utilizador
3. Clique em "Enviar Convite"

O que Acontece

1. Email de convite é enviado
2. Utilizador clica no link
3. Cria conta (se necessário)
4. Junta-se à organização
5. Aparece na lista de utilizadores

Filtros e Pesquisa

Pesquisa

Encontre utilizadores por:

• Nome
• Email

Debounce: 150ms para melhor performance.

Filtro de Estado

Gestores de Clientes

Funcionalidade para atribuir gestores a clientes:

1. Clique em "Gestores de Clientes"
2. Veja atribuições atuais
3. Adicione ou remova gestores
4. Guarde alterações

Permissões e Funções

Níveis de Acesso

Departamentos

Utilizadores podem ser associados a departamentos:

• Contabilidade
• Recursos Humanos
• Administrativo
• Receção

O departamento afeta algumas funcionalidades (ex: RH pode aprovar férias).

Desativar Utilizador

Quando Desativar

• Utilizador deixou a empresa
• Acesso temporariamente suspenso
• Conta comprometida

Como Desativar

1. Encontre o utilizador
2. Clique nas opções
3. Selecione "Desativar"
4. Confirme a ação

Impacto

• Utilizador não pode fazer login
• Histórico mantido
• Pode ser reativado posteriormente

Suspensão no Google Workspace

Se o utilizador tiver email do domínio gerido no Google Workspace, o CRM pode também suspender a conta Google sem a eliminar. Isto exige configuração adicional no Google Cloud e no Google Admin.

Variáveis de ambiente necessárias

Estas variáveis são específicas desta integração e não devem reutilizar automaticamente as variáveis genéricas do Google Calendar:

GOOGLE_WORKSPACE_SERVICE_ACCOUNT_EMAIL=
GOOGLE_WORKSPACE_PRIVATE_KEY=
GOOGLE_WORKSPACE_ADMIN_EMAIL=
GOOGLE_WORKSPACE_MANAGED_DOMAIN=salvadorprospero.com

Se gerir mais do que um domínio:

GOOGLE_WORKSPACE_MANAGED_DOMAINS=salvadorprospero.com,outraempresa.com

O que cada variável significa

• GOOGLE_WORKSPACE_SERVICE_ACCOUNT_EMAIL — Email do service account criado especificamente para a integração com o Admin SDK.
• GOOGLE_WORKSPACE_PRIVATE_KEY — Chave privada do JSON desse service account, em formato de uma linha com \n.
• GOOGLE_WORKSPACE_ADMIN_EMAIL — Email de um utilizador Google Workspace com permissões de Super Admin para ser impersonado via domain-wide delegation.
• GOOGLE_WORKSPACE_MANAGED_DOMAIN / GOOGLE_WORKSPACE_MANAGED_DOMAINS — Lista de domínios para os quais o CRM deve tentar suspender utilizadores.

Passo a passo completo

1. Entre em Google Cloud Console.
2. Crie um projeto novo para esta integração, por exemplo crm-google-workspace-admin.
3. No projeto, vá a APIs & Services → Library.
4. Procure Admin SDK API e clique em Enable.
5. Vá a IAM & Admin → Service Accounts.
6. Clique em Create service account.
7. Dê um nome claro, por exemplo crm-workspace-user-suspension.
8. Termine a criação do service account.
9. Abra o service account criado.
10. Em Keys, clique em Add Key → Create new key → JSON.
11. Guarde o ficheiro JSON num local seguro. Este ficheiro contém o email e a private key.
12. Ainda no service account, abra Show advanced settings e confirme que Domain-wide delegation está ativa. Se não estiver, ative.
13. Copie o Client ID do service account.
14. Entre em Google Admin Console com uma conta Super Admin.
15. Vá a Security → Access and data control → API controls → Manage Domain Wide Delegation.
16. Clique em Add new.
17. Cole o Client ID do service account.
18. Em OAuth scopes, adicione:

https://www.googleapis.com/auth/admin.directory.user

1. Clique em Authorize.
2. Escolha o email de admin que o CRM vai usar em GOOGLE_WORKSPACE_ADMIN_EMAIL. Deve ser um Super Admin do domínio.
3. No ficheiro de ambiente do CRM, configure:

GOOGLE_WORKSPACE_SERVICE_ACCOUNT_EMAIL=service-account-name@project-id.iam.gserviceaccount.com
GOOGLE_WORKSPACE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
GOOGLE_WORKSPACE_ADMIN_EMAIL=admin@salvadorprospero.com
GOOGLE_WORKSPACE_MANAGED_DOMAIN=salvadorprospero.com

1. Reinicie a app CRM.
2. No CRM, desative um utilizador de teste do domínio gerido.
3. Confirme no Google Admin que o utilizador ficou com estado Suspended.
4. Reative o utilizador no CRM e confirme que voltou a ficar ativo no Google Workspace.

Como obter os valores a partir do JSON

No ficheiro JSON descarregado do Google Cloud:

• client_email → GOOGLE_WORKSPACE_SERVICE_ACCOUNT_EMAIL
• private_key → GOOGLE_WORKSPACE_PRIVATE_KEY
• client_id → usar no Manage Domain Wide Delegation

Notas importantes

• A autorização no Google Admin pode demorar algum tempo a propagar, embora normalmente seja rápida.
• Se a organização usar multi-party approval, outro Super Admin pode ter de aprovar a delegação.
• Este setup permite suspender contas Google Workspace; por isso, deve ser feito com um service account dedicado e bem documentado.

Reativar Utilizador

1. Filtre por "Desativados"
2. Encontre o utilizador
3. Clique em "Reativar"
4. Utilizador volta a poder aceder

Autenticação

O sistema usa Clerk para autenticação:

Métodos Disponíveis

• Email e password
• Login social (se configurado)
• Single Sign-On (se configurado)

Segurança

• Passwords seguras obrigatórias
• Sessões geridas automaticamente
• Logout em dispositivos inativos

Boas Práticas

Convites

• Use emails corporativos quando possível
• Verifique que email está correto
• Informe o utilizador que vai receber convite

Gestão

• Reveja utilizadores periodicamente
• Desative contas de quem saiu
• Mantenha departamentos atualizados

Segurança

• Limite número de admins
• Reveja acessos regularmente
• Desative contas suspeitas imediatamente