Delivery & Cardápio

🌮 Cardápio / Delivery — /admin/produtos

Produtos do delivery/site (Produto): nome, preço, categoria, foto (webp thumb+full), estação, complementos/adicionais. Cada produto carrega campos fiscais (NCM/CFOP/CEST/origem/CST/alíquotas) e de estoque.

🍽️ Produtos da Casa — /admin/produtos-casa

Itens do salão/PDV (ProdutoCasa): nome, preço, categoria, estação (cozinha/bar). É o cardápio que o garçom lança na comanda.

📦 Estoque — /admin/estoque *(novo)*

Controle por produto (opt-in): entrada/baixa/ajuste, mínimo, indicadores (ok/baixo/zerado). Automação: a venda baixa o estoque (idempotente). Diferente do estoque de insumos.

🧺 Insumos & Fornecedores — /admin/insumos *(novo)*

Cadastro de insumos (unidade, custo médio, estoque, mínimo, fornecedor) e fornecedores (CNPJ, contato). Base do CMV, compras e inventário. Modelos: Insumo, Fornecedor.

📐 Ficha Técnica & CMV — /admin/ficha-tecnica *(novo)*

Lista de produtos com custo (CMV), CMV%, margem R$ e margem%; editor de ficha (insumo + quantidade + % perda) com recálculo ao vivo. Motor (_cmv_produto): custo = Σ insumo.custo_médio × quantidade × (1 + perda/100). Ex.: 40×0,15×1,1 + 30×0,05 = R$8,10. Alimenta BI e previsão de estoque. Modelo FichaTecnicaItem. Margem REAL por canal (§9/§12): passando canal_custos, o motor desconta também embalagem + taxa do adquirente/canal + imposto + comissão e devolve a margem de contribuição verdadeira por canal.

🛒 Compras — /admin/compras *(novo)*

Pedidos de compra (fornecedor + itens + custo unitário), sugestão automática (insumos abaixo do mínimo, por fornecedor), recebimento. Entrada de mercadoria (_receber_compra): soma ao estoque + recalcula custo médio ponderado (ex.: (10×40+10×46)/20 = R$43) + grava histórico de preço. Idempotente. Modelos: CompraPedido, CompraItem, PrecoFornecedorHist.

📋 Inventário — /admin/inventario *(novo)*

Abrir contagem (snapshot do estoque), digitar contado (divergência ao vivo), fechar. Fechamento (_fechar_inventario): aplica contado ao estoque + valoriza a divergência (quebra/perda R$ = Σ (contado−sistema)×custo). Ex.: −2 kg × R$43 = −R$86. Auditado, sem desfazer. Modelos: InventarioContagem, InventarioItem.

🛵 Motoboys — /admin/motoboys

Cadastro de entregadores (nome, telefone, token do app, disponibilidade). Cada instalação gera um uuid. Alimenta fila de rastreio e roteirização. Modelo Motoboy.

📦 Configurações de entregas — /admin/entregas

Regras de taxa de entrega (grátis/por bairro/por km), raio, tempos. Alimenta o frete no checkout.

Versão para IA/crawler: /manual.md (Markdown cru) · /manual/completo (página única) · /sitemap.xml