@open-mercato/core 0.6.7-develop.6661.1.0043ed1d03 → 0.6.7-develop.6670.1.4efa7961c6

package/src/modules/wms/migrations/Migration20260428110546.ts

@@ -0,0 +1,91 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260428110546_wms extends Migration {
+
+  override up(): void | Promise<void> {
+    this.addSql(`create table "wms_inventory_lots" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "catalog_variant_id" uuid not null, "sku" text not null, "lot_number" text not null, "batch_number" text null, "manufactured_at" timestamptz null, "best_before_at" timestamptz null, "expires_at" timestamptz null, "status" text not null default 'available', primary key ("id"));`);
+    this.addSql(`create unique index "wms_inventory_lots_variant_lot_unique_idx" on "wms_inventory_lots" ("organization_id", "catalog_variant_id", "lot_number") where deleted_at is null;`);
+    this.addSql(`create index "wms_inventory_lots_variant_idx" on "wms_inventory_lots" ("catalog_variant_id");`);
+    this.addSql(`create index "wms_inventory_lots_org_tenant_idx" on "wms_inventory_lots" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_product_inventory_profiles" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "catalog_product_id" uuid not null, "catalog_variant_id" uuid null, "default_uom" text not null, "track_lot" boolean not null default false, "track_serial" boolean not null default false, "track_expiration" boolean not null default false, "default_strategy" text not null, "reorder_point" numeric(16,4) not null default '0', "safety_stock" numeric(16,4) not null default '0', primary key ("id"));`);
+    this.addSql(`create unique index "wms_inventory_profiles_product_unique_idx" on "wms_product_inventory_profiles" ("organization_id", "catalog_product_id") where deleted_at is null and catalog_variant_id is null;`);
+    this.addSql(`create unique index "wms_inventory_profiles_variant_unique_idx" on "wms_product_inventory_profiles" ("organization_id", "catalog_variant_id") where deleted_at is null and catalog_variant_id is not null;`);
+    this.addSql(`create index "wms_inventory_profiles_org_tenant_idx" on "wms_product_inventory_profiles" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_warehouses" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "name" text not null, "code" text not null, "is_active" boolean not null default true, "address_line1" text null, "city" text null, "postal_code" text null, "country" text null, "timezone" text null, primary key ("id"));`);
+    this.addSql(`create unique index "wms_warehouses_org_code_unique_idx" on "wms_warehouses" ("organization_id", "code") where deleted_at is null;`);
+    this.addSql(`create index "wms_warehouses_org_tenant_idx" on "wms_warehouses" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_inventory_reservations" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "warehouse_id" uuid not null, "catalog_variant_id" uuid not null, "lot_id" uuid null, "serial_number" text null, "quantity" numeric(16,4) not null, "source_type" text not null, "source_id" uuid not null, "expires_at" timestamptz null, "status" text not null default 'active', primary key ("id"));`);
+    this.addSql(`create index "wms_inventory_reservations_status_idx" on "wms_inventory_reservations" ("organization_id", "warehouse_id", "catalog_variant_id", "status");`);
+    this.addSql(`create index "wms_inventory_reservations_source_idx" on "wms_inventory_reservations" ("organization_id", "source_type", "source_id");`);
+    this.addSql(`create index "wms_inventory_reservations_org_tenant_idx" on "wms_inventory_reservations" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_warehouse_locations" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "warehouse_id" uuid not null, "code" text not null, "type" text not null, "parent_id" uuid null, "is_active" boolean not null default true, "capacity_units" numeric(16,4) null, "capacity_weight" numeric(16,4) null, "constraints" jsonb null, primary key ("id"));`);
+    this.addSql(`create unique index "wms_warehouse_locations_warehouse_code_unique_idx" on "wms_warehouse_locations" ("warehouse_id", "code") where deleted_at is null;`);
+    this.addSql(`create index "wms_warehouse_locations_parent_idx" on "wms_warehouse_locations" ("parent_id");`);
+    this.addSql(`create index "wms_warehouse_locations_warehouse_idx" on "wms_warehouse_locations" ("warehouse_id");`);
+    this.addSql(`create index "wms_warehouse_locations_org_tenant_idx" on "wms_warehouse_locations" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_inventory_movements" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "warehouse_id" uuid not null, "location_from_id" uuid null, "location_to_id" uuid null, "catalog_variant_id" uuid not null, "lot_id" uuid null, "serial_number" text null, "quantity" numeric(16,4) not null, "type" text not null, "reference_type" text not null, "reference_id" uuid not null, "performed_by" uuid not null, "performed_at" timestamptz not null, "received_at" timestamptz not null, "reason" text null, primary key ("id"));`);
+    this.addSql(`create index "wms_inventory_movements_warehouse_performed_at_idx" on "wms_inventory_movements" ("organization_id", "warehouse_id", "performed_at" desc) where deleted_at is null;`);
+    this.addSql(`create index "wms_inventory_movements_reference_idx" on "wms_inventory_movements" ("organization_id", "reference_type", "reference_id");`);
+    this.addSql(`create index "wms_inventory_movements_variant_received_at_idx" on "wms_inventory_movements" ("organization_id", "catalog_variant_id", "received_at" desc) where deleted_at is null;`);
+    this.addSql(`create index "wms_inventory_movements_org_tenant_idx" on "wms_inventory_movements" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_inventory_balances" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "warehouse_id" uuid not null, "location_id" uuid not null, "catalog_variant_id" uuid not null, "lot_id" uuid null, "serial_number" text null, "quantity_on_hand" numeric(16,4) not null default '0', "quantity_reserved" numeric(16,4) not null default '0', "quantity_allocated" numeric(16,4) not null default '0', primary key ("id"));`);
+    this.addSql(`create unique index "wms_inventory_balances_serial_unique_idx" on "wms_inventory_balances" ("organization_id", "warehouse_id", "location_id", "catalog_variant_id", "serial_number") where serial_number is not null and deleted_at is null;`);
+    this.addSql(`create index "wms_inventory_balances_org_lot_idx" on "wms_inventory_balances" ("organization_id", "lot_id") where lot_id is not null and deleted_at is null;`);
+    this.addSql(`create index "wms_inventory_balances_org_location_variant_idx" on "wms_inventory_balances" ("organization_id", "location_id", "catalog_variant_id");`);
+    this.addSql(`create index "wms_inventory_balances_org_warehouse_variant_idx" on "wms_inventory_balances" ("organization_id", "warehouse_id", "catalog_variant_id");`);
+    this.addSql(`create index "wms_inventory_balances_org_tenant_idx" on "wms_inventory_balances" ("organization_id", "tenant_id");`);
+
+    this.addSql(`create table "wms_warehouse_zones" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "metadata" jsonb null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, "warehouse_id" uuid not null, "code" text not null, "name" text not null, "priority" int not null default 0, primary key ("id"));`);
+    this.addSql(`create unique index "wms_warehouse_zones_warehouse_code_unique_idx" on "wms_warehouse_zones" ("warehouse_id", "code") where deleted_at is null;`);
+    this.addSql(`create index "wms_warehouse_zones_warehouse_idx" on "wms_warehouse_zones" ("warehouse_id");`);
+    this.addSql(`create index "wms_warehouse_zones_org_tenant_idx" on "wms_warehouse_zones" ("organization_id", "tenant_id");`);
+
+    this.addSql(`alter table "wms_inventory_reservations" add constraint "wms_inventory_reservations_warehouse_id_foreign" foreign key ("warehouse_id") references "wms_warehouses" ("id");`);
+    this.addSql(`alter table "wms_inventory_reservations" add constraint "wms_inventory_reservations_lot_id_foreign" foreign key ("lot_id") references "wms_inventory_lots" ("id") on delete set null;`);
+
+    this.addSql(`alter table "wms_warehouse_locations" add constraint "wms_warehouse_locations_warehouse_id_foreign" foreign key ("warehouse_id") references "wms_warehouses" ("id");`);
+    this.addSql(`alter table "wms_warehouse_locations" add constraint "wms_warehouse_locations_parent_id_foreign" foreign key ("parent_id") references "wms_warehouse_locations" ("id") on delete set null;`);
+
+    this.addSql(`alter table "wms_inventory_movements" add constraint "wms_inventory_movements_warehouse_id_foreign" foreign key ("warehouse_id") references "wms_warehouses" ("id");`);
+    this.addSql(`alter table "wms_inventory_movements" add constraint "wms_inventory_movements_location_from_id_foreign" foreign key ("location_from_id") references "wms_warehouse_locations" ("id") on delete set null;`);
+    this.addSql(`alter table "wms_inventory_movements" add constraint "wms_inventory_movements_location_to_id_foreign" foreign key ("location_to_id") references "wms_warehouse_locations" ("id") on delete set null;`);
+    this.addSql(`alter table "wms_inventory_movements" add constraint "wms_inventory_movements_lot_id_foreign" foreign key ("lot_id") references "wms_inventory_lots" ("id") on delete set null;`);
+
+    this.addSql(`alter table "wms_inventory_balances" add constraint "wms_inventory_balances_warehouse_id_foreign" foreign key ("warehouse_id") references "wms_warehouses" ("id");`);
+    this.addSql(`alter table "wms_inventory_balances" add constraint "wms_inventory_balances_location_id_foreign" foreign key ("location_id") references "wms_warehouse_locations" ("id");`);
+    this.addSql(`alter table "wms_inventory_balances" add constraint "wms_inventory_balances_lot_id_foreign" foreign key ("lot_id") references "wms_inventory_lots" ("id") on delete set null;`);
+
+    this.addSql(`alter table "wms_warehouse_zones" add constraint "wms_warehouse_zones_warehouse_id_foreign" foreign key ("warehouse_id") references "wms_warehouses" ("id");`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`alter table "wms_inventory_reservations" drop constraint if exists "wms_inventory_reservations_lot_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_movements" drop constraint if exists "wms_inventory_movements_lot_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_balances" drop constraint if exists "wms_inventory_balances_lot_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_reservations" drop constraint if exists "wms_inventory_reservations_warehouse_id_foreign";`);
+    this.addSql(`alter table "wms_warehouse_locations" drop constraint if exists "wms_warehouse_locations_warehouse_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_movements" drop constraint if exists "wms_inventory_movements_warehouse_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_balances" drop constraint if exists "wms_inventory_balances_warehouse_id_foreign";`);
+    this.addSql(`alter table "wms_warehouse_zones" drop constraint if exists "wms_warehouse_zones_warehouse_id_foreign";`);
+    this.addSql(`alter table "wms_warehouse_locations" drop constraint if exists "wms_warehouse_locations_parent_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_movements" drop constraint if exists "wms_inventory_movements_location_from_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_movements" drop constraint if exists "wms_inventory_movements_location_to_id_foreign";`);
+    this.addSql(`alter table "wms_inventory_balances" drop constraint if exists "wms_inventory_balances_location_id_foreign";`);
+
+    this.addSql(`drop table if exists "wms_warehouse_zones" cascade;`);
+    this.addSql(`drop table if exists "wms_inventory_balances" cascade;`);
+    this.addSql(`drop table if exists "wms_inventory_movements" cascade;`);
+    this.addSql(`drop table if exists "wms_warehouse_locations" cascade;`);
+    this.addSql(`drop table if exists "wms_inventory_reservations" cascade;`);
+    this.addSql(`drop table if exists "wms_warehouses" cascade;`);
+    this.addSql(`drop table if exists "wms_product_inventory_profiles" cascade;`);
+    this.addSql(`drop table if exists "wms_inventory_lots" cascade;`);
+  }
+
+}

