Modelos e contratos de dados

Os campos abaixo derivam dos DTOs, entidades serializadas, getters Jackson e contratos dinâmicos do MES. Colunas internas do banco não são automaticamente campos de entrada. obrigatório representa as anotações do DTO; só é aplicado automaticamente quando o argumento recebe @Valid. Regras condicionais estão nos serviços. Campos não obrigatórios não significam que null e omissão tenham o mesmo efeito. Exemplos nos endpoints usam dados fictícios e exigem referências reais do ambiente. Paginação Spring Data usa content, number, size, totalElements, totalPages, first, last, empty, numberOfElements e metadados pageable/sort. O MES usa content, page, size, totalElements, totalPages. Relatórios WMS usam pagination e items; não trocar os formatos.

AdicionarItemEncertoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AdicionarItemEncertoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
produtoId	integer	Sim
quantidade	integer	Não
observacao	string	Não

AlertaEstoqueFiltroDTO

Fonte: src/main/java/com/wester/storage/dto/AlertaEstoqueFiltroDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
tipoAlerta	string	Não	Filtros para consulta de alertas de estoque
produtoId	integer	Não	Identificador do produto
textoLivre	string	Não	Busca livre por nome, codigo ou descricao do produto
codigoWester	string	Não	Codigo Wester exato
areaId	integer	Não	Identificador da area/setor
criticidade	string	Não	Criticidade do alerta
produtoAtivo	boolean	Não	Status do produto
diasSemMovimentacao	integer	Não	Quantidade minima de dias sem movimentacao para gerar alerta
ordenarPor	string	Não	Campo de ordenacao
direcaoOrdenacao	string	Não	Direcao da ordenacao
pagina	integer	Não	Pagina da consulta
tamanhoPagina	integer	Não	Tamanho da pagina

AlertaEstoqueItemDTO

Fonte: src/main/java/com/wester/storage/dto/AlertaEstoqueItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
tipoAlerta	string	Não
criticidade	string	Não
mensagem	string	Não
produtoId	integer	Não
produtoNomeModelo	string	Não
produtoCodigoSistemaWester	string	Não
produtoCor	string	Não
produtoAtivo	boolean	Não
quantidadeTotal	integer	Não
estoqueMinimo	integer	Não
estoqueMaximo	integer	Não
areaId	integer	Não
areaNome	string	Não
itemEstoqueId	integer	Não
nivelId	integer	Não
localizacaoResumo	string	Não
ultimaMovimentacaoEm	string	Não	Data/hora local sem offset; não assumir UTC.
diasSemMovimentacao	integer	Não

AlertaEstoqueResponseDTO

Fonte: src/main/java/com/wester/storage/dto/AlertaEstoqueResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
itens	array de AlertaEstoqueItemDTO	Não
pagina	integer	Não
tamanhoPagina	integer	Não
totalItens	integer	Não
totalPaginas	integer	Não
resumo	AlertaEstoqueResumoDTO	Não

AlertaEstoqueResumoDTO

Fonte: src/main/java/com/wester/storage/dto/AlertaEstoqueResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
totalAlertas	integer	Não
produtosSemEstoque	integer	Não
produtosAbaixoMinimo	integer	Não
produtosAcimaMaximo	integer	Não
produtosSemMovimentacao	integer	Não
criticidadeAlta	integer	Não
criticidadeMedia	integer	Não
criticidadeBaixa	integer	Não

AlocarMateriaisRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AlocarMateriaisRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
materiais	array de AlocarMaterialRequestDTO	Sim

AlocarMaterialRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AlocarMaterialRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
materialId	integer	Sim
materialType	string	Sim
ordem	integer	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não

AlocarMoldeRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AlocarMoldeRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
moldeId	integer	Sim	DTO para alocar um molde em um slot de nível
ordem	integer	Não	Ordem do molde dentro do slot

ApiErrorDTO

Fonte: src/main/java/com/wester/storage/dto/ApiErrorDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
message	string	Não

AreaLabelsUpdateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AreaLabelsUpdateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
labelEstruturaPrimaria	string	Não	Payload para atualizar labels visuais do setor Aliases de entrada: {"labelFileira", "label_fileira", "nomenclaturaFileira"}
labelEstruturaSecundaria	string	Não	Aliases de entrada: {"labelGrade", "label_grade", "nomenclaturaGrade"}
labelNivel	string	Não	Aliases de entrada: {"nomenclaturaNivel"}
labelSlot	string	Não	Aliases de entrada: {"labelPosicao", "label_posicao", "nomenclaturaPosicao"}

AreaMaterialTagsRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AreaMaterialTagsRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
materialTypes	array de string	Sim

AtualizarObservacaoEncertoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AtualizarObservacaoEncertoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
observacao	string	Não

AtualizarQuantidadeEncertoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AtualizarQuantidadeEncertoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
quantidade	integer	Sim

AtualizarQuantidadeNivelMaterialRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AtualizarQuantidadeNivelMaterialRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
quantidade	integer	Sim
quantidadeAproximada	boolean	Não

AtualizarTabelaEncertoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/AtualizarTabelaEncertoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
titulo	string	Não
colunas	array de string	Não

CategoriaProdutoDTO

Fonte: src/main/java/com/wester/storage/dto/CategoriaProdutoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
codigo	string	Não
descricao	string	Não
totalProdutos	integer	Não	Quantidade de produtos vinculados a esta categoria

CategoriaProdutoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/CategoriaProdutoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
codigo	string	Sim	Dados para criar/atualizar categoria de produto Não pode ser vazio ou conter apenas espaços.
descricao	string	Sim	Não pode ser vazio ou conter apenas espaços.

CategoriaProdutoVinculoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/CategoriaProdutoVinculoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
produtoIds	array de integer	Sim	Produtos a vincular/desvincular de uma categoria

CriarFileiraRequestDTO

Fonte: src/main/java/com/wester/storage/dto/CriarFileiraRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
identificador	string	Não	Payload para cria\u00e7\u00e3o de fileira
ordem	integer	Não	Opcional. O backend recalcula a ordem final com base na \u00e1rea de estoque.

CriarTabelaEncertoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/CriarTabelaEncertoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
areaId	integer	Sim
titulo	string	Sim	Não pode ser vazio ou conter apenas espaços.
colunas	array de string	Não

ErrorResponseDTO

Fonte: src/main/java/com/wester/storage/dto/ErrorResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
timestamp	string	Não	Data/hora local sem offset; não assumir UTC.
status	integer	Não
error	string	Não
message	string	Não
path	string	Não

NivelFixoResponseDTO

Fonte: src/main/java/com/wester/storage/dto/EstanteFixaResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
nivelId	integer	Não
nivelIdentificador	string	Não
nivelOrdem	integer	Não
slots	array de SlotNivelResponseDTO	Não
materiais	array de NivelMaterialResponseDTO	Não

GradeFixaResponseDTO

Fonte: src/main/java/com/wester/storage/dto/EstanteFixaResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
gradeId	integer	Não
gradeIdentificador	string	Não
gradeOrdem	integer	Não
niveis	array de NivelFixoResponseDTO	Não

EstanteFixaResponseDTO

Fonte: src/main/java/com/wester/storage/dto/EstanteFixaResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
fileiraId	integer	Não
fileiraIdentificador	string	Não
fileiraOrdem	integer	Não
grades	array de GradeFixaResponseDTO	Não

EstoqueConsolidadoRowDTO

