@fayz-ai/plugin-inventory 0.1.1

package/src/locales/pt-BR.ts

@@ -0,0 +1,242 @@
+// inventory.* — merged plugin-own + saas-core central i18n
+export const ptBR: Record<string, string> = {
+  "inventory.dashboard.activeItems": "Itens ativos",
+  "inventory.dashboard.belowMinimum": "Abaixo do mínimo",
+  "inventory.dashboard.entries": "Entradas:",
+  "inventory.dashboard.exits": "Saídas:",
+  "inventory.dashboard.last7Days": "Últimos 7 dias",
+  "inventory.dashboard.lowStock": "Estoque Baixo",
+  "inventory.dashboard.needRestocking": "Precisam reposição",
+  "inventory.dashboard.outOfStock": "Sem Estoque",
+  "inventory.dashboard.quickActions": "Ações Rápidas",
+  "inventory.dashboard.quickActionsDesc": "Use a barra lateral para registrar entradas, saídas ou gerenciar produtos.",
+  "inventory.dashboard.recentActivity": "Atividade Recente",
+  "inventory.dashboard.stockValue": "Valor do Estoque",
+  "inventory.dashboard.totalProducts": "Total de Produtos",
+  "inventory.dashboard.totalValue": "Valor total do estoque",
+  "inventory.history.noMovements": "Nenhuma movimentação registrada",
+  "inventory.history.searchPlaceholder": "Buscar movimentações...",
+  "inventory.history.subtitle": "Todas as movimentações de estoque",
+  "inventory.history.title": "Histórico de Estoque",
+  "inventory.nav.dashboard": "Painel",
+  "inventory.nav.entry": "Entrada",
+  "inventory.nav.exit": "Saída",
+  "inventory.nav.history": "Histórico",
+  "inventory.nav.list": "Lista",
+  "inventory.nav.new": "Novo",
+  "inventory.nav.products": "Produtos",
+  "inventory.nav.stock": "Estoque",
+  "inventory.page.newProduct": "Novo Produto",
+  "inventory.page.newProductDesc": "Adicionar um produto ao seu catálogo",
+  "inventory.page.settingsSubtitle": "Preferências, fornecedores, categorias e unidades",
+  "inventory.page.settingsTitle": "Configurações de Estoque",
+  "inventory.page.stockEntry": "Entrada de Estoque",
+  "inventory.page.stockEntryDesc": "Registrar mercadorias recebidas",
+  "inventory.page.stockExit": "Saída de Estoque",
+  "inventory.page.stockExitDesc": "Registrar mercadorias usadas ou vendidas",
+  "inventory.recipeDetail.active": "Ativa",
+  "inventory.recipeDetail.backToList": "Voltar à lista",
+  "inventory.recipeDetail.inactive": "Inativa",
+  "inventory.recipeDetail.ingredientCount": "Ingredientes",
+  "inventory.recipeDetail.ingredientsTitle": "Ingredientes",
+  "inventory.recipeDetail.instructions": "Instruções",
+  "inventory.recipeDetail.noIngredients": "Nenhum ingrediente definido",
+  "inventory.recipeDetail.notFound": "Receita não encontrada",
+  "inventory.recipeDetail.prepTime": "Tempo de preparo",
+  "inventory.recipeDetail.produces": "Produz",
+  "inventory.recipeDetail.recipes": "Receitas",
+  "inventory.recipeDetail.yield": "Rendimento",
+  "inventory.recipes.createFirst": "Crie sua primeira receita",
+  "inventory.recipes.ingredients": "Ingredientes",
+  "inventory.recipes.newRecipe": "Nova Receita",
+  "inventory.recipes.noRecipes": "Nenhuma receita ainda",
+  "inventory.recipes.produces": "Produz:",
+  "inventory.recipes.productionFormulas": "{{count}} fórmulas de produção",
+  "inventory.recipes.recipesDesc": "Receitas definem como produzir produtos a partir de ingredientes",
+  "inventory.recipes.title": "Receitas",
+  "inventory.recipes.yield": "Rendimento",
+  "inventory.stock.additionalDetails": "Detalhes adicionais (opcional)",
+  "inventory.stock.adjustmentDesc": "Correção de contagem",
+  "inventory.stock.adjustmentLabel": "Ajuste",
+  "inventory.stock.back": "Voltar",
+  "inventory.stock.batchNumber": "Número do Lote",
+  "inventory.stock.currentStock": "Estoque Atual",
+  "inventory.stock.destination": "Destino",
+  "inventory.stock.document": "Documento",
+  "inventory.stock.documentNumber": "Número do Documento",
+  "inventory.stock.entry": "Entrada de Estoque",
+  "inventory.stock.entryDesc": "Recebimento de mercadorias",
+  "inventory.stock.entryLabel": "Entrada",
+  "inventory.stock.exit": "Saída de Estoque",
+  "inventory.stock.exitDesc": "Uso ou venda",
+  "inventory.stock.exitLabel": "Saída",
+  "inventory.stock.expirationDate": "Data de Validade",
+  "inventory.stock.fromLocation": "Local de Origem",
+  "inventory.stock.locationLabel": "Local",
+  "inventory.stock.lossDesc": "Desperdício ou dano",
+  "inventory.stock.lossLabel": "Perda",
+  "inventory.stock.movement": "Movimentação de Estoque",
+  "inventory.stock.movementDetails": "Detalhes da Movimentação",
+  "inventory.stock.movementType": "Tipo de movimentação",
+  "inventory.stock.next": "Próximo",
+  "inventory.stock.notes": "Observações",
+  "inventory.stock.product": "Produto",
+  "inventory.stock.quantity": "Quantidade *",
+  "inventory.stock.quantityLabel": "Quantidade",
+  "inventory.stock.reason": "Motivo *",
+  "inventory.stock.reasonLabel": "Motivo",
+  "inventory.stock.recordMovement": "Registrar Movimentação",
+  "inventory.stock.recorded": "Registrado",
+  "inventory.stock.recording": "Registrando...",
+  "inventory.stock.searchProduct": "Buscar por nome, SKU ou código de barras...",
+  "inventory.stock.stepOf": "Etapa {{step}} de 3",
+  "inventory.stock.supplier": "Fornecedor",
+  "inventory.stock.toLocation": "Local de Destino *",
+  "inventory.stock.total": "Total",
+  "inventory.stock.totalCost": "Custo Total",
+  "inventory.stock.transferDesc": "Entre locais",
+  "inventory.stock.transferLabel": "Transferência",
+  "inventory.stock.unitCost": "Custo Unitário",
+  "inventory.stock.unitCostLabel": "Custo Unitário",
+  "inventory.onboarding.welcome": "Bem-vindo ao Estoque",
+  "inventory.onboarding.description": "Acompanhe produtos, gerencie níveis de estoque e monitore movimentações do seu negócio.",
+  "inventory.onboarding.skip": "Pular configuração",
+  "inventory.onboarding.getStarted": "Começar",
+  "inventory.onboarding.units.title": "Unidades de Medida",
+  "inventory.onboarding.units.description": "Unidades padrão (Unidade, Caixa, Kg, L, etc.) estão prontas. Personalize-as a qualquer momento em Configurações.",
+  "inventory.onboarding.locations.title": "Locais de Estoque",
+  "inventory.onboarding.locations.description": "Um local de armazenamento padrão foi criado. Adicione mais para controle multi-local.",
+  "inventory.onboarding.start": "Começar a usar Estoque",
+  "inventory.quickActions.newProduct": "Novo Produto",
+  "inventory.quickActions.newProductDesc": "Adicionar um produto ao catálogo",
+  "inventory.quickActions.stockEntry": "Entrada de Estoque",
+  "inventory.quickActions.stockEntryDesc": "Registrar mercadorias recebidas",
+  "inventory.quickActions.stockExit": "Saída de Estoque",
+  "inventory.quickActions.stockExitDesc": "Registrar mercadorias usadas ou vendidas",
+  "inventory.settingsPage.title": "Configurações de Estoque",
+  "inventory.settingsPage.subtitle": "Gerenciar unidades, categorias e locais de estoque",
+  "inventory.settings.stockManagement": "Gestão de Estoque",
+  "inventory.settings.stockManagementDesc": "Como os níveis de estoque são rastreados",
+  "inventory.settings.lowStockAlerts": "Alertas de estoque baixo",
+  "inventory.settings.lowStockAlertsDesc": "Mostrar avisos quando produtos ficarem abaixo da quantidade mínima",
+  "inventory.settings.requireReason": "Exigir motivo para ajustes",
+  "inventory.settings.requireReasonDesc": "Tornar obrigatório o motivo para ajustes e perdas de estoque",
+  "inventory.settings.autoDeduct": "Auto-deduzir no serviço",
+  "inventory.settings.autoDeductDesc": "Deduzir automaticamente produtos quando um serviço é executado",
+  "inventory.settings.products": "Produtos",
+  "inventory.settings.productsDesc": "Comportamento do catálogo de produtos",
+  "inventory.settings.requireSku": "Exigir SKU",
+  "inventory.settings.requireSkuDesc": "Tornar SKU obrigatório ao criar produtos",
+  "inventory.settings.allowNegative": "Permitir estoque negativo",
+  "inventory.settings.allowNegativeDesc": "Permitir que quantidades de estoque fiquem abaixo de zero",
+  "inventory.settings.notifications": "Notificações",
+  "inventory.settings.notificationsDesc": "Alertas e lembretes",
+  "inventory.settings.lowStockEmail": "Alertas de estoque baixo por e-mail",
+  "inventory.settings.lowStockEmailDesc": "Enviar e-mail quando produtos atingirem a quantidade mínima",
+  "inventory.settings.expiryWarnings": "Avisos de validade",
+  "inventory.settings.expiryWarningsDesc": "Alertar antes de produtos vencerem (rastreamento de lotes)",
+  "inventory.productForm.newProduct": "Novo Produto",
+  "inventory.productForm.editProduct": "Editar Produto",
+  "inventory.productForm.updateDetails": "Atualizar detalhes do produto",
+  "inventory.productForm.addToCatalog": "Adicionar um produto ao seu catálogo",
+  "inventory.productForm.cancel": "Cancelar",
+  "inventory.productForm.save": "Salvar",
+  "inventory.productForm.saving": "Salvando...",
+  "inventory.productForm.generalInfo": "Informações Gerais",
+  "inventory.productForm.name": "Nome",
+  "inventory.productForm.namePlaceholder": "Nome do produto",
+  "inventory.productForm.brand": "Marca",
+  "inventory.productForm.brandPlaceholder": "Nome da marca",
+  "inventory.productForm.sku": "SKU",
+  "inventory.productForm.skuPlaceholder": "Código interno",
+  "inventory.productForm.barcode": "Código de Barras",
+  "inventory.productForm.barcodePlaceholder": "EAN / UPC",
+  "inventory.productForm.description": "Descrição",
+  "inventory.productForm.descriptionPlaceholder": "Informações adicionais sobre o produto",
+  "inventory.productForm.classification": "Classificação",
+  "inventory.productForm.classificationDesc": "Como este produto é usado no seu negócio",
+  "inventory.productForm.typeIngredient": "Matéria-prima usada na produção ou serviços",
+  "inventory.productForm.typeSale": "Vendido diretamente aos clientes",
+  "inventory.productForm.typeIntermediate": "Produzido internamente a partir de outros itens",
+  "inventory.productForm.typeAsset": "Ativo fixo para controle patrimonial",
+  "inventory.productForm.pricing": "Preços",
+  "inventory.productForm.costPrice": "Preço de Custo",
+  "inventory.productForm.salePrice": "Preço de Venda",
+  "inventory.productForm.margin": "Margem",
+  "inventory.productForm.stockLevels": "Níveis de Estoque",
+  "inventory.productForm.stockLevelsDesc": "Limites mínimo e máximo para alertas",
+  "inventory.productForm.minQuantity": "Quantidade Mínima",
+  "inventory.productForm.minQuantityHint": "Alertar quando o estoque ficar abaixo deste valor",
+  "inventory.productForm.maxQuantity": "Quantidade Máxima",
+  "inventory.productForm.maxQuantityHint": "Capacidade máxima para este produto",
+  "inventory.productForm.optional": "Opcional",
+  "inventory.productList.title": "Produtos",
+  "inventory.productList.subtitle": "{{count}} produtos",
+  "inventory.productList.product": "Produto",
+  "inventory.productList.type": "Tipo",
+  "inventory.productList.stock": "Estoque",
+  "inventory.productList.cost": "Custo",
+  "inventory.productList.value": "Valor",
+  "inventory.productList.searchPlaceholder": "Buscar produtos...",
+  "inventory.productList.newProduct": "Novo Produto",
+  "inventory.productList.empty": "Nenhum produto ainda",
+  "inventory.productList.createFirst": "Crie seu primeiro produto",
+  "inventory.stock.unknownProduct": "Produto Desconhecido",
+  "inventory.stock.reasonLossPlaceholder": "ex. Vencido, danificado",
+  "inventory.stock.reasonAdjustPlaceholder": "ex. Correção de contagem física",
+  "inventory.stock.documentPlaceholder": "Nota fiscal, recibo, PO...",
+  "inventory.stock.batchPlaceholder": "ex. LOT001",
+  "inventory.stock.notesPlaceholder": "Observações adicionais...",
+  "inventory.recipeDetail.loading": "Carregando...",
+  "inventory.recipeDetail.ingredient": "Ingrediente",
+  "inventory.recipeDetail.quantity": "Quantidade",
+  "inventory.recipeDetail.unit": "Unidade",
+  "inventory.recipeDetail.notes": "Observações",
+  "inventory.recipeDetail.created": "Criado",
+  "inventory.recipeDetail.updated": "Atualizado",
+  "inventory.recipeForm.newRecipe": "Nova Receita",
+  "inventory.recipeForm.subtitle": "Definir uma fórmula de produção",
+  "inventory.recipeForm.cancel": "Cancelar",
+  "inventory.recipeForm.saveRecipe": "Salvar Receita",
+  "inventory.recipeForm.saving": "Salvando...",
+  "inventory.recipeForm.recipeDetails": "Detalhes da Receita",
+  "inventory.recipeForm.recipeName": "Nome da Receita",
+  "inventory.recipeForm.recipeNamePlaceholder": "ex. Molho de Tomate",
+  "inventory.recipeForm.description": "Descrição",
+  "inventory.recipeForm.descriptionPlaceholder": "Breve descrição...",
+  "inventory.recipeForm.produces": "Produz (Produto)",
+  "inventory.recipeForm.searchProduct": "Buscar produto...",
+  "inventory.recipeForm.createProduct": "Criar produto",
+  "inventory.recipeForm.yieldQuantity": "Quantidade de Rendimento",
+  "inventory.recipeForm.prepTime": "Tempo de Preparo (min)",
+  "inventory.recipeForm.instructions": "Instruções",
+  "inventory.recipeForm.instructionsPlaceholder": "Instruções de preparo passo a passo...",
+  "inventory.recipeForm.ingredients": "Ingredientes",
+  "inventory.recipeForm.addIngredient": "Adicionar Ingrediente",
+  "inventory.recipeForm.noIngredients": "Nenhum ingrediente adicionado",
+  "inventory.recipeForm.addFirstIngredient": "Adicione seu primeiro ingrediente",
+  "inventory.recipeForm.ingredient": "Ingrediente",
+  "inventory.recipeForm.quantity": "Quantidade",
+  "inventory.recipeForm.notes": "Observações",
+  "inventory.recipeForm.searchIngredient": "Buscar ingrediente...",
+  "inventory.recipeForm.createIngredient": "Criar ingrediente",
+  "inventory.recipeForm.notesPlaceholder": "ex. picado, fresco",
+  "inventory.recipeForm.ingredientsConfigured": "{{configured}} de {{total}} ingredientes configurados",
+  "inventory.title": "Estoque",
+  "inventory.stock.title": "Estoque",
+  "inventory.stock.minStock": "Estoque Mín.",
+  "inventory.stock.adjust": "Ajustar Estoque",
+  "inventory.stock.lowStock": "Estoque Baixo",
+  "inventory.products.title": "Produtos",
+  "inventory.products.create": "Novo Produto",
+  "inventory.recipes.create": "Nova Receita",
+  "inventory.recipes.addIngredient": "Adicionar Ingrediente",
+  "inventory.recipes.cost": "Custo",
+  "inventory.recipes.loading": "Carregando...",
+  "inventory.suppliers.title": "Fornecedores",
+  "inventory.suppliers.create": "Novo Fornecedor",
+  "inventory.movements.title": "Movimentações",
+  "inventory.movements.in": "Entrada",
+  "inventory.movements.out": "Saída",
+  "inventory.settings.title": "Configurações de Estoque",
+}

