@fayz-ai/plugin-inventory 0.1.1

package/src/index.ts

@@ -0,0 +1,191 @@
+import React from 'react'
+import type { PluginManifest, PluginScope, VerticalId } from '@fayz-ai/core'
+import { InventoryPage } from './InventoryPage'
+import { createInventoryDashboardWidgets } from './views/dashboardWidgets'
+import type { ResolvedInventoryConfig } from './InventoryContext'
+import type { InventoryDataProvider } from './data/types'
+import { createMockInventoryProvider } from './data/mock'
+import { createSupabaseInventoryProvider } from './data/supabase'
+import { createSafeDataProvider, registerTranslations } from '@fayz-ai/core'
+import { createInventoryStore } from './store'
+import { inventoryRegistries } from './registries'
+import { inventoryLocales } from './locales'
+import { InventoryGeneralSettings } from './components/InventoryGeneralSettings'
+
+// ---------------------------------------------------------------------------
+// Public types
+// ---------------------------------------------------------------------------
+
+export interface InventoryPluginLabels {
+  pageTitle: string
+  pageSubtitle: string
+  dashboard: string
+  products: string
+  productsNew: string
+  productsList: string
+  stock: string
+  stockEntry: string
+  stockExit: string
+  stockHistory: string
+  recipes: string
+  recipesNew: string
+  recipesList: string
+}
+
+export interface InventoryPluginOptions {
+  modules?: {
+    recipes?: boolean
+    stockLocations?: boolean
+    batchTracking?: boolean
+  }
+  labels?: Partial<InventoryPluginLabels>
+  productTypes?: Array<{ value: string; label: string }>
+  currency?: { code?: string; locale?: string; symbol?: string }
+  navPosition?: number
+  navSection?: 'main' | 'secondary'
+  scope?: PluginScope
+  verticalId?: VerticalId
+  dataProvider?: InventoryDataProvider
+  locations?: Array<{ id: string; name: string; isHQ?: boolean }>
+}
+
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+
+const DEFAULT_LABELS: InventoryPluginLabels = {
+  pageTitle: 'Inventory',
+  pageSubtitle: 'Product catalog and stock management',
+  dashboard: 'Dashboard',
+  products: 'Products',
+  productsNew: 'New',
+  productsList: 'List',
+  stock: 'Stock',
+  stockEntry: 'Entry',
+  stockExit: 'Exit',
+  stockHistory: 'History',
+  recipes: 'Recipes',
+  recipesNew: 'New',
+  recipesList: 'List',
+}
+
+const DEFAULT_CURRENCY = { code: 'BRL', locale: 'pt-BR', symbol: 'R$' }
+
+const DEFAULT_PRODUCT_TYPES = [
+  { value: 'ingredient', label: 'Ingredient' },
+  { value: 'sale', label: 'For Sale' },
+  { value: 'intermediate', label: 'Intermediate' },
+  { value: 'asset', label: 'Asset' },
+]
+
+// ---------------------------------------------------------------------------
+// Config resolver
+// ---------------------------------------------------------------------------
+
+function resolveConfig(options?: InventoryPluginOptions): ResolvedInventoryConfig {
+  return {
+    modules: {
+      recipes: options?.modules?.recipes !== false,
+      stockLocations: options?.modules?.stockLocations !== false,
+      batchTracking: options?.modules?.batchTracking ?? false,
+    },
+    labels: { ...DEFAULT_LABELS, ...options?.labels },
+    currency: { ...DEFAULT_CURRENCY, ...options?.currency },
+    productTypes: options?.productTypes ?? DEFAULT_PRODUCT_TYPES,
+    locations: options?.locations ?? [],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+
+export function createInventoryPlugin(options?: InventoryPluginOptions): PluginManifest {
+  const config = resolveConfig(options)
+  registerTranslations(inventoryLocales)
+  const provider = options?.dataProvider ?? createSafeDataProvider(
+    () => createSupabaseInventoryProvider(),
+    () => createMockInventoryProvider(),
+  )
+  const store = createInventoryStore(provider)
+  const dashboardWidgets = createInventoryDashboardWidgets({ config, provider, store })
+
+  const PageComponent: React.FC<any> = () =>
+    React.createElement(InventoryPage, { config, provider, store, registries: inventoryRegistries })
+
+  return {
+    id: 'inventory',
+    name: config.labels.pageTitle,
+    icon: 'Package',
+    version: '1.0.0',
+    scope: options?.scope ?? 'universal',
+    verticalId: options?.verticalId,
+    defaultEnabled: true,
+    dependencies: [],
+    declaredFeatures: [
+      { id: 'inventory', label: config.labels.pageTitle, group: config.labels.pageTitle },
+      ...(config.modules.recipes ? [{ id: 'inventory.recipes', label: config.labels.recipes ?? 'Recipes', group: config.labels.pageTitle }] : []),
+    ],
+    navigation: [
+      {
+        section: options?.navSection ?? 'main',
+        position: options?.navPosition ?? 4,
+        label: config.labels.pageTitle,
+        route: '/inventory',
+        icon: 'Package',
+        permission: { feature: 'inventory', action: 'read' as const },
+      },
+    ],
+    routes: [
+      {
+        path: '/inventory',
+        component: PageComponent,
+        permission: { feature: 'inventory', action: 'read' as const },
+      },
+    ],
+    widgets: [],
+    dashboardWidgets,
+    aiTools: [
+      {
+        id: 'inventory.low-stock',
+        name: 'getLowStock',
+        description: 'Lists products with stock below minimum threshold.',
+        icon: 'AlertTriangle',
+        mode: 'read' as const,
+        category: 'Inventory',
+        parameters: {
+          type: 'object' as const,
+          properties: {
+            threshold: { type: 'number' as const, description: 'Custom stock threshold' },
+          },
+        },
+        suggestions: [
+          { label: 'Which products are running low?' },
+          { label: 'What ingredients need restocking?', verticalId: 'food' as const },
+          { label: 'Show me a stock summary' },
+          { label: 'What are my most used products?' },
+        ],
+        permission: { feature: 'inventory', action: 'read' as const },
+      },
+    ],
+    registries: inventoryRegistries,
+    settings: [
+      {
+        id: 'inventory',
+        label: 'Inventory',
+        icon: 'Package',
+        component: (() => {
+          const Tab: React.FC = () => React.createElement(InventoryGeneralSettings)
+          Tab.displayName = 'InventorySettingsTab'
+          return Tab
+        })() as unknown as React.ComponentType<unknown>,
+        order: 11,
+        permission: { feature: 'inventory', action: 'read' as const },
+      },
+    ],
+    locales: inventoryLocales,
+  }
+}
+
+export type { InventoryDataProvider } from './data/types'
+export type { ResolvedInventoryConfig } from './InventoryContext'

package/src/lib/tenant.ts

@@ -0,0 +1,4 @@
+// Runtime-DI tenant accessor (decoupled from saas-core org store).
+let t: string | undefined
+export function setInventoryTenantId(id: string | undefined){ t = id }
+export function getInventoryTenantId(): string | undefined { return t }

package/src/locales/en.ts

@@ -0,0 +1,242 @@
+// inventory.* — merged plugin-own + saas-core central i18n
+export const en: Record<string, string> = {
+  "inventory.dashboard.activeItems": "Active items",
+  "inventory.dashboard.belowMinimum": "Below minimum",
+  "inventory.dashboard.entries": "Entries:",
+  "inventory.dashboard.exits": "Exits:",
+  "inventory.dashboard.last7Days": "Last 7 days",
+  "inventory.dashboard.lowStock": "Low Stock",
+  "inventory.dashboard.needRestocking": "Need restocking",
+  "inventory.dashboard.outOfStock": "Out of Stock",
+  "inventory.dashboard.quickActions": "Quick Actions",
+  "inventory.dashboard.quickActionsDesc": "Use the sidebar to record stock entries, exits, or manage products.",
+  "inventory.dashboard.recentActivity": "Recent Activity",
+  "inventory.dashboard.stockValue": "Stock Value",
+  "inventory.dashboard.totalProducts": "Total Products",
+  "inventory.dashboard.totalValue": "Total inventory value",
+  "inventory.history.noMovements": "No movements recorded",
+  "inventory.history.searchPlaceholder": "Search movements...",
+  "inventory.history.subtitle": "All stock movements",
+  "inventory.history.title": "Stock History",
+  "inventory.nav.dashboard": "Dashboard",
+  "inventory.nav.entry": "Entry",
+  "inventory.nav.exit": "Exit",
+  "inventory.nav.history": "History",
+  "inventory.nav.list": "List",
+  "inventory.nav.new": "New",
+  "inventory.nav.products": "Products",
+  "inventory.nav.stock": "Stock",
+  "inventory.page.newProduct": "New Product",
+  "inventory.page.newProductDesc": "Add a product to your catalog",
+  "inventory.page.settingsSubtitle": "Preferences, suppliers, categories, and units",
+  "inventory.page.settingsTitle": "Inventory Settings",
+  "inventory.page.stockEntry": "Stock Entry",
+  "inventory.page.stockEntryDesc": "Record goods received",
+  "inventory.page.stockExit": "Stock Exit",
+  "inventory.page.stockExitDesc": "Record goods used or sold",
+  "inventory.recipeDetail.active": "Active",
+  "inventory.recipeDetail.backToList": "Back to list",
+  "inventory.recipeDetail.inactive": "Inactive",
+  "inventory.recipeDetail.ingredientCount": "Ingredients",
+  "inventory.recipeDetail.ingredientsTitle": "Ingredients",
+  "inventory.recipeDetail.instructions": "Instructions",
+  "inventory.recipeDetail.noIngredients": "No ingredients defined",
+  "inventory.recipeDetail.notFound": "Recipe not found",
+  "inventory.recipeDetail.prepTime": "Prep time",
+  "inventory.recipeDetail.produces": "Produces",
+  "inventory.recipeDetail.recipes": "Recipes",
+  "inventory.recipeDetail.yield": "Yield",
+  "inventory.recipes.createFirst": "Create your first recipe",
+  "inventory.recipes.ingredients": "Ingredients",
+  "inventory.recipes.newRecipe": "New Recipe",
+  "inventory.recipes.noRecipes": "No recipes yet",
+  "inventory.recipes.produces": "Produces:",
+  "inventory.recipes.productionFormulas": "{{count}} production formulas",
+  "inventory.recipes.recipesDesc": "Recipes define how to produce products from ingredients",
+  "inventory.recipes.title": "Recipes",
+  "inventory.recipes.yield": "Yield",
+  "inventory.stock.additionalDetails": "Additional details (optional)",
+  "inventory.stock.adjustmentDesc": "Count correction",
+  "inventory.stock.adjustmentLabel": "Adjustment",
+  "inventory.stock.back": "Back",
+  "inventory.stock.batchNumber": "Batch Number",
+  "inventory.stock.currentStock": "Current Stock",
+  "inventory.stock.destination": "Destination",
+  "inventory.stock.document": "Document",
+  "inventory.stock.documentNumber": "Document Number",
+  "inventory.stock.entry": "Stock Entry",
+  "inventory.stock.entryDesc": "Receiving goods",
+  "inventory.stock.entryLabel": "Entry",
+  "inventory.stock.exit": "Stock Exit",
+  "inventory.stock.exitDesc": "Using or selling",
+  "inventory.stock.exitLabel": "Exit",
+  "inventory.stock.expirationDate": "Expiration Date",
+  "inventory.stock.fromLocation": "From Location",
+  "inventory.stock.locationLabel": "Location",
+  "inventory.stock.lossDesc": "Waste or damage",
+  "inventory.stock.lossLabel": "Loss",
+  "inventory.stock.movement": "Stock Movement",
+  "inventory.stock.movementDetails": "Movement Details",
+  "inventory.stock.movementType": "Movement type",
+  "inventory.stock.next": "Next",
+  "inventory.stock.notes": "Notes",
+  "inventory.stock.product": "Product",
+  "inventory.stock.quantity": "Quantity *",
+  "inventory.stock.quantityLabel": "Quantity",
+  "inventory.stock.reason": "Reason *",
+  "inventory.stock.reasonLabel": "Reason",
+  "inventory.stock.recordMovement": "Record Movement",
+  "inventory.stock.recorded": "Recorded",
+  "inventory.stock.recording": "Recording...",
+  "inventory.stock.searchProduct": "Search by name, SKU, or barcode...",
+  "inventory.stock.stepOf": "Step {{step}} of 3",
+  "inventory.stock.supplier": "Supplier",
+  "inventory.stock.toLocation": "To Location *",
+  "inventory.stock.total": "Total",
+  "inventory.stock.totalCost": "Total Cost",
+  "inventory.stock.transferDesc": "Between locations",
+  "inventory.stock.transferLabel": "Transfer",
+  "inventory.stock.unitCost": "Unit Cost",
+  "inventory.stock.unitCostLabel": "Unit Cost",
+  "inventory.onboarding.welcome": "Welcome to Inventory",
+  "inventory.onboarding.description": "Track products, manage stock levels, and monitor movements across your business.",
+  "inventory.onboarding.skip": "Skip setup",
+  "inventory.onboarding.getStarted": "Get Started",
+  "inventory.onboarding.units.title": "Measurement Units",
+  "inventory.onboarding.units.description": "Default units (Unit, Box, Kg, L, etc.) are ready. Customize them anytime in Settings.",
+  "inventory.onboarding.locations.title": "Stock Locations",
+  "inventory.onboarding.locations.description": "A default storage location has been created. Add more for multi-location tracking.",
+  "inventory.onboarding.start": "Start using Inventory",
+  "inventory.quickActions.newProduct": "New Product",
+  "inventory.quickActions.newProductDesc": "Add a product to your catalog",
+  "inventory.quickActions.stockEntry": "Stock Entry",
+  "inventory.quickActions.stockEntryDesc": "Record goods received",
+  "inventory.quickActions.stockExit": "Stock Exit",
+  "inventory.quickActions.stockExitDesc": "Record goods used or sold",
+  "inventory.settingsPage.title": "Inventory Settings",
+  "inventory.settingsPage.subtitle": "Manage units, categories, and stock locations",
+  "inventory.settings.stockManagement": "Stock Management",
+  "inventory.settings.stockManagementDesc": "How stock levels are tracked",
+  "inventory.settings.lowStockAlerts": "Low stock alerts",
+  "inventory.settings.lowStockAlertsDesc": "Show warnings when products fall below minimum quantity",
+  "inventory.settings.requireReason": "Require reason for adjustments",
+  "inventory.settings.requireReasonDesc": "Make reason mandatory for stock adjustments and losses",
+  "inventory.settings.autoDeduct": "Auto-deduct on service",
+  "inventory.settings.autoDeductDesc": "Automatically deduct products when a service is executed",
+  "inventory.settings.products": "Products",
+  "inventory.settings.productsDesc": "Product catalog behavior",
+  "inventory.settings.requireSku": "Require SKU",
+  "inventory.settings.requireSkuDesc": "Make SKU mandatory when creating products",
+  "inventory.settings.allowNegative": "Allow negative stock",
+  "inventory.settings.allowNegativeDesc": "Allow stock quantities to go below zero",
+  "inventory.settings.notifications": "Notifications",
+  "inventory.settings.notificationsDesc": "Alerts and reminders",
+  "inventory.settings.lowStockEmail": "Low stock email alerts",
+  "inventory.settings.lowStockEmailDesc": "Send email when products reach minimum quantity",
+  "inventory.settings.expiryWarnings": "Expiry date warnings",
+  "inventory.settings.expiryWarningsDesc": "Alert before products expire (batch tracking)",
+  "inventory.productForm.newProduct": "New Product",
+  "inventory.productForm.editProduct": "Edit Product",
+  "inventory.productForm.updateDetails": "Update product details",
+  "inventory.productForm.addToCatalog": "Add a product to your catalog",
+  "inventory.productForm.cancel": "Cancel",
+  "inventory.productForm.save": "Save",
+  "inventory.productForm.saving": "Saving...",
+  "inventory.productForm.generalInfo": "General Information",
+  "inventory.productForm.name": "Name",
+  "inventory.productForm.namePlaceholder": "Product name",
+  "inventory.productForm.brand": "Brand",
+  "inventory.productForm.brandPlaceholder": "Brand name",
+  "inventory.productForm.sku": "SKU",
+  "inventory.productForm.skuPlaceholder": "Internal code",
+  "inventory.productForm.barcode": "Barcode",
+  "inventory.productForm.barcodePlaceholder": "EAN / UPC",
+  "inventory.productForm.description": "Description",
+  "inventory.productForm.descriptionPlaceholder": "Additional information about the product",
+  "inventory.productForm.classification": "Classification",
+  "inventory.productForm.classificationDesc": "How this product is used in your business",
+  "inventory.productForm.typeIngredient": "Raw material used in production or services",
+  "inventory.productForm.typeSale": "Sold directly to customers",
+  "inventory.productForm.typeIntermediate": "Produced internally from other items",
+  "inventory.productForm.typeAsset": "Fixed asset for patrimony tracking",
+  "inventory.productForm.pricing": "Pricing",
+  "inventory.productForm.costPrice": "Cost Price",
+  "inventory.productForm.salePrice": "Sale Price",
+  "inventory.productForm.margin": "Margin",
+  "inventory.productForm.stockLevels": "Stock Levels",
+  "inventory.productForm.stockLevelsDesc": "Minimum and maximum thresholds for alerts",
+  "inventory.productForm.minQuantity": "Minimum Quantity",
+  "inventory.productForm.minQuantityHint": "Alert when stock falls below this",
+  "inventory.productForm.maxQuantity": "Maximum Quantity",
+  "inventory.productForm.maxQuantityHint": "Max capacity for this product",
+  "inventory.productForm.optional": "Optional",
+  "inventory.productList.title": "Products",
+  "inventory.productList.subtitle": "{{count}} products",
+  "inventory.productList.product": "Product",
+  "inventory.productList.type": "Type",
+  "inventory.productList.stock": "Stock",
+  "inventory.productList.cost": "Cost",
+  "inventory.productList.value": "Value",
+  "inventory.productList.searchPlaceholder": "Search products...",
+  "inventory.productList.newProduct": "New Product",
+  "inventory.productList.empty": "No products yet",
+  "inventory.productList.createFirst": "Create your first product",
+  "inventory.stock.unknownProduct": "Unknown Product",
+  "inventory.stock.reasonLossPlaceholder": "e.g. Expired, damaged",
+  "inventory.stock.reasonAdjustPlaceholder": "e.g. Physical count correction",
+  "inventory.stock.documentPlaceholder": "Invoice, receipt, PO...",
+  "inventory.stock.batchPlaceholder": "e.g. LOT001",
+  "inventory.stock.notesPlaceholder": "Additional notes...",
+  "inventory.recipeDetail.loading": "Loading...",
+  "inventory.recipeDetail.ingredient": "Ingredient",
+  "inventory.recipeDetail.quantity": "Quantity",
+  "inventory.recipeDetail.unit": "Unit",
+  "inventory.recipeDetail.notes": "Notes",
+  "inventory.recipeDetail.created": "Created",
+  "inventory.recipeDetail.updated": "Updated",
+  "inventory.recipeForm.newRecipe": "New Recipe",
+  "inventory.recipeForm.subtitle": "Define a production formula",
+  "inventory.recipeForm.cancel": "Cancel",
+  "inventory.recipeForm.saveRecipe": "Save Recipe",
+  "inventory.recipeForm.saving": "Saving...",
+  "inventory.recipeForm.recipeDetails": "Recipe Details",
+  "inventory.recipeForm.recipeName": "Recipe Name",
+  "inventory.recipeForm.recipeNamePlaceholder": "e.g. Tomato Sauce",
+  "inventory.recipeForm.description": "Description",
+  "inventory.recipeForm.descriptionPlaceholder": "Brief description...",
+  "inventory.recipeForm.produces": "Produces (Product)",
+  "inventory.recipeForm.searchProduct": "Search product...",
+  "inventory.recipeForm.createProduct": "Create product",
+  "inventory.recipeForm.yieldQuantity": "Yield Quantity",
+  "inventory.recipeForm.prepTime": "Prep Time (min)",
+  "inventory.recipeForm.instructions": "Instructions",
+  "inventory.recipeForm.instructionsPlaceholder": "Step-by-step preparation instructions...",
+  "inventory.recipeForm.ingredients": "Ingredients",
+  "inventory.recipeForm.addIngredient": "Add Ingredient",
+  "inventory.recipeForm.noIngredients": "No ingredients added",
+  "inventory.recipeForm.addFirstIngredient": "Add your first ingredient",
+  "inventory.recipeForm.ingredient": "Ingredient",
+  "inventory.recipeForm.quantity": "Quantity",
+  "inventory.recipeForm.notes": "Notes",
+  "inventory.recipeForm.searchIngredient": "Search ingredient...",
+  "inventory.recipeForm.createIngredient": "Create ingredient",
+  "inventory.recipeForm.notesPlaceholder": "e.g. diced, fresh",
+  "inventory.recipeForm.ingredientsConfigured": "{{configured}} of {{total}} ingredients configured",
+  "inventory.title": "Inventory",
+  "inventory.stock.title": "Stock",
+  "inventory.stock.minStock": "Min. Stock",
+  "inventory.stock.adjust": "Adjust Stock",
+  "inventory.stock.lowStock": "Low Stock",
+  "inventory.products.title": "Products",
+  "inventory.products.create": "New Product",
+  "inventory.recipes.create": "New Recipe",
+  "inventory.recipes.addIngredient": "Add Ingredient",
+  "inventory.recipes.cost": "Cost",
+  "inventory.recipes.loading": "Loading...",
+  "inventory.suppliers.title": "Suppliers",
+  "inventory.suppliers.create": "New Supplier",
+  "inventory.movements.title": "Movements",
+  "inventory.movements.in": "Stock In",
+  "inventory.movements.out": "Stock Out",
+  "inventory.settings.title": "Inventory Settings",
+}

package/src/locales/index.ts

@@ -0,0 +1,7 @@
+import { en } from './en'
+import { ptBR } from './pt-BR'
+
+export const inventoryLocales: Record<string, Record<string, string>> = {
+  en,
+  'pt-BR': ptBR,
+}