@tailor-platform/erp-kit 0.4.1 → 0.5.0

package/src/modules/inventory/testing/fixtures.ts

@@ -0,0 +1,412 @@
+import type {
+  Warehouse,
+  StorageLocation,
+  ValuationPolicy,
+  StockLevel,
+  StockMovement,
+  StockMoveLine,
+  Lot,
+  LotStockLevel,
+  SerialNumber,
+  InventoryCount,
+  InventoryCountLine,
+  InventoryAdjustment,
+  ItemValuation,
+  CostLayer,
+  Schema,
+} from "../lib/types";
+
+// Warehouse fixtures
+export const baseActiveWarehouse = {
+  id: "warehouse-1",
+  name: "Main Warehouse",
+  siteId: "site-1",
+  storageCondition: null,
+  capacity: null,
+  status: "ACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies Warehouse<Schema>;
+
+export const baseInactiveWarehouse = {
+  id: "warehouse-2",
+  name: "Closed Warehouse",
+  siteId: "site-1",
+  storageCondition: "cold",
+  capacity: 5000,
+  status: "INACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies Warehouse<Schema>;
+
+// StorageLocation fixtures
+export const baseZone = {
+  id: "location-1",
+  name: "Zone A",
+  code: "ZA",
+  warehouseId: "warehouse-1",
+  parentId: null,
+  locationType: "zone",
+  storageCondition: null,
+  capacity: null,
+  status: "ACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StorageLocation<Schema>;
+
+export const baseBin = {
+  id: "location-2",
+  name: "Bin A-1",
+  code: "BA1",
+  warehouseId: "warehouse-1",
+  parentId: "location-1",
+  locationType: "bin",
+  storageCondition: null,
+  capacity: null,
+  status: "ACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StorageLocation<Schema>;
+
+export const baseInactiveLocation = {
+  id: "location-3",
+  name: "Inactive Zone",
+  code: "IZ",
+  warehouseId: "warehouse-1",
+  parentId: null,
+  locationType: "zone",
+  storageCondition: null,
+  capacity: null,
+  status: "INACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StorageLocation<Schema>;
+
+// ValuationPolicy fixtures
+export const baseFifoPolicy = {
+  id: "policy-1",
+  name: "FIFO Policy",
+  costingMethod: "FIFO",
+  standardCostRate: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ValuationPolicy<Schema>;
+
+export const baseAvcoPolicy = {
+  id: "policy-2",
+  name: "AVCO Policy",
+  costingMethod: "AVCO",
+  standardCostRate: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ValuationPolicy<Schema>;
+
+export const baseStandardCostPolicy = {
+  id: "policy-3",
+  name: "Standard Cost Policy",
+  costingMethod: "STANDARD_COST",
+  standardCostRate: 10.5,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ValuationPolicy<Schema>;
+
+// StockLevel fixtures
+export const baseStockLevel = {
+  id: "stock-level-1",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  onHand: 100,
+  reserved: 10,
+  incoming: 20,
+  blocked: 5,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockLevel<Schema>;
+
+export const emptyStockLevel = {
+  id: "stock-level-2",
+  itemId: "item-2",
+  storageLocationId: "location-1",
+  onHand: 0,
+  reserved: 0,
+  incoming: 0,
+  blocked: 0,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockLevel<Schema>;
+
+// StockMovement fixtures
+export const baseDraftMovement = {
+  id: "movement-1",
+  movementType: "GOODS_RECEIPT",
+  reasonCode: null,
+  status: "DRAFT",
+  executedAt: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockMovement<Schema>;
+
+export const baseConfirmedMovement = {
+  id: "movement-2",
+  movementType: "GOODS_RECEIPT",
+  reasonCode: null,
+  status: "CONFIRMED",
+  executedAt: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockMovement<Schema>;
+
+export const baseDoneMovement = {
+  id: "movement-3",
+  movementType: "GOODS_RECEIPT",
+  reasonCode: null,
+  status: "DONE",
+  executedAt: new Date("2024-01-02T00:00:00.000Z"),
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockMovement<Schema>;
+
+export const baseCancelledMovement = {
+  id: "movement-4",
+  movementType: "GOODS_RECEIPT",
+  reasonCode: null,
+  status: "CANCELLED",
+  executedAt: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockMovement<Schema>;
+
+// StockMoveLine fixtures
+export const baseMoveLine = {
+  id: "move-line-1",
+  stockMovementId: "movement-1",
+  itemId: "item-1",
+  quantity: 50,
+  sourceLocationId: null,
+  destinationLocationId: "location-1",
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies StockMoveLine<Schema>;
+
+// Lot fixtures
+export const baseActiveLot = {
+  id: "lot-1",
+  lotNumber: "LOT-001",
+  itemId: "item-1",
+  manufactureDate: new Date("2024-01-01T00:00:00.000Z"),
+  expirationDate: new Date("2025-01-01T00:00:00.000Z"),
+  supplierLotReference: "SUP-LOT-001",
+  status: "ACTIVE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies Lot<Schema>;
+
+export const baseFullyConsumedLot = {
+  id: "lot-2",
+  lotNumber: "LOT-002",
+  itemId: "item-1",
+  manufactureDate: new Date("2023-06-01T00:00:00.000Z"),
+  expirationDate: new Date("2024-06-01T00:00:00.000Z"),
+  supplierLotReference: null,
+  status: "FULLY_CONSUMED",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies Lot<Schema>;
+
+// LotStockLevel fixtures
+export const baseLotStockLevel = {
+  id: "lot-stock-1",
+  lotId: "lot-1",
+  storageLocationId: "location-1",
+  onHand: 50,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies LotStockLevel<Schema>;
+
+// SerialNumber fixtures
+export const baseAvailableSerial = {
+  id: "serial-1",
+  serialNumber: "SN-001",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  status: "AVAILABLE",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies SerialNumber<Schema>;
+
+export const baseIssuedSerial = {
+  id: "serial-2",
+  serialNumber: "SN-002",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  status: "ISSUED",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies SerialNumber<Schema>;
+
+// InventoryCount fixtures
+export const basePlannedCount = {
+  id: "count-1",
+  countType: "FULL",
+  warehouseId: "warehouse-1",
+  storageLocationId: null,
+  plannedDate: new Date("2024-02-01T00:00:00.000Z"),
+  status: "PLANNED",
+  isFrozen: false,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryCount<Schema>;
+
+export const baseInProgressCount = {
+  id: "count-2",
+  countType: "FULL",
+  warehouseId: "warehouse-1",
+  storageLocationId: null,
+  plannedDate: new Date("2024-02-01T00:00:00.000Z"),
+  status: "IN_PROGRESS",
+  isFrozen: true,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryCount<Schema>;
+
+export const baseCompletedCount = {
+  id: "count-3",
+  countType: "FULL",
+  warehouseId: "warehouse-1",
+  storageLocationId: null,
+  plannedDate: new Date("2024-02-01T00:00:00.000Z"),
+  status: "COMPLETED",
+  isFrozen: false,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryCount<Schema>;
+
+// InventoryCountLine fixtures
+export const basePendingCountLine = {
+  id: "count-line-1",
+  inventoryCountId: "count-2",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  systemQuantity: 100,
+  countedQuantity: 98,
+  variance: -2,
+  status: "PENDING",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryCountLine<Schema>;
+
+export const baseApprovedCountLine = {
+  id: "count-line-2",
+  inventoryCountId: "count-2",
+  itemId: "item-2",
+  storageLocationId: "location-1",
+  systemQuantity: 50,
+  countedQuantity: 50,
+  variance: 0,
+  status: "APPROVED",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryCountLine<Schema>;
+
+// InventoryAdjustment fixtures
+export const baseDraftAdjustment = {
+  id: "adjustment-1",
+  adjustmentType: "CORRECTION",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  quantityDelta: -5,
+  reasonCode: "damage",
+  status: "DRAFT",
+  inventoryCountId: null,
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryAdjustment<Schema>;
+
+export const basePendingApprovalAdjustment = {
+  id: "adjustment-2",
+  adjustmentType: "CORRECTION",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  quantityDelta: -10,
+  reasonCode: "count-variance",
+  status: "PENDING_APPROVAL",
+  inventoryCountId: null,
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryAdjustment<Schema>;
+
+export const baseApprovedAdjustment = {
+  id: "adjustment-3",
+  adjustmentType: "CORRECTION",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  quantityDelta: 5,
+  reasonCode: "receiving-error",
+  status: "APPROVED",
+  inventoryCountId: null,
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryAdjustment<Schema>;
+
+export const baseRejectedAdjustment = {
+  id: "adjustment-4",
+  adjustmentType: "CORRECTION",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  quantityDelta: -20,
+  reasonCode: "theft",
+  status: "REJECTED",
+  inventoryCountId: null,
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryAdjustment<Schema>;
+
+export const baseConfirmedAdjustment = {
+  id: "adjustment-5",
+  adjustmentType: "SCRAP",
+  itemId: "item-1",
+  storageLocationId: "location-1",
+  quantityDelta: -3,
+  reasonCode: "expired",
+  status: "CONFIRMED",
+  inventoryCountId: null,
+  lotId: null,
+  serialNumberId: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies InventoryAdjustment<Schema>;
+
+// ItemValuation fixtures
+export const baseItemValuation = {
+  id: "valuation-1",
+  itemId: "item-1",
+  valuationPolicyId: "policy-1",
+  totalQuantity: 100,
+  totalValue: 1000,
+  costPerUnit: 10,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ItemValuation<Schema>;
+
+// CostLayer fixtures
+export const baseCostLayer = {
+  id: "cost-layer-1",
+  itemId: "item-1",
+  valuationPolicyId: "policy-1",
+  stockMovementId: "movement-3",
+  quantity: 100,
+  unitCost: 10,
+  remainingQuantity: 80,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies CostLayer<Schema>;

package/src/modules/item-management/docs/models/{item.md → Item.md}

@@ -1,4 +1,4 @@
-# item
+# Item
 
 ## Description
 

package/src/modules/primitives/seed/currencies.ts

@@ -0,0 +1,22 @@
+import { uuidv5 } from "../../../shared/uuidv5";
+import type { CurrencyCreate, Schema } from "../lib/types";
+
+const NS = "erp-kit:primitives";
+
+type SeedRow = Omit<CurrencyCreate<Schema>, "id">;
+
+export const currencyIds = {
+  USD: uuidv5(NS, "currency:USD"),
+  EUR: uuidv5(NS, "currency:EUR"),
+  GBP: uuidv5(NS, "currency:GBP"),
+  JPY: uuidv5(NS, "currency:JPY"),
+  CNY: uuidv5(NS, "currency:CNY"),
+} as const;
+
+export const currencies: Record<string, SeedRow> = {
+  [currencyIds.USD]: { code: "USD", name: "US Dollar", symbol: "$", decimalPlaces: 2, isBaseCurrency: true, isActive: true },
+  [currencyIds.EUR]: { code: "EUR", name: "Euro", symbol: "€", decimalPlaces: 2, isBaseCurrency: false, isActive: true },
+  [currencyIds.GBP]: { code: "GBP", name: "British Pound", symbol: "£", decimalPlaces: 2, isBaseCurrency: false, isActive: true },
+  [currencyIds.JPY]: { code: "JPY", name: "Japanese Yen", symbol: "¥", decimalPlaces: 0, isBaseCurrency: false, isActive: true },
+  [currencyIds.CNY]: { code: "CNY", name: "Chinese Yuan", symbol: "¥", decimalPlaces: 2, isBaseCurrency: false, isActive: true },
+};

package/src/modules/primitives/seed/exchangeRates.ts

@@ -0,0 +1,22 @@
+import { uuidv5 } from "../../../shared/uuidv5";
+import type { ExchangeRateCreate, Schema } from "../lib/types";
+import { currencyIds } from "./currencies";
+
+const NS = "erp-kit:primitives";
+
+type SeedRow = Omit<ExchangeRateCreate<Schema>, "id">;
+
+export const exchangeRateIds = {
+  "USD-EUR": uuidv5(NS, "rate:USD-EUR"),
+  "USD-GBP": uuidv5(NS, "rate:USD-GBP"),
+  "USD-JPY": uuidv5(NS, "rate:USD-JPY"),
+  "USD-CNY": uuidv5(NS, "rate:USD-CNY"),
+} as const;
+
+// Illustrative rates (USD-based, not live market data)
+export const exchangeRates: Record<string, SeedRow> = {
+  [exchangeRateIds["USD-EUR"]]: { sourceCurrencyId: currencyIds.USD, targetCurrencyId: currencyIds.EUR, rate: 0.92, effectiveDate: new Date("2025-01-01") },
+  [exchangeRateIds["USD-GBP"]]: { sourceCurrencyId: currencyIds.USD, targetCurrencyId: currencyIds.GBP, rate: 0.79, effectiveDate: new Date("2025-01-01") },
+  [exchangeRateIds["USD-JPY"]]: { sourceCurrencyId: currencyIds.USD, targetCurrencyId: currencyIds.JPY, rate: 148.5, effectiveDate: new Date("2025-01-01") },
+  [exchangeRateIds["USD-CNY"]]: { sourceCurrencyId: currencyIds.USD, targetCurrencyId: currencyIds.CNY, rate: 7.24, effectiveDate: new Date("2025-01-01") },
+};

package/src/modules/primitives/seed/index.ts

@@ -0,0 +1,4 @@
+export { uomCategories as UoMCategory, uomCategoryIds } from "./uomCategories";
+export { units as Unit, unitIds } from "./units";
+export { currencies as Currency, currencyIds } from "./currencies";
+export { exchangeRates as ExchangeRate } from "./exchangeRates";

package/src/modules/primitives/seed/seed.test.ts

@@ -0,0 +1,80 @@
+import { describe, it, expect } from "vitest";
+import { uuidv5 } from "../../../shared/uuidv5";
+import { uomCategories } from "./uomCategories";
+import { units, unitIds } from "./units";
+import { currencies, currencyIds } from "./currencies";
+import { exchangeRates } from "./exchangeRates";
+
+describe("primitives seed data", () => {
+  describe("uuid determinism", () => {
+    it("produces stable IDs across calls", () => {
+      const id1 = uuidv5("erp-kit:primitives", "currency:USD");
+      const id2 = uuidv5("erp-kit:primitives", "currency:USD");
+      expect(id1).toBe(id2);
+      expect(id1).toBe(currencyIds.USD);
+    });
+  });
+
+  describe("uomCategories", () => {
+    it("has all expected categories", () => {
+      const names = Object.values(uomCategories).map((c) => c.name);
+      expect(names).toEqual(["Weight", "Length", "Volume", "Area", "Time", "Quantity"]);
+    });
+
+    it("all entries are active", () => {
+      for (const row of Object.values(uomCategories)) {
+        expect(row.isActive).toBe(true);
+      }
+    });
+  });
+
+  describe("units", () => {
+    it("every unit references a valid category", () => {
+      const categoryIds = new Set(Object.keys(uomCategories));
+      for (const [id, row] of Object.entries(units)) {
+        expect(categoryIds.has(row.categoryId), `unit ${id} references missing category ${row.categoryId}`).toBe(true);
+      }
+    });
+
+    it("reference units have conversionFactor 1", () => {
+      const referenceUnits = [unitIds.kg, unitIds.m, unitIds.L, unitIds.sqm, unitIds.hr, unitIds.ea];
+      for (const id of referenceUnits) {
+        expect(units[id].conversionFactor).toBe(1);
+      }
+    });
+
+    it("has unique symbols", () => {
+      const symbols = Object.values(units).map((u) => u.symbol);
+      expect(new Set(symbols).size).toBe(symbols.length);
+    });
+  });
+
+  describe("currencies", () => {
+    it("has exactly one base currency", () => {
+      const baseCurrencies = Object.values(currencies).filter((c) => c.isBaseCurrency);
+      expect(baseCurrencies).toHaveLength(1);
+      expect(baseCurrencies[0].code).toBe("USD");
+    });
+
+    it("has unique codes", () => {
+      const codes = Object.values(currencies).map((c) => c.code);
+      expect(new Set(codes).size).toBe(codes.length);
+    });
+  });
+
+  describe("exchangeRates", () => {
+    it("all rates reference valid currencies", () => {
+      const cIds = new Set(Object.keys(currencies));
+      for (const [id, row] of Object.entries(exchangeRates)) {
+        expect(cIds.has(row.sourceCurrencyId), `rate ${id} references missing source ${row.sourceCurrencyId}`).toBe(true);
+        expect(cIds.has(row.targetCurrencyId), `rate ${id} references missing target ${row.targetCurrencyId}`).toBe(true);
+      }
+    });
+
+    it("all rates are positive", () => {
+      for (const row of Object.values(exchangeRates)) {
+        expect(row.rate).toBeGreaterThan(0);
+      }
+    });
+  });
+});

package/src/modules/primitives/seed/units.ts

@@ -0,0 +1,62 @@
+import { uuidv5 } from "../../../shared/uuidv5";
+import type { UnitCreate, Schema } from "../lib/types";
+import { uomCategoryIds } from "./uomCategories";
+
+const NS = "erp-kit:primitives";
+
+type SeedRow = Omit<UnitCreate<Schema>, "id">;
+
+export const unitIds = {
+  kg: uuidv5(NS, "unit:kg"),
+  g: uuidv5(NS, "unit:g"),
+  lb: uuidv5(NS, "unit:lb"),
+  oz: uuidv5(NS, "unit:oz"),
+  m: uuidv5(NS, "unit:m"),
+  cm: uuidv5(NS, "unit:cm"),
+  ft: uuidv5(NS, "unit:ft"),
+  in: uuidv5(NS, "unit:in"),
+  L: uuidv5(NS, "unit:L"),
+  mL: uuidv5(NS, "unit:mL"),
+  gal: uuidv5(NS, "unit:gal"),
+  sqm: uuidv5(NS, "unit:sqm"),
+  sqft: uuidv5(NS, "unit:sqft"),
+  hr: uuidv5(NS, "unit:hr"),
+  min: uuidv5(NS, "unit:min"),
+  s: uuidv5(NS, "unit:s"),
+  ea: uuidv5(NS, "unit:ea"),
+  dz: uuidv5(NS, "unit:dz"),
+  pk: uuidv5(NS, "unit:pk"),
+} as const;
+
+export const units: Record<string, SeedRow> = {
+  // Weight (reference: kg = 1.0)
+  [unitIds.kg]: { name: "Kilogram", symbol: "kg", categoryId: uomCategoryIds.Weight, conversionFactor: 1, roundingPrecision: 2, isActive: true },
+  [unitIds.g]: { name: "Gram", symbol: "g", categoryId: uomCategoryIds.Weight, conversionFactor: 0.001, roundingPrecision: 0, isActive: true },
+  [unitIds.lb]: { name: "Pound", symbol: "lb", categoryId: uomCategoryIds.Weight, conversionFactor: 0.453592, roundingPrecision: 2, isActive: true },
+  [unitIds.oz]: { name: "Ounce", symbol: "oz", categoryId: uomCategoryIds.Weight, conversionFactor: 0.0283495, roundingPrecision: 2, isActive: true },
+
+  // Length (reference: m = 1.0)
+  [unitIds.m]: { name: "Meter", symbol: "m", categoryId: uomCategoryIds.Length, conversionFactor: 1, roundingPrecision: 2, isActive: true },
+  [unitIds.cm]: { name: "Centimeter", symbol: "cm", categoryId: uomCategoryIds.Length, conversionFactor: 0.01, roundingPrecision: 0, isActive: true },
+  [unitIds.ft]: { name: "Foot", symbol: "ft", categoryId: uomCategoryIds.Length, conversionFactor: 0.3048, roundingPrecision: 2, isActive: true },
+  [unitIds.in]: { name: "Inch", symbol: "in", categoryId: uomCategoryIds.Length, conversionFactor: 0.0254, roundingPrecision: 2, isActive: true },
+
+  // Volume (reference: L = 1.0)
+  [unitIds.L]: { name: "Liter", symbol: "L", categoryId: uomCategoryIds.Volume, conversionFactor: 1, roundingPrecision: 2, isActive: true },
+  [unitIds.mL]: { name: "Milliliter", symbol: "mL", categoryId: uomCategoryIds.Volume, conversionFactor: 0.001, roundingPrecision: 0, isActive: true },
+  [unitIds.gal]: { name: "Gallon", symbol: "gal", categoryId: uomCategoryIds.Volume, conversionFactor: 3.78541, roundingPrecision: 2, isActive: true },
+
+  // Area (reference: m² = 1.0)
+  [unitIds.sqm]: { name: "Square Meter", symbol: "m²", categoryId: uomCategoryIds.Area, conversionFactor: 1, roundingPrecision: 2, isActive: true },
+  [unitIds.sqft]: { name: "Square Foot", symbol: "ft²", categoryId: uomCategoryIds.Area, conversionFactor: 0.092903, roundingPrecision: 2, isActive: true },
+
+  // Time (reference: hr = 1.0)
+  [unitIds.hr]: { name: "Hour", symbol: "hr", categoryId: uomCategoryIds.Time, conversionFactor: 1, roundingPrecision: 2, isActive: true },
+  [unitIds.min]: { name: "Minute", symbol: "min", categoryId: uomCategoryIds.Time, conversionFactor: 1 / 60, roundingPrecision: 0, isActive: true },
+  [unitIds.s]: { name: "Second", symbol: "s", categoryId: uomCategoryIds.Time, conversionFactor: 1 / 3600, roundingPrecision: 0, isActive: true },
+
+  // Quantity (reference: ea = 1.0)
+  [unitIds.ea]: { name: "Each", symbol: "ea", categoryId: uomCategoryIds.Quantity, conversionFactor: 1, roundingPrecision: 0, isActive: true },
+  [unitIds.dz]: { name: "Dozen", symbol: "dz", categoryId: uomCategoryIds.Quantity, conversionFactor: 12, roundingPrecision: 0, isActive: true },
+  [unitIds.pk]: { name: "Pack", symbol: "pk", categoryId: uomCategoryIds.Quantity, conversionFactor: 1, roundingPrecision: 0, isActive: true },
+};

package/src/modules/primitives/seed/uomCategories.ts

@@ -0,0 +1,24 @@
+import { uuidv5 } from "../../../shared/uuidv5";
+import type { UoMCategoryCreate, Schema } from "../lib/types";
+
+const NS = "erp-kit:primitives";
+
+type SeedRow = Omit<UoMCategoryCreate<Schema>, "id">;
+
+export const uomCategoryIds = {
+  Weight: uuidv5(NS, "uom-category:Weight"),
+  Length: uuidv5(NS, "uom-category:Length"),
+  Volume: uuidv5(NS, "uom-category:Volume"),
+  Area: uuidv5(NS, "uom-category:Area"),
+  Time: uuidv5(NS, "uom-category:Time"),
+  Quantity: uuidv5(NS, "uom-category:Quantity"),
+} as const;
+
+export const uomCategories: Record<string, SeedRow> = {
+  [uomCategoryIds.Weight]: { name: "Weight", description: "Mass and weight measurement", isActive: true },
+  [uomCategoryIds.Length]: { name: "Length", description: "Length and distance measurement", isActive: true },
+  [uomCategoryIds.Volume]: { name: "Volume", description: "Volume and capacity measurement", isActive: true },
+  [uomCategoryIds.Area]: { name: "Area", description: "Surface area measurement", isActive: true },
+  [uomCategoryIds.Time]: { name: "Time", description: "Time duration measurement", isActive: true },
+  [uomCategoryIds.Quantity]: { name: "Quantity", description: "Discrete count measurement", isActive: true },
+};