Fonte: src/main/java/com/wester/storage/dto/EstoqueConsolidadoRowDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
registroId	integer	Não
tipoEstrutura	string	Não
areaId	integer	Não
areaNome	string	Não
labelEstruturaPrimaria	string	Não
labelEstruturaSecundaria	string	Não
labelNivel	string	Não
labelSlot	string	Não
fileiraId	integer	Não
fileiraIdentificador	string	Não
gradeId	integer	Não
gradeIdentificador	string	Não
nivelId	integer	Não
nivelIdentificador	string	Não
nivelOrdem	integer	Não
slotId	integer	Não
slotIdentificador	string	Não
tipoMaterial	string	Não
itemId	integer	Não
codigo	string	Não
nome	string	Não
descricao	string	Não
cor	string	Não
ativo	boolean	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não
estoqueMinimo	integer	Não
estoqueMaximo	integer	Não
observacao	string	Não

EstoqueItemConsolidadoDTO

Fonte: src/main/java/com/wester/storage/dto/EstoqueItemConsolidadoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
registroId	integer	Não	Record id — itemEstoqueId (DINAMICO) or nivelMaterialId (FIXO)
tipoEstrutura	string	Não	Sector structure type
areaId	integer	Não	Area identifier
areaNome	string	Não	Area name
labelEstruturaPrimaria	string	Não	Label for primary structure (fileira)
labelEstruturaSecundaria	string	Não	Label for secondary structure (grade)
labelNivel	string	Não	Label for nivel
labelSlot	string	Não	Label for slot — null for DINAMICO
localizacaoFormatada	string	Não	Pre-formatted location string built from area labels
fileiraId	integer	Não	Fileira identifier
fileiraIdentificador	string	Não	Fileira code
gradeId	integer	Não	Grade identifier
gradeIdentificador	string	Não	Grade code
nivelId	integer	Não	Nivel identifier
nivelIdentificador	string	Não	Nivel code
nivelOrdem	integer	Não	Nivel order
slotId	integer	Não	Slot identifier — null for DINAMICO
slotIdentificador	string	Não	Slot code — null for DINAMICO
tipoMaterial	string	Não	Material type: PRODUTO or MOLDE — always PRODUTO for DINAMICO
itemId	integer	Não	Item id — produtoId (DINAMICO) or moldeId/produtoId (FIXO)
codigo	string	Não	Item code — codigoSistemaWester (DINAMICO) or codigo/codigoSistemaWester (FIXO)
nome	string	Não	Item name — nomeModelo (DINAMICO); FIXO uses descricao for moldes, nomeModelo for produtos
descricao	string	Não	Item description
cor	string	Não	Color (DINAMICO or FIXO produto) or category (FIXO molde)
ativo	boolean	Não	Whether the item is active
quantidade	integer	Não	Quantity in stock — always 1 for FIXO moldes
quantidadeAproximada	boolean	Não	Whether the quantity is approximate — always false for FIXO moldes
estoqueMinimo	integer	Não	Minimum stock threshold — null for FIXO moldes
estoqueMaximo	integer	Não	Maximum stock threshold — null for FIXO moldes
observacao	string	Não	Additional observation

EstoqueItemConsolidadoPageResponseDTO

Fonte: src/main/java/com/wester/storage/dto/EstoqueItemConsolidadoPageResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
content	array de EstoqueItemConsolidadoDTO	Não	Current page content
page	integer	Não	Current page index
size	integer	Não	Page size
totalElements	integer	Não	Total amount of matching rows
totalPages	integer	Não	Total amount of pages

EstoqueItemDashboardDTO

Fonte: src/main/java/com/wester/storage/dto/EstoqueItemDashboardDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
itemEstoqueId	integer	Não	Stock item identifier
areaId	integer	Não	Area identifier
areaNome	string	Não	Area name
fileiraId	integer	Não	Fileira identifier
fileiraIdentificador	string	Não	Fileira code
gradeId	integer	Não	Grade identifier
gradeIdentificador	string	Não	Grade code
nivelId	integer	Não	Nivel identifier
nivelIdentificador	string	Não	Nivel code
nivelOrdem	integer	Não	Nivel order
produtoId	integer	Não	Produto identifier
codigoSistemaWester	string	Não	Wester system product code
nomeModelo	string	Não	Product model name
descricao	string	Não	Product description
observacao	string	Não	Item-specific note for this stock position
cor	string	Não	Product color
produtoAtivo	boolean	Não	Indicates whether the product is active
estoqueMinimo	integer	Não	Minimum stock threshold configured for the product
estoqueMaximo	integer	Não	Maximum stock threshold configured for the product
quantidadeAproximada	boolean	Não	Indicates whether the stored quantity is approximate
quantidade	integer	Não	Stored quantity

EstoqueItemDashboardPageResponseDTO

Fonte: src/main/java/com/wester/storage/dto/EstoqueItemDashboardPageResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
content	array de EstoqueItemDashboardDTO	Não	Current page content
page	integer	Não	Current page index
size	integer	Não	Page size
totalElements	integer	Não	Total amount of matching rows
totalPages	integer	Não	Total amount of pages

EstoquePosicaoDTO

Fonte: src/main/java/com/wester/storage/dto/EstoquePosicaoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
fileiraId	integer	Não	ID da fileira
fileiraIdentificador	string	Não	Identificador da fileira
fileiraOrdem	integer	Não	Ordem numerica da fileira
gradeId	integer	Não	ID da grade
gradeIdentificador	string	Não	Identificador da grade
gradeOrdem	integer	Não	Ordem numerica da grade
nivelId	integer	Não	ID do nivel
nivelVersion	integer	Não	Versao atual do nivel
nivelIdentificador	string	Não	Identificador do nivel
nivelOrdem	integer	Não	Ordem numerica do nivel
itemEstoqueId	integer	Não	ID do item em estoque (pode ser nulo quando vazio)
itemEstoqueVersion	integer	Não	Versao atual do item em estoque
quantidade	integer	Não	Quantidade armazenada no nivel
quantidadeAproximada	boolean	Não	Indica se a quantidade armazenada e aproximada
observacao	string	Não	Observacao especifica do item nesta posicao do estoque
produtoId	integer	Não	ID do produto associado
codigoSistemaWester	string	Não	Codigo do produto no sistema Wester
nomeModelo	string	Não	Nome ou modelo do produto
cor	string	Não	Cor do produto
descricao	string	Não	Descrição do produto

FileiraResponseDTO

Fonte: src/main/java/com/wester/storage/dto/FileiraResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resposta da criação/consulta de fileira
identificador	string	Não	Identificador da fileira
ordem	integer	Não	Ordem da fileira
areaEstoqueId	integer	Não	ID da área de estoque

GradeCreateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/GradeCreateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
identificador	string	Não	Payload para criar uma grade vinculada a uma fileira
ordem	integer	Não	Opcional. O backend recalcula a ordem final com base na fileira.

GradeResequenceResultDTO

Fonte: src/main/java/com/wester/storage/dto/GradeResequenceResultDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
gradeId	integer	Não	Resultado do processo de remoção e resequenciamento de níveis de uma grade
niveis	array de NivelDTO	Não	Lista de níveis após o resequenciamento

GradeResponseDTO

Fonte: src/main/java/com/wester/storage/dto/GradeResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resposta de grade criada
identificador	string	Não
ordem	integer	Não
fileiraId	integer	Não

