@fayz-ai/plugin-inventory 0.12.1 → 0.12.3

package/dist/index.js

@@ -1,9 +1,9 @@
 import React3, { useState, useMemo, useEffect, useCallback, useRef } from 'react';
-import { toast, defineKpiWidget, defineCustomWidget, PageTransition, ModulePage, Button, SubpageHeader, SearchSelect, cn, DatePicker, ListView, ConfirmDialog, Badge, DraftCommitBar, Switch, useSaveBar, DataTable, DashboardCanvas, Modal, ModalContent, ModalHeader, ModalTitle, ModalDescription, ModalBody, ModalFooter, StockEntryForm, KpiCard, Card, CardHeader, CardTitle, CardContent } from '@fayz-ai/ui';
+import { toast, defineKpiWidget, defineCustomWidget, PageTransition, ModulePage, Button, SubpageHeader, SearchSelect, cn, DatePicker, ListView, ConfirmDialog, Badge, DraftCommitBar, Switch, useSaveBar, DataTable, DashboardCanvas, Modal, ModalContent, ModalHeader, ModalTitle, ModalDescription, ModalBody, ModalFooter, StockEntryForm, KpiCard, Card, CardHeader, CardTitle, CardContent, Skeleton } from '@fayz-ai/ui';
 import { createPluginContext, PluginSettingsPanel, dedup, useModuleNavigation, createViewRouter, ModuleActionBar, useTenantPluginSettings, SettingsGroup, ToggleRow, usePermissionOptional, CrudListView, TeachMeLink, useLimitGuard, invalidateRelationOptions, CrudFormSkeleton, CrudFormPage, CrudDetailPage, formatCurrency, useAgentSurface, askAI, PermissionGate, QuickActionsButton, invalidateLimit } from '@fayz-ai/admin';
-import { createSafeDataProvider, registerTranslations, countByTenant, useTranslation, getActiveUnitId, errorMessage, useDataChanged, getSupabaseClientOptional, getActiveTenantId } from '@fayz-ai/core';
+import { createSafeDataProvider, registerTranslations, countByTenant, useTranslation, getActiveUnitId, createPendingCommand, errorMessage, useDataChanged, getSupabaseClientOptional, getActiveTenantId } from '@fayz-ai/core';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
-import { Trash2, ArrowRightLeft, RefreshCw, ArrowUpRight, ArrowDownRight, Package, Ruler, MapPin, Loader2, Check, ChevronRight, CircleSlash, CircleCheck, ClipboardCheck, AlertTriangle, Plus, BookOpen, Layers, Clock, Coins, Building2, Undo2 } from 'lucide-react';
+import { Trash2, ArrowRightLeft, RefreshCw, ArrowUpRight, ArrowDownRight, Package, Ruler, MapPin, Loader2, Check, ChevronRight, CircleSlash, CircleCheck, ClipboardCheck, AlertTriangle, Plus, BookOpen, Layers, Clock, Coins, Building2, Undo2, PackageX } from 'lucide-react';
 import { createStore as createStore$1 } from 'zustand/vanilla';
 
 // src/index.ts
@@ -70,6 +70,17 @@ function normalizeMovementType(raw) {
   if (MOVEMENT_TYPE_VALUES.includes(v)) return v;
   return LEDGER_KIND_TO_TYPE[v] ?? LEGACY_PT_MOVEMENT_TYPE[v];
 }
+
+// src/lib/idempotency.ts
+function createIdempotencyKey(scope) {
+  let suffix;
+  try {
+    suffix = typeof globalThis.crypto?.randomUUID === "function" ? globalThis.crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  } catch {
+    suffix = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  }
+  return `${scope}:${suffix}`;
+}
 function TableSkeleton() {
   return /* @__PURE__ */ jsx("div", { className: "rounded-card border p-4 space-y-2", children: [1, 2, 3].map((i) => /* @__PURE__ */ jsx("div", { className: "h-3.5 rounded bg-muted/30 animate-pulse" }, i)) });
 }
