packages/bom-inventory/
├── src/
│   ├── types.ts                    # Zod schemas for Recipe, InventoryRecord, StoreTransferOrder
│   ├── recipe-bom.ts               # explodeBOM, explodeBatch, calculateRecipeCost, RecipeCatalog, convertUnit
│   ├── variance-analyzer.ts        # calculateItemVariance, analyzeStoreVariance
│   ├── store-transfer.ts           # createTransferOrder, dispatchTransfer, verifyReceiveTransfer
│   ├── inventory-alert/
│   │   ├── batch-manager.ts        # BatchManager (FEFO sorting & allocation)
│   │   ├── expiry-evaluator.ts     # evaluateBatchExpiry, evaluateInventoryExpiry
│   │   ├── low-stock-engine.ts     # evaluateStockLevel (calculateReorderPoint)
│   │   └── shrinkage-logger.ts     # ShrinkageLogger (Audit trail for spoiled/damaged goods)
│   ├── wms-barcode/
│   │   ├── barcode-scanner.ts      # parseGS1128, parseBarcode, BarcodeScannerBuffer
│   │   ├── bin-location.ts         # BinLocationSchema, isValidBinLocation, formatBinLocation
│   │   ├── s-shape-2opt-router.ts  # optimizeSshape2OptRoute, calculateWarehouseWalkingDistance
│   │   └── stock-movement-ledger.ts# IdempotentStockLedger
│   └── index.ts                    # SSoT Unified Barrel

import {
  RecipeCatalog,
  DEFAULT_FNB_RECIPES,
  BatchManager,
  optimizeSshape2OptRoute,
  calculateWarehouseWalkingDistance,
  parseGS1128,
  type Recipe,
  type BatchItem,
} from '@kido/bom-inventory';

// 1. Initialize Recipe Catalog with F&B Recipes
const catalog = new RecipeCatalog(DEFAULT_FNB_RECIPES);

// 2. Explode Raw Ingredient Requirements for 40 Large Pepperoni Pizzas
const pizzaRecipe = catalog.getRecipe('PIZZA_PEPPERONI_L')!;
const exploded = catalog.explodeRecipe('PIZZA_PEPPERONI_L', 40, {
  wasteMultiplier: 1.05, // 5% kitchen preparation waste factor
});

console.log(`Exploded BOM for 40x ${pizzaRecipe.name}:`);
exploded.ingredients.forEach((ing) => {
  console.log(`- ${ing.ingredientName}: ${ing.requiredQuantity} ${ing.unit} (Cost: ${ing.costVnd.toLocaleString()}₫)`);
});

// 3. FEFO Batch Allocation for Mozzarella Cheese (Requires 8,400g)
const cheeseBatches: BatchItem[] = [
  {
    id: 'batch-c2',
    sku: 'RAW-MOZZARELLA',
    quantity: 5000,
    unit: 'g',
    receivedDate: new Date('2026-11-10'),
    expiryDate: new Date('2026-11-28'), // Expires later
    locationBin: 'A-02-03',
  },
  {
    id: 'batch-c1',
    sku: 'RAW-MOZZARELLA',
    quantity: 4000,
    unit: 'g',
    receivedDate: new Date('2026-11-05'),
    expiryDate: new Date('2026-11-22'), // Expires SOONEST -> FEFO Priority #1
    locationBin: 'A-01-01',
  },
];

const batchManager = new BatchManager();
const allocation = batchManager.allocateFefo(cheeseBatches, 8400);

console.log('FEFO Allocation Result:');
allocation.allocatedBatches.forEach((b) => {
  console.log(`- Pull ${b.allocatedQuantity}g from Bin ${b.locationBin} (Batch: ${b.batchId}, Expires: ${b.expiryDate.toISOString().split('T')[0]})`);
});

// 4. Warehouse Pick Path Optimization (S-Shape + 2-Opt Heuristic)
const pickLocations = [
  { binCode: 'A-01-02', aisle: 1, section: 1, level: 2, x: 2, y: 5 },
  { binCode: 'B-04-01', aisle: 2, section: 4, level: 1, x: 6, y: 20 },
  { binCode: 'A-03-01', aisle: 1, section: 3, level: 1, x: 2, y: 15 },
  { binCode: 'B-01-03', aisle: 2, section: 1, level: 3, x: 6, y: 5 },
];

const unoptimizedDistance = calculateWarehouseWalkingDistance(pickLocations);
const optimizedPickSequence = optimizeSshape2OptRoute(pickLocations);
const optimizedDistance = calculateWarehouseWalkingDistance(optimizedPickSequence);

console.log('Pick Path Optimization:', {
  initialDistanceMeters: `${unoptimizedDistance}m`,
  optimizedDistanceMeters: `${optimizedDistance}m`,
  distanceSavedPercent: `${Math.round(((unoptimizedDistance - optimizedDistance) / unoptimizedDistance) * 100)}%`,
  pickSequence: optimizedPickSequence.map(p => p.binCode),
});

// 5. GS1-128 Barcode Verification during Picking
const rawBarcode = '(01)08935001234567(10)LOT2026A(17)261122(21)SN998822';
const parsedGS1 = parseGS1128(rawBarcode);
console.log('Scanned GS1 Barcode:', {
  gtin: parsedGS1.gtin,       // 08935001234567
  batch: parsedGS1.batchLot,  // LOT2026A
  expiry: parsedGS1.expiryDate,// 2026-11-22
  serial: parsedGS1.serialNumber, // SN998822
});