HistoricoMovimentacaoFilterRequestDTO

Fonte: src/main/java/com/wester/storage/dto/HistoricoMovimentacaoFilterRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
dataInicio	string	Não	Filtro para consulta avançada do histórico de movimentação
dataFim	string	Não	Data/hora final ISO-8601 (aceita yyyy-MM-dd ou yyyy-MM-ddTHH:mm:ss)
tipoOperacao	string	Não	Tipo de operação
usuarioId	integer	Não	ID do usuário
produtoId	integer	Não	ID do produto
moldeId	integer	Não	ID do molde
nivelId	integer	Não	ID de um nível (nível principal, origem ou destino)
textoLivre	string	Não	Texto livre para busca em detalhes e campos de produto
areaEstoqueIds	array de integer	Não	IDs das áreas de estoque para filtro (setores)

HistoricoMovimentacaoResponseDTO

Fonte: src/main/java/com/wester/storage/dto/HistoricoMovimentacaoResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
timestamp	string	Não	Data/hora local sem offset; não assumir UTC.
tipoOperacao	string	Não
usuarioId	integer	Não
usuarioLogin	string	Não
usuarioNome	string	Não
produtoId	integer	Não
produtoNomeModelo	string	Não
produtoDescricao	string	Não
produtoCor	string	Não
produtoCodigoSistemaWester	string	Não
itemEstoqueId	integer	Não
areaId	integer	Não
areaNome	string	Não
setorId	integer	Não
setorNome	string	Não
tipoEstruturaArea	string	Não
labelEstruturaPrimaria	string	Não
labelEstruturaSecundaria	string	Não
labelFileira	string	Não
labelGrade	string	Não
labelNivel	string	Não
labelSlot	string	Não
labelPosicao	string	Não
fileiraId	integer	Não
fileiraIdentificador	string	Não
gradeId	integer	Não
gradeIdentificador	string	Não
nivelId	integer	Não
nivelIdentificador	string	Não
nivelOrigemId	integer	Não
nivelOrigemIdentificador	string	Não
nivelDestinoId	integer	Não
nivelDestinoIdentificador	string	Não
slotId	integer	Não
slotIdentificador	string	Não
slotPosicao	integer	Não
posicao	string	Não
moldeId	integer	Não
moldeCodigo	string	Não
entidade	string	Não
entidadeId	integer	Não
campo	string	Não
valorAnterior	string	Não
valorNovo	string	Não
payloadJson	string	Não
quantidadeAlterada	integer	Não
quantidadeAnterior	integer	Não
quantidadeNova	integer	Não
detalhesAlteracao	string	Não

IdentifierUpdateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/IdentifierUpdateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
identificador	string	Sim	Payload para atualizar identificador estrutural Não pode ser vazio ou conter apenas espaços.
version	integer	Não	Versao esperada para entidades com concorrencia otimista

ItemEstoqueDTO

Fonte: src/main/java/com/wester/storage/dto/ItemEstoqueDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Stock item representation
version	integer	Não	Entity version for optimistic locking
nivelId	integer	Não	Nivel ID
nivelIdentificador	string	Não	Nivel identifier
nivelCompletoIdentificador	string	Não	Full identifier of nivel (if applicable)
produtoId	integer	Não	Product ID
produtoCodigoWester	string	Não	Product code
produtoNomeModelo	string	Não	Product model name
produtoCor	string	Não	Product color
produtoDescricao	string	Não	Product description
observacao	string	Não	Item-specific note for this warehouse position
quantidade	integer	Não	Quantity
quantidadeAproximada	boolean	Não	Indicates whether the quantity is approximate
dataAtualizacao	string	Não	Last update date/time

ItemEstoqueLookupDTO

Fonte: src/main/java/com/wester/storage/dto/ItemEstoqueLookupDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
itemEstoqueId	integer	Não
produtoId	integer	Não
codigo	string	Não
nome	string	Não
cor	string	Não
localizacao	string	Não
quantidade	integer	Não

ItemEstoqueMovimentacaoRequestDTO

Fonte: src/main/java/com/wester/storage/dto/ItemEstoqueMovimentacaoRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
nivelOrigemId	integer	Sim	Payload para movimentar item entre níveis
nivelOrigemVersion	integer	Não	Versao atual do nivel de origem
nivelDestinoId	integer	Sim	ID do nível de destino
nivelDestinoVersion	integer	Não	Versao atual do nivel de destino
itemOrigemVersion	integer	Não	Versao atual do item de origem
itemDestinoVersion	integer	Não	Versao atual do item de destino
quantidade	integer	Sim	Quantidade a movimentar

ItemEstoqueResponseDTO

Fonte: src/main/java/com/wester/storage/dto/ItemEstoqueResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resposta do item de estoque por nivel
nivelId	integer	Não	ID do nivel
quantidade	integer	Não	Quantidade (0 quando não existir)
quantidadeAproximada	boolean	Não	Indica se a quantidade informada e aproximada
produto	ProdutoResumoDTO	Não	Produto (null quando não existir)

ItemEstoqueUpsertRequestDTO

Fonte: src/main/java/com/wester/storage/dto/ItemEstoqueUpsertRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
itemEstoqueVersion	integer	Não	Payload para criar/atualizar item de estoque em um nível
nivelVersion	integer	Não	Versao atual do nivel para controle de concorrencia otimista
quantidade	integer	Sim	Quantidade do item no nível
quantidadeAproximada	boolean	Não	Indica se a quantidade informada e aproximada
observacao	string	Não	Observação especifica do item nesta posição do estoque
produto	ProdutoDTO	Sim	Dados do produto

LoginDTO

Fonte: src/main/java/com/wester/storage/dto/LoginDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
login	string	Sim	Não pode ser vazio ou conter apenas espaços.
senha	string	Sim	Não pode ser vazio ou conter apenas espaços.

MoldeAlocadoResponseDTO

Fonte: src/main/java/com/wester/storage/dto/MoldeAlocadoResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
slotId	integer	Não
moldeId	integer	Não
moldeCodigo	string	Não
moldeDescricao	string	Não
moldeCategoria	string	Não
ordem	integer	Não

MoldeRequestDTO

Fonte: src/main/java/com/wester/storage/dto/MoldeRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
codigo	string	Sim	DTO para criação ou atualização de molde Não pode ser vazio ou conter apenas espaços.
descricao	string	Não	Descrição do molde
categoria	string	Não	Categoria do molde
observacoes	string	Não	Observações adicionais

MovimentacaoEstoqueAreaOpcaoDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueAreaOpcaoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resumo de área disponível para a tela de movimentações
nome	string	Não	Nome curto da area

MovimentacaoEstoqueContextoInicialDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueContextoInicialDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
produtos	array de MovimentacaoEstoqueProdutoOpcaoDTO	Não	Dados iniciais agregados para carregar a tela de movimentações
areas	array de MovimentacaoEstoqueAreaOpcaoDTO	Não	Areas ativas disponiveis para selecao
movimentacoesRecentes	array de MovimentacaoEstoqueRecenteDTO	Não	Ultimas movimentacoes operacionais exibidas no resumo da tela

MovimentacaoEstoqueProdutoOpcaoDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueProdutoOpcaoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resumo de produto ativo disponível para movimentações
codigoSistemaWester	string	Não	Codigo Wester do produto
nomeModelo	string	Não	Nome/modelo do produto

MovimentacaoEstoqueRecenteDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueRecenteDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
timestamp	string	Não	Data/hora local sem offset; não assumir UTC.
tipoMovimentacao	string	Não
produtoNomeModelo	string	Não
quantidadeMovimentada	integer	Não

MovimentacaoEstoqueRequestDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
tipoMovimentacao	string	Não	Payload para registrar uma movimentação operacional de estoque
produtoId	integer	Não	Produto informado manualmente quando aplicavel
nivelId	integer	Não	Nivel alvo para entrada, saida ou ajuste
nivelVersion	integer	Não	Versao atual do nivel alvo
nivelOrigemId	integer	Não	Nivel de origem da transferencia
nivelOrigemVersion	integer	Não	Versao atual do nivel de origem
nivelDestinoId	integer	Não	Nivel de destino da transferencia
nivelDestinoVersion	integer	Não	Versao atual do nivel de destino
itemEstoqueVersion	integer	Não	Versao atual do item do nivel alvo
itemOrigemVersion	integer	Não	Versao atual do item da origem
itemDestinoVersion	integer	Não	Versao atual do item do destino
quantidade	integer	Não	Quantidade movimentada para entrada, saida e transferencia
quantidadeAjustada	integer	Não	Quantidade final desejada no ajuste
quantidadeDiferenca	integer	Não	Diferenca aplicada no ajuste
motivo	string	Não	Motivo da operacao, obrigatorio no ajuste
observacao	string	Não	Observacao complementar

MovimentacaoEstoqueResponseDTO

Fonte: src/main/java/com/wester/storage/dto/MovimentacaoEstoqueResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
historicoMovimentacaoId	integer	Não
registradoEm	string	Não	Data/hora local sem offset; não assumir UTC.
tipoMovimentacao	string	Não
produtoId	integer	Não
produtoNomeModelo	string	Não
produtoCodigoSistemaWester	string	Não
itemEstoqueId	integer	Não
nivelId	integer	Não
nivelOrigemId	integer	Não
nivelDestinoId	integer	Não
nivelLabel	string	Não
nivelOrigemLabel	string	Não
nivelDestinoLabel	string	Não
quantidadeMovimentada	integer	Não
quantidadeAnterior	integer	Não
quantidadeNova	integer	Não
motivo	string	Não
observacao	string	Não
detalhesAlteracao	string	Não

NivelCreateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/NivelCreateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
identificador	string	Sim	DTO para criacao de um nivel dentro de uma grade Não pode ser vazio ou conter apenas espaços.
ordem	integer	Sim	Posição alvo do nível dentro da grade
item	ItemEstoqueUpsertRequestDTO	Não	Produto a vincular à nova gaiola. Quando informado (setor dinâmico), a gaiola e o item de estoque

NivelDTO

Fonte: src/main/java/com/wester/storage/dto/NivelDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
version	integer	Não
identificador	string	Não
ordem	integer	Não

NivelMaterialDashboardDTO

Fonte: src/main/java/com/wester/storage/dto/NivelMaterialDashboardDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
nivelMaterialId	integer	Não
materialId	integer	Não
materialType	string	Não
ordem	integer	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não
areaId	integer	Não
fileiraId	integer	Não
fileiraIdentificador	string	Não
gradeId	integer	Não
gradeIdentificador	string	Não
nivelId	integer	Não
nivelIdentificador	string	Não
nivelOrdem	integer	Não

NivelMaterialResponseDTO

Fonte: src/main/java/com/wester/storage/dto/NivelMaterialResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
nivelId	integer	Não
materialId	integer	Não
materialType	string	Não
materialCodigo	string	Não
materialDescricao	string	Não
materialCategoria	string	Não
produtoDescricao	string	Não
ordem	integer	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não

NivelMoveRequestDTO

Fonte: src/main/java/com/wester/storage/dto/NivelMoveRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
sourceGradeId	integer	Sim	DTO para mover um nivel entre grades e posicoes
targetGradeId	integer	Sim	Grade de destino
targetPosition	integer	Sim	Posição alvo dentro da grade de destino
nivelVersion	integer	Não	Versao esperada do nivel para controle otimista

NivelMoveResultDTO

Fonte: src/main/java/com/wester/storage/dto/NivelMoveResultDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
nivelId	integer	Não	Resultado da movimentação estrutural de um nível
sourceGradeId	integer	Não	ID da grade de origem
targetGradeId	integer	Não	ID da grade de destino
targetPosition	integer	Não	Posição final ocupada pelo nível no destino
impactedGrades	array de GradeResequenceResultDTO	Não	Grades impactadas pela movimentação

NivelResponseDTO

Fonte: src/main/java/com/wester/storage/dto/NivelResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	DTO de resposta após criação ou consulta de um nível
version	integer	Não	Versão da entidade para concorrência otimista
identificador	string	Não	Identificador do nível (ex: Ordem 01, Ordem 02)
ordem	integer	Não	Ordem do nível dentro da grade
gradeId	integer	Não	ID da grade à qual o nível pertence
itemEstoqueId	integer	Não	ID do item de estoque criado junto com o nível (somente quando a criação recebeu item). Permite ao cliente confirmar que o produto foi vinculado.

PerfilDisponivelDTO

Fonte: src/main/java/com/wester/storage/dto/PerfilDisponivelDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	DTO com os perfis disponíveis para vinculação em usuários
code	string	Não	Codigo persistido do perfil
description	string	Não	Descrição legível do perfil
type	string	Não	Tipo de acesso do perfil
active	boolean	Não	Indica se o perfil esta ativo

PerfilResponseDTO

Fonte: src/main/java/com/wester/storage/dto/PerfilResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	DTO completo de perfil para gerenciamento
code	string	Não	Codigo estavel do perfil
description	string	Não	Descricao de negocio do perfil
type	string	Não	Tipo de acesso do perfil
allowedScreens	array de string	Não	Telas permitidas para o perfil
active	boolean	Não	Indica se o perfil esta ativo
createdAt	string	Não	Data/hora de criacao
updatedAt	string	Não	Data/hora da ultima atualizacao

PerfilUpsertRequestDTO

Fonte: src/main/java/com/wester/storage/dto/PerfilUpsertRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
description	string	Sim	DTO de criacao/atualizacao de perfil Não pode ser vazio ou conter apenas espaços.
type	string	Sim	Tipo de acesso do perfil
allowedScreens	array de string	Sim	Lista de telas permitidas para o perfil
active	boolean	Não	Status ativo do perfil

ProdutoDTO

Fonte: src/main/java/com/wester/storage/dto/ProdutoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
codigoSistemaWester	string	Não	Dados do produto para criação/atualização no item de estoque
nomeModelo	string	Não	Nome/modelo do produto
cor	string	Não	Cor do produto
descricao	string	Não	Descrição do produto

ProdutoResumoDTO

Fonte: src/main/java/com/wester/storage/dto/ProdutoResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Resumo do produto associado ao item de estoque
codigoSistemaWester	string	Não	Código Wester (pode ser null)
nomeModelo	string	Não	Nome/Modelo
cor	string	Não	Cor
descricao	string	Não	Descrição

ProdutoUpsertRequestDTO