package/src/modules/wms/migrations/Migration20260527120000.ts

@@ -0,0 +1,15 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260527120000_wms extends Migration {
+
+  override up(): void | Promise<void> {
+    this.addSql(`alter table "wms_warehouses" add column "is_primary" boolean not null default false;`);
+    this.addSql(`create unique index "wms_warehouses_org_primary_unique_idx" on "wms_warehouses" ("organization_id") where deleted_at is null and is_primary = true;`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`drop index if exists "wms_warehouses_org_primary_unique_idx";`);
+    this.addSql(`alter table "wms_warehouses" drop column if exists "is_primary";`);
+  }
+
+}

package/src/modules/wms/migrations/Migration20260527140000.ts

@@ -0,0 +1,35 @@
+import { Migration } from '@mikro-orm/migrations'
+
+export class Migration20260527140000_wms extends Migration {
+  override up(): void | Promise<void> {
+    this.addSql(`
+      create table "wms_sales_order_warehouse_assignments" (
+        "id" uuid not null default gen_random_uuid(),
+        "organization_id" uuid not null,
+        "tenant_id" uuid not null,
+        "sales_order_id" uuid not null,
+        "warehouse_id" uuid not null,
+        "assigned_by" uuid,
+        "notes" text,
+        "metadata" jsonb,
+        "created_at" timestamptz not null default now(),
+        "updated_at" timestamptz not null default now(),
+        "deleted_at" timestamptz,
+        constraint "wms_sowa_pkey" primary key ("id")
+      );
+    `)
+    this.addSql(
+      `create index "wms_sowa_org_tenant_idx" on "wms_sales_order_warehouse_assignments" ("organization_id", "tenant_id");`,
+    )
+    this.addSql(
+      `create index "wms_sowa_warehouse_idx" on "wms_sales_order_warehouse_assignments" ("warehouse_id");`,
+    )
+    this.addSql(
+      `create unique index "wms_sowa_org_order_unique_idx" on "wms_sales_order_warehouse_assignments" ("organization_id", "sales_order_id") where deleted_at is null;`,
+    )
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`drop table if exists "wms_sales_order_warehouse_assignments";`)
+  }
+}

