Permissões de Unidade de Produção (DwProductionUnitPermission)

O módulo Permissões de Unidade de Produção define quais grupos de usuários têm acesso a quais Unidades de Produção, funcionando como uma camada de governança operacional sobre o chão de fábrica.

Ele permite restringir visualização, apontamento e operação conforme perfil, setor ou responsabilidade.

---

Identidade do Modelo

Recurso	Identificador	Finalidade
Módulo	Unidade de Produção	Domínio operacional
Grupo	Unidade de Produção	Controle de acesso
Principal	Não	Entidade auxiliar

---

Papel Arquitetural

Este módulo atua como:

• Filtro de acesso às Unidades de Produção
• Controle de escopo operacional por grupo
• Base para segurança em dashboards, formulários e apontamentos
• Isolamento lógico sem duplicar dados

Ele não cria unidades, define quem pode vê-las ou operá-las.

---

Interface & Comportamento (UI)

Busca e Identificação

• Campo de busca: description
• Descriptor: description

Usado para identificar rapidamente o propósito da permissão.

---

Estrutura de Campos

Descrição (description)

• Tipo: string
• Descrição funcional da permissão
• Exemplo:
  • Operadores Linha 01
  • Supervisores Produção
  • Equipe Manutenção

---

Grupos (groups)

• Tipo: group
• Representa grupos de usuários
• Campo responsável por quem recebe a permissão
• Normalmente vinculado a perfis de acesso ou cargos

---

Unidades de Produção (unitProduction)

• Tipo: array de string
• Relacionamento com DwProductionUnit
• Permite associar uma ou várias unidades
• Propriedades importantes:
  • ignoreCompanySite: true
  • Permite vincular unidades mesmo em cenários transversais

Define onde o grupo pode atuar.

---

Sincronização (sync)

• Tipo: boolean
• Valor inicial fixo: false
• Uso técnico para integrações

---

Regras do Formulário

Ordem lógica de preenchimento:

1. Descrição da permissão
2. Grupo(s) de usuário
3. Unidade(s) de Produção permitida(s)

Campos técnicos não são exibidos ao usuário final.

---

Comportamento Funcional

Uma permissão funciona da seguinte forma:

• Um grupo recebe acesso a
• Uma ou mais Unidades de Produção
• O sistema filtra automaticamente:
  • Listagens
  • Dashboards
  • Seletores
  • Apontamentos
  • Relatórios

---

Exemplo de Uso Prático

Cenário 1 — Operadores de Linha

• Grupo: Operadores
• Unidades:
  • Linha 01
  • Linha 02

➡ Eles não enxergam outras linhas ou células.

---

Cenário 2 — Supervisores

• Grupo: Supervisão
• Unidades:
  • Todas as linhas

➡ Visão completa, mas sem acesso administrativo.

---

Exemplo de Registro

{
  "description": "Operadores Linha 01",
  "groups": ["operadores"],
  "unitProduction": [
    "64fa9c2e8b1c2a001f3e9a01"
  ],
  "sync": false
}