Skip to main content

Produto (Item)

O módulo Produto representa o cadastro central de itens/produtos do sistema.
Ele define o que é produzido, movimentado, analisado e integrado, servindo como base para processos produtivos, relatórios e integrações externas.

Identidade do Modelo​

RecursoIdentificadorFinalidade
MóduloProdutoDomínio de itens e materiais
GrupoItemIdentificador técnico do schema
PrincipalSimCadastro base do domínio

Papel Arquitetural​

Este módulo atua como:

  • Cadastro mestre de produtos
  • Referência para produção, estoque e apontamentos
  • Base para relatórios e indicadores
  • Ponto de integração com outros sistemas

Todo processo produtivo parte de um Item válido.

Interface & Comportamento (UI)​

Busca e Identificação​

  • Campos indexados: code, description
  • Descriptor: description

A descrição identifica o produto em listas, seletores e relatórios.

Estrutura de Campos​

Código (code)​

  • Tipo: string
  • Identificador funcional do produto
  • Pode refletir código interno, SKU ou código de integração

Descrição (description)​

  • Tipo: string
  • Nome ou descrição do produto
  • Campo principal de identificação semântica

Tipo do Produto (typeItem)​

  • Relacionamento com TypeItem
  • Classificação obrigatória do produto
  • Define comportamento do item em processos produtivos e relatórios

Sincronização (sync)​

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

Regras do Formulário​

Ordem de preenchimento:

  1. Código
  2. Descrição
  3. Tipo do Produto

O campo sync não é exibido na interface de cadastro.

Integridade e Segurança​

Proteção de Exclusão​

Exclusão Bloqueada por Relacionamentos

Um produto não pode ser removido caso esteja vinculado a:

  • Ordens de produção
  • Apontamentos produtivos
  • Registros históricos
  • Movimentações ou relatórios

Isso garante rastreabilidade e consistência dos dados.

Fluxos de Uso Comuns​

Este módulo é utilizado em conjunto com:

  • TypeItem → Classificação
  • Unidades de Produção
  • Formulários Dinâmicos
  • Eventos de Parada e Perda
  • Indicadores produtivos

Exemplo de Registro​

{
  "code": "PA-0001",
  "description": "Produto Acabado Exemplo",
  "typeItem": "64fa9c2e8b1c2a001f3e9c10",
  "sync": false
}