package/src/modules/wms/migrations/Migration20260613120000.ts

@@ -0,0 +1,21 @@
+import { Migration } from '@mikro-orm/migrations'
+
+export class Migration20260613120000_wms extends Migration {
+  override up(): void | Promise<void> {
+    this.addSql(`alter table "wms_inventory_movements" add column "idempotency_key" text null;`)
+    this.addSql(`alter table "wms_inventory_reservations" add column "idempotency_key" text null;`)
+    this.addSql(
+      `create unique index "wms_inventory_movements_idempotency_unique_idx" on "wms_inventory_movements" ("organization_id", "idempotency_key") where idempotency_key is not null and deleted_at is null;`,
+    )
+    this.addSql(
+      `create unique index "wms_inventory_reservations_idempotency_unique_idx" on "wms_inventory_reservations" ("organization_id", "idempotency_key") where idempotency_key is not null and deleted_at is null and status = 'active';`,
+    )
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`drop index if exists "wms_inventory_reservations_idempotency_unique_idx";`)
+    this.addSql(`drop index if exists "wms_inventory_movements_idempotency_unique_idx";`)
+    this.addSql(`alter table "wms_inventory_reservations" drop column if exists "idempotency_key";`)
+    this.addSql(`alter table "wms_inventory_movements" drop column if exists "idempotency_key";`)
+  }
+}

