Grupo de Atributos (AttributeGroup)

O AttributeGroup é a base da organização semântica dos dados.
Ele atua como um container estrutural, responsável por agrupar atributos relacionados e estabelecer uma hierarquia lógica utilizada em formulários, filtros, regras de negócio e apresentação no sistema.

Seu papel é garantir consistência, escalabilidade e isolamento por empresa.

---

Identidade do Modelo

Configurações de back-end que definem o comportamento estrutural do objeto.

Recurso	Identificador	Finalidade
Módulo	Atributo	Localização funcional no ecossistema
Grupo	AttributeGroup	Agrupamento técnico para processamento
Ícone	mdi-alpha-r-circle	Identidade visual no sistema
Principal	Sim	Define se é um ponto de entrada no menu

---

Contrato do Modelo

Este schema assume as seguintes garantias:

• Todo AttributeGroup pertence a uma única empresa
• O campo code é imutável após a criação
• A description é o identificador humano do registro
• Não é permitido remover grupos que possuam vínculos ativos

Essas regras são aplicadas automaticamente pelo motor do sistema.

---

Interface & Comportamento (UI)

Como o sistema interpreta este schema para o usuário final.

Inteligência de Busca

O sistema indexa campos estratégicos para otimizar a navegação:

• Campos indexados: description, code
• Descriptor: sempre será a Descrição

Sempre que este grupo for referenciado em qualquer parte do sistema, o valor exibido será a description.

---

Regras do Formulário

Fluxo de Preenchimento

O formulário respeita a ordem lógica, validações e restrições de cada campo.

1. Código do Grupo (code)

• Auto-gerado pelo sistema
• Único (não permite duplicidade)
• Não editável após o primeiro salvamento

2. Descrição (description)

• Tipo: Texto
• Limite: 100 caracteres
• Obrigatório

3. Empresa (companySiteId)

• Relacionamento com CompanySite
• Somente leitura
• Preenchido automaticamente pelo contexto

---

Conectividade e Regras Especiais

Definições de valores automáticos e integridade relacional:

Campo	Relation Schema	Valor Default	Valor Fixo
companySiteId	CompanySite	Contexto atual	-
code	-	-	Auto-gerado

O relationSchema garante integridade referencial e impede inconsistências entre empresas e grupos de atributos.

---

Segurança e Integridade

Multitenancy (Múltiplas Empresas)

Com multi_company: true, o sistema aplica automaticamente:

• Isolamento total por empresa
• Filtro invisível em todas as queries
• Impossibilidade de acesso cruzado, inclusive via API

---

Proteção de Integridade

• Exclusão bloqueada por relacionamento
• Regra: preventDeleteDueToRelations

Um AttributeGroup não pode ser removido caso esteja vinculado a qualquer entidade do sistema.

---

Exemplo de Registro

{
  "code": 12,
  "description": "Dimensões Técnicas",
  "companySiteId": "64fa9c2e8b1c2a001f3e9a77"
}