@fayz-ai/plugin-inventory 0.1.1

package/src/types.ts

@@ -0,0 +1,256 @@
+// ---------------------------------------------------------------------------
+// Inventory Plugin — Pure TypeScript types
+// Zero dependencies. Abstracted from beautyplace Estoque module.
+// ---------------------------------------------------------------------------
+
+// ============================================================
+// ENUMS / LITERALS
+// ============================================================
+
+/** Product classification — a product can have multiple types */
+export type ProductType = 'ingredient' | 'sale' | 'intermediate' | 'asset'
+
+/** Stock movement direction/reason */
+export type MovementType = 'entry' | 'exit' | 'adjustment' | 'transfer' | 'loss'
+
+/** Product purpose for filtering */
+export type ProductPurpose = 'purchase' | 'sale' | 'both' | 'internal'
+
+// ============================================================
+// CORE ENTITIES
+// ============================================================
+
+export interface Product {
+  id: string
+  name: string
+  description?: string
+  sku?: string
+  barcode?: string
+  brand?: string
+  categoryId?: string
+  categoryName?: string
+  productType: ProductType
+  purpose?: ProductPurpose
+  currentQuantity: number
+  minQuantity: number
+  maxQuantity?: number
+  costPrice: number
+  salePrice?: number
+  measurementUnitId?: string
+  measurementUnitName?: string
+  isActive: boolean
+  supplierId?: string
+  supplierName?: string
+  defaultLocationId?: string
+  imageUrl?: string
+  metadata?: Record<string, unknown>
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface StockMovement {
+  id: string
+  productId: string
+  productName?: string
+  quantity: number
+  movementType: MovementType
+  unitCost: number
+  totalCost: number
+  stockLocationId?: string
+  stockLocationName?: string
+  destinationLocationId?: string
+  destinationLocationName?: string
+  supplierId?: string
+  supplierName?: string
+  documentNumber?: string
+  reason?: string
+  notes?: string
+  movementDate: string
+  userId?: string
+  userName?: string
+  metadata?: Record<string, unknown>
+  tenantId: string
+  createdAt: string
+}
+
+export interface StockPosition {
+  id: string
+  productId: string
+  productName?: string
+  quantity: number
+  unitCost: number
+  stockLocationId?: string
+  stockLocationName?: string
+  batchNumber?: string
+  expirationDate?: string
+  tenantId: string
+  createdAt: string
+}
+
+export interface StockLocation {
+  id: string
+  name: string
+  description?: string
+  isActive: boolean
+  unitId?: string
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface Recipe {
+  id: string
+  name: string
+  description?: string
+  productId: string
+  productName?: string
+  yieldQuantity: number
+  yieldUnitId?: string
+  yieldUnitName?: string
+  preparationTimeMinutes?: number
+  instructions?: string
+  isActive: boolean
+  ingredientCount?: number
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface RecipeIngredient {
+  id: string
+  recipeId: string
+  productId: string
+  productName?: string
+  quantity: number
+  unitId?: string
+  unitName?: string
+  displayOrder: number
+  notes?: string
+  createdAt: string
+}
+
+export interface MeasurementUnit {
+  id: string
+  name: string
+  abbreviation: string
+  isActive: boolean
+  tenantId: string
+  createdAt: string
+}
+
+export interface ProductCategory {
+  id: string
+  name: string
+  parentId?: string
+  isActive: boolean
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+// ============================================================
+// INPUT TYPES
+// ============================================================
+
+export interface CreateProductInput {
+  name: string
+  description?: string
+  sku?: string
+  barcode?: string
+  brand?: string
+  categoryId?: string
+  productType: ProductType
+  purpose?: ProductPurpose
+  minQuantity?: number
+  maxQuantity?: number
+  costPrice?: number
+  salePrice?: number
+  measurementUnitId?: string
+  supplierId?: string
+  defaultLocationId?: string
+  imageUrl?: string
+  metadata?: Record<string, unknown>
+}
+
+export interface CreateStockMovementInput {
+  productId: string
+  quantity: number
+  movementType: MovementType
+  unitCost?: number
+  stockLocationId?: string
+  destinationLocationId?: string
+  supplierId?: string
+  documentNumber?: string
+  reason?: string
+  notes?: string
+  movementDate?: string
+  batchNumber?: string
+  expirationDate?: string
+}
+
+export interface CreateRecipeInput {
+  name: string
+  description?: string
+  productId: string
+  yieldQuantity: number
+  yieldUnitId?: string
+  preparationTimeMinutes?: number
+  instructions?: string
+  ingredients: CreateRecipeIngredientInput[]
+}
+
+export interface CreateRecipeIngredientInput {
+  productId: string
+  quantity: number
+  unitId?: string
+  displayOrder?: number
+  notes?: string
+}
+
+// ============================================================
+// QUERY / FILTER TYPES
+// ============================================================
+
+export interface DateRange {
+  from: string
+  to: string
+}
+
+export interface ProductQuery {
+  productType?: ProductType
+  categoryId?: string
+  search?: string
+  lowStockOnly?: boolean
+  isActive?: boolean
+  page?: number
+  pageSize?: number
+}
+
+export interface MovementQuery {
+  productId?: string
+  movementType?: MovementType | MovementType[]
+  stockLocationId?: string
+  dateRange?: DateRange
+  search?: string
+  page?: number
+  pageSize?: number
+}
+
+export interface PaginatedResult<T> {
+  data: T[]
+  total: number
+}
+
+// ============================================================
+// AGGREGATION TYPES
+// ============================================================
+
+export interface InventorySummary {
+  totalProducts: number
+  lowStockCount: number
+  outOfStockCount: number
+  totalStockValue: number
+  recentMovementCount: number
+  movementsByType: Record<MovementType, number>
+}

package/src/views/DashboardView.tsx

@@ -0,0 +1,11 @@
+import React from 'react'
+import { DashboardCanvas } from '@fayz-ai/ui'
+
+/**
+ * Inventory overview. KPIs and the activity panel are registered dashboard
+ * widgets (see ./dashboardWidgets), rendered through the shared DashboardCanvas;
+ * the stock-value KPI also surfaces on the global app home.
+ */
+export function DashboardView() {
+  return <DashboardCanvas surface="plugin-home" domain="inventory" showHeader={false} className="space-y-6" />
+}

package/src/views/MovementHistoryView.tsx

@@ -0,0 +1,104 @@
+import React, { useEffect, useState, useMemo } from 'react'
+import { ArrowUpRight, ArrowDownRight, RefreshCw, ArrowRightLeft, Trash2 } from 'lucide-react'
+import type { ColumnDef } from '@tanstack/react-table'
+import { ListView } from '@fayz-ai/ui'
+import { useInventoryStore, formatCurrency, useInventoryConfig } from '../InventoryContext'
+import { useTranslation } from '@fayz-ai/core'
+import { SubpageHeader } from '@fayz-ai/ui'
+import type { MovementType, StockMovement } from '../types'
+
+const TYPE_ICONS: Record<MovementType, React.ElementType> = {
+  entry: ArrowDownRight,
+  exit: ArrowUpRight,
+  adjustment: RefreshCw,
+  transfer: ArrowRightLeft,
+  loss: Trash2,
+}
+
+const TYPE_COLORS: Record<MovementType, string> = {
+  entry: 'text-success',
+  exit: 'text-destructive',
+  adjustment: 'text-info',
+  transfer: 'text-magic',
+  loss: 'text-warning',
+}
+
+export function MovementHistoryView({ onViewDetail }: { onViewDetail?: (id: string) => void } = {}) {
+  const t = useTranslation()
+  const { currency } = useInventoryConfig()
+  const movements = useInventoryStore((s) => s.movements)
+  const movementsLoading = useInventoryStore((s) => s.movementsLoading)
+  const fetchMovements = useInventoryStore((s) => s.fetchMovements)
+
+  const [search, setSearch] = useState('')
+
+  useEffect(() => { fetchMovements({ search: search || undefined }) }, [search])
+
+  const columns: ColumnDef<StockMovement, any>[] = useMemo(() => [
+    {
+      accessorKey: 'movementDate', header: t('inventory.history.columnDate'),
+      cell: ({ getValue }: any) => <span className="text-xs text-muted-foreground">{getValue() as string}</span>,
+    },
+    {
+      accessorKey: 'productName', header: t('inventory.history.columnProduct'),
+      cell: ({ getValue }: any) => <span className="font-medium">{(getValue() as string) ?? '—'}</span>,
+    },
+    {
+      accessorKey: 'movementType', header: t('inventory.history.columnType'),
+      cell: ({ getValue }: any) => {
+        const type = getValue() as MovementType
+        const Icon = TYPE_ICONS[type] ?? RefreshCw
+        const color = TYPE_COLORS[type] ?? 'text-muted-foreground'
+        return (
+          <span className={`inline-flex items-center gap-1 ${color}`}>
+            <Icon className="h-3 w-3" />
+            <span className="text-xs capitalize">{type}</span>
+          </span>
+        )
+      },
+    },
+    {
+      id: 'location', header: t('inventory.history.columnLocation'),
+      cell: ({ row }: any) => (
+        <span className="text-xs text-muted-foreground">
+          {row.original.stockLocationName ?? '—'}
+          {row.original.movementType === 'transfer' && row.original.destinationLocationName && (
+            <span> → {row.original.destinationLocationName}</span>
+          )}
+        </span>
+      ),
+    },
+    {
+      accessorKey: 'quantity', header: t('inventory.history.columnQty'),
+      cell: ({ row }: any) => (
+        <span className="text-right block">
+          {row.original.movementType === 'entry' ? '+' : '-'}{row.original.quantity}
+        </span>
+      ),
+    },
+    {
+      accessorKey: 'totalCost', header: t('inventory.history.columnTotal'),
+      cell: ({ getValue }: any) => (
+        <span className="text-right block text-muted-foreground">{formatCurrency(getValue() as number, currency)}</span>
+      ),
+    },
+  ], [currency, t])
+
+  return (
+    <div className="space-y-4">
+      <SubpageHeader title={t('inventory.history.title')} subtitle={t('inventory.history.subtitle')} />
+
+      <ListView<StockMovement>
+        columns={columns}
+        data={movements}
+        loading={movementsLoading}
+        searchPlaceholder={t('inventory.history.searchPlaceholder')}
+        search={search}
+        onSearchChange={setSearch}
+        searchDebounce={0}
+        onRowClick={onViewDetail ? (row) => onViewDetail(row.id) : undefined}
+        emptyMessage={t('inventory.history.noMovements')}
+      />
+    </div>
+  )
+}

package/src/views/ProductCrudForm.tsx

@@ -0,0 +1,99 @@
+import React from 'react'
+import { SubpageHeader, toast } from '@fayz-ai/ui'
+import { useTranslation } from '@fayz-ai/core'
+import { CrudFormPage } from '@fayz-ai/saas'
+import { useInventoryConfig, useInventoryStore, useInventoryProvider } from '../InventoryContext'
+import type { ProductType } from '../types'
+import { buildProductEntity } from './productEntity'
+
+// ---------------------------------------------------------------------------
+// Product create/edit, rendered through the generic CRUD form. The sectioned
+// layout (General Information · Classification · Pricing+Margin · Stock Levels)
+// comes from the shared buildProductEntity (segmented/computed/currency field
+// types). Persistence still flows through the inventory provider/store, so the
+// metadata-JSON column mapping is unchanged.
+// ---------------------------------------------------------------------------
+
+export function ProductCrudForm({ editId, onSaved }: { editId?: string; onSaved?: () => void }) {
+  const t = useTranslation()
+  const { productTypes, currency } = useInventoryConfig()
+  const provider = useInventoryProvider()
+  const createProduct = useInventoryStore((s) => s.createProduct)
+  const isEdit = !!editId
+
+  const [initialData, setInitialData] = React.useState<Record<string, any> | null>(isEdit ? null : {})
+  const [headerName, setHeaderName] = React.useState('')
+
+  // Load the existing product for edit and map it to flat form values.
+  React.useEffect(() => {
+    if (!editId) return
+    let cancelled = false
+    ;(async () => {
+      const p = await provider.getProductById(editId)
+      if (cancelled) return
+      setHeaderName(p?.name ?? '')
+      setInitialData(
+        p
+          ? {
+              name: p.name,
+              brand: p.brand ?? '',
+              sku: p.sku ?? '',
+              barcode: p.barcode ?? '',
+              description: p.description ?? '',
+              productType: p.productType,
+              costPrice: p.costPrice,
+              salePrice: p.salePrice ?? 0,
+              minQuantity: p.minQuantity,
+              maxQuantity: p.maxQuantity ?? 0,
+            }
+          : {},
+      )
+    })()
+    return () => { cancelled = true }
+  }, [editId])
+
+  const entity = React.useMemo(() => buildProductEntity(t, productTypes, currency), [t, productTypes, currency])
+
+  async function save(values: Record<string, any>) {
+    const name = String(values.name ?? '').trim()
+    if (!name) { toast.error(t('common.formIncomplete')); throw new Error('name required') }
+    const payload = {
+      name,
+      sku: values.sku || undefined,
+      barcode: values.barcode || undefined,
+      brand: values.brand || undefined,
+      productType: (values.productType ?? productTypes[0]?.value) as ProductType,
+      costPrice: Number(values.costPrice) || 0,
+      salePrice: Number(values.salePrice) || undefined,
+      minQuantity: Number(values.minQuantity) || 0,
+      maxQuantity: Number(values.maxQuantity) || undefined,
+      description: values.description || undefined,
+    }
+    if (isEdit && editId) {
+      await provider.updateProduct(editId, payload)
+    } else {
+      await createProduct(payload)
+    }
+    onSaved?.()
+  }
+
+  const title = isEdit ? (headerName || t('inventory.productForm.editProduct')) : t('inventory.productForm.newProduct')
+  const subtitle = isEdit ? undefined : t('inventory.productForm.addToCatalog')
+
+  return (
+    <div className="space-y-5">
+      <SubpageHeader title={title} subtitle={subtitle} onBack={onSaved} parentLabel={t('inventory.nav.products')} />
+      {initialData && (
+        <CrudFormPage
+          entityDef={entity}
+          mode={isEdit ? 'edit' : 'create'}
+          initialData={initialData}
+          onSubmit={save}
+          onCancel={() => onSaved?.()}
+          namePlural={t('inventory.nav.products')}
+          hideBreadcrumb
+        />
+      )}
+    </div>
+  )
+}