package/src/modules/wms/migrations/Migration20260616090000.ts

@@ -0,0 +1,11 @@
+import { Migration } from '@mikro-orm/migrations'
+
+export class Migration20260616090000_wms extends Migration {
+  override up(): void | Promise<void> {
+    this.addSql(`alter table "wms_inventory_movements" add column "reason_code" text null;`)
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`alter table "wms_inventory_movements" drop column if exists "reason_code";`)
+  }
+}

package/src/modules/wms/migrations/Migration20260707180000.ts

@@ -0,0 +1,13 @@
+import { Migration } from '@mikro-orm/migrations'
+
+export class Migration20260707180000_wms extends Migration {
+  override up(): void | Promise<void> {
+    this.addSql(
+      `alter table "wms_inventory_balances" add column "quantity_available" numeric(16,4) generated always as ("quantity_on_hand" - "quantity_reserved" - "quantity_allocated") stored not null;`,
+    )
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`alter table "wms_inventory_balances" drop column if exists "quantity_available";`)
+  }
+}

package/src/modules/wms/notifications.client.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+import { notificationTypes } from './notifications'
+import { WmsLowStockRenderer } from './widgets/notifications/WmsLowStockRenderer'
+import { WmsReservationShortfallRenderer } from './widgets/notifications/WmsReservationShortfallRenderer'
+
+const rendererMap: Record<string, NotificationTypeDefinition['Renderer']> = {
+  'wms.inventory.low_stock': WmsLowStockRenderer,
+  'wms.inventory.reservation_shortfall': WmsReservationShortfallRenderer,
+}
+
+export const wmsNotificationTypes: NotificationTypeDefinition[] = notificationTypes.map((type) => ({
+  ...type,
+  Renderer: rendererMap[type.type],
+}))
+
+export default wmsNotificationTypes