@@ -87,6 +98,8 @@ function ProductStockTab({ item, onChanged }) {
   const [undoing, setUndoing] = useState(false);
   const [entryVerb, setEntryVerb] = useState(null);
   const [saving, setSaving] = useState(false);
+  const command = useRef(createPendingCommand(() => createIdempotencyKey("inventory:product-movement"), (input) => input.productId));
+  const [pending, setPending] = useState(false);
   const load = useCallback(async () => {
     setLoading(true);
     try {
@@ -104,25 +117,32 @@ function ProductStockTab({ item, onChanged }) {
     void load();
   }, [load]);
   const handleEntry = useCallback(async (entry) => {
+    if (command.current.running) return;
     setSaving(true);
+    setPending(true);
     try {
-      await provider.createMovement({
+      await command.current.run({
         productId: item.id,
         movementType: entry.verb,
         quantity: entry.quantity,
         ...entry.reasonCode ? { reason: entry.reasonCode } : {},
         ...entry.note ? { notes: entry.note } : {},
         ...entry.occurredOn ? { movementDate: entry.occurredOn } : {}
-      });
+      }, (input) => provider.createMovement(input));
       setEntryVerb(null);
-      await load();
-      onChanged?.();
+      try {
+        await load();
+        onChanged?.();
+      } catch {
+        toast.warning(t2("inventory.stock.refreshAfterCommit"));
+      }
     } catch (error) {
       toast.error(t2("inventory.productDetail.movementFailed"), {
         description: error.message
       });
     } finally {
       setSaving(false);
+      setPending(command.current.pending);
     }
   }, [item.id, provider, load, onChanged, t2]);
   const ordered = useMemo(
@@ -260,8 +280,12 @@ function ProductStockTab({ item, onChanged }) {
       StockEntryForm,
       {
         verb: entryVerb,
-        onVerbChange: setEntryVerb,
-        onClose: () => setEntryVerb(null),
+        onVerbChange: (verb) => {
+          if (!command.current.pending) setEntryVerb(verb);
+        },
+        onClose: () => {
+          if (!command.current.pending) setEntryVerb(null);
+        },
         verbs: MOVEMENT_TYPES.map((m) => ({
           value: m.value,
           label: t2(m.labelKey),
@@ -269,6 +293,8 @@ function ProductStockTab({ item, onChanged }) {
         })),
         available: onHand,
         saving,
+        readOnly: pending,
+        notice: pending ? t2("inventory.stock.pendingRetry") : void 0,
         onSubmit: (entry) => void handleEntry(entry),
         labels: {
           title: t2("inventory.productDetail.newMovement"),
@@ -360,6 +386,16 @@ function buildProductEntity(t2, productTypes, currency, onStockChanged, provider
       renderCell: (v) => /* @__PURE__ */ jsx("span", { className: "inline-flex items-center rounded-full px-2 py-0.5 text-[10px] font-medium bg-muted text-muted-foreground", children: typeLabel(v) })
     },
     // — Stock column (list only) — placed before Cost for the desired column order
+    //
+    // A célula carrega o saldo E o mínimo, porque a pergunta do balcão é a
+    // COMPARAÇÃO entre os dois — no V1 são duas colunas e o olho faz a conta.
+    // Uma coluna a mais custaria a sétima numa tabela que já é larga.
+    //
+    // E o alarme obedece à mesma regra do resumo (`stock > 0 && stock <= min`).
+    // Antes era `currentQuantity <= minQuantity`, que com mínimo 0 — o caso de
+    // 169 dos 169 produtos deste tenant — pinta o catálogo INTEIRO de vermelho.
+    // Alarme que toca sempre é alarme que ninguém ouve: é literalmente o defeito
+    // do V1 que a Visão Geral documenta (203 de 218 "em reposição urgente").
     {
       key: "currentQuantity",
       label: t2("inventory.productList.stock"),
@@ -367,7 +403,23 @@ function buildProductEntity(t2, productTypes, currency, onStockChanged, provider
       showInForm: false,
       showInTable: true,
       sortable: true,
-      renderCell: (_v, row) => /* @__PURE__ */ jsx("span", { className: `text-right block ${row.currentQuantity <= row.minQuantity ? "text-destructive font-medium" : ""}`, children: row.currentQuantity })
+      renderCell: (_v, row) => {
+        const qty2 = Number(row.currentQuantity) || 0;
+        const min = Number(row.minQuantity) || 0;
+        const unit = row.measurementUnitName;
+        const below = min > 0 && qty2 > 0 && qty2 <= min;
+        const empty = qty2 <= 0;
+        return /* @__PURE__ */ jsxs("span", { className: "block text-right", children: [
+          /* @__PURE__ */ jsxs("span", { className: below ? "font-medium text-destructive" : empty ? "text-muted-foreground" : "", children: [
+            qty2.toLocaleString("pt-BR", { maximumFractionDigits: 3 }),
+            unit ? /* @__PURE__ */ jsx("span", { className: "ml-1 text-xs text-muted-foreground", children: unit }) : null
+          ] }),
+          min > 0 && /* @__PURE__ */ jsxs("span", { className: "block text-xs text-muted-foreground", children: [
+            "m\xEDn. ",
+            min.toLocaleString("pt-BR", { maximumFractionDigits: 3 })
+          ] })
+        ] });
+      }
     },
     // — Pricing (form) + Cost column (table) —
     {
@@ -380,7 +432,12 @@ function buildProductEntity(t2, productTypes, currency, onStockChanged, provider
       currencyLocale: currency.locale,
       showInTable: true,
       sortable: false,
-      renderCell: (v) => /* @__PURE__ */ jsx("span", { className: "text-right block text-muted-foreground", children: formatCurrency(Number(v) || 0, currency) })
+      // Mesma regra do preço de venda: custo zero é "não cadastrado", não
+      // "custa nada". E é ele que faz o Valor abaixo mentir.
+      renderCell: (v) => {
+        const n = Number(v);
+        return /* @__PURE__ */ jsx("span", { className: "block text-right text-muted-foreground", children: v == null || v === "" || !Number.isFinite(n) || n === 0 ? "\u2014" : formatCurrency(n, currency) });
+      }
     },
     // — Value column (list only): stock × cost —
     {
@@ -390,7 +447,19 @@ function buildProductEntity(t2, productTypes, currency, onStockChanged, provider
       showInForm: false,
       showInTable: true,
       sortable: false,
-      renderCell: (_v, row) => /* @__PURE__ */ jsx("span", { className: "text-right block font-medium", children: formatCurrency((row.currentQuantity || 0) * (row.costPrice || 0), currency) })
+      // Saldo em mãos SEM custo cadastrado não vale R$ 0,00 — vale um número
+      // que esta casa não sabe. É o beco que o V1 documenta nas movimentações:
+      // "o Valor Total se descola da realidade sem ninguém errar nada". Zero
+      // com saldo zero é verdade; zero com 84 unidades na prateleira é uma
+      // afirmação que o dado não sustenta.
+      renderCell: (_v, row) => {
+        const qty2 = Number(row.currentQuantity) || 0;
+        const cost = Number(row.costPrice) || 0;
+        if (qty2 > 0 && cost === 0) {
+          return /* @__PURE__ */ jsx("span", { className: "block text-right text-muted-foreground", title: "Sem custo cadastrado, o valor deste saldo n\xE3o pode ser calculado", children: "\u2014" });
+        }
+        return /* @__PURE__ */ jsx("span", { className: "block text-right font-medium", children: formatCurrency(qty2 * cost, currency) });
+      }
     },
     {
       key: "salePrice",
@@ -400,7 +469,16 @@ function buildProductEntity(t2, productTypes, currency, onStockChanged, provider
       currency: currency.code,
       currencySymbol: currency.symbol,
       currencyLocale: currency.locale,
-      showInTable: false,
+      // O V1 mostra Custo E Venda lado a lado. Custo sozinho não responde
+      // "quanto isto rende", e o preço estava só dentro da ficha.
+      showInTable: true,
+      // Zero aqui é "não informado", não "de graça" — 100 dos 169 produtos deste
+      // tenant estão assim. "R$ 0,00" afirmaria um preço; o travessão diz que
+      // falta cadastrar, que é a verdade e é o que se pode agir sobre.
+      renderCell: (v) => {
+        const n = Number(v);
+        return /* @__PURE__ */ jsx("span", { className: "block text-right text-muted-foreground", children: v == null || v === "" || !Number.isFinite(n) || n === 0 ? "\u2014" : formatCurrency(n, currency) });
+      },
       // Ingredients and intermediate preparations are inputs, not things sold
       // directly to the customer. If it is sold, it belongs to the menu-item
       // classification and gets the commercial fields there.
@@ -933,6 +1011,8 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
   const [supplierLabel, setSupplierLabel] = useState("");
   const [saving, setSaving] = useState(false);
   const [savedMovement, setSavedMovement] = useState(null);
+  const command = useRef(createPendingCommand(() => createIdempotencyKey("inventory:manual-movement"), (input) => input.productId));
+  const [pending, setPending] = useState(false);
   useEffect(() => {
     fetchProducts({});
     fetchLocations();
@@ -1000,10 +1080,11 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
   const canProceedStep2 = quantity > 0 && (!needsReason || reason.trim()) && (!needsDest || destLocationId);
   const title = defaultType === "entry" ? t2("inventory.stock.entry") : defaultType === "exit" ? t2("inventory.stock.exit") : t2("inventory.stock.movement");
   async function handleSave() {
-    if (!productId || quantity <= 0) return;
+    if (command.current.running || !command.current.pending && (!productId || quantity <= 0)) return;
     setSaving(true);
+    setPending(true);
     try {
-      const movement = await createMovement({
+      const movement = await command.current.run({
         productId,
         quantity,
         movementType,
@@ -1016,10 +1097,12 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
         batchNumber: batchNumber || void 0,
         expirationDate: expirationDate || void 0,
         supplierId: movementType === "entry" ? supplierId || void 0 : void 0
-      });
+      }, createMovement);
       setSavedMovement(movement);
+    } catch {
     } finally {
       setSaving(false);
+      setPending(command.current.pending);
     }
   }
   return /* @__PURE__ */ jsxs("div", { className: "space-y-6", children: [
@@ -1028,7 +1111,12 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
       {
         title,
         subtitle: t2("inventory.stock.stepOf", { step: String(step) }),
-        onBack: step > 1 ? () => setStep(step - 1) : onSaved,
+        onBack: () => {
+          if (!command.current.pending && !command.current.running) {
+            if (step > 1) setStep(step - 1);
+            else onSaved?.();
+          }
+        },
         parentLabel: t2("inventory.nav.stock")
       }
     ),
@@ -1057,6 +1145,7 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
       /* @__PURE__ */ jsx(
         SearchSelect,
         {
+          "data-tour": "inventory.entry-product",
           value: productId,
           displayValue: productLabel,
           onChange: handleProductSelect,
@@ -1138,7 +1227,7 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
           /* @__PURE__ */ jsxs("div", { children: [
             /* @__PURE__ */ jsx("label", { className: "text-xs font-medium text-muted-foreground", children: needsDest ? t2("inventory.stock.fromLocation") : t2("inventory.stock.locationLabel") }),
             /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2 mt-1.5", children: sortedLocations.map((l) => {
-              const qty = positionByLocation[l.id] ?? 0;
+              const qty2 = positionByLocation[l.id] ?? 0;
               return /* @__PURE__ */ jsxs(
                 "button",
                 {
@@ -1152,8 +1241,8 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
                     /* @__PURE__ */ jsx("span", { children: l.name }),
                     productId && /* @__PURE__ */ jsx("span", { className: cn(
                       "inline-flex items-center rounded-full px-1.5 py-0.5 text-[10px] font-semibold tabular-nums",
-                      qty > 0 ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
-                    ), children: qty })
+                      qty2 > 0 ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
+                    ), children: qty2 })
                   ]
                 },
                 l.id
@@ -1163,7 +1252,7 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
           needsDest && /* @__PURE__ */ jsxs("div", { children: [
             /* @__PURE__ */ jsx("label", { className: "text-xs font-medium text-muted-foreground", children: t2("inventory.stock.toLocation") }),
             /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2 mt-1.5", children: sortedLocations.filter((l) => l.id !== locationId).map((l) => {
-              const qty = positionByLocation[l.id] ?? 0;
+              const qty2 = positionByLocation[l.id] ?? 0;
               return /* @__PURE__ */ jsxs(
                 "button",
                 {
@@ -1177,8 +1266,8 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
                     /* @__PURE__ */ jsx("span", { children: l.name }),
                     productId && /* @__PURE__ */ jsx("span", { className: cn(
                       "inline-flex items-center rounded-full px-1.5 py-0.5 text-[10px] font-semibold tabular-nums",
-                      qty > 0 ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
-                    ), children: qty })
+                      qty2 > 0 ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
+                    ), children: qty2 })
                   ]
                 },
                 l.id
@@ -1238,7 +1327,8 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
           ] })
         ] })
       ] }),
-      /* @__PURE__ */ jsxs("div", { className: "rounded-card border bg-card shadow-sm p-5 space-y-4", children: [
+      pending && /* @__PURE__ */ jsx("p", { role: "status", className: "text-sm text-warning", children: t2("inventory.stock.pendingRetry") }),
+      /* @__PURE__ */ jsxs("fieldset", { disabled: pending, className: "rounded-card border bg-card shadow-sm p-5 space-y-4", children: [
         /* @__PURE__ */ jsx("p", { className: "text-xs font-medium text-muted-foreground", children: t2("inventory.stock.additionalDetails") }),
         /* @__PURE__ */ jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [
           movementType === "entry" && /* @__PURE__ */ jsx(
@@ -1279,10 +1369,13 @@ function StockMovementView({ defaultType, onSaved, viewMovement }) {
         ] })
       ] }),
       /* @__PURE__ */ jsxs("div", { className: "flex justify-between", children: [
-        /* @__PURE__ */ jsx("button", { onClick: () => setStep(2), className: "rounded-lg border px-4 py-2 text-sm font-medium hover:bg-muted bg-card shadow-button active:shadow-button-inset transition-colors", children: t2("inventory.stock.back") }),
+        /* @__PURE__ */ jsx("button", { disabled: pending, onClick: () => {
+          if (!command.current.pending) setStep(2);
+        }, className: "rounded-lg border px-4 py-2 text-sm font-medium hover:bg-muted bg-card shadow-button active:shadow-button-inset transition-colors", children: t2("inventory.stock.back") }),
         /* @__PURE__ */ jsxs(
           "button",
           {
+            "data-tour": "inventory.entry-save",
             onClick: handleSave,
             disabled: saving,
             className: "inline-flex items-center gap-1.5 rounded-button bg-primary border border-primary px-5 py-2 text-sm font-medium text-primary-foreground hover:bg-primary/90 shadow-button-primary active:shadow-button-inset transition-colors disabled:opacity-50",
@@ -1336,9 +1429,30 @@ function MovementHistoryView({ onViewDetail, onNew, onNewExit } = {}) {
       cell: ({ getValue }) => /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: getValue() })
     },
     {
+      // O MOTIVO entra debaixo do produto, não como sétima coluna.
+      //
+      // É o campo central do razão do V1 — "nenhum movimento existe sem motivo"
+      // — e estava gravado e invisível: as entradas deste tenant carregam
+      // "Entrada via DANFE NF-e 10467692" desde a migração, que é a resposta
+      // exata para a pergunta nº 1 do usuário no V1 ("de onde vieram essas
+      // entradas que eu não lancei?"). Como legenda ele fica onde o olho já
+      // está, em vez de numa coluna a mais numa tabela que já tem seis.
       accessorKey: "productName",
       header: t2("inventory.history.columnProduct"),
-      cell: ({ getValue }) => /* @__PURE__ */ jsx("span", { className: "font-medium", children: getValue() ?? "\u2014" })
+      cell: ({ row }) => {
+        const reason = row.original.reason || void 0;
+        const doc = row.original.documentNumber || void 0;
+        const printableDoc = doc && !/^[0-9a-f-]{32,36}$/i.test(doc) ? doc : void 0;
+        const caption = reason ?? (printableDoc ? `Documento ${printableDoc}` : void 0);
+        return /* @__PURE__ */ jsxs("span", { className: "block", children: [
+          /* @__PURE__ */ jsx("span", { className: "block font-medium", children: row.original.productName ?? "\u2014" }),
+          caption ? /* @__PURE__ */ jsx("span", { className: "block truncate text-xs text-muted-foreground", title: caption, children: caption }) : (
+            // Movimento sem motivo é um buraco no razão, e o V1 não deixa
+            // criar um pela tela. Dizê-lo é o que faz alguém parar de criar.
+            /* @__PURE__ */ jsx("span", { className: "block text-xs italic text-muted-foreground", children: "Sem motivo registrado" })
+          )
+        ] });
+      }
     },
     {
       accessorKey: "movementType",
@@ -1372,7 +1486,25 @@ function MovementHistoryView({ onViewDetail, onNew, onNewExit } = {}) {
     {
       accessorKey: "totalCost",
       header: t2("inventory.history.columnTotal"),
-      cell: ({ getValue }) => /* @__PURE__ */ jsx("span", { className: "text-right block text-muted-foreground", children: formatCurrency(getValue(), currency) })
+      // Custo é OPCIONAL na entrada, e o V1 documenta o beco que isso abre: o
+      // saldo de quantidade sobe, o valor do estoque não, e o "Valor Total" da
+      // visão geral se descola da realidade sem ninguém errar nada. "R$ 0,00"
+      // esconde isso atrás de um número; o travessão com a explicação no hover
+      // diz que o movimento entrou sem valor — que é o fato.
+      cell: ({ getValue }) => {
+        const n = Number(getValue());
+        if (!Number.isFinite(n) || n === 0) {
+          return /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: "block text-right text-muted-foreground",
+              title: "Movimento registrado sem custo: o saldo mudou, o valor do estoque n\xE3o",
+              children: "\u2014"
+            }
+          );
+        }
+        return /* @__PURE__ */ jsx("span", { className: "block text-right text-muted-foreground", children: formatCurrency(n, currency) });
+      }
     }
   ], [currency, t2]);
   return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
@@ -1705,6 +1837,15 @@ function StockCountSessionView({ sessionId, onBack }) {
       setConfirmingClose(false);
     }
   }
+  function requestClose() {
+    if (summary.uncounted > 0) {
+      toast.error(t2("inventory.counts.incomplete"), {
+        description: t2("inventory.counts.incompleteDescription", { count: String(summary.uncounted) })
+      });
+      return;
+    }
+    setConfirmingClose(true);
+  }
   async function handleCancel() {
     try {
       await provider.cancelCountSession(sessionId);
@@ -1770,7 +1911,7 @@ function StockCountSessionView({ sessionId, onBack }) {
       ] }),
       !closed && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
         /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: () => setConfirmingCancel(true), children: t2("inventory.counts.cancelCount") }),
-        /* @__PURE__ */ jsx(Button, { size: "sm", onClick: () => setConfirmingClose(true), children: t2("inventory.counts.close") })
+        /* @__PURE__ */ jsx(Button, { size: "sm", onClick: requestClose, children: t2("inventory.counts.close") })
       ] })
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "rounded-card border bg-card shadow-sm divide-y", children: [
@@ -1816,10 +1957,7 @@ function StockCountSessionView({ sessionId, onBack }) {
       {
         open: confirmingClose,
         title: t2("inventory.counts.closeTitle"),
-        description: t2("inventory.counts.closeDescription", {
-          divergent: String(summary.divergent),
-          uncounted: String(summary.uncounted)
-        }),
+        description: t2("inventory.counts.closeDescription", { divergent: String(summary.divergent) }),
         confirmLabel: t2("inventory.counts.closeConfirm"),
         cancelLabel: t2("inventory.counts.cancel"),
         loading: closing,
@@ -3159,22 +3297,36 @@ function buildNav(config, view, navigate, t2) {
       icon: "Package",
       active: view.startsWith("products"),
       children: [
-        { id: "products-new", label: t2("inventory.nav.new"), active: view === "products-new", onClick: () => navigate("products-new") },
+        { id: "products-new", kind: "action", label: t2("inventory.nav.new"), active: view === "products-new", onClick: () => navigate("products-new") },
         { id: "products-list", label: t2("inventory.nav.list"), active: view === "products-list" || view.startsWith("products-detail:") || view.startsWith("products-stock:"), onClick: () => navigate("products-list") }
       ]
     }] : [],
+    // Movimentações é UMA tela: o que entrou e o que saiu. A pílula "Histórico"
+    // ao lado da aba repetia o nome da própria aba (e o título da página já diz
+    // "Histórico de Estoque"), então a aba passa a SER o destino — filha única
+    // não desenha controle.
     {
       id: "stock",
       label: t2("inventory.nav.stock"),
       icon: "ArrowUpCircle",
       children: [
-        { id: "stock-entry", label: t2("inventory.nav.entry"), active: view === "stock-entry", onClick: () => navigate("stock-entry") },
-        { id: "stock-exit", label: t2("inventory.nav.exit"), active: view === "stock-exit", onClick: () => navigate("stock-exit") },
-        // Before History on purpose: the parent tab flattens to the LAST child,
-        // and "Stock" has always landed on History.
-        { id: "stock-counts", label: t2("inventory.nav.counts"), active: view === "stock-counts" || view.startsWith("stock-counts"), onClick: () => navigate("stock-counts") },
-        { id: "stock-usage-audit", label: t2("inventory.nav.usageAudit"), active: view === "stock-usage-audit", onClick: () => navigate("stock-usage-audit") },
-        { id: "stock-history", label: t2("inventory.nav.history"), active: view === "stock-history", onClick: () => navigate("stock-history") }
+        { id: "stock-entry", kind: "action", label: t2("inventory.nav.entry"), active: view === "stock-entry", onClick: () => navigate("stock-entry") },
+        { id: "stock-exit", kind: "action", label: t2("inventory.nav.exit"), active: view === "stock-exit", onClick: () => navigate("stock-exit") },
+        { id: "stock-history", label: t2("inventory.nav.history"), defaultChild: true, active: view === "stock-history", onClick: () => navigate("stock-history") }
+      ]
+    },
+    // Inventário — conferir o que o sistema diz contra o que existe na
+    // prateleira. Contagem e auditoria de uso respondem à mesma pergunta por
+    // dois caminhos (contar e comparar consumo), e nenhuma das duas é uma
+    // movimentação: viviam como pílula de Movimentações e ninguém as achava.
+    {
+      id: "inventory-check",
+      label: t2("inventory.nav.inventory"),
+      icon: "ClipboardCheck",
+      children: [
+        { id: "stock-counts-new", kind: "action", label: t2("inventory.nav.new"), active: view === "stock-counts-new", onClick: () => navigate("stock-counts-new") },
+        { id: "stock-counts", label: t2("inventory.nav.counts"), defaultChild: true, active: view === "stock-counts" || view.startsWith("stock-counts"), onClick: () => navigate("stock-counts") },
+        { id: "stock-usage-audit", label: t2("inventory.nav.usageAudit"), active: view === "stock-usage-audit", onClick: () => navigate("stock-usage-audit") }
       ]
     }
   ];
@@ -3185,7 +3337,7 @@ function buildNav(config, view, navigate, t2) {
       icon: "BookOpen",
       children: [
         { id: "recipes-list", label: config.labels.recipesList, active: view === "recipes-list" || view.startsWith("recipes-detail:"), onClick: () => navigate("recipes-list") },
-        { id: "recipes-new", label: config.labels.recipesNew, active: view === "recipes-new", onClick: () => navigate("recipes-new") }
+        { id: "recipes-new", kind: "action", label: config.labels.recipesNew, active: view === "recipes-new", onClick: () => navigate("recipes-new") }
       ]
     });
   }
@@ -3389,6 +3541,120 @@ function RecentActivityPanel() {
     ] })
   ] });
 }
+function NoMinimumKpi() {
+  const summary = useInventoryStore((s) => s.summary);
+  useEnsureSummary();
+  const n = summary?.noMinimumCount ?? 0;
+  return /* @__PURE__ */ jsx(
+    KpiCard,
+    {
+      label: "Sem m\xEDnimo definido",
+      icon: "AlertTriangle",
+      value: String(n),
+      sub: n > 0 ? "N\xE3o entram no alerta de estoque baixo" : "Todo produto tem m\xEDnimo"
+    }
+  );
+}
+function RestockRowSkeleton() {
+  return /* @__PURE__ */ jsx("ul", { className: "space-y-2", children: [0, 1, 2].map((i) => /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-3", children: [
+    /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-40" }),
+    /* @__PURE__ */ jsx("span", { className: "flex-1" }),
+    /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-16" })
+  ] }, i)) });
+}
+function qty(value, unit) {
+  const n = value.toLocaleString("pt-BR", { maximumFractionDigits: 3 });
+  return unit ? `${n} ${unit}` : n;
+}
+function RestockPanel() {
+  const rows = useInventoryStore((s) => s.restock);
+  const summary = useInventoryStore((s) => s.summary);
+  const fetchRestock = useInventoryStore((s) => s.fetchRestock);
+  useEnsureSummary();
+  useEffect(() => {
+    void fetchRestock();
+  }, []);
+  const belowMinimum = (rows ?? []).filter((r) => r.reason === "below-minimum");
+  const outOfStock = (rows ?? []).filter((r) => r.reason === "out-of-stock");
+  const noMinimum = summary?.noMinimumCount ?? 0;
+  const total = summary?.totalProducts ?? 0;
+  const nobodyHasMinimum = total > 0 && noMinimum === total;
+  return /* @__PURE__ */ jsxs(Card, { children: [
+    /* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsx(CardTitle, { children: "Precisa de reposi\xE7\xE3o" }) }),
+    /* @__PURE__ */ jsx(CardContent, { children: rows === null ? /* @__PURE__ */ jsx(RestockRowSkeleton, {}) : nobodyHasMinimum ? (
+      // Sem nenhum mínimo cadastrado esta lista não é um alerta: é o
+      // catálogo inteiro. Dizer o que falta vale mais do que listá-lo.
+      /* @__PURE__ */ jsxs("div", { className: "text-sm", children: [
+        /* @__PURE__ */ jsx("p", { className: "font-medium", children: "Nenhum produto tem estoque m\xEDnimo definido." }),
+        /* @__PURE__ */ jsxs("p", { className: "mt-1 text-muted-foreground", children: [
+          "Sem o m\xEDnimo na ficha do produto n\xE3o h\xE1 reposi\xE7\xE3o a calcular \u2014 o alerta de estoque baixo fica em zero mesmo com o dep\xF3sito vazio.",
+          (summary?.outOfStockCount ?? 0) > 0 && ` Hoje ${summary.outOfStockCount === 1 ? "h\xE1 1 produto" : `h\xE1 ${summary.outOfStockCount} produtos`} com saldo zerado.`
+        ] })
+      ] })
+    ) : rows.length === 0 ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Nada a repor: todo produto est\xE1 acima do m\xEDnimo." }) : /* @__PURE__ */ jsx("ul", { className: "space-y-2", children: [...belowMinimum, ...outOfStock].slice(0, 8).map((row) => /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-3 text-sm", children: [
+      /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
+        /* @__PURE__ */ jsx("span", { className: "block truncate", children: row.name }),
+        row.categoryName && /* @__PURE__ */ jsx("span", { className: "block truncate text-xs text-muted-foreground", children: row.categoryName })
+      ] }),
+      row.reason === "below-minimum" ? /* @__PURE__ */ jsxs(Badge, { variant: "secondary", className: "gap-1 shrink-0", children: [
+        /* @__PURE__ */ jsx(AlertTriangle, { className: "h-3 w-3", "aria-hidden": "true" }),
+        qty(row.currentQuantity, row.unit),
+        " de ",
+        qty(row.minQuantity, row.unit)
+      ] }) : /* @__PURE__ */ jsxs(Badge, { variant: "outline", className: "gap-1 shrink-0", children: [
+        /* @__PURE__ */ jsx(PackageX, { className: "h-3 w-3", "aria-hidden": "true" }),
+        "Sem estoque"
+      ] })
+    ] }, row.productId)) }) })
+  ] });
+}
+function CategoryMixPanel() {
+  const mix = useInventoryStore((s) => s.categoryMix);
+  const fetchMix = useInventoryStore((s) => s.fetchCategoryMix);
+  useEffect(() => {
+    void fetchMix();
+  }, []);
+  const total = (mix ?? []).reduce((sum, c) => sum + c.count, 0);
+  const uncategorized = (mix ?? []).find((c) => c.categoryId === null);
+  return /* @__PURE__ */ jsxs(Card, { children: [
+    /* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsx(CardTitle, { children: "Produtos por categoria" }) }),
+    /* @__PURE__ */ jsx(CardContent, { children: mix === null ? /* @__PURE__ */ jsx(RestockRowSkeleton, {}) : total === 0 ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Nenhum produto ativo para distribuir." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("ul", { className: "space-y-2", children: mix.slice(0, 8).map((row) => {
+        const pct = Math.round(row.count / total * 100);
+        const isGap = row.categoryId === null;
+        return /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-3 text-sm", children: [
+          /* @__PURE__ */ jsx("span", { className: "w-40 shrink-0 truncate", title: row.name, children: row.name }),
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: "relative h-2 flex-1 overflow-hidden rounded-full bg-muted",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: isGap ? "absolute inset-y-0 left-0 rounded-full bg-muted-foreground/60" : "absolute inset-y-0 left-0 rounded-full bg-primary",
+                  style: { width: `${pct}%` }
+                }
+              )
+            }
+          ),
+          /* @__PURE__ */ jsxs("span", { className: "w-20 shrink-0 text-right tabular-nums text-muted-foreground", children: [
+            row.count,
+            " \xB7 ",
+            pct,
+            "%"
+          ] })
+        ] }, row.categoryId ?? "none");
+      }) }),
+      uncategorized && uncategorized.count > 0 && /* @__PURE__ */ jsxs("p", { className: "mt-3 text-xs text-muted-foreground", children: [
+        uncategorized.count,
+        " de ",
+        total,
+        " produtos ainda n\xE3o t\xEAm categoria \u2014 \xE9 o que impede este painel, os filtros e as isen\xE7\xF5es de taxa de dizerem algo \xFAtil."
+      ] })
+    ] }) })
+  ] });
+}
 function createInventoryDashboardWidgets(ctx2) {
   const withCtx = (Inner) => {
     const Wrapped = () => /* @__PURE__ */ jsx(InventoryContextProvider, { config: ctx2.config, provider: ctx2.provider, store: ctx2.store, children: /* @__PURE__ */ jsx(Inner, {}) });
@@ -3402,7 +3668,12 @@ function createInventoryDashboardWidgets(ctx2) {
     defineKpiWidget({ id: "inventory.kpi.total-products", title: "inventory.dashboard.totalProducts", domain: "inventory", defaultOrder: 1, defaultVisible: false, component: withCtx(TotalProductsKpi) }),
     defineKpiWidget({ id: "inventory.kpi.low-stock", title: "inventory.dashboard.lowStock", domain: "inventory", defaultOrder: 2, defaultVisible: false, component: withCtx(LowStockKpi) }),
     defineKpiWidget({ id: "inventory.kpi.out-of-stock", title: "inventory.dashboard.outOfStock", domain: "inventory", defaultOrder: 3, defaultVisible: false, component: withCtx(OutOfStockKpi) }),
-    defineCustomWidget({ id: "inventory.panel.recent-activity", title: "inventory.dashboard.recentActivity", domain: "inventory", span: 2, defaultOrder: 10, surfaces: ["plugin-home"], component: withCtx(RecentActivityPanel) })
+    // Escondido na home global (é diagnóstico de cadastro, não manchete do
+    // negócio) e visível no painel do estoque, que é onde se conserta.
+    defineKpiWidget({ id: "inventory.kpi.no-minimum", title: "Sem m\xEDnimo definido", domain: "inventory", defaultOrder: 4, defaultVisible: false, component: withCtx(NoMinimumKpi) }),
+    defineCustomWidget({ id: "inventory.panel.recent-activity", title: "inventory.dashboard.recentActivity", domain: "inventory", span: 2, defaultOrder: 10, surfaces: ["plugin-home"], component: withCtx(RecentActivityPanel) }),
+    defineCustomWidget({ id: "inventory.panel.restock", title: "Precisa de reposi\xE7\xE3o", domain: "inventory", span: 2, defaultOrder: 11, surfaces: ["plugin-home"], component: withCtx(RestockPanel) }),
+    defineCustomWidget({ id: "inventory.panel.category-mix", title: "Produtos por categoria", domain: "inventory", span: 2, defaultOrder: 12, surfaces: ["plugin-home"], component: withCtx(CategoryMixPanel) })
   ];
 }
 
@@ -3445,6 +3716,7 @@ function createStore() {
 function createMockInventoryProvider() {
   const store = createStore();
   const tenantId = "mock-tenant";
+  const countMovementWatermarks = /* @__PURE__ */ new Map();
   function withProduct(recipe) {
     const product = store.products.find((p) => p.id === recipe.productId);
     return { ...recipe, productName: product?.name ?? recipe.productName, productSalePrice: product?.salePrice };
@@ -3732,6 +4004,7 @@ function createMockInventoryProvider() {
         updatedAt: now()
       };
       store.countSessions.push(session);
+      countMovementWatermarks.set(session.id, new Set(store.movements.map((movement) => movement.id)));
       for (const product of store.products) {
         if (!product.isActive || product.productType === "asset") continue;
         if (input.categoryId && product.categoryId !== input.categoryId) continue;
@@ -3771,20 +4044,37 @@ function createMockInventoryProvider() {
         return { sessionId, adjustmentsCreated: 0, alreadyClosed: true };
       }
       if (session.status === "cancelled") throw new Error("This count was cancelled");
+      const sessionItems = store.countItems.filter((item) => item.sessionId === sessionId);
+      const uncounted = sessionItems.filter((item) => item.countedQuantity === void 0);
+      if (uncounted.length > 0) {
+        throw new Error(`Count every line before closing (${uncounted.length} uncounted)`);
+      }
+      const movementWatermark = countMovementWatermarks.get(sessionId) ?? /* @__PURE__ */ new Set();
+      const changedAfterOpening = store.movements.some(
+        (movement) => !movementWatermark.has(movement.id) && sessionItems.some((item) => item.productId === movement.productId) && (movement.stockLocationId === session.stockLocationId || movement.destinationLocationId === session.stockLocationId)
+      );
+      if (changedAfterOpening) {
+        throw new Error("Stock changed after this count opened; review and recount");
+      }
       let emitted = 0;
-      for (const item of store.countItems) {
-        if (item.sessionId !== sessionId) continue;
+      for (const item of sessionItems) {
         if (!isDivergent(item) || item.movementId) continue;
         const counted = item.countedQuantity;
         const delta = counted - item.systemQuantity;
+        const hasBatchStock = store.positions.some(
+          (position) => position.productId === item.productId && position.stockLocationId === session.stockLocationId && position.quantity !== 0 && Boolean(position.batchNumber || position.expirationDate)
+        );
+        if (hasBatchStock) {
+          throw new Error(`Product ${item.productId} has batch stock; use a batch-aware count`);
+        }
         const movement = {
           id: uid(),
           productId: item.productId,
           productName: item.productName,
-          quantity: counted,
+          quantity: delta,
           movementType: "adjustment",
           unitCost: item.unitCost,
-          totalCost: item.unitCost * counted,
+          totalCost: item.unitCost * Math.abs(delta),
           stockLocationId: session.stockLocationId,
           stockLocationName: session.stockLocationName,
           reason: reason || "Stock count",
@@ -3813,6 +4103,7 @@ function createMockInventoryProvider() {
       session.status = "closed";
       session.closedAt = now();
       session.updatedAt = now();
+      countMovementWatermarks.delete(sessionId);
       return { sessionId, adjustmentsCreated: emitted, alreadyClosed: false };
     },
     async cancelCountSession(sessionId) {
@@ -3821,6 +4112,7 @@ function createMockInventoryProvider() {
       if (session.status === "closed") throw new Error("A closed count cannot be cancelled");
       session.status = "cancelled";
       session.updatedAt = now();
+      countMovementWatermarks.delete(sessionId);
       return session;
     },
     // --- Recipes ---
@@ -4024,7 +4316,8 @@ function createMockInventoryProvider() {
         outOfStockCount: outOfStock.length,
         totalStockValue: totalValue,
         recentMovementCount: recent.length,
-        movementsByType
+        movementsByType,
+        noMinimumCount: active.filter((p) => !(p.minQuantity > 0)).length
       };
     }
   };
@@ -4563,6 +4856,7 @@ function createSupabaseInventoryProvider() {
       if (!locationId) {
         throw new Error("inventory: this tenant has no stock location to record the movement against");
       }
+      const idempotencyKey = input.idempotencyKey ?? createIdempotencyKey(`inventory:${kind}`);
       const { data: opResult, error } = kind === "in" ? await pub.rpc("inventory_receive", {
         p_location: locationId,
         p_lines: [line],
@@ -4571,32 +4865,37 @@ function createSupabaseInventoryProvider() {
           ...input.documentNumber ? { ref: input.documentNumber } : {},
           ...input.supplierId ? { supplier_id: input.supplierId } : {},
           ...input.movementDate ? { date: input.movementDate } : {}
-        }
+        },
+        p_idempotency_key: idempotencyKey
       }) : await pub.rpc("inventory_adjust", {
         p_location: locationId,
         p_lines: [line],
         // The ledger refuses an adjustment with no reason, and the verb is one
         // when the user did not type another.
-        p_reason: input.reason ?? input.movementType
+        p_reason: input.reason ?? input.movementType,
+        p_idempotency_key: idempotencyKey
       });
-      if (error) throw new Error(error.message);
+      if (error) throw error;
       const written = opResult?.movements?.[0];
       if (!written) throw new Error("inventory: the ledger accepted the operation but returned no movement");
       const data = { ...written, tenant_id: tenantId, movement_type: input.movementType };
-      const { data: product } = await core.from(PRODUCTS_READ).select("id, name, stock").eq("id", input.productId).single();
       const movement = snakeToCamel(data);
-      movement.productName = product?.name;
-      if (input.stockLocationId) {
-        const { data: loc } = await pub.from(T.stockLocations).select("name").eq("id", input.stockLocationId).single();
-        movement.stockLocationName = loc?.name;
-      }
-      if (input.destinationLocationId) {
-        const { data: loc } = await pub.from(T.stockLocations).select("name").eq("id", input.destinationLocationId).single();
-        movement.destinationLocationName = loc?.name;
-      }
-      if (input.supplierId) {
-        const { data: supplier } = await core.from("people").select("name").eq("id", input.supplierId).single();
-        movement.supplierName = supplier?.name;
+      try {
+        const { data: product } = await core.from(PRODUCTS_READ).select("id, name, stock").eq("id", input.productId).single();
+        movement.productName = product?.name;
+        if (input.stockLocationId) {
+          const { data: loc } = await pub.from(T.stockLocations).select("name").eq("id", input.stockLocationId).single();
+          movement.stockLocationName = loc?.name;
+        }
+        if (input.destinationLocationId) {
+          const { data: loc } = await pub.from(T.stockLocations).select("name").eq("id", input.destinationLocationId).single();
+          movement.destinationLocationName = loc?.name;
+        }
+        if (input.supplierId) {
+          const { data: supplier } = await core.from("people").select("name").eq("id", input.supplierId).single();
+          movement.supplierName = supplier?.name;
+        }
+      } catch {
       }
       return movement;
     },
@@ -5060,8 +5359,58 @@ function createSupabaseInventoryProvider() {
         outOfStockCount: outOfStock.length,
         totalStockValue: totalValue,
         recentMovementCount: movs.length,
-        movementsByType
+        movementsByType,
+        // `> 0`, não `!= null`: mínimo zero é o mesmo que não ter mínimo — é
+        // dele que sai o alerta que nunca dispara.
+        noMinimumCount: items.filter((p) => !(Number(p.min_stock) > 0)).length
       };
+    },
+    async getRestockList(limit = 50) {
+      const { core, pub } = getClients();
+      const { data } = await core.from(PRODUCTS_READ).select("id, name, category_id, stock, min_stock, unit").eq("is_active", true);
+      const rows = data ?? [];
+      const needs = rows.map((r) => ({
+        productId: r.id,
+        name: r.name,
+        categoryId: r.category_id,
+        currentQuantity: Number(r.stock) || 0,
+        minQuantity: Number(r.min_stock) || 0,
+        unit: r.unit ?? void 0
+      })).filter((r) => r.currentQuantity <= 0 || r.minQuantity > 0 && r.currentQuantity <= r.minQuantity).sort((a, b) => {
+        const rank = (x) => x.minQuantity > 0 && x.currentQuantity > 0 ? 0 : 1;
+        return rank(a) - rank(b) || a.name.localeCompare(b.name, "pt-BR");
+      }).slice(0, limit);
+      const catIds = [...new Set(needs.map((n) => n.categoryId).filter(Boolean))];
+      const names = /* @__PURE__ */ new Map();
+      if (catIds.length) {
+        const { data: cats } = await pub.from("categories").select("id, name").in("id", catIds);
+        for (const c of cats ?? []) names.set(c.id, c.name);
+      }
+      return needs.map(({ categoryId, ...rest }) => ({
+        ...rest,
+        categoryName: categoryId ? names.get(categoryId) : void 0,
+        reason: rest.currentQuantity <= 0 ? "out-of-stock" : "below-minimum"
+      }));
+    },
+    async getCategoryDistribution() {
+      const { core, pub } = getClients();
+      const { data } = await core.from(PRODUCTS_READ).select("category_id").eq("is_active", true);
+      const rows = data ?? [];
+      const tally = /* @__PURE__ */ new Map();
+      for (const r of rows) tally.set(r.category_id ?? null, (tally.get(r.category_id ?? null) ?? 0) + 1);
+      const ids = [...tally.keys()].filter(Boolean);
+      const names = /* @__PURE__ */ new Map();
+      if (ids.length) {
+        const { data: cats } = await pub.from("categories").select("id, name").in("id", ids);
+        for (const c of cats ?? []) names.set(c.id, c.name);
+      }
+      return [...tally.entries()].map(([categoryId, count]) => ({
+        categoryId,
+        // "Sem categoria" é uma resposta, não um buraco: é o que diz ao dono
+        // que o cadastro está incompleto. Esconder o balde esconderia isso.
+        name: categoryId ? names.get(categoryId) ?? "Categoria removida" : "Sem categoria",
+        count
+      })).sort((a, b) => b.count - a.count);
     }
   };
   return provider;
@@ -5085,6 +5434,28 @@ function createInventoryStore(provider) {
     recipesLoading: false,
     summary: null,
     summaryLoading: false,
+    restock: null,
+    categoryMix: null,
+    async fetchRestock() {
+      if (!provider.getRestockList) return;
+      return dedup("inv:restock", async () => {
+        try {
+          set({ restock: await provider.getRestockList() });
+        } catch {
+          set({ restock: [] });
+        }
+      });
+    },
+    async fetchCategoryMix() {
+      if (!provider.getCategoryDistribution) return;
+      return dedup("inv:category-mix", async () => {
+        try {
+          set({ categoryMix: await provider.getCategoryDistribution() });
+        } catch {
+          set({ categoryMix: [] });
+        }
+      });
+    },
     async fetchSummary() {
       return dedup("inv:summary", async () => {
         set({ summaryLoading: true });
@@ -5162,16 +5533,20 @@ function createInventoryStore(provider) {
       }
     },
     async createMovement(input) {
+      let movement;
       try {
-        const movement = await provider.createMovement(input);
-        const [summary] = await Promise.all([provider.getSummary()]);
-        set({ summary });
-        toast.success("Stock movement recorded");
-        return movement;
+        movement = await provider.createMovement(input);
       } catch (err) {
         toast.error("Failed to record movement", { description: err?.message });
         throw err;
       }
+      try {
+        set({ summary: await provider.getSummary() });
+        toast.success("Stock movement recorded");
+      } catch {
+        toast.warning("Stock movement recorded; refresh the list to see the updated balance");
+      }
+      return movement;
     },
     async createRecipe(input) {
       try {
@@ -5350,8 +5725,12 @@ var products = {
       check: "existe pelo menos um local \u2014 \xE9 onde o saldo vai morar"
     }
   ],
+  // O tour navega até o cadastro de produto; os passos sem âncora ficam de
+  // briefing (a tela é um CRUD genérico, sem campos ancoráveis por enquanto).
   steps: [
-    { do: "Estoque \u203A Produtos \u203A Novo.", route: "/inventory/products/new" },
+    { do: "O Estoque mora aqui.", anchor: "nav./inventory", route: "/inventory" },
+    { do: "Produtos ficam neste menu.", anchor: "modnav.products", route: "/inventory/products/list" },
+    { do: "Cadastre um produto novo aqui.", anchor: "action.new-product", route: "/inventory/products/list" },
     {
       do: "Escolha a unidade em que voc\xEA CONTA o produto, n\xE3o a que o fornecedor vende.",
       why: "Se voc\xEA conta ampolas e ele vende caixa, o produto \xE9 em ampola \u2014 a convers\xE3o \xE9 problema da entrada."
@@ -5389,10 +5768,16 @@ var movements = {
       check: "o movimento pede um local e existe op\xE7\xE3o"
     }
   ],
+  // Navega até a tela de entrada; a `practice` deixa a pessoa dar a entrada.
   steps: [
-    { do: "Estoque \u203A Movimenta\xE7\xF5es \u203A Entrada para a compra que chegou.", route: "/inventory/stock/entry" },
-    { do: "Sa\xEDda para o que foi descartado, perdido ou usado fora de um atendimento.", route: "/inventory/stock/exit" },
-    { do: "O hist\xF3rico mostra tudo, inclusive o que o sistema lan\xE7ou sozinho.", route: "/inventory/stock/history" }
+    { do: "O Estoque mora aqui.", anchor: "nav./inventory", route: "/inventory" },
+    { do: "Abra Entrada neste menu para lan\xE7ar a compra que chegou.", anchor: "modnav.stock-entry", route: "/inventory/stock/entry" },
+    { do: "Sa\xEDda \xE9 para o que foi descartado, perdido ou usado fora de um atendimento." },
+    { do: "O hist\xF3rico mostra tudo, inclusive o que o sistema lan\xE7ou sozinho." }
+  ],
+  practice: [
+    { anchor: "inventory.entry-product", label: "Escolha o produto que chegou" },
+    { anchor: "inventory.entry-save", label: "Confirme a entrada", final: true }
   ],
   rules: [
     "O raz\xE3o \xE9 append-only: nada \xE9 apagado. Corrigir \xE9 lan\xE7ar o movimento contr\xE1rio \u2014 e o hist\xF3rico guarda os dois.",
@@ -5570,6 +5955,8 @@ function buildInventoryOnboarding() {
 
 // src/locales/en.ts
 var en = {
+  "inventory.stock.pendingRetry": "Confirmation is pending. Do not create another entry. Retry the same details before leaving this screen.",
+  "inventory.stock.refreshAfterCommit": "Movement recorded. Refresh the screen to see the balance.",
   "inventory.dashboard.activeItems": "Active items",
   "inventory.dashboard.belowMinimum": "Below minimum",
   "inventory.dashboard.entries": "Entries:",
@@ -5609,10 +5996,11 @@ var en = {
   "inventory.nav.entry": "Entry",
   "inventory.nav.exit": "Exit",
   "inventory.nav.history": "History",
+  "inventory.nav.inventory": "Inventory",
   "inventory.nav.list": "List",
   "inventory.nav.new": "New",
   "inventory.nav.products": "Products",
-  "inventory.nav.stock": "Stock",
+  "inventory.nav.stock": "Movements",
   "inventory.page.newProduct": "New Product",
   "inventory.page.newProductDesc": "Add a product to your catalog",
   "inventory.page.settingsSubtitle": "Preferences, suppliers, categories, and units",
@@ -5957,7 +6345,9 @@ var en = {
   "inventory.counts.saveFailed": "Could not save this line",
   "inventory.counts.close": "Close the count",
   "inventory.counts.closeTitle": "Close the count?",
-  "inventory.counts.closeDescription": "{{divergent}} line(s) differ from the system and will get an adjustment. {{uncounted}} line(s) were never counted and are left exactly as they are.",
+  "inventory.counts.closeDescription": "{{divergent}} line(s) differ from the system and will get an adjustment.",
+  "inventory.counts.incomplete": "Finish the count before closing",
+  "inventory.counts.incompleteDescription": "{{count}} line(s) are still blank. Enter zero when the item is physically out of stock.",
   "inventory.counts.closeConfirm": "Close and adjust",
   "inventory.counts.closed": "Count closed \u2014 {{count}} adjustment(s) recorded",
   "inventory.counts.alreadyClosed": "This count was already closed",
@@ -6018,6 +6408,8 @@ var en = {
 
 // src/locales/pt-BR.ts
 var ptBR = {
+  "inventory.stock.pendingRetry": "A confirma\xE7\xE3o ainda est\xE1 pendente. N\xE3o fa\xE7a outro lan\xE7amento. Tente novamente com os mesmos dados antes de sair desta tela.",
+  "inventory.stock.refreshAfterCommit": "Movimento registrado. Atualize a tela para consultar o saldo.",
   "inventory.dashboard.activeItems": "Itens ativos",
   "inventory.dashboard.belowMinimum": "Abaixo do m\xEDnimo",
   "inventory.dashboard.entries": "Entradas:",
@@ -6057,10 +6449,11 @@ var ptBR = {
   "inventory.nav.entry": "Entrada",
   "inventory.nav.exit": "Sa\xEDda",
   "inventory.nav.history": "Hist\xF3rico",
+  "inventory.nav.inventory": "Invent\xE1rio",
   "inventory.nav.list": "Lista",
   "inventory.nav.new": "Novo",
   "inventory.nav.products": "Produtos",
-  "inventory.nav.stock": "Estoque",
+  "inventory.nav.stock": "Movimenta\xE7\xF5es",
   "inventory.page.newProduct": "Novo Produto",
   "inventory.page.newProductDesc": "Adicionar um produto ao seu cat\xE1logo",
   "inventory.page.settingsSubtitle": "Prefer\xEAncias, fornecedores, categorias e unidades",
@@ -6405,7 +6798,9 @@ var ptBR = {
   "inventory.counts.saveFailed": "N\xE3o foi poss\xEDvel salvar esta linha",
   "inventory.counts.close": "Fechar a contagem",
   "inventory.counts.closeTitle": "Fechar a contagem?",
-  "inventory.counts.closeDescription": "{{divergent}} linha(s) divergem do sistema e v\xE3o receber um ajuste. {{uncounted}} linha(s) ningu\xE9m contou e ficam exatamente como est\xE3o.",
+  "inventory.counts.closeDescription": "{{divergent}} linha(s) divergem do sistema e v\xE3o receber um ajuste.",
+  "inventory.counts.incomplete": "Finalize a contagem antes de fechar",
+  "inventory.counts.incompleteDescription": "Ainda existem {{count}} linha(s) em branco. Informe zero quando o item acabou fisicamente.",
   "inventory.counts.closeConfirm": "Fechar e ajustar",
   "inventory.counts.closed": "Contagem fechada \u2014 {{count}} ajuste(s) lan\xE7ado(s)",
   "inventory.counts.alreadyClosed": "Esta contagem j\xE1 estava fechada",
@@ -10584,10 +10979,175 @@ REVOKE ALL ON FUNCTION public.inventory_correct_usage_batch(text, jsonb) FROM PU
 GRANT ALL ON FUNCTION public.inventory_correct_usage_batch(text, jsonb) TO authenticated;
 GRANT ALL ON FUNCTION public.inventory_correct_usage_batch(text, jsonb) TO service_role;
 `;
+var MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER = `-- 003_stock_count_closes_through_ledger.sql
+--
+-- A physical count is a reconciliation, not a second stock writer. The old
+-- function inserted values into GENERATED columns, recorded the counted total
+-- instead of the variance and then updated the position a second time outside
+-- the ledger trigger. This replacement emits one canonical \`adjust\` movement
+-- per divergent line and lets the existing movement trigger update the balance.
+--
+-- Safety gates: every line must be counted (zero is valid); any stock movement
+-- after the opening snapshot aborts the close; lot stock requires a future
+-- batch-aware count instead of guessing which lot changed.
+
+CREATE OR REPLACE FUNCTION public.inventory_close_count_session(p_session_id uuid, p_reason text DEFAULT NULL::text) RETURNS jsonb
+    LANGUAGE plpgsql SECURITY DEFINER
+    SET search_path TO ''
+    AS $$
+DECLARE
+  v_tenant uuid := app.inventory_require_tenant();
+  v_session public.plg_inventory_count_sessions%ROWTYPE;
+  v_item public.plg_inventory_count_items%ROWTYPE;
+  v_op record;
+  v_delta numeric;
+  v_current numeric;
+  v_current_cost numeric;
+  v_has_lots boolean;
+  v_movement_id uuid;
+  v_reason text;
+  v_key text := 'count:' || p_session_id::text || ':close:v1';
+  v_line_no int := 0;
+  v_uncounted int;
+  v_conflicts int;
+  v_emitted int := 0;
+  v_movements jsonb := '[]'::jsonb;
+  v_positions jsonb := '[]'::jsonb;
+  v_result jsonb;
+BEGIN
+  SELECT * INTO v_session FROM public.plg_inventory_count_sessions
+   WHERE id = p_session_id AND tenant_id = v_tenant FOR UPDATE;
+  IF NOT FOUND THEN
+    RETURN jsonb_build_object('ok', false, 'error', 'unknown count session');
+  END IF;
+  PERFORM app.inventory_authorize_location(v_tenant, v_session.stock_location_id, 'inventory.edit');
+
+  IF v_session.status = 'closed' THEN
+    RETURN jsonb_build_object('ok', true, 'session_id', p_session_id,
+      'status', 'closed', 'already_closed', true, 'adjustments_created', 0);
+  END IF;
+  IF v_session.status = 'cancelled' THEN
+    RETURN jsonb_build_object('ok', false, 'error', 'this count was cancelled');
+  END IF;
+
+  v_reason := COALESCE(NULLIF(btrim(COALESCE(p_reason, '')), ''), 'Stock count');
+
+  SELECT count(*) INTO v_uncounted
+    FROM public.plg_inventory_count_items i
+   WHERE i.session_id = p_session_id AND i.counted_quantity IS NULL;
+  IF v_uncounted > 0 THEN
+    RAISE EXCEPTION 'inventory: count session has % uncounted line(s)', v_uncounted
+      USING ERRCODE = '22023', HINT = 'Count every line, including physical zero, before closing.';
+  END IF;
+
+  PERFORM p.id
+    FROM public.plg_inventory_stock_positions p
+    JOIN public.plg_inventory_count_items i
+      ON i.tenant_id = p.tenant_id AND i.product_id = p.product_id
+   WHERE i.session_id = p_session_id
+     AND p.stock_location_id = v_session.stock_location_id
+   ORDER BY p.id
+   FOR UPDATE OF p;
+
+  SELECT count(DISTINCT i.id) INTO v_conflicts
+    FROM public.plg_inventory_count_items i
+    JOIN public.plg_inventory_stock_movements m
+      ON m.tenant_id = i.tenant_id
+     AND m.product_id = i.product_id
+     AND (m.source_location_id = v_session.stock_location_id
+       OR m.destination_location_id = v_session.stock_location_id)
+   WHERE i.session_id = p_session_id
+     AND m.created_at > v_session.opened_at
+     AND (i.movement_id IS NULL OR m.id <> i.movement_id);
+  IF v_conflicts > 0 THEN
+    RAISE EXCEPTION 'inventory: stock changed after this count opened (% line(s)); review and recount', v_conflicts
+      USING ERRCODE = '40001';
+  END IF;
+
+  SELECT * INTO v_op FROM app.inventory_begin_operation(
+    v_tenant, 'adjust', v_key,
+    jsonb_build_object('count_session_id', p_session_id, 'reason', v_reason));
+  IF v_op.existing IS NOT NULL THEN
+    UPDATE public.plg_inventory_count_sessions
+       SET status = 'closed', closed_at = coalesce(closed_at, now()),
+           closed_by = coalesce(closed_by, auth.uid()), updated_at = now()
+     WHERE id = p_session_id;
+    RETURN v_op.existing || jsonb_build_object('already_closed', true, 'adjustments_created', 0);
+  END IF;
+
+  FOR v_item IN
+    SELECT * FROM public.plg_inventory_count_items
+     WHERE session_id = p_session_id AND movement_id IS NULL
+     ORDER BY id
+     FOR UPDATE
+  LOOP
+    SELECT coalesce(sum(p.quantity), 0),
+           coalesce(max(p.unit_cost), v_item.unit_cost, 0),
+           coalesce(bool_or((p.batch_number IS NOT NULL OR p.expiration_date IS NOT NULL) AND p.quantity <> 0), false)
+      INTO v_current, v_current_cost, v_has_lots
+      FROM public.plg_inventory_stock_positions p
+     WHERE p.tenant_id = v_tenant
+       AND p.product_id = v_item.product_id
+       AND p.stock_location_id = v_session.stock_location_id;
+
+    v_delta := v_item.counted_quantity - v_current;
+    IF v_delta = 0 THEN CONTINUE; END IF;
+    IF v_has_lots THEN
+      RAISE EXCEPTION 'inventory: product % has batch stock; close it with a batch-aware count', v_item.product_id
+        USING ERRCODE = '22023';
+    END IF;
+
+    v_line_no := v_line_no + 1;
+    INSERT INTO public.plg_inventory_stock_movements (
+      tenant_id, product_id, kind, quantity, unit_cost,
+      source_location_id, document_type, reason,
+      idempotency_key, line_no, operation_id,
+      source_item_type, source_item_id, metadata
+    ) VALUES (
+      v_tenant, v_item.product_id, 'adjust', v_delta, v_current_cost,
+      v_session.stock_location_id, 'stock_count', v_reason,
+      v_key, v_line_no, v_op.op_id,
+      'stock_count_item', v_item.id,
+      jsonb_build_object(
+        'countSessionId', p_session_id,
+        'countItemId', v_item.id,
+        'systemQuantity', v_item.system_quantity,
+        'currentQuantity', v_current,
+        'countedQuantity', v_item.counted_quantity,
+        'variance', v_delta
+      )
+    )
+    RETURNING id INTO v_movement_id;
+
+    UPDATE public.plg_inventory_count_items
+       SET movement_id = v_movement_id, updated_at = now()
+     WHERE id = v_item.id;
+    v_movements := v_movements || app.inventory_movement_json(v_movement_id);
+    v_positions := v_positions || app.inventory_position_json(
+      v_tenant, v_item.product_id, v_session.stock_location_id, NULL, NULL);
+    v_emitted := v_emitted + 1;
+  END LOOP;
+
+  UPDATE public.plg_inventory_count_sessions
+     SET status = 'closed', closed_at = now(), closed_by = auth.uid(), updated_at = now()
+   WHERE id = p_session_id;
+
+  v_result := jsonb_build_object(
+    'ok', true, 'session_id', p_session_id, 'status', 'closed',
+    'already_closed', false, 'adjustments_created', v_emitted,
+    'operation_id', v_op.op_id, 'idempotency_key', v_key,
+    'movements', v_movements, 'positions', v_positions);
+  RETURN app.inventory_finish_operation(
+    v_tenant, v_op.op_id, 'count.close', v_key, v_result,
+    jsonb_build_object('count_session_id', p_session_id, 'adjustments_created', v_emitted));
+END;
+$$;
+`;
 var MIGRATIONS = [
   { id: "000_baseline", sql: MIGRATION_000_BASELINE },
   { id: "001_the_usage_that_left_stock_can_be_audited", sql: MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED },
-  { id: "002_a_auditoria_fecha_em_lote", sql: MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE }
+  { id: "002_a_auditoria_fecha_em_lote", sql: MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE },
+  { id: "003_stock_count_closes_through_ledger", sql: MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER }
 ];
 
 // src/index.ts