package/src/migrations/001_inventory_base.sql

@@ -0,0 +1,69 @@
+-- Inventory Plugin: Base Tables
+-- Products use saas_core.products archetype directly
+-- These are plugin-specific extension tables
+
+CREATE TABLE IF NOT EXISTS public.product_categories (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  parent_id uuid REFERENCES public.product_categories(id),
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.product_categories ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_product_categories_tenant ON public.product_categories(tenant_id);
+
+CREATE TABLE IF NOT EXISTS public.stock_locations (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  description text,
+  is_active boolean NOT NULL DEFAULT true,
+  unit_id uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.stock_locations ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_stock_locations_tenant ON public.stock_locations(tenant_id);
+
+CREATE TABLE IF NOT EXISTS public.stock_movements (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  product_id uuid NOT NULL REFERENCES saas_core.products(id),
+  quantity numeric(14,4) NOT NULL,
+  movement_type text NOT NULL,
+  unit_cost numeric(14,2) DEFAULT 0,
+  total_cost numeric(14,2) DEFAULT 0,
+  stock_location_id uuid REFERENCES public.stock_locations(id),
+  destination_location_id uuid REFERENCES public.stock_locations(id),
+  supplier_id uuid REFERENCES saas_core.persons(id),
+  document_number text,
+  reason text,
+  notes text,
+  movement_date date NOT NULL DEFAULT CURRENT_DATE,
+  user_id uuid,
+  batch_number text,
+  expiration_date date,
+  metadata jsonb DEFAULT '{}'::jsonb,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.stock_movements ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_stock_movements_tenant ON public.stock_movements(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_stock_movements_product ON public.stock_movements(product_id);
+CREATE INDEX IF NOT EXISTS idx_stock_movements_date ON public.stock_movements(tenant_id, movement_date);
+
+CREATE TABLE IF NOT EXISTS public.stock_positions (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  product_id uuid NOT NULL REFERENCES saas_core.products(id),
+  quantity numeric(14,4) NOT NULL,
+  unit_cost numeric(14,2) DEFAULT 0,
+  stock_location_id uuid REFERENCES public.stock_locations(id),
+  batch_number text,
+  expiration_date date,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.stock_positions ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_stock_positions_tenant ON public.stock_positions(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_stock_positions_product ON public.stock_positions(product_id);

package/src/migrations/002_recipes.sql

@@ -0,0 +1,34 @@
+-- Inventory Plugin: Recipes & Technical Specs
+
+CREATE TABLE IF NOT EXISTS public.recipes (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  description text,
+  product_id uuid REFERENCES saas_core.products(id),
+  yield_quantity numeric(14,4) DEFAULT 1,
+  yield_unit_id uuid,
+  preparation_time_minutes integer,
+  instructions text,
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.recipes ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_recipes_tenant ON public.recipes(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_recipes_product ON public.recipes(product_id);
+
+CREATE TABLE IF NOT EXISTS public.recipe_ingredients (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  recipe_id uuid NOT NULL REFERENCES public.recipes(id) ON DELETE CASCADE,
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  product_id uuid NOT NULL REFERENCES saas_core.products(id),
+  quantity numeric(14,4) NOT NULL,
+  unit_id uuid,
+  display_order integer DEFAULT 0,
+  notes text,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.recipe_ingredients ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_recipe_ingredients_tenant ON public.recipe_ingredients(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_recipe_ingredients_recipe ON public.recipe_ingredients(recipe_id);

package/src/migrations/003_measurement_units.sql

@@ -0,0 +1,13 @@
+-- Inventory Plugin: Measurement Units
+
+CREATE TABLE IF NOT EXISTS public.measurement_units (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  abbreviation text NOT NULL,
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.measurement_units ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_measurement_units_tenant ON public.measurement_units(tenant_id);

package/src/registries.ts

@@ -0,0 +1,111 @@
+import type { PluginRegistryDef } from '@fayz-ai/core'
+import type { EntityDef } from '@fayz-ai/core'
+
+const supplierEntity: EntityDef = {
+  name: 'Supplier',
+  namePlural: 'Suppliers',
+  icon: 'Building2',
+  layout: 'person',
+  displayField: 'name',
+  defaultSort: 'name',
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true, showInTable: true, searchable: true },
+    { key: 'phone', label: 'Phone', type: 'phone', showInTable: true },
+    { key: 'email', label: 'Email', type: 'email', showInTable: true },
+    { key: 'documentNumber', label: 'Tax ID', type: 'text', showInTable: true },
+    { key: 'address', label: 'Address', type: 'text' },
+    { key: 'notes', label: 'Notes', type: 'textarea' },
+    { key: 'isActive', label: 'Active', type: 'boolean', showInTable: true, defaultValue: true },
+  ],
+  data: {
+    table: 'persons',
+    schema: 'saas_core',
+    tenantScoped: true,
+    filters: { kind: 'supplier' },
+    defaults: { kind: 'supplier' },
+  },
+}
+
+const measurementUnitEntity: EntityDef = {
+  name: 'Measurement Unit',
+  namePlural: 'Measurement Units',
+  icon: 'Ruler',
+  displayField: 'name',
+  defaultSort: 'name',
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true, showInTable: true },
+    { key: 'abbreviation', label: 'Abbreviation', type: 'text', required: true, showInTable: true },
+    { key: 'isActive', label: 'Active', type: 'boolean', showInTable: true, defaultValue: true },
+  ],
+  data: { table: 'measurement_units', tenantScoped: true },
+}
+
+const productCategoryEntity: EntityDef = {
+  name: 'Product Category',
+  namePlural: 'Product Categories',
+  icon: 'Tag',
+  displayField: 'name',
+  defaultSort: 'name',
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true, showInTable: true },
+    { key: 'parentId', label: 'Parent', type: 'text', showInTable: false },
+    { key: 'isActive', label: 'Active', type: 'boolean', showInTable: true, defaultValue: true },
+  ],
+  data: { table: 'product_categories', tenantScoped: true },
+}
+
+const stockLocationEntity: EntityDef = {
+  name: 'Stock Location',
+  namePlural: 'Stock Locations',
+  icon: 'Warehouse',
+  displayField: 'name',
+  defaultSort: 'name',
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true, showInTable: true },
+    { key: 'description', label: 'Description', type: 'textarea', showInTable: true },
+    { key: 'isActive', label: 'Active', type: 'boolean', showInTable: true, defaultValue: true },
+  ],
+  data: { table: 'stock_locations', tenantScoped: true },
+}
+
+export const inventoryRegistries: PluginRegistryDef[] = [
+  // --- Editable ---
+  {
+    id: 'suppliers',
+    entity: supplierEntity,
+    icon: 'Building2',
+    description: 'Manage your product and material suppliers',
+    display: 'table',
+  },
+  {
+    id: 'product-categories',
+    entity: productCategoryEntity,
+    icon: 'Tag',
+    description: 'Product categories for organization',
+    display: 'table',
+  },
+  {
+    id: 'stock-locations',
+    entity: stockLocationEntity,
+    icon: 'Warehouse',
+    description: 'Physical storage locations for inventory',
+    display: 'table',
+  },
+  // --- Read-only (system / seeded) ---
+  {
+    id: 'measurement-units',
+    entity: measurementUnitEntity,
+    icon: 'Ruler',
+    description: 'Standard units of measure',
+    display: 'table',
+    readOnly: true,
+    seedData: [
+      { id: 'mu-unit', name: 'Unit', abbreviation: 'un', isActive: true },
+      { id: 'mu-box', name: 'Box', abbreviation: 'box', isActive: true },
+      { id: 'mu-kg', name: 'Kilogram', abbreviation: 'kg', isActive: true },
+      { id: 'mu-g', name: 'Gram', abbreviation: 'g', isActive: true },
+      { id: 'mu-l', name: 'Liter', abbreviation: 'L', isActive: true },
+      { id: 'mu-ml', name: 'Milliliter', abbreviation: 'mL', isActive: true },
+    ],
+  },
+]

package/src/store.ts

@@ -0,0 +1,127 @@
+import { createStore, type StoreApi } from 'zustand/vanilla'
+import { dedup } from '@fayz-ai/saas'
+import { toast } from '@fayz-ai/ui'
+import type { InventoryDataProvider } from './data/types'
+import type {
+  Product, StockMovement, StockLocation, Recipe,
+  InventorySummary, ProductQuery, MovementQuery,
+  CreateProductInput, CreateStockMovementInput, CreateRecipeInput,
+} from './types'
+
+export interface InventoryUIState {
+  products: Product[]
+  productsTotal: number
+  productsLoading: boolean
+  productQuery: ProductQuery
+
+  movements: StockMovement[]
+  movementsTotal: number
+  movementsLoading: boolean
+
+  locations: StockLocation[]
+  locationsLoading: boolean
+
+  recipes: Recipe[]
+  recipesLoading: boolean
+
+  summary: InventorySummary | null
+  summaryLoading: boolean
+
+  fetchSummary(): Promise<void>
+  fetchProducts(query: ProductQuery): Promise<void>
+  fetchMovements(query: MovementQuery): Promise<void>
+  fetchLocations(): Promise<void>
+  fetchRecipes(): Promise<void>
+  createProduct(input: CreateProductInput): Promise<Product>
+  createMovement(input: CreateStockMovementInput): Promise<StockMovement>
+  createRecipe(input: CreateRecipeInput): Promise<Recipe>
+}
+
+export function createInventoryStore(provider: InventoryDataProvider): StoreApi<InventoryUIState> {
+  return createStore<InventoryUIState>((set, get) => ({
+    products: [], productsTotal: 0, productsLoading: false, productQuery: {},
+    movements: [], movementsTotal: 0, movementsLoading: false,
+    locations: [], locationsLoading: false,
+    recipes: [], recipesLoading: false,
+    summary: null, summaryLoading: false,
+
+    async fetchSummary() {
+      return dedup('inv:summary', async () => {
+        set({ summaryLoading: true })
+        const summary = await provider.getSummary()
+        set({ summary, summaryLoading: false })
+      })
+    },
+
+    async fetchProducts(query) {
+      const key = 'inv:products:' + JSON.stringify(query)
+      return dedup(key, async () => {
+        set({ productsLoading: true, productQuery: query })
+        const result = await provider.getProducts(query)
+        set({ products: result.data, productsTotal: result.total, productsLoading: false })
+      })
+    },
+
+    async fetchMovements(query) {
+      return dedup('inv:movements:' + JSON.stringify(query), async () => {
+        set({ movementsLoading: true })
+        const result = await provider.getMovements(query)
+        set({ movements: result.data, movementsTotal: result.total, movementsLoading: false })
+      })
+    },
+
+    async fetchLocations() {
+      return dedup('inv:locations', async () => {
+        set({ locationsLoading: true })
+        const locations = await provider.getLocations()
+        set({ locations, locationsLoading: false })
+      })
+    },
+
+    async fetchRecipes() {
+      set({ recipesLoading: true })
+      const recipes = await provider.getRecipes()
+      set({ recipes, recipesLoading: false })
+    },
+
+    async createProduct(input) {
+      try {
+        const product = await provider.createProduct(input)
+        const query = get().productQuery
+        const [result, summary] = await Promise.all([provider.getProducts(query), provider.getSummary()])
+        set({ products: result.data, productsTotal: result.total, summary })
+        toast.success('Product created')
+        return product
+      } catch (err: any) {
+        toast.error('Failed to create product', { description: err?.message })
+        throw err
+      }
+    },
+
+    async createMovement(input) {
+      try {
+        const movement = await provider.createMovement(input)
+        const [summary] = await Promise.all([provider.getSummary()])
+        set({ summary })
+        toast.success('Stock movement recorded')
+        return movement
+      } catch (err: any) {
+        toast.error('Failed to record movement', { description: err?.message })
+        throw err
+      }
+    },
+
+    async createRecipe(input) {
+      try {
+        const recipe = await provider.createRecipe(input)
+        const recipes = await provider.getRecipes()
+        set({ recipes })
+        toast.success('Recipe created')
+        return recipe
+      } catch (err: any) {
+        toast.error('Failed to create recipe', { description: err?.message })
+        throw err
+      }
+    },
+  }))
+}