package/src/modules/wms/notifications.ts

@@ -0,0 +1,51 @@
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+
+export const notificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'wms.inventory.low_stock',
+    module: 'wms',
+    titleKey: 'wms.notifications.lowStock.title',
+    bodyKey: 'wms.notifications.lowStock.body',
+    icon: 'alert-triangle',
+    severity: 'warning',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'wms.notifications.lowStock.renderer.viewInventory',
+        variant: 'outline',
+        href: '/backend/wms/inventory',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/wms/inventory',
+    expiresAfterHours: 72,
+  },
+  {
+    type: 'wms.inventory.reservation_shortfall',
+    module: 'wms',
+    titleKey: 'wms.notifications.reservationShortfall.title',
+    bodyKey: 'wms.notifications.reservationShortfall.body',
+    icon: 'alert-triangle',
+    severity: 'warning',
+    actions: [
+      {
+        id: 'view-order',
+        labelKey: 'wms.notifications.reservationShortfall.renderer.viewOrder',
+        variant: 'outline',
+        href: '/backend/sales/orders/{sourceEntityId}',
+        icon: 'external-link',
+      },
+      {
+        id: 'view-inventory',
+        labelKey: 'wms.notifications.reservationShortfall.renderer.viewInventory',
+        variant: 'outline',
+        href: '/backend/wms/inventory',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/orders/{sourceEntityId}',
+    expiresAfterHours: 72,
+  },
+]
+
+export default notificationTypes

package/src/modules/wms/search.ts

@@ -0,0 +1,230 @@
+import type {
+  SearchBuildContext,
+  SearchIndexSource,
+  SearchModuleConfig,
+  SearchResultPresenter,
+} from '@open-mercato/shared/modules/search'
+import type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { E } from '#generated/entities.ids.generated'
+
+const WMS_ROOT_URL = '/backend/wms'
+const WMS_INVENTORY_URL = '/backend/wms/inventory'
+const WMS_CONFIG_URL = '/backend/config/wms'
+
+function pickString(...candidates: Array<unknown>): string | null {
+  for (const candidate of candidates) {
+    if (typeof candidate !== 'string') continue
+    const trimmed = candidate.trim()
+    if (trimmed.length > 0) return trimmed
+  }
+  return null
+}
+
+function appendLine(lines: string[], label: string, value: unknown) {
+  if (value === null || value === undefined) return
+  const text = Array.isArray(value)
+    ? value.map((item) => (item == null ? '' : String(item))).filter(Boolean).join(', ')
+    : typeof value === 'object'
+      ? JSON.stringify(value)
+      : String(value)
+  if (!text.trim()) return
+  lines.push(`${label}: ${text}`)
+}
+
+function formatSubtitle(...parts: Array<unknown>): string | undefined {
+  const values = parts
+    .map((part) => (part == null ? '' : String(part)).trim())
+    .filter(Boolean)
+  if (!values.length) return undefined
+  return values.join(' · ')
+}
+
+function buildIndexSource(
+  ctx: SearchBuildContext,
+  presenter: SearchResultPresenter,
+  lines: string[],
+): SearchIndexSource | null {
+  for (const [key, value] of Object.entries(ctx.customFields)) {
+    appendLine(lines, key.replace(/^cf:/, ''), value)
+  }
+  if (!lines.length) return null
+  return {
+    text: lines,
+    presenter,
+    checksumSource: { record: ctx.record, customFields: ctx.customFields },
+  }
+}
+
+function buildWarehousePresenter(
+  t: TranslateFn,
+  record: Record<string, unknown>,
+): SearchResultPresenter {
+  const label = t('wms.search.badge.warehouse', 'Warehouse')
+  const title = pickString(record.name, record.code, record.id) ?? label
+  const subtitle = formatSubtitle(record.code, record.city, record.country)
+  return { title, subtitle, icon: 'warehouse', badge: label }
+}
+
+function buildLocationPresenter(
+  t: TranslateFn,
+  record: Record<string, unknown>,
+): SearchResultPresenter {
+  const label = t('wms.search.badge.location', 'Location')
+  const title = pickString(record.code, record.id) ?? label
+  const subtitle = formatSubtitle(record.type, record.warehouse_id ?? record.warehouseId)
+  return { title, subtitle, icon: 'map-pinned', badge: label }
+}
+
+function buildInventoryProfilePresenter(
+  t: TranslateFn,
+  record: Record<string, unknown>,
+): SearchResultPresenter {
+  const label = t('wms.search.badge.inventoryProfile', 'Inventory profile')
+  const productId = pickString(record.catalog_product_id, record.catalogProductId)
+  const variantId = pickString(record.catalog_variant_id, record.catalogVariantId)
+  const title = variantId || productId || pickString(record.id) || label
+  const subtitle = formatSubtitle(
+    record.default_strategy ?? record.defaultStrategy,
+    record.default_uom ?? record.defaultUom,
+    variantId ? t('wms.search.profile.variantScoped', 'Variant-scoped') : t('wms.search.profile.productScoped', 'Product-scoped'),
+  )
+  return { title, subtitle, icon: 'boxes', badge: label }
+}
+
+function buildLotPresenter(
+  t: TranslateFn,
+  record: Record<string, unknown>,
+): SearchResultPresenter {
+  const label = t('wms.search.badge.lot', 'Inventory lot')
+  const title = pickString(record.lot_number, record.lotNumber, record.batch_number, record.batchNumber, record.id) ?? label
+  const subtitle = formatSubtitle(record.catalog_variant_id ?? record.catalogVariantId, record.status, record.expires_at ?? record.expiresAt)
+  return { title, subtitle, icon: 'package-search', badge: label }
+}
+
+export const searchConfig: SearchModuleConfig = {
+  entities: [
+    {
+      entityId: E.wms.warehouse,
+      enabled: true,
+      priority: 8,
+      buildSource: async (ctx) => {
+        const { t } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Name', record.name)
+        appendLine(lines, 'Code', record.code)
+        appendLine(lines, 'City', record.city)
+        appendLine(lines, 'Country', record.country)
+        appendLine(lines, 'Timezone', record.timezone)
+        return buildIndexSource(ctx, buildWarehousePresenter(t, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t } = await resolveTranslations()
+        return buildWarehousePresenter(t, ctx.record)
+      },
+      resolveUrl: async () => WMS_CONFIG_URL,
+      fieldPolicy: {
+        searchable: ['name', 'code', 'city', 'country', 'timezone'],
+      },
+    },
+    {
+      entityId: E.wms.warehouse_location,
+      enabled: true,
+      priority: 7,
+      buildSource: async (ctx) => {
+        const { t } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Code', record.code)
+        appendLine(lines, 'Type', record.type)
+        appendLine(lines, 'Warehouse', record.warehouse_id ?? record.warehouseId)
+        appendLine(lines, 'Parent', record.parent_id ?? record.parentId)
+        appendLine(lines, 'Capacity units', record.capacity_units ?? record.capacityUnits)
+        appendLine(lines, 'Capacity weight', record.capacity_weight ?? record.capacityWeight)
+        return buildIndexSource(ctx, buildLocationPresenter(t, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t } = await resolveTranslations()
+        return buildLocationPresenter(t, ctx.record)
+      },
+      resolveUrl: async () => WMS_CONFIG_URL,
+      fieldPolicy: {
+        searchable: ['code', 'type', 'warehouse_id', 'parent_id', 'capacity_units', 'capacity_weight'],
+      },
+    },
+    {
+      entityId: E.wms.product_inventory_profile,
+      enabled: true,
+      priority: 8,
+      buildSource: async (ctx) => {
+        const { t } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Product', record.catalog_product_id ?? record.catalogProductId)
+        appendLine(lines, 'Variant', record.catalog_variant_id ?? record.catalogVariantId)
+        appendLine(lines, 'Default UOM', record.default_uom ?? record.defaultUom)
+        appendLine(lines, 'Strategy', record.default_strategy ?? record.defaultStrategy)
+        appendLine(lines, 'Reorder point', record.reorder_point ?? record.reorderPoint)
+        appendLine(lines, 'Safety stock', record.safety_stock ?? record.safetyStock)
+        appendLine(lines, 'Track lot', record.track_lot ?? record.trackLot)
+        appendLine(lines, 'Track serial', record.track_serial ?? record.trackSerial)
+        appendLine(lines, 'Track expiration', record.track_expiration ?? record.trackExpiration)
+        return buildIndexSource(ctx, buildInventoryProfilePresenter(t, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t } = await resolveTranslations()
+        return buildInventoryProfilePresenter(t, ctx.record)
+      },
+      resolveUrl: async (ctx) => {
+        const variantId = pickString(ctx.record.catalog_variant_id, ctx.record.catalogVariantId)
+        if (variantId) return `${WMS_ROOT_URL}/sku/${variantId}`
+        return WMS_CONFIG_URL
+      },
+      resolveLinks: async () => [{ href: WMS_INVENTORY_URL, label: 'Inventory console', kind: 'secondary' }],
+      fieldPolicy: {
+        searchable: [
+          'catalog_product_id',
+          'catalog_variant_id',
+          'default_uom',
+          'default_strategy',
+          'reorder_point',
+          'safety_stock',
+        ],
+      },
+    },
+    {
+      entityId: E.wms.inventory_lot,
+      enabled: true,
+      priority: 6,
+      buildSource: async (ctx) => {
+        const { t } = await resolveTranslations()
+        const record = ctx.record
+        const lines: string[] = []
+        appendLine(lines, 'Lot number', record.lot_number ?? record.lotNumber)
+        appendLine(lines, 'Batch number', record.batch_number ?? record.batchNumber)
+        appendLine(lines, 'SKU', record.sku)
+        appendLine(lines, 'Variant', record.catalog_variant_id ?? record.catalogVariantId)
+        appendLine(lines, 'Status', record.status)
+        appendLine(lines, 'Expires at', record.expires_at ?? record.expiresAt)
+        return buildIndexSource(ctx, buildLotPresenter(t, record), lines)
+      },
+      formatResult: async (ctx) => {
+        const { t } = await resolveTranslations()
+        return buildLotPresenter(t, ctx.record)
+      },
+      resolveUrl: async (ctx) => {
+        const id = pickString(ctx.record.id)
+        if (id) return `${WMS_ROOT_URL}/lot/${id}`
+        return WMS_ROOT_URL
+      },
+      resolveLinks: async () => [{ href: WMS_CONFIG_URL, label: 'WMS configuration', kind: 'secondary' }],
+      fieldPolicy: {
+        searchable: ['lot_number', 'batch_number', 'sku', 'catalog_variant_id', 'status', 'expires_at'],
+      },
+    },
+  ],
+}
+
+export default searchConfig
+export const config = searchConfig

package/src/modules/wms/setup.ts

@@ -0,0 +1,29 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { ensureRoles } from '@open-mercato/core/modules/auth/lib/setup-app'
+import {
+  WMS_CUSTOM_ROLE_NAMES,
+  WMS_OPERATOR_FEATURES,
+  WMS_OPERATOR_ROLE,
+  WMS_SUPERVISOR_FEATURES,
+  WMS_SUPERVISOR_ROLE,
+} from './lib/roleFeatures'
+import { seedWmsIntegrationToggles } from './lib/wmsIntegrationToggles'
+
+async function seedWmsRoles(em: Parameters<typeof ensureRoles>[0], tenantId: string): Promise<void> {
+  await ensureRoles(em, { tenantId, roleNames: [...WMS_CUSTOM_ROLE_NAMES] })
+}
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    await seedWmsIntegrationToggles(ctx.em)
+    await seedWmsRoles(ctx.em, ctx.tenantId)
+  },
+  defaultRoleFeatures: {
+    admin: ['wms.*'],
+    employee: ['wms.view'],
+    [WMS_OPERATOR_ROLE]: [...WMS_OPERATOR_FEATURES],
+    [WMS_SUPERVISOR_ROLE]: [...WMS_SUPERVISOR_FEATURES],
+  },
+}
+
+export default setup

package/src/modules/wms/subscribers/low-stock-notification.ts

@@ -0,0 +1,54 @@
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { notificationTypes } from '../notifications'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('wms')
+
+export const metadata = {
+  event: 'wms.inventory.low_stock',
+  persistent: true,
+  id: 'wms:low-stock-notification',
+}
+
+type LowStockPayload = {
+  catalogVariantId: string
+  availableQuantity: number
+  reorderPoint: number
+  safetyStock: number
+  state: 'below_safety_stock' | 'below_reorder_point'
+  tenantId: string
+  organizationId?: string | null
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+export default async function handle(payload: LowStockPayload, ctx: ResolverContext) {
+  try {
+    const notificationService = resolveNotificationService(ctx)
+    const typeDef = notificationTypes.find((type) => type.type === 'wms.inventory.low_stock')
+    if (!typeDef) return
+
+    const notificationInput = buildFeatureNotificationFromType(typeDef, {
+      requiredFeature: 'wms.view',
+      bodyVariables: {
+        availableQuantity: String(payload.availableQuantity),
+        reorderPoint: String(payload.reorderPoint),
+        safetyStock: String(payload.safetyStock),
+        state: payload.state,
+      },
+      sourceEntityType: 'wms:inventory_balance',
+      sourceEntityId: payload.catalogVariantId,
+      linkHref: `/backend/wms/sku/${encodeURIComponent(payload.catalogVariantId)}`,
+    })
+
+    await notificationService.createForFeature(notificationInput, {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+    })
+  } catch (err) {
+    logger.error('Failed to create notification', { subscriber: 'low-stock-notification', err })
+  }
+}