itecnologys/pizza-digital
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
pizza-digital/docs/PRD/PRD-SPEC-ESTOQUE.md
Admin e3da540b6e Add detailed developer PRDs for all Pizza Digital SPECs. 
Each PRD documents real UI/API processes, service methods, states and gaps.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-09 21:22:22 +00:00

2.6 KiB
Raw Permalink Blame History

PRD — Estoque / SmartStock

Campo Valor
Produto Pizza Digital
Versão app auditada v0.5.0
Ambiente https://pizza.itecnologys.com · VM125 · loja pizza-digital-piloto
Spec de origem docs/SPEC-ESTOQUE.md
Módulo Insumos, CMV, transferências, turnos
Rotas UI /estoque /estoque/smart/*
APIs /api/estoque/* /api/estoque/smart/*
Data 2026-11-09
Estilo PRD operacional detalhado (visão de desenvolvedor)
Audiência Dev / QA / Product

Como ler: cada seção descreve o processo real (o que o sistema faz hoje), com passos de usuário, chamadas de API, regras de negócio e estados. Status: ✅ construído · ⚠️ parcial · ⏳ especificado / não entregue · 🐛 gap observado.

1. Visão de implementação

Dois níveis:

  1. Estoque clássico (/api/estoque) — insumos, ajuste, relatório, preview baixa
  2. SmartStock (/api/estoque/smart) — estações, transferências, picking, turnos, contagens

Ponte com cardápio: BOM (MenuItemRecipeLine) e stockMode.

2. Processo — baixa por venda (conceitual)

  1. Pedido confirmado com itens stockMode=bom
  2. Preview POST /api/estoque/preview
  3. Consumo grava RecipeConsumption / movimentos
  4. Alerta se saldo insuficiente (strict mode PATCH /api/estoque/strict)

3. Processo — SmartStock transferência (dev steps)

  1. Estação solicita: POST /estoque/smart/requests
  2. Central vê GET /estoque/smart/transfers
  3. POST .../start-picking → PATCH .../picking linhas
  4. POST .../dispatch → envio
  5. Destino POST .../receive
  6. Movimentos auditáveis GET /estoque/smart/movements

4. Processo — turno / fechamento

  1. POST /estoque/smart/shifts/open
  2. Contagens POST .../counts
  3. Aprovação por insumo POST .../approve/:ingredientId
  4. POST .../close
  5. UI: /estoque/smart/fechamento/:shiftId

5. UI map

  • Dashboard, Central, Transferências, Consumo, Movimentos, Estação, Recebimento

6. Aceite

  • ✅ Módulo SmartStock amplo na API/UI
  • ⚠️ Strict/BOM amarrado 100% ao PDV em todos itens
  • ⏳ NF compra / inventário físico completo

7. SmartStockService (~1838 linhas) — processos chave

Método Processo
dashboard / listStations / stationBoard Visão
createRequest Pedido de reposição
startPicking / updatePickingLines Separação
dispatchTransfer / receiveTransfer Envio/recebimento
openShift / saveCounts / approveCount / closeShift Fechamento
movements / movementDetail / moveBalance Auditoria saldo