Skip to main content

Perdas (DwLossRecord)

O módulo Perdas representa o cadastro estruturado de perdas produtivas, utilizado para classificar, analisar e mensurar impactos no processo de produção.

Ele atua como uma camada semântica entre os eventos operacionais e os indicadores, sendo fundamental para análises de eficiência e cálculo de OEE.

Identidade do Modelo​

RecursoIdentificadorFinalidade
MóduloParadas/PerdasDomínio de perdas produtivas
GrupoDwLossRecordIdentificador técnico do schema
PrincipalSimCadastro base do domínio

Papel Arquitetural​

Este módulo atua como:

  • Catálogo de tipos de perdas produtivas
  • Base para classificação de impactos operacionais
  • Apoio ao cálculo de indicadores (OEE)
  • Referência para apontamentos e eventos produtivos

Diferente de um evento, a perda aqui é conceitual, reutilizável e padronizada.

Interface & Comportamento (UI)​

Busca e Identificação​

  • Campos indexados: code, description
  • Descriptor: description

A descrição identifica a perda em seletores, relatórios e análises.

Estrutura de Campos​

Código (code)​

  • Tipo: string
  • Auto incremento por empresa
  • Único dentro da empresa
  • Não editável após criação

Nome (name)​

  • Tipo: string
  • Campo obrigatório
  • Nome curto e objetivo da perda

Descrição (description)​

  • Tipo: string
  • Detalhamento funcional da perda
  • Uso informativo e analítico

Afeta OEE (oee)​

  • Tipo: enum
  • Valores possíveis:
    • SIM
    • NAO
  • Campo obrigatório
  • Define se a perda impacta os indicadores de OEE

Categoria (categoryId)​

  • Relacionamento com DwCategory
  • Campo obrigatório
  • Define se a perda pertence a:
    • Perda
    • Parada (semântica herdada da categoria)

Unidade de Produção (productionUnitId)​

  • Relacionamento com DwProductionUnit
  • Campo obrigatório
  • Restringe o uso da perda ao contexto produtivo correto

Empresa / Filial (companySiteId)​

  • Relacionamento com CompanySite
  • Obrigatório
  • Somente leitura
  • Preenchimento automático conforme contexto

Sincronização (sync)​

  • Tipo: boolean
  • Valor inicial fixo: false
  • Controle técnico de integração

Data de Sincronização (dataSync)​

  • Tipo: datetime-local
  • Uso técnico para rastreamento de estado

Regras do Formulário​

Ordem de preenchimento:

  1. Código (gerado automaticamente)
  2. Nome
  3. Descrição
  4. Afeta OEE?
  5. Categoria
  6. Unidade de Produção
  7. Filial

Campos técnicos (sync, dataSync) não são exibidos na UI padrão.

Multitenancy e Segurança​

Com multi_company: true, o sistema garante:

  • Isolamento completo entre empresas
  • Perdas específicas por contexto produtivo
  • Segurança para ambientes multi-filiais

Integração com OEE​

O campo oee determina:

  • Inclusão ou exclusão no cálculo de OEE
  • Impacto direto em:
    • Disponibilidade
    • Performance
    • Qualidade (dependendo do uso)

A perda só afeta OEE se categoria + flag OEE permitirem.

Fluxos de Uso Comuns​

Este módulo é utilizado em conjunto com:

  • Eventos de Parada
  • Eventos de Perda
  • Categorias (DwCategory)
  • Unidades de Produção
  • Cálculo de OEE
  • Dashboards operacionais

Exemplo de Registro​

{
  "code": "015",
  "name": "Refugo de Matéria-Prima",
  "description": "Perda gerada por defeito no insumo",
  "oee": "SIM",
  "categoryId": "64fa9c2e8b1c2a001f3e9a88",
  "productionUnitId": "64fa9c2e8b1c2a001f3e9b21",
  "companySiteId": "64fa9c2e8b1c2a001f3e9a77",
  "sync": false
}