02. Itens
Item é a representação operacional de uma peça dentro do nanosap.
Ele nasce a partir de entradas manuais ou de sincronização via Geleca e passa por revisão até estar pronto para as próximas etapas da operação.
Campos principais
nome é o nome revisável da peça.
preco_estimado é o valor estimado da peça. No modelo de rateio ele é chamado de A.
valor_pago é uma referência manual registrada na entrada. Ele não interfere no rateio.
largura, altura, comprimento e peso descrevem a peça como produto físico.
status mostra o estágio de revisão do item.
id_lote liga o item ao lote que representa a origem financeira.
imagens guarda as fotos anexadas manualmente.
thumb_url guarda a imagem de referência quando a origem é Instagram.
tags guarda marcações operacionais que podem coexistir com o status.
Estados
O fluxo esperado é:
recebido -> cadastrado -> postado -> reservado -> vendido -> enviado -> arquivado
recebido significa que o item entrou no sistema.
cadastrado significa que nome, descrição, fotos e valores foram revisados.
postado significa que o item já foi publicado na vitrine.
reservado significa que há intenção de compra, mas a venda ainda não foi concluída.
vendido significa que existe venda registrada.
enviado significa que a etapa de entrega já começou ou foi concluída.
arquivado significa que o item saiu do fluxo ativo.
O sistema bloqueia regressões fora do pipeline esperado.
Tags
Tag não é status.
publicacao_pendente indica que o item ainda precisa ser publicado. Ela pode aparecer junto com recebido ou cadastrado, sem quebrar o pipeline principal.
Relação com lote
O item pode existir antes do lote, mas não deve receber custo real sem lote.
Quando id_lote está vazio, o item ainda não tem origem financeira definida.
Quando id_lote aponta para um lote, o item passa a participar do rateio daquele lote.
Valor estimado não é custo real
preco_estimado é uma referência de proporção.
Ele ajuda a calcular quanto cada item representa dentro do lote, mas não é o custo real final.
Produto físico
Todo item deve poder carregar largura, altura, comprimento e peso.
Essas informações apoiam publicação, logística e conferência. Elas não mudam preco_estimado, custo_real ou margem.
Quando a origem do item é um caption de Instagram, esses campos podem ser sugeridos automaticamente a partir do texto.
A sugestão não deve ser tratada como verdade final: medida, peso e preço precisam continuar revisáveis.