Trânsito M+2
O sistema NÃO calcula essa regra — o relatório "Mês de X" já vem do Protheus com a alocação pronta (entrega do mês M contando no saldo do mês M+2). O PCM só lê Estoque/Trânsito/Comprometido exatamente como estão no relatório importado.
O prazo configurado acima é usado em UM lugar só: decidir de qual mês descontar quando você exclui uma importação de trânsito na Simulação ("e se essa entrega não vier"). Mudar esse número não afeta o Cenário Completo nem o cálculo real do saldo.
Fórmula do saldo calculado
Saldo do mês = Estoque + Trânsito − Comprometido daquele mês. O Estoque de um mês é sempre o Saldo do mês anterior (a cascata rola pra frente) — só o 1º mês da janela usa o estoque físico real do relatório.
Entrada de nota fiscal e o armazém
O relatório "Análise de movimentação — Entrada de NF" sai do Protheus filtrado por um armazém de cada vez e não traz o armazém em cada linha. Como toda entrada de nota da JFA cai no armazém 20, o sistema marca as linhas desse relatório como armazém 20 na hora da importação.
Não confundir com o relatório "Análise de movimentação — ARMAZÉM", que é outro tipo e traz o armazém na própria planilha. Se um dia a entrada de nota passar a cair em outro armazém, avise: a escolha precisa virar um campo na tela, porque o que já foi importado fica marcado como 20.
Qual custo é usado para valorizar
Todo valor em R$ da tela — saldo valorizado do mês, saldo valorizado total, valor em excesso, capital em estoque e Curva ABC — é calculado na hora da consulta, multiplicando a quantidade pelo custo atual do produto. Não é o custo que valia no dia do cálculo.
Isso importa porque o custo é atualizado a cada importação que traga preço (Pedido de Compra, Armazéns, Movimentação), enquanto as quantidades só mudam quando um novo cálculo roda. Então, entre um cálculo e outro, os valores em R$ podem mudar sozinhos mesmo com as quantidades paradas — é o preço que se atualizou, não o saldo.
Produto sem custo cadastrado fica com R$ 0 em todas essas colunas, e fora da Curva ABC.
Papéis de usuário (aba Admin)
Administrador — acesso total, incluindo criar e desativar usuários.
Usuário — faz tudo no sistema (importar, calcular, simular, resolver), menos gerenciar usuários.
Somente leitura — consulta todas as telas e exporta relatórios, mas nenhuma ação que altere dados: não importa relatório, não roda cálculo, não cria ou apaga simulação, não resolve item do Comparativo, não marca alerta como tratado.
Sugestão de compra e Compra total sugerida
Cada mês é calculado de forma independente, direto do saldo daquele mês (arredondado pra cima pro múltiplo de compra do produto) — a sugestão de um mês nunca supõe que a sugestão de outro mês foi comprada.
"Compra total sugerida" é o MAIOR valor entre as sugestões mensais da janela (o pico), não a soma — o saldo é uma rolagem cumulativa, então o mesmo déficit aparecendo em vários meses seguidos (sem novo comprometido) é o MESMO problema, não um problema novo em cada mês. O total só sobe se o comprometido aumentar em algum mês. É um norte pra analista comprar (ou pra conferir na extração de relatórios), nunca um dado usado em outro cálculo do sistema.
Classificação crítico / atenção / confortável
Crítico saldo calculado negativo em algum mês do contexto (todos os meses, um mês específico, ou os meses selecionados — depende do filtro ativo na tela).
Atenção saldo positivo, mas menor que o comprometido do mês (margem apertada).
Confortável nem crítico nem atenção.
Desconsiderar trânsito de um fornecedor
O filtro "Ignorar trânsito", na barra de cada tela, recalcula tudo como se o material a caminho daquele fornecedor não fosse chegar — útil para medir o risco de um atraso ou de um canal vermelho. Cada aba guarda a própria seleção, então dá para deixar o Cenário Completo no pior caso e o Excesso no número oficial ao mesmo tempo. O Comparativo Diário e o Início ficam de fora: o primeiro mostra a variação real entre duas datas, o segundo é a lista de trabalho do dia. Nada é gravado — é uma visão montada na consulta.
Curva ABC (sub-aba do Dashboard)
Classifica por valor imobilizado (saldo × custo), valor de demanda (comprometido × custo) e giro (meses de cobertura). Nas duas curvas de valor o corte é por Pareto acumulado: A até 80% do valor, B até 95%, C o restante. No giro o corte é por tempo: A até 3 meses, B de 3 a 12, C acima disso. Tudo parte da demanda prevista dos meses da janela, não de consumo histórico — o sistema não guarda série de consumo, porque o relatório de Movimentação traz entrada de NF, não saída. Produto sem custo, sem saldo ou sem demanda fica fora da curva (não vira C) e a tela informa quantos são.
Capital em estoque (Dashboard)
Divide o estoque físico valorizado em três partes que somam o total: gira (consumido pela demanda da janela), acima do necessário (a sobra nos itens que têm demanda) e parado (itens sem demanda nenhuma). Só entra o que tem custo cadastrado — produto sem custo não aparece em nenhuma das três fatias.
Onde e por quanto tempo os dados ficam salvos
O sistema roda no EasyPanel (mesmo painel do Orkestra), com deploy automático a cada atualização enviada pelo desenvolvedor. Os dados ficam num banco MySQL, separado da aplicação, dentro do mesmo painel — não é apagado em reinícios nem em atualizações do sistema.
Só UMA informação tem limpeza automática: o histórico de saldo diário que alimenta o Comparativo Diário guarda só os últimos 60 dias — comparações mais antigas que isso deixam de estar disponíveis ali. Essa limpeza roda sozinha toda vez que um cálculo é feito (automático ou manual).
Tudo o mais fica guardado indefinidamente, sem limpeza nenhuma: os relatórios importados (Empenho, Pedido de Compra, Movimentação, Armazéns, Relatório do mês), os arquivos originais disponíveis pra extração, alertas, produtos, usuários, simulações e ajustes manuais.
