Documentação em desenvolvimentoBeta Aberto clique aqui para participar
docs.cloudmes.ai
CloudMES Docs

Hierarquia

Cadastro da estrutura fabril Planta → Área → Linha, obrigatório quando Hierarquia produtiva está ativa em Preferências de produção.

Objetivo

Organizar o chão de fábrica para:

Pré-requisitos

  • Hierarquia produtiva = ativa em Preferências de produção (já ativada no ambiente de documentação).

Como usar

  1. Acesse Produção > Cadastros > Hierarquia (acessar diretamente).
  2. Use as abas (não há árvore única na tela):
    • PlantasNova planta
    • ÁreasNova área (planta pai no modal)
    • LinhasNova linha (área pai no modal)
  3. Preencha Código e Nome (obrigatórios) em cada modal.
  4. Em Máquinas, abra cada equipamento e selecione Linha produtiva (lista todas as linhas cadastradas).
  5. Nos relatórios, use o bloco Hierarquia antes de buscar — ou combine com seleção de máquinas.

Hierarquia — aba Plantas

Modais de cadastro

Planta

Modal nova planta

CampoObrigatórioDescrição
CódigoSim *Identificador único da planta.
NomeSim *Nome de exibição.

Área

Na aba Áreas, Nova área só fica habilitada se existir ao menos uma planta. No modal, escolha a Planta e informe código/nome.

Modal nova área

Linha

Na aba Linhas, Nova linha exige Área cadastrada. A linha é o nível usado no vínculo com máquinas.

Modal nova linha

Impacto com hierarquia ativa

TelaO que aparece
MáquinasCampo e coluna Linha produtiva
Tempos máquina / IndicadoresFiltros Planta, Área, Linha (persistidos com outros filtros de produção)
Relatório de eventosMesmos filtros; máquinas da linha entram no escopo
Edição de eventosFiltro de hierarquia na consulta

Como filtrar relatórios

  • Só hierarquia: informe planta e/ou área e/ou linha — o sistema considera máquinas com id_production_line naquela linha.
  • Hierarquia + máquinas: interseção dos filtros.
  • Máquina sem linha: não aparece ao filtrar por linha — associe a linha em Máquinas.

Dados e integrações

  • GET/POST/PUT/DELETE/plants/, /production-areas/, /production-lines/
  • GET /production-preferences/use_machine_hierarchy
  • Máquinas: id_production_line em /machine-registry/

Perguntas frequentes

Cadastrei linha mas relatório vazio
Vincule a linha em cada Máquina e confirme eventos no período filtrado.

Preciso de área sem linha?
Áreas agrupam linhas; o vínculo operacional é sempre na linha.

Posso desativar hierarquia depois?
Sim nas preferências; cadastros permanecem, campos somem até reativar.

Hierarquia interfere no lote do reporte?
Não diretamente — lote usa ordem/operação/máquina do reporte (Preferências de produção).

Erros comuns

  • Nova área / Nova linha desabilitado: aba errada ou falta nível pai.
  • Linha não lista em Máquinas: salvar linha, recarregar cadastro; preferência deve estar ativa.

Relacionado