Skip to main content

Unidade de Produção (DwProductionUnit)

O módulo Unidade de Produção representa os ativos produtivos reais da planta industrial, como linhas, máquinas, células ou setores.
Ele é o núcleo operacional onde eventos produtivos, perdas, paradas e indicadores são consolidados.

Identidade do Modelo​

RecursoIdentificadorFinalidade
MóduloUnidade de ProduçãoDomínio operacional
GrupoUnidadeDeProducaoIdentificador técnico
PrincipalSimEntidade central

Papel Arquitetural​

A Unidade de Produção é responsável por:

  • Centralizar apontamentos produtivos
  • Ser base de cálculo de OEE
  • Estruturar hierarquias produtivas
  • Conectar produtos, perdas, paradas e indicadores
  • Representar fisicamente o chão de fábrica

Tudo que acontece na produção acontece dentro de uma Unidade de Produção.

Interface & Comportamento (UI)​

Busca e Identificação​

  • Campos de busca: name, code
  • Descriptor: name

Utilizada amplamente em seletores, dashboards e relatórios.

Estrutura Hierárquica​

Este modelo suporta hierarquia recursiva, permitindo estruturas como:

  • Fábrica
    └ Linha
      └ Célula
       └ Máquina

Isso é feito via o campo production_unit_id_parent.

Estrutura de Campos​

Código (code)​

  • Tipo: string
  • Auto incremental
  • Único por empresa
  • Não editável
  • Identificador técnico e operacional

Nome (name)​

  • Tipo: string
  • Campo obrigatório
  • Nome visível da unidade
  • Exemplo: Linha 01, Prensa A

Abreviação (abbreviation)​

  • Tipo: string
  • Nome curto para dashboards e telas compactas
  • Exemplo: L01, PR-A

Unidade Pai (production_unit_id_parent)​

  • Relacionamento recursivo com DwProductionUnit
  • Define hierarquia estrutural
  • Opcional

Tipo de Unidade (production_unit_type)​

  • Relacionamento com DwProductionUnitType
  • Campo obrigatório
  • Define o papel estrutural da unidade

Status (status)​

  • Tipo: enum
  • Valores:
    • Ativo
    • Inativo
  • Controle operacional e de visibilidade

OEE (oee)​

  • Tipo: enum
  • Valores:
    • Sim
    • Não
  • Define se a unidade participa de cálculos de OEE
  • Valor padrão: Não

Fator de Prioridade (priorityFactor)​

  • Tipo: number
  • Define relevância da unidade em cálculos e ordenações
  • Útil para cenários com múltiplas unidades concorrentes

Sequência (sequence)​

  • Tipo: number
  • Controle de ordenação visual ou lógica
  • Muito usado em fluxos produtivos sequenciais

Empresa / Filial (companySiteId)​

  • Relacionamento com CompanySite
  • Campo obrigatório
  • Somente leitura
  • Preenchimento automático

Sincronização (sync)​

  • Tipo: boolean
  • Valor fixo inicial: false
  • Uso técnico para integração

Data de Sincronização (dataSync)​

  • Tipo: datetime-local
  • Rastreio de integração

Regras do Formulário​

Ordem lógica de preenchimento:

  1. Código (automático)
  2. Nome
  3. Abreviação
  4. Unidade Pai
  5. Tipo de Unidade
  6. Status
  7. OEE
  8. Fator de Prioridade
  9. Sequência
  10. Filial

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

Multitenancy e Governança​

Multitenancy​

Com multi_company: true:

  • Unidades isoladas por empresa
  • Suporte a múltiplas plantas
  • Escalabilidade organizacional

Proteção de Exclusão​

Exclusão bloqueada por relacionamento

Uma Unidade de Produção não pode ser excluída se estiver associada a:

  • Eventos de parada
  • Registros de perda
  • Apontamentos produtivos
  • Indicadores históricos
  • Outras unidades filhas

Isso preserva a integridade histórica e analítica.

Fluxos de Uso Comuns​

A Unidade de Produção é utilizada diretamente por:

  • Perdas (DwLossRecord)
  • Paradas
  • Eventos de Produção
  • Cálculo de OEE
  • Dashboards operacionais
  • Formulários dinâmicos
  • Relatórios históricos

Exemplo de Registro​

{
  "code": "001",
  "name": "Linha 01",
  "abbreviation": "L01",
  "production_unit_type": "Linha",
  "status": "Ativo",
  "oee": "Sim",
  "priorityFactor": 1,
  "sequence": 10,
  "companySiteId": "64fa9c2e8b1c2a001f3e9a77",
  "sync": false
}