Status: rascunho operacional para aprovação ou ajuste.
Escopo: tenant 15 (Fazendinha) · lojas 1001 / 1003 / 1004 · ~331 SKUs.
Módulo no portal: menus PA dentro de Terus Production.
Cutover (Z-03) ainda não desligou o legado Production — este guia é para ciclo supervisionado (operar PA em paralelo, com cuidado).
Docs técnicos de código: portal-terus/docs/producao-abastecimento/
Baseline Z-01 / shadow Z-02: baseline-fazendinha.md, ciclo-shadow-fazendinha.md (mesmo diretório).
| # | Tela | Caminho | Permissão | Uso |
|---|---|---|---|---|
| 1 | Produtos PA | /dashboard/production/pa-produtos |
menu.pa.produtos |
Unidades, cobertura, mínimos, validade |
| 2 | Centros / Lojas PA | /dashboard/production/pa-centros |
menu.pa.cadastros |
Nós LOJA / CENTRO / LOJA_COM_CENTRO |
| 3 | Roteamento PA | /dashboard/production/pa-roteamento |
menu.pa.cadastros |
Produto × centro × loja destino |
| 4 | Estoque PA | /dashboard/production/pa-estoque |
menu.pa.estoque |
Saldos PRODUCAO / VENDA / TRANSITO |
| 5 | Pedidos da loja | /dashboard/production/pa-pedidos |
menu.pa.pedido_loja |
Sugestão + aprovação |
| 6 | Planejamento centro | /dashboard/production/pa-planejamento |
menu.pa.planejamento |
Consolida pedidos aprovados |
| 7 | Ordens centro | /dashboard/production/pa-ordens |
menu.pa.ordens |
Liberar / apontar / finalizar |
| 8 | Transferências | /dashboard/production/pa-transferencias |
menu.pa.transferencias |
Expedir → trânsito → receber |
Pré-requisito de acesso: flag ProducaoAbastecimento - Habilitado = S no tenant (Fazendinha já está S) + permissões menu.pa.* (admin/master bypass).
| Item | Situação | Workaround |
|---|---|---|
| Dashboard PA | Permissão menu.pa.dashboard existe; tela não |
Usar listagens + Estoque |
| Parâmetros PA dedicados | Permissão existe; tela não | core.parametros / tela genérica de parâmetros |
| Sync OUTRAS_SAIDAS / perdas → ledger | Só API/worker | Manter flags sync em N no piloto até D-01 |
| Relatório shadow / baseline | Só scripts + markdown | Rodar pa_ciclo_shadow_fazendinha.py |
| Aprovação via Task (app) | Não ligada ao PA | Aprovar no portal |
| Breakdown “perdas” na UI do pedido | API grava; UI pode não destacar o bloco | Abrir JSON/breakdown se disponível; evoluir UI |
| KDS / ondas cozinha | Fora do MVP PA | Não usar neste piloto |
Conclusão: para o ciclo loja → centro → apontamento → (interna ou transferência) → estoque, as interfaces existem. Faltam telas de gestão/observabilidade e cutover do legado.
No seed atual cada loja é LOJA_COM_CENTRO e o roteamento aponta para si mesma.
Por isso o caminho feliz do piloto é produção interna (não gera transferência).
Use uma loja por vez (ex.: 1001). Data de necessidade: amanhã (ou data acordada com a operação).
Não misture com ordens do Terus Production legado na mesma seção sem alinhamento.
Regras que definem a produção diária — ver
Regras: embalagem, lote e ponto de pedido:
| Pilares | Regra |
|---|---|
| Transferência | Sempre múltiplo da emb. de transferência |
| Produção | Sempre múltiplo da emb. de produção + lote econômico (N emb.) |
| Ponto de pedido | Gatilho + mínimo na loja e no centro |
O pedido da loja não opera fração crua (ex.: 0,36 KG). Sem embalagem/múltiplo,
SKUs em KG/LT são omitidos do cálculo (Exigir Embalagem Pedido = S).
1 (seed automático ajuda).1001/1003/1004 = LOJA_COM_CENTRO) e Roteamento.Seed auxiliar (ops/TI):
backend/scripts/seed_pa_embalagens_fazendinha.sql
(preenche UN=1 e tenta lote inferido/planilha; KG ainda exige revisão humana).
/dashboard/production/pa-pedidosv1_cobertura)Conferir:
SUGERIDOqtd_sugerida > 0Ajustes possíveis nesta etapa:
qtd_aprovada item a item (justificativa fica no log)APROVADOPedido aprovado entra no consolidado do centro.
PedidosAPROVADOem aberto consomem necessidade em novos cálculos (anti–pedido duplicado).
Conferir:
CALCULADOqtd_a_produzirCALCULADA → LIBERADA)O que o sistema faz no piloto (mesma filial):
PRODUCAO_INTERNA → saldo sobe em VENDA na própria lojaEM_ATENDIMENTO / ATENDIDO / parcial), conforme o que foi produzidoNo piloto atual não é o caminho padrão. Se no futuro houver centro distinto:
Marque após o teste na loja:
Espaço para decisão:
| Pergunta | Aprovado? | Observação / ajuste |
|---|---|---|
| Fluxo de telas está claro para a loja? | Sim / Não / Parcial | |
Sugestão v1_cobertura está utilizável? |
Sim / Não / Parcial | |
| Precisa Task (app) na aprovação? | Sim / Não / Depois | |
| Pode ir para cutover seccional (Z-03)? | Sim / Não / Depois | |
| Calibrar cobertura/perdas/embalagem antes? | Sim / Não |
| Papel | Telas | Ação |
|---|---|---|
| Encarregado loja | Pedidos | Criar, ajustar, aprovar |
| Produção / centro | Planejamento, Ordens | Consolidar, liberar, apontar |
| Conferência / estoque | Estoque, (Transferências) | Validar saldos; receber se houver TF |
| Suporte Terus | Cadastros + parâmetros | Flag, permissões, seed, logs |
| Parâmetro | Valor tipico piloto | Efeito |
|---|---|---|
ProducaoAbastecimento - Habilitado |
S | Liga o módulo |
… Dias Cobertura Default |
2 | Cobertura se produto não tiver |
… Lead Time Centro (dias) |
1 | Soma aos dias efetivos |
… Considerar Saldo ERP |
S | Usa ERP se PA ainda não for SoT do SKU |
… Considerar Perdas Sobra |
S | Soma perda projetada no breakdown |
… Sync OUTRAS_SAIDAS |
N | Não baixar ledger via agenda ainda |
… Sync Perdas Sobra Ledger |
N | Evita dupla baixa vs cálculo |
APROVADO (zera sugestões futuras).| Artefato | Onde |
|---|---|
| Menus PA | Production → itens “* PA” / “Abastecimento” |
| Baseline escopo | docs/.../baseline-fazendinha.md |
| Último shadow PA×planilha×legado | docs/.../ciclo-shadow-fazendinha.md |
| Modelo / TODO | wiki índice + portal-terus/docs/producao-abastecimento/ |
| Data | Nota |
|---|---|
| 2026-08-04 | Primeira versão do guia (pós Z-01/Z-02). Aguardando aprovação/ajustes da operação. |