Unidade de Medida (DwUnitMeasure)

A Unidade de Medida define como valores quantitativos são interpretados, exibidos e validados em todo o sistema.
Ela garante padronização semântica, consistência matemática e reutilização segura em atributos, formulários e regras de negócio.

Toda unidade de medida é compartilhável dentro da empresa e não pode ser removida enquanto estiver em uso.

---

Identidade do Modelo

Configurações estruturais que definem o comportamento do objeto.

Recurso	Identificador	Finalidade
Módulo	Formulários	Contexto funcional
Grupo	DwUnitMeasure	Identificação técnica do schema
Principal	Sim	Disponível como ponto de entrada no menu

---

Contrato do Modelo

Este schema opera sob as seguintes garantias:

• Toda unidade de medida pertence a uma empresa
• O campo code é único e imutável
• A description é o identificador humano
• Unidades de medida não podem ser excluídas se estiverem em uso
• O isolamento por empresa é aplicado automaticamente

---

Interface & Comportamento (UI)

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

Inteligência de Busca

Campos indexados para localização rápida:

• Campos indexados: code, description
• Descriptor: description

Sempre que uma unidade de medida for referenciada, o valor exibido será sua descrição.

---

Regras do Formulário

Fluxo de Preenchimento

A ordem, validações e bloqueios são controlados automaticamente pelo sistema.

Código (code)

• Texto (máx. 100 caracteres)
• Obrigatório
• Único
• Não editável após criação

Descrição (description)

• Texto (máx. 100 caracteres)
• Obrigatório

Filial / Empresa (companySiteId)

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

---

Conectividade e Regras Especiais

Campo	Relation Schema	Valor Default	Valor Fixo
companySiteId	CompanySite	Contexto atual	-
sync	-	-	false

A integridade relacional impede inconsistências entre empresas e unidades de medida.

---

Segurança e Integridade

Multitenancy (Múltiplas Empresas)

Com multi_company: true, o sistema aplica:

• Isolamento completo por empresa
• Filtro automático em todas as consultas
• Bloqueio de acesso entre empresas, inclusive via API

---

Proteção de Integridade

• Exclusão bloqueada por relacionamento
• Regra aplicada: preventDeleteDueToRelations

Uma unidade de medida não pode ser removida caso esteja vinculada a qualquer atributo ou entidade dependente.

---

Exemplo de Registro

{
  "code": "KG",
  "description": "Quilograma",
  "companySiteId": "64fa9c2e8b1c2a001f3e9a77"
}