Fonte: src/main/java/com/wester/storage/dto/ProdutoUpsertRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
codigoSistemaWester	string	Não	Dados do produto para criação e atualização Aliases de entrada: "codigo"
nomeModelo	string	Não	Nome/modelo do produto. Obrigatório apenas se o código não for informado.
cor	string	Não	Cor do produto (opcional)
descricao	string	Não	Descrição do produto
ativo	boolean	Não	Status ativo do produto. Quando omitido na atualização, mantém o valor atual.
estoqueMinimo	integer	Não	Quantidade minima recomendada em estoque para o produto
estoqueMaximo	integer	Não	Quantidade maxima recomendada em estoque para o produto
categoriaId	integer	Não
removerCategoria	boolean	Não	Quando true, remove a categoria do produto na atualização

RelatorioEstoqueItemDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioEstoqueItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
areaId	integer	Não
areaNome	string	Não
areaDescricao	string	Não
ativo	boolean	Não
totalFileiras	integer	Não
totalGrades	integer	Não
totalNiveis	integer	Não
niveisOcupados	integer	Não
totalItensEstoque	integer	Não
quantidadeTotal	integer	Não
quantidadeTotalAproximada	boolean	Não
ocupacaoPercentual	number	Não	Percentual de ocupacao calculado sobre niveis ocupados

RelatorioEstoquesFiltroDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioEstoquesFiltroDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
area	string	Não	Filtros do relatorio de estoques
fileira	string	Não	Filtro por identificador da fileira
grade	string	Não	Filtro por identificador da grade
nivel	string	Não	Filtro por identificador do nivel
ativo	boolean	Não	Filtro por status ativo da area
sortBy	string	Não	Campo de ordenacao
sortDirection	string	Não	Direcao da ordenacao
page	integer	Não	Pagina desejada
size	integer	Não	Quantidade por pagina

RelatorioEstoquesResponseDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioEstoquesResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
generatedAt	string	Não	Data/hora local sem offset; não assumir UTC.
summary	RelatorioEstoquesResumoDTO	Não
pagination	RelatorioPaginacaoDTO	Não
items	array de RelatorioEstoqueItemDTO	Não
quantityByAreaChart	array de RelatorioGraficoDadoDTO	Não
occupancyByAreaChart	array de RelatorioGraficoDadoDTO	Não
quantityByFileiraChart	array de RelatorioGraficoDadoDTO	Não

RelatorioEstoquesResumoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioEstoquesResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
totalAreas	integer	Não
totalAreasAtivas	integer	Não
totalFileiras	integer	Não
totalGrades	integer	Não
totalNiveis	integer	Não
totalItensEstoque	integer	Não
quantidadeTotalArmazenada	integer	Não	Soma total das quantidades armazenadas
quantidadeTotalArmazenadaAproximada	boolean	Não	Indica se a quantidade total armazenada inclui valores aproximados

RelatorioGraficoDadoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioGraficoDadoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
label	string	Não	Ponto de dados de um grafico de relatorio
value	number	Não	Valor numerico do ponto
formattedValue	string	Não	Valor formatado para exibicao
aproximado	boolean	Não	Indica se o valor exibido representa uma quantidade aproximada
color	string	Não	Cor opcional do ponto

RelatorioHistoricoMovimentacaoFiltroDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioHistoricoMovimentacaoFiltroDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
produto	string	Não	Filtros do relatório de histórico de movimentação
codigoSistemaWester	string	Não	Filtro por codigo Wester
area	string	Não	Filtro por area ou setor
usuario	string	Não	Filtro por nome ou login do usuário
tipoOperacao	string	Não	Filtro por tipo de movimentação
dataInicio	string	Não	Data inicial recomendada (yyyy-MM-dd)
dataFim	string	Não	Data final recomendada (yyyy-MM-dd)
sortDirection	string	Não	Direcao da ordenacao pelo timestamp
page	integer	Não	Pagina desejada
size	integer	Não	Quantidade por pagina

RelatorioHistoricoMovimentacaoItemDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioHistoricoMovimentacaoItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
timestamp	string	Não	Data/hora local sem offset; não assumir UTC.
tipoOperacao	string	Não
usuarioNome	string	Não
usuarioLogin	string	Não
produtoNomeModelo	string	Não
codigoSistemaWester	string	Não
areaNome	string	Não
fileira	string	Não
grade	string	Não
nivel	string	Não
quantidadeAlterada	integer	Não
quantidadeAnterior	integer	Não
quantidadeNova	integer	Não
detalhesAlteracao	string	Não

RelatorioHistoricoMovimentacaoResponseDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioHistoricoMovimentacaoResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
generatedAt	string	Não	Data/hora local sem offset; não assumir UTC.
summary	RelatorioHistoricoMovimentacaoResumoDTO	Não
pagination	RelatorioPaginacaoDTO	Não
items	array de RelatorioHistoricoMovimentacaoItemDTO	Não
typeChart	array de RelatorioGraficoDadoDTO	Não
periodChart	array de RelatorioGraficoDadoDTO	Não
productChart	array de RelatorioGraficoDadoDTO	Não
areaChart	array de RelatorioGraficoDadoDTO	Não
userChart	array de RelatorioGraficoDadoDTO	Não

RelatorioHistoricoMovimentacaoResumoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioHistoricoMovimentacaoResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
totalMovimentacoes	integer	Não
totalEntradas	integer	Não
totalSaidas	integer	Não
totalAjustes	integer	Não
totalMovimentacoesInternas	integer	Não
totalResequenciamentos	integer	Não
quantidadeMovimentadaTotal	integer	Não	Soma absoluta das quantidades movimentadas

RelatorioItemEstoqueItemDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioItemEstoqueItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
itemEstoqueId	integer	Não
produtoId	integer	Não
produtoNomeModelo	string	Não
codigoSistemaWester	string	Não
areaNome	string	Não
tipoEstrutura	string	Não
localizacaoFormatada	string	Não
fileira	string	Não
grade	string	Não
nivel	string	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não
statusItem	string	Não
dataAtualizacao	string	Não	Data/hora local sem offset; não assumir UTC.

RelatorioItensEstoqueFiltroDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioItensEstoqueFiltroDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
produto	string	Não	Filtros do relatorio de itens de estoque
codigoSistemaWester	string	Não	Filtro por codigo Wester
area	string	Não	Filtro por nome da area
fileira	string	Não	Filtro por fileira
grade	string	Não	Filtro por grade
nivel	string	Não	Filtro por nivel
statusItem	string	Não	Filtro por status do item: DISPONIVEL, BAIXO ou SEM_ESTOQUE
dataInicio	string	Não	Data inicial de atualizacao (yyyy-MM-dd)
dataFim	string	Não	Data final de atualizacao (yyyy-MM-dd)
sortBy	string	Não	Campo de ordenacao
sortDirection	string	Não	Direcao da ordenacao
page	integer	Não	Pagina desejada
size	integer	Não	Quantidade por pagina

RelatorioItensEstoqueResponseDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioItensEstoqueResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
generatedAt	string	Não	Data/hora local sem offset; não assumir UTC.
summary	RelatorioItensEstoqueResumoDTO	Não
pagination	RelatorioPaginacaoDTO	Não
items	array de RelatorioItemEstoqueItemDTO	Não
topProductsChart	array de RelatorioGraficoDadoDTO	Não
quantityByAreaChart	array de RelatorioGraficoDadoDTO	Não
quantityByLocationChart	array de RelatorioGraficoDadoDTO	Não

RelatorioItensEstoqueResumoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioItensEstoqueResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
totalItensEstoque	integer	Não
quantidadeTotalArmazenada	integer	Não	Soma de todas as quantidades armazenadas
quantidadeTotalArmazenadaAproximada	boolean	Não	Indica se a quantidade total armazenada inclui valores aproximados
totalProdutosUnicos	integer	Não
totalAreasComItens	integer	Não

RelatorioPaginacaoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioPaginacaoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
page	integer	Não	Metadados de paginacao de um relatorio
size	integer	Não	Tamanho da pagina
totalItems	integer	Não	Total de registros filtrados
totalPages	integer	Não	Total de paginas

RelatorioProdutoItemDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioProdutoItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
codigoSistemaWester	string	Não
nomeModelo	string	Não
cor	string	Não
descricao	string	Não
ativo	boolean	Não
categoriaId	integer	Não	Id da categoria do produto (null quando sem categoria)
categoriaDescricao	string	Não	Descricao da categoria do produto
quantidadeTotalEmEstoque	integer	Não	Quantidade total deste produto atualmente em estoque
quantidadeTotalEmEstoqueAproximada	boolean	Não	Indica se a quantidade total consolidada deste produto e aproximada

RelatorioProdutosFiltroDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioProdutosFiltroDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
nome	string	Não	Filtros do relatorio de produtos
codigoSistemaWester	string	Não	Filtro por codigo Wester
descricao	string	Não	Filtro por descricao
cor	string	Não	Filtro por cor
ativo	boolean	Não	Filtro por status ativo/inativo
categoria	string	Não	Filtro por categoria: id da categoria ou SEM_CATEGORIA
sortBy	string	Não	Campo de ordenacao
sortDirection	string	Não	Direcao da ordenacao
page	integer	Não	Pagina desejada
size	integer	Não	Quantidade por pagina

RelatorioProdutosResponseDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioProdutosResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
generatedAt	string	Não	Data/hora local sem offset; não assumir UTC.
summary	RelatorioProdutosResumoDTO	Não
pagination	RelatorioPaginacaoDTO	Não
items	array de RelatorioProdutoItemDTO	Não
statusChart	array de RelatorioGraficoDadoDTO	Não
colorChart	array de RelatorioGraficoDadoDTO	Não
usageChart	array de RelatorioGraficoDadoDTO	Não
categoryTotals	array de RelatorioGraficoDadoDTO	Não	Quantidade total em estoque somada por categoria (todos os produtos filtrados)

RelatorioProdutosResumoDTO

Fonte: src/main/java/com/wester/storage/dto/RelatorioProdutosResumoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
totalProdutos	integer	Não
totalProdutosAtivos	integer	Não
totalProdutosInativos	integer	Não
quantidadeTotalEmEstoque	integer	Não	Soma das quantidades atualmente armazenadas para os produtos filtrados
quantidadeTotalEmEstoqueAproximada	boolean	Não	Indica se a quantidade total em estoque inclui valores aproximados

SlotNivelRequestDTO

Fonte: src/main/java/com/wester/storage/dto/SlotNivelRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
posicao	integer	Não	Payload para criar ou editar slot de nivel fixo
identificador	string	Não	Identificador visual do slot

SlotNivelResponseDTO

Fonte: src/main/java/com/wester/storage/dto/SlotNivelResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
nivelId	integer	Não
posicao	integer	Não
identificador	string	Não
moldesAlocados	array de MoldeAlocadoResponseDTO	Não

TabelaEncertoDTO

Fonte: src/main/java/com/wester/storage/dto/TabelaEncertoDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
areaId	integer	Não
titulo	string	Não
colunas	array de string	Não
itens	array de TabelaEncertoItemDTO	Não

TabelaEncertoItemDTO

Fonte: src/main/java/com/wester/storage/dto/TabelaEncertoItemDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
produtoId	integer	Não
codigo	string	Não
nome	string	Não
cor	string	Não
descricao	string	Não
observacao	string	Não
quantidade	integer	Não
ordem	integer	Não

TabelaEncertoSummaryDTO

Fonte: src/main/java/com/wester/storage/dto/TabelaEncertoSummaryDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
titulo	string	Não
colunas	array de string	Não
totalItens	integer	Não

UsuarioChangePasswordRequestDTO

Fonte: src/main/java/com/wester/storage/dto/UsuarioChangePasswordRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
senhaAtual	string	Sim	DTO de request para alteração de senha do usuário Não pode ser vazio ou conter apenas espaços.
novaSenha	string	Sim	Nova senha do usuário Não pode ser vazio ou conter apenas espaços.
confirmarNovaSenha	string	Sim	Confirmação da nova senha Não pode ser vazio ou conter apenas espaços.

UsuarioRequestDTO

Fonte: src/main/java/com/wester/storage/dto/UsuarioRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
login	string	Sim	Não pode ser vazio ou conter apenas espaços.
nome	string	Sim	Não pode ser vazio ou conter apenas espaços.
senha	string	Não
perfil	string	Não

UsuarioResponseDTO

Fonte: src/main/java/com/wester/storage/dto/UsuarioResponseDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
login	string	Não
nome	string	Não
perfil	string	Não
ativo	boolean	Não
token	string	Não
perfilResumo	PerfilResponseDTO	Não

UsuarioStatusUpdateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/UsuarioStatusUpdateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
ativo	boolean	Sim	DTO de request para atualizacao de status (ativo/inativo) do usuario

UsuarioUpdateRequestDTO

Fonte: src/main/java/com/wester/storage/dto/UsuarioUpdateRequestDTO.java.

Campo	Contrato	Obrigatório no DTO	Observações
login	string	Sim	DTO de request para atualização de dados do usuário (sem alterar senha) Não pode ser vazio ou conter apenas espaços.
nome	string	Sim	Nome do usuário Não pode ser vazio ou conter apenas espaços.
perfil	string	Sim	Codigo do perfil do usuário Não pode ser vazio ou conter apenas espaços.

AreaEstoque

Fonte: src/main/java/com/wester/storage/model/AreaEstoque.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Area fisica/logica de estoque
descricao	string	Sim	Descricao da area Não pode ser vazio ou conter apenas espaços.
nome	string	Não	Nome curto da area
ativo	boolean	Não	Status ativo da area
tipoEstrutura	string	Não	Tipo de estrutura do setor: DINAMICO ou FIXO
labelEstruturaPrimaria	string	Não	Label da estrutura primaria do setor Aliases de entrada: {"labelFileira", "label_fileira", "nomenclaturaFileira"}
labelEstruturaSecundaria	string	Não	Label da estrutura secundaria do setor Aliases de entrada: {"labelGrade", "label_grade", "nomenclaturaGrade"}
labelNivel	string	Não	Label dos niveis do setor Aliases de entrada: {"nomenclaturaNivel"}
labelSlot	string	Não	Label dos slots do setor Aliases de entrada: {"labelPosicao", "label_posicao", "nomenclaturaPosicao"}
labelFileira	string	Não	Alias de saída calculado pelo getter.
labelGrade	string	Não	Alias de saída calculado pelo getter.
labelPosicao	string	Não	Alias de saída calculado pelo getter.

AreaMaterialTag

Fonte: src/main/java/com/wester/storage/model/AreaMaterialTag.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
areaEstoque	AreaEstoque	Não
materialType	string	Não

CategoriaProduto

Fonte: src/main/java/com/wester/storage/model/CategoriaProduto.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
codigo	string	Sim	Não pode ser vazio ou conter apenas espaços.
descricao	string	Sim	Não pode ser vazio ou conter apenas espaços.

Fileira

