Manual do usuário
Central de ajuda/Manual do usuário/Layout e dados: desenhe uma vez, atualiza para sempre

Layout e dados: desenhe uma vez, atualiza para sempre

Última atualização 2026-10-16

O editor grava as coordenadas 3D em wms_location_3d; a página 3D as junta com o estoque ao vivo para calcular a ocupação. Mude o layout e publique de novo: o histórico não é afetado.

Muita gente se preocupa: "se eu redesenhar o layout, preciso redigitar o estoque?" Não. O layout 3D e os dados de negócio vivem em duas tabelas separadas, ligadas só pelo código do endereço (location_id). Desenhe uma vez; a imagem fica atualizada para sempre.

O que o editor realmente grava#

  • A tabela de coordenadas 3D (wms_location_3d): uma linha por endereço — posição (x/y/z em metros), tamanho, rotação, grupo, andar — carimbada com a versão do layout.
  • Nunca toca o estoque: quantidades, clientes, lotes e validades vivem nas tabelas de estoque. A página 3D junta as duas por location_id ao renderizar.
  • A ocupação é calculada ao vivo a partir dos saldos de estoque (endereços com estoque ÷ endereços totais): por isso as cores mudam sem redesenhar nada.

Garantia dupla de atualização#

  • Assinatura ao vivo: mude para o modo ao vivo e as cores atualizam em segundos após um recebimento, endereçamento, separação ou contagem.
  • Instantâneo de 5 minutos: o modo padrão lê um agregado pré-calculado a cada 5 minutos; carrega rápido, suficiente para o dia a dia.

Mudou o armazém? Publique de novo#

  1. Porta-paletes movidos, adicionados ou removidos: edite o rascunho no editor (arraste, gire, exclua grupos) e publique.
  2. Publicar arquiva a versão anterior automaticamente; a página 3D muda na hora. Estoque, tarefas e histórico não são tocados: referenciam endereços por código, não por coordenadas.
  3. Errou? Reverta para qualquer versão arquivada na aba Versões.
Limitação conhecida: regenerar sobrescreve as coordenadas anteriores. Reverter para uma versão sobrescrita pode mostrar uma cena 3D vazia: comportamento esperado. Visualize a nova versão antes de aposentar a anterior.