Gestão de Grupos

O módulo de Grupos permite organizar a base de utilizadores em categorias lógicas superiores. Ao contrário das Tags (etiquetas simples), os Grupos são utilizados para a Gestão de Operação em Massa, facilitando o controlo de frotas complexas e a extração de relatórios consolidados.

---

Operações de Grupo

Funcionalidade	Método	Caminho	Descrição
Listar Grupos	GET	/groups	Lista os agrupamentos com filtros de status.
Criar Grupo	POST	/group	Cria um novo agrupamento operacional.

Exemplo de Resposta (Listagem)

{
    "data": [
      {
        "id": 10,
        "name": "Condutores Logística",
        "status": "active",
        "members": 42
      }
    ]
  }

---

Vinculação e Relacionamentos

Um grupo pode herdar membros de forma dinâmica através de Tags ou vinculações diretas a Organizações.

POST /add-group

Campo (Body)	Obrigatório	Descrição
group_id	Sim	ID do grupo alvo.
organization_id	Opcional	Vincula todos os membros de uma frota B2B.
tag_id	Opcional	Vincula utilizadores que possuam uma etiqueta específica.

Corpo da Requisição (Vincular Organização ao Grupo)

{
    "group_id": 10,
    "organization_id": 5
  }