Fonte: src/main/java/com/wester/storage/model/Fileira.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Representa uma fileira do armazém vinculada a uma área de estoque
identificador	string	Sim	Identificador da fileira Não pode ser vazio ou conter apenas espaços.
ordem	integer	Sim	Ordem da fileira
areaEstoque	AreaEstoque	Não	Área de estoque vinculada
ativo	boolean	Não	Inativação lógica — não há reativação

Grade

Fonte: src/main/java/com/wester/storage/model/Grade.java.

Campo	Contrato	Obrigatório no DTO	Observações
fileira	Fileira	Sim
identificador	string	Sim	Não pode ser vazio ou conter apenas espaços.
ordem	integer	Não
ativo	boolean	Não

HistoricoMovimentacao

Fonte: src/main/java/com/wester/storage/model/HistoricoMovimentacao.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
timestamp	string	Não	Data/hora local sem offset; não assumir UTC.
usuario	Usuario	Sim
tipoOperacao	string	Sim	Não pode ser vazio ou conter apenas espaços.
itemEstoque	ItemEstoque	Não
produto	Produto	Não
nivel	Nivel	Não
nivelOrigem	Nivel	Não
nivelDestino	Nivel	Não
nivelIdentificador	string	Não
nivelOrigemIdentificador	string	Não
nivelDestinoIdentificador	string	Não
quantidadeAlterada	integer	Não
quantidadeAnterior	integer	Não
quantidadeNova	integer	Não
detalhesAlteracao	string	Não
areaEstoqueId	integer	Não
areaNome	string	Não
tipoEstruturaArea	string	Não
labelEstruturaPrimaria	string	Não
labelEstruturaSecundaria	string	Não
labelNivel	string	Não
labelSlot	string	Não
fileiraId	integer	Não
fileiraIdentificador	string	Não
gradeId	integer	Não
gradeIdentificador	string	Não
slotId	integer	Não
slotIdentificador	string	Não
slotPosicao	integer	Não
moldeId	integer	Não
moldeCodigo	string	Não
entidade	string	Não
entidadeId	integer	Não
campo	string	Não
valorAnterior	string	Não
valorNovo	string	Não
payloadJson	string	Não

ItemEstoque

Fonte: src/main/java/com/wester/storage/model/ItemEstoque.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
version	integer	Não	Versão para concorrência otimista; obtida na consulta.
nivel	Nivel	Sim
produto	Produto	Sim
quantidade	integer	Sim
quantidadeAproximada	boolean	Não
observacao	string	Não
dataAtualizacao	string	Não	Data/hora local sem offset; não assumir UTC.

Molde

Fonte: src/main/java/com/wester/storage/model/Molde.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não	Molde físico da ferramentaria
codigo	string	Sim	Código único do molde Não pode ser vazio ou conter apenas espaços.
descricao	string	Não	Descrição do molde
categoria	string	Não	Categoria do molde (prefixo do código)
observacoes	string	Não	Observações adicionais sobre o molde
ativo	boolean	Não	Indica se o molde está ativo no catálogo

MoldeAlocado

Fonte: src/main/java/com/wester/storage/model/MoldeAlocado.java.

Campo	Contrato	Obrigatório no DTO	Observações
slot	SlotNivel	Sim
molde	Molde	Sim
ordem	integer	Não	Ordem do molde dentro do slot (para múltiplos moldes no mesmo slot)

Nivel

Fonte: src/main/java/com/wester/storage/model/Nivel.java.

Campo	Contrato	Obrigatório no DTO	Observações
version	integer	Não	Versão para concorrência otimista; obtida na consulta.
grade	Grade	Sim
identificador	string	Sim	Não pode ser vazio ou conter apenas espaços.
ordem	integer	Não
identificadorCompletoLegivel	string	Não
ativo	boolean	Não

NivelMaterial

Fonte: src/main/java/com/wester/storage/model/NivelMaterial.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
nivel	Nivel	Não
materialId	integer	Não
materialType	string	Não
ordem	integer	Não
quantidade	integer	Não
quantidadeAproximada	boolean	Não

Perfil

Fonte: src/main/java/com/wester/storage/model/Perfil.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
codigo	string	Sim	Não pode ser vazio ou conter apenas espaços.
descricao	string	Sim	Não pode ser vazio ou conter apenas espaços.
tipoAcesso	string	Não
telasPermitidas	array de string	Não
ativo	boolean	Não
createdAt	string	Não	Data/hora local sem offset; não assumir UTC.
updatedAt	string	Não	Data/hora local sem offset; não assumir UTC.

Produto

Fonte: src/main/java/com/wester/storage/model/Produto.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
codigoSistemaWester	string	Não	Aliases de entrada: "codigo"
nomeModelo	string	Sim	Não pode ser vazio ou conter apenas espaços.
cor	string	Não
descricao	string	Não
ativo	boolean	Não
estoqueMinimo	integer	Não	Quantidade minima recomendada em estoque
estoqueMaximo	integer	Não	Quantidade maxima recomendada em estoque
categoria	CategoriaProduto	Não

SlotNivel

Fonte: src/main/java/com/wester/storage/model/SlotNivel.java.

Campo	Contrato	Obrigatório no DTO	Observações
nivel	Nivel	Sim
posicao	integer	Sim	Posição do slot dentro do nível (1=esquerda, 2=direita, ...)
identificador	string	Sim	Identificador editavel do slot dentro do nivel Não pode ser vazio ou conter apenas espaços.
moldesAlocados	array de MoldeAlocado	Não

TabelaEncerto

Fonte: src/main/java/com/wester/storage/model/TabelaEncerto.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
area	AreaEstoque	Sim
titulo	string	Sim	Não pode ser vazio ou conter apenas espaços.
colunas	array de string	Não
ativo	boolean	Não
criadoEm	string	Não	Data/hora local sem offset; não assumir UTC.
itens	array de TabelaEncertoItem	Não

TabelaEncertoItem

Fonte: src/main/java/com/wester/storage/model/TabelaEncertoItem.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
tabela	TabelaEncerto	Sim
produto	Produto	Sim
quantidade	integer	Não
ordem	integer	Não
observacao	string	Não

Usuario

Fonte: src/main/java/com/wester/storage/model/Usuario.java.

Campo	Contrato	Obrigatório no DTO	Observações
id	integer	Não
nome	string	Sim	Não pode ser vazio ou conter apenas espaços.
login	string	Sim	Não pode ser vazio ou conter apenas espaços.
perfil	string	Sim	Não pode ser vazio ou conter apenas espaços.
ativo	boolean	Não

MesToolSettings

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
lot	string	Não
moldName	string	Não
nozzleMode	string	Não
pieceWeightGrams	number	Não
netWeightGrams	number	Não
grossWeightGrams	number	Não
sprueWeightGrams	number	Não
cyclesPerKit	integer	Não

MesMachineInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Sim
name	string	Sim
numero	string	Sim
marca	string	Sim
modelo	string	Sim
edgeId	string	Não
nozzleMode	string	Não
ativo	boolean	Não
testYellow	boolean	Não
testRed	boolean	Não

MesOrderInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Não
orderCode	string	Sim
productCode	string	Sim
productName	string	Sim
toolCode	string	Não
material	string	Não
notes	string	Não
quantityPieces	integer	Sim
piecesPerCycle	integer	Sim
idealCycleMs	integer	Sim
toolSettings	MesToolSettings	Não

MesPositionInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
queuePosition	integer	Sim
machineId	string	Não

MesAssignInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Sim

MesReasonInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
reason	string	Sim

MesQualityInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
reject	integer	Sim
secondQuality	integer	Não
residueGrams	number	Sim
notes	string	Sim

MesDowntimeInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
kind	string	Sim
reason	string	Sim
notes	string	Não

MesReleaseInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
notes	string	Não

MesRejection

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
code	string	Sim
status	integer	Sim
at	string	Sim

MesHeartbeatInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Sim
adamReadAt	string	Não
outboxDepth	integer	Sim
quarantineDepth	integer	Sim
lastAcknowledgedSequence	integer	Não
collectorFailureCount	integer	Não
collectorFailureAt	string	Não
collectorLastError	string	Não
lastRejection	MesRejection	Não

MesEdgeEventInput

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Sim
edgeId	string	Não
eventId	string	Sim
sequence	integer	Sim
timestamp	string	Sim
type	string	Sim
classification	string	Não
cycleState	string	Não
previousCycleState	string	Não
interruptionReason	string	Não
currentCycleStartedAt	string	Não
lamp	string	Sim
outputStatus	string	Sim
reason	string	Não
signals	object	Sim
schemaVersion	integer	Não
namedSignals	object	Não
executionId	string	Não
cycle	object	Não

MesOrder

Campos comprovados no mapeamento JDBC e migrações; propriedades adicionais permitidas para projeções e contadores. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
orderId	string	Não
machineId	string	Não
orderCode	string	Não
productCode	string	Não
productName	string	Não
toolCode	string	Não
material	string	Não
quantityPieces	integer	Não
piecesPerCycle	integer	Não
idealCycleMs	integer	Não
notes	string	Não
toolSettings	MesToolSettings	Não
status	string	Não
queuePosition	integer	Não
createdAt	string	Não
author	string	Não
insumos	string	Não
executionId	string	Não
goodPieces	integer	Não
targetReached	boolean	Não

MesExecution

Campos comprovados no mapeamento JDBC e migrações; propriedades adicionais permitidas para projeções e contadores. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
executionId	string	Não
orderId	string	Não
machineId	string	Não
contextRevision	integer	Não
status	string	Não
preparedAt	string	Não
startedAt	string	Não
finishedAt	string	Não
author	string	Não
cancelReason	string	Não
orderCode	string	Não
productCode	string	Não
productName	string	Não
toolCode	string	Não
material	string	Não
quantityPieces	integer	Não
piecesPerCycle	integer	Não
idealCycleMs	integer	Não
notes	string	Não
toolSettings	MesToolSettings	Não
insumos	string	Não
goodPieces	integer	Não
targetReached	boolean	Não

MesQuality

Campos comprovados no mapeamento JDBC e migrações; propriedades adicionais permitidas para projeções e contadores. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
qualityId	string	Não
executionId	string	Não
secondQuality	integer	Não
reject	integer	Não
residueGrams	number	Não
notes	string	Não
createdAt	string	Não
author	string	Não

MesDowntime

Campos comprovados no mapeamento JDBC e migrações; propriedades adicionais permitidas para projeções e contadores. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
downtimeId	string	Não
machineId	string	Não
executionId	string	Não
kind	string	Não
reason	string	Não
notes	string	Não
startedAt	string	Não
releasedAt	string	Não
recoveredAt	string	Não
author	string	Não
releasedBy	string	Não
releaseNotes	string	Não
category	string	Não
source	string	Não
mergedInto	string	Não

MesCycleOutcome

Campos comprovados no mapeamento JDBC e migrações; propriedades adicionais permitidas para projeções e contadores. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
eventId	string	Não
executionId	string	Não
machineId	string	Não
timestamp	string	Não
classification	string	Não
cycleState	string	Não
previousCycleState	string	Não
reason	string	Não
startedAt	string	Não
endedAt	string	Não
pieces	integer	Não
durationMs	integer	Não
body	string	Não

MesMachine

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Não
name	string	Não
numero	string	Não
marca	string	Não
modelo	string	Não
nozzleMode	string	Não
ativo	boolean	Não
testYellow	boolean	Não
testRed	boolean	Não
revision	integer	Não
activeExecutionId	string	Não
mechanicalFault	boolean	Não

MesMetrics

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
grossPieces	number	Não
cycles	number	Não
validCycles	number	Não
averageCycleMs	number	Não
averageInjectionMs	number	Não
averageMoldClosedMs	number	Não
averageMoldNotClosedMs	number	Não
averageNozzleContactMs	number	Não
averageNozzleAwayMs	number	Não
averageDosingMs	number	Não
secondQuality	number	Não
reject	number	Não
residueGrams	number	Não
goodPieces	number	Não
qualityBasis	string	Não
projection	string	Não

MesReport

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
grossPieces	number	Não
cycles	number	Não
validCycles	number	Não
averageCycleMs	number	Não
averageInjectionMs	number	Não
averageMoldClosedMs	number	Não
averageMoldNotClosedMs	number	Não
averageNozzleContactMs	number	Não
averageNozzleAwayMs	number	Não
averageDosingMs	number	Não
secondQuality	number	Não
reject	number	Não
residueGrams	number	Não
goodPieces	number	Não
qualityBasis	string	Não
projection	string	Não
executionTotals	MesMetrics	Não

MesStatus

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machine	MesMachine	Não
execution	MesExecution	Não
telemetry	object	Não
telemetryAt	string	Não
hasCompletedCycle	boolean	Não
cycleState	string	Não
cycleClassification	string	Não
validationRequired	boolean	Não
validationReason	string	Não
lastSequence	integer	Não
currentCycleElapsedMs	number	Não
lastCycleMs	number	Não
desiredLamp	string	Não
productionBlocked	boolean	Não
communication	string	Não
metrics	MesMetrics	Não
edgeHealth	object	Não
collectorHealth	object	Não
ingestionHealth	object	Não
nozzleModeInferred	object	Não

MesConfig

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
machineId	string	Não
revision	integer	Não
executionId	string	Não
idealCycleMs	integer	Não
piecesPerCycle	integer	Não
mechanicalFault	boolean	Não
recoveryPending	boolean	Não
hasCompletedCycle	boolean	Não
productionBlocked	boolean	Não
manualLamp	string	Não
desiredLamp	string	Não

MesPermissions

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
read	boolean	Não
operate	boolean	Não
maintain	boolean	Não
plan	boolean	Não
admin	boolean	Não

MesActiveDowntime

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
active	MesDowntime	Não
linked	array de MesDowntime	Não

MesEventAck

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
eventId	string	Não
duplicate	boolean	Não

MesHeartbeatAck

Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações
accepted	boolean	Não
receivedAt	string	Não

MesImportPreview

Prévia variável; confira campos, source (NATIVE/OCR) e informações não resolvidas. Não cria OS. Campos do parser: bags, boxes, field, idealCycleSeconds, lot, machineHint, multiple, orderCode, orderDate, piecesPerCycle, productCode, productName, quantityPieces, reason, toolCode, toolDescription. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações

ProdutoListaVariavel

Sem filtros/paginação: array; com filtros/paginação: página Spring Data. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações

MoldeListaVariavel

Formato depende de shouldUsePaginatedListing; ver regras do serviço. Fonte: MesService, MesRules e migrações MES, ou composição do tipo de retorno.

Campo	Contrato	Obrigatório no DTO	Observações