@open-mercato/core 0.4.2-canary-ed15f2e753 → 0.4.2-canary-f075c3eb92

package/src/modules/configs/lib/upgrade-actions.ts

@@ -4,13 +4,8 @@ import type { AwilixContainer } from 'awilix'
 import { Role, RoleAcl } from '@open-mercato/core/modules/auth/data/entities'
 import type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'
 import { reindexModules } from '@open-mercato/core/modules/configs/lib/reindex-helpers'
-import { installExampleCatalogData, type CatalogSeedScope } from '@open-mercato/core/modules/catalog/lib/seeds'
-import { seedSalesExamples } from '@open-mercato/core/modules/sales/seed/examples'
-import { seedExampleCurrencies } from '@open-mercato/core/modules/currencies/lib/seeds'
-import { seedExampleWorkflows } from '@open-mercato/core/modules/workflows/lib/seeds'
-import { seedPlannerAvailabilityRuleSetDefaults, seedPlannerUnavailabilityReasons } from '@open-mercato/core/modules/planner/lib/seeds'
-import { seedResourcesAddressTypes, seedResourcesCapacityUnits, seedResourcesResourceExamples } from '@open-mercato/core/modules/resources/lib/seeds'
-import { seedStaffTeamExamples } from '@open-mercato/core/modules/staff/lib/seeds'
+// Optional module imports are loaded dynamically inside each upgrade action
+// so the app does not crash when a module is disabled.
 import { collectCrudCacheStats, purgeCrudCacheSegment } from '@open-mercato/shared/lib/crud/cache-stats'
 import { isCrudCacheEnabled, resolveCrudCache } from '@open-mercato/shared/lib/crud/cache'
 import * as semver from 'semver'
@@ -91,7 +86,9 @@ async function ensureVectorSearchEncryptionMap(
   return true
 }
 
-export type UpgradeActionContext = CatalogSeedScope & {
+export type UpgradeActionContext = {
+  tenantId: string
+  organizationId: string
   container: AwilixContainer
   em: EntityManager
 }
@@ -155,6 +152,14 @@ export const upgradeActions: UpgradeActionDefinition[] = [
     successKey: 'upgrades.v034.success',
     loadingKey: 'upgrades.v034.loading',
     async run({ container, em, tenantId, organizationId }) {
+      let installExampleCatalogData: typeof import('@open-mercato/core/modules/catalog/lib/seeds')['installExampleCatalogData'] | undefined
+      try {
+        const catalogSeeds = await import('@open-mercato/core/modules/catalog/lib/seeds')
+        installExampleCatalogData = catalogSeeds.installExampleCatalogData
+      } catch {
+        console.warn('[upgrade-actions] catalog module not available, skipping catalog example data')
+        return
+      }
       await installExampleCatalogData(container, { tenantId, organizationId }, em)
       const vectorService = resolveVectorService(container)
       await reindexModules(em, ['catalog'], { tenantId, organizationId, vectorService })
@@ -214,8 +219,16 @@ export const upgradeActions: UpgradeActionDefinition[] = [
     successKey: 'upgrades.v036.success',
     loadingKey: 'upgrades.v036.loading',
     async run({ container, em, tenantId, organizationId }) {
+      let seedSalesExamples: typeof import('@open-mercato/core/modules/sales/seed/examples')['seedSalesExamples'] | undefined
+      try {
+        const salesSeeds = await import('@open-mercato/core/modules/sales/seed/examples')
+        seedSalesExamples = salesSeeds.seedSalesExamples
+      } catch {
+        console.warn('[upgrade-actions] sales module not available, skipping sales example data')
+        return
+      }
       await em.transactional(async (tem) => {
-        await seedSalesExamples(tem, container, { tenantId, organizationId })
+        await seedSalesExamples!(tem, container, { tenantId, organizationId })
       })
       const vectorService = resolveVectorService(container)
       await reindexModules(em, ['sales', 'catalog'], { tenantId, organizationId, vectorService })
@@ -262,9 +275,26 @@ export const upgradeActions: UpgradeActionDefinition[] = [
     async run({ container, em, tenantId, organizationId }) {
       const normalizedTenantId = tenantId.trim()
       const scope = { tenantId, organizationId }
+
+      let seedExampleCurrencies: typeof import('@open-mercato/core/modules/currencies/lib/seeds')['seedExampleCurrencies'] | undefined
+      try {
+        const currenciesSeeds = await import('@open-mercato/core/modules/currencies/lib/seeds')
+        seedExampleCurrencies = currenciesSeeds.seedExampleCurrencies
+      } catch {
+        console.warn('[upgrade-actions] currencies module not available, skipping currency seeding')
+      }
+
+      let seedExampleWorkflows: typeof import('@open-mercato/core/modules/workflows/lib/seeds')['seedExampleWorkflows'] | undefined
+      try {
+        const workflowsSeeds = await import('@open-mercato/core/modules/workflows/lib/seeds')
+        seedExampleWorkflows = workflowsSeeds.seedExampleWorkflows
+      } catch {
+        console.warn('[upgrade-actions] workflows module not available, skipping workflow seeding')
+      }
+
       await em.transactional(async (tem) => {
-        await seedExampleCurrencies(tem, scope)
-        await seedExampleWorkflows(tem, scope)
+        if (seedExampleCurrencies) await seedExampleCurrencies(tem, scope)
+        if (seedExampleWorkflows) await seedExampleWorkflows(tem, scope)
 
         const adminRole = await tem.findOne(Role, { name: 'admin', tenantId: normalizedTenantId, deletedAt: null })
         if (!adminRole) return
@@ -315,13 +345,44 @@ export const upgradeActions: UpgradeActionDefinition[] = [
     async run({ container, em, tenantId, organizationId }) {
       const normalizedTenantId = tenantId.trim()
       const scope = { tenantId, organizationId }
+
+      let seedPlannerAvailabilityRuleSetDefaults: typeof import('@open-mercato/core/modules/planner/lib/seeds')['seedPlannerAvailabilityRuleSetDefaults'] | undefined
+      let seedPlannerUnavailabilityReasons: typeof import('@open-mercato/core/modules/planner/lib/seeds')['seedPlannerUnavailabilityReasons'] | undefined
+      try {
+        const plannerSeeds = await import('@open-mercato/core/modules/planner/lib/seeds')
+        seedPlannerAvailabilityRuleSetDefaults = plannerSeeds.seedPlannerAvailabilityRuleSetDefaults
+        seedPlannerUnavailabilityReasons = plannerSeeds.seedPlannerUnavailabilityReasons
+      } catch {
+        console.warn('[upgrade-actions] planner module not available, skipping planner seeding')
+      }
+
+      let seedStaffTeamExamples: typeof import('@open-mercato/core/modules/staff/lib/seeds')['seedStaffTeamExamples'] | undefined
+      try {
+        const staffSeeds = await import('@open-mercato/core/modules/staff/lib/seeds')
+        seedStaffTeamExamples = staffSeeds.seedStaffTeamExamples
+      } catch {
+        console.warn('[upgrade-actions] staff module not available, skipping staff seeding')
+      }
+
+      let seedResourcesAddressTypes: typeof import('@open-mercato/core/modules/resources/lib/seeds')['seedResourcesAddressTypes'] | undefined
+      let seedResourcesCapacityUnits: typeof import('@open-mercato/core/modules/resources/lib/seeds')['seedResourcesCapacityUnits'] | undefined
+      let seedResourcesResourceExamples: typeof import('@open-mercato/core/modules/resources/lib/seeds')['seedResourcesResourceExamples'] | undefined
+      try {
+        const resourcesSeeds = await import('@open-mercato/core/modules/resources/lib/seeds')
+        seedResourcesAddressTypes = resourcesSeeds.seedResourcesAddressTypes
+        seedResourcesCapacityUnits = resourcesSeeds.seedResourcesCapacityUnits
+        seedResourcesResourceExamples = resourcesSeeds.seedResourcesResourceExamples
+      } catch {
+        console.warn('[upgrade-actions] resources module not available, skipping resources seeding')
+      }
+
       await em.transactional(async (tem) => {
-        await seedPlannerAvailabilityRuleSetDefaults(tem, scope)
-        await seedPlannerUnavailabilityReasons(tem, scope)
-        await seedStaffTeamExamples(tem, scope)
-        await seedResourcesCapacityUnits(tem, scope)
-        await seedResourcesAddressTypes(tem, scope)
-        await seedResourcesResourceExamples(tem, scope)
+        if (seedPlannerAvailabilityRuleSetDefaults) await seedPlannerAvailabilityRuleSetDefaults(tem, scope)
+        if (seedPlannerUnavailabilityReasons) await seedPlannerUnavailabilityReasons(tem, scope)
+        if (seedStaffTeamExamples) await seedStaffTeamExamples(tem, scope)
+        if (seedResourcesCapacityUnits) await seedResourcesCapacityUnits(tem, scope)
+        if (seedResourcesAddressTypes) await seedResourcesAddressTypes(tem, scope)
+        if (seedResourcesResourceExamples) await seedResourcesResourceExamples(tem, scope)
 
         const adminRole = await tem.findOne(Role, { name: 'admin', tenantId: normalizedTenantId, deletedAt: null })
         if (!adminRole) return

package/src/modules/configs/setup.ts

@@ -0,0 +1,14 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: [
+      'configs.system_status.view',
+      'configs.cache.view',
+      'configs.cache.manage',
+      'configs.manage',
+    ],
+  },
+}
+
+export default setup

package/src/modules/currencies/setup.ts

@@ -0,0 +1,15 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { seedExampleCurrencies } from './lib/seeds'
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedExampleCurrencies(ctx.em, scope)
+  },
+
+  defaultRoleFeatures: {
+    admin: ['currencies.*'],
+  },
+}
+
+export default setup

package/src/modules/customers/setup.ts

@@ -0,0 +1,36 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { seedCustomerDictionaries, seedCurrencyDictionary, seedCustomerExamples } from './cli'
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedCustomerDictionaries(ctx.em, scope)
+    await seedCurrencyDictionary(ctx.em, scope)
+  },
+
+  seedExamples: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedCustomerExamples(ctx.em, ctx.container, scope)
+  },
+
+  defaultRoleFeatures: {
+    admin: [
+      'customers.*',
+      'customers.people.view',
+      'customers.people.manage',
+      'customers.companies.view',
+      'customers.companies.manage',
+      'customers.deals.view',
+      'customers.deals.manage',
+    ],
+    employee: [
+      'customers.*',
+      'customers.people.view',
+      'customers.people.manage',
+      'customers.companies.view',
+      'customers.companies.manage',
+    ],
+  },
+}
+
+export default setup

package/src/modules/dashboards/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['dashboards.*', 'dashboards.admin.assign-widgets', 'analytics.view'],
+    employee: ['dashboards.view', 'dashboards.configure', 'analytics.view'],
+  },
+}
+
+export default setup

package/src/modules/dictionaries/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['dictionaries.view', 'dictionaries.manage'],
+    employee: ['dictionaries.view'],
+  },
+}
+
+export default setup

package/src/modules/directory/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    superadmin: ['directory.tenants.*'],
+    admin: ['directory.organizations.view', 'directory.organizations.manage'],
+  },
+}
+
+export default setup

package/src/modules/entities/setup.ts

@@ -0,0 +1,9 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['entities.*'],
+  },
+}
+
+export default setup

package/src/modules/feature_toggles/setup.ts

@@ -0,0 +1,9 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['feature_toggles.*'],
+  },
+}
+
+export default setup

package/src/modules/perspectives/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['perspectives.use', 'perspectives.role_defaults'],
+    employee: ['perspectives.use'],
+  },
+}
+
+export default setup

package/src/modules/planner/setup.ts

@@ -0,0 +1,21 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { seedPlannerUnavailabilityReasons, seedPlannerAvailabilityRuleSetDefaults } from './lib/seeds'
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedPlannerUnavailabilityReasons(ctx.em, scope)
+  },
+
+  seedExamples: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedPlannerAvailabilityRuleSetDefaults(ctx.em, scope)
+  },
+
+  defaultRoleFeatures: {
+    admin: ['planner.*'],
+    employee: ['planner.view'],
+  },
+}
+
+export default setup

package/src/modules/query_index/setup.ts

@@ -0,0 +1,9 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['query_index.*'],
+  },
+}
+
+export default setup

package/src/modules/resources/setup.ts

@@ -0,0 +1,21 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { seedResourcesAddressTypes, seedResourcesCapacityUnits, seedResourcesResourceExamples } from './lib/seeds'
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedResourcesAddressTypes(ctx.em, scope)
+  },
+
+  seedExamples: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedResourcesCapacityUnits(ctx.em, scope)
+    await seedResourcesResourceExamples(ctx.em, scope)
+  },
+
+  defaultRoleFeatures: {
+    admin: ['resources.*'],
+  },
+}
+
+export default setup

package/src/modules/sales/acl.ts

@@ -1,7 +1,6 @@
 export const features = [
   { id: 'sales.orders.view', title: 'View sales orders', module: 'sales' },
   { id: 'sales.orders.manage', title: 'Manage sales orders', module: 'sales' },
-  { id: 'sales.orders.approve', title: 'Approve sales orders', module: 'sales' },
   { id: 'sales.quotes.view', title: 'View sales quotes', module: 'sales' },
   { id: 'sales.quotes.manage', title: 'Manage sales quotes', module: 'sales' },
   { id: 'sales.shipments.manage', title: 'Manage order shipments', module: 'sales' },

package/src/modules/sales/backend/sales/documents/[id]/page.tsx

@@ -50,9 +50,6 @@ import {
   emitSalesDocumentTotalsRefresh,
   subscribeSalesDocumentTotalsRefresh,
 } from '@open-mercato/core/modules/sales/lib/frontend/documentTotalsEvents'
-import {
-  subscribeSalesDocumentDataRefresh,
-} from '@open-mercato/core/modules/sales/lib/frontend/documentDataEvents'
 import type { CommentSummary, SectionAction } from '@open-mercato/ui/backend/detail'
 import { ICON_SUGGESTIONS } from '@open-mercato/core/modules/customers/lib/dictionaries'
 import { readMarkdownPreferenceCookie, writeMarkdownPreferenceCookie } from '@open-mercato/core/modules/customers/lib/markdownPreference'
@@ -2604,19 +2601,6 @@ export default function SalesDocumentDetailPage({
     [kind, record?.id, refreshDocumentTotals],
   )
 
-  // Subscribe to document data refresh events (e.g., from workflow status updates)
-  React.useEffect(
-    () =>
-      subscribeSalesDocumentDataRefresh((detail) => {
-        if (!record?.id) return
-        if (detail.documentId !== record.id) return
-        if (detail.kind && detail.kind !== kind) return
-        // Increment reloadKey to trigger a full document reload
-        setReloadKey((prev) => prev + 1)
-      }),
-    [kind, record?.id],
-  )
-
   const statusDictionaryMap = React.useMemo(
     () =>
       createDictionaryMap(

package/src/modules/sales/commands/documents.ts

@@ -4,7 +4,7 @@ import { randomUUID } from 'crypto'
 import { z } from 'zod'
 import { registerCommand } from '@open-mercato/shared/lib/commands'
 import type { CommandHandler } from '@open-mercato/shared/lib/commands'
-import { emitCrudSideEffects, requireId, type CrudEventsConfig } from '@open-mercato/shared/lib/commands/helpers'
+import { emitCrudSideEffects, requireId } from '@open-mercato/shared/lib/commands/helpers'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { EventBus } from '@open-mercato/events'
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
@@ -89,29 +89,6 @@ import { resolveStatusEntryIdByValue } from '../lib/statusHelpers'
 import { SalesDocumentNumberGenerator } from '../services/salesDocumentNumberGenerator'
 import { loadSalesSettings } from './settings'
 
-// CRUD events configuration for workflow triggers
-const orderCrudEvents: CrudEventsConfig<SalesOrder> = {
-  module: 'sales',
-  entity: 'orders',
-  persistent: true,
-  buildPayload: (ctx) => ({
-    id: ctx.identifiers.id,
-    organizationId: ctx.identifiers.organizationId,
-    tenantId: ctx.identifiers.tenantId,
-  }),
-}
-
-const quoteCrudEvents: CrudEventsConfig<SalesQuote> = {
-  module: 'sales',
-  entity: 'quotes',
-  persistent: true,
-  buildPayload: (ctx) => ({
-    id: ctx.identifiers.id,
-    organizationId: ctx.identifiers.organizationId,
-    tenantId: ctx.identifiers.tenantId,
-  }),
-}
-
 type DocumentAddressSnapshot = {
   id: string
   organizationId: string
@@ -3134,31 +3111,6 @@ const createQuoteCommand: CommandHandler<QuoteCreateInput, { quoteId: string }>
     })
     await em.flush()
 
-    // Emit CRUD side effects to trigger workflow event listeners
-    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine
-    await emitCrudSideEffects({
-      dataEngine,
-      action: 'created',
-      entity: quote,
-      identifiers: {
-        id: quote.id,
-        organizationId: quote.organizationId,
-        tenantId: quote.tenantId,
-      },
-      events: quoteCrudEvents,
-      indexer: { entityType: E.sales.sales_quote },
-    })
-
-    // Invalidate cache
-    const resourceKind = deriveResourceFromCommandId(createQuoteCommand.id) ?? 'sales.quote'
-    await invalidateCrudCache(
-      ctx.container,
-      resourceKind,
-      { id: quote.id, organizationId: quote.organizationId, tenantId: quote.tenantId },
-      ctx.auth?.tenantId ?? null,
-      'created'
-    )
-
     return { quoteId: quote.id }
   },
   captureAfter: async (_input, result, ctx) => {
@@ -3830,31 +3782,6 @@ const createOrderCommand: CommandHandler<OrderCreateInput, { orderId: string }>
     })
     await em.flush()
 
-    // Emit CRUD side effects to trigger workflow event listeners
-    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine
-    await emitCrudSideEffects({
-      dataEngine,
-      action: 'created',
-      entity: order,
-      identifiers: {
-        id: order.id,
-        organizationId: order.organizationId,
-        tenantId: order.tenantId,
-      },
-      events: orderCrudEvents,
-      indexer: { entityType: E.sales.sales_order },
-    })
-
-    // Invalidate cache
-    const resourceKind = deriveResourceFromCommandId(createOrderCommand.id) ?? 'sales.order'
-    await invalidateCrudCache(
-      ctx.container,
-      resourceKind,
-      { id: order.id, organizationId: order.organizationId, tenantId: order.tenantId },
-      ctx.auth?.tenantId ?? null,
-      'created'
-    )
-
     return { orderId: order.id }
   },
   captureAfter: async (_input, result, ctx) => {

package/src/modules/sales/lib/dictionaries.ts

@@ -125,9 +125,6 @@ type SeedScope = { tenantId: string; organizationId: string }
 
 const ORDER_STATUS_DEFAULTS: SalesDictionarySeed[] = [
   { value: 'draft', label: 'Draft', color: '#94a3b8', icon: 'lucide:file-pen-line' },
-  { value: 'pending_approval', label: 'Pending Approval', color: '#f59e0b', icon: 'lucide:hourglass' },
-  { value: 'approved', label: 'Approved', color: '#16a34a', icon: 'lucide:check-circle' },
-  { value: 'rejected', label: 'Rejected', color: '#ef4444', icon: 'lucide:x-circle' },
   { value: 'sent', label: 'Sent', color: '#0ea5e9', icon: 'lucide:send' },
   { value: 'confirmed', label: 'Confirmed', color: '#2563eb', icon: 'lucide:badge-check' },
   { value: 'in_fulfillment', label: 'In fulfillment', color: '#f59e0b', icon: 'lucide:loader-2' },

package/src/modules/sales/setup.ts

@@ -0,0 +1,108 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { SalesSettings, SalesDocumentSequence, SalesTaxRate } from './data/entities'
+import { DEFAULT_ORDER_NUMBER_FORMAT, DEFAULT_QUOTE_NUMBER_FORMAT } from './lib/documentNumberTokens'
+import { seedSalesStatusDictionaries, seedSalesAdjustmentKinds } from './lib/dictionaries'
+import { ensureExampleShippingMethods, ensureExamplePaymentMethods } from './seed/examples-data'
+import { seedSalesExamples } from './seed/examples'
+
+type SeedScope = { tenantId: string; organizationId: string }
+
+const DEFAULT_TAX_RATES = [
+  { code: 'vat-23', name: '23% VAT', rate: '23' },
+  { code: 'vat-0', name: '0% VAT', rate: '0' },
+] as const
+
+async function seedSalesTaxRates(em: EntityManager, scope: SeedScope): Promise<void> {
+  await em.transactional(async (tem) => {
+    const existing = await tem.find(SalesTaxRate, {
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      deletedAt: null,
+    })
+    const existingCodes = new Set(existing.map((rate) => rate.code))
+    const hasDefault = existing.some((rate) => rate.isDefault)
+    const now = new Date()
+    let isFirst = !hasDefault
+
+    for (const seed of DEFAULT_TAX_RATES) {
+      if (existingCodes.has(seed.code)) continue
+      tem.persist(
+        tem.create(SalesTaxRate, {
+          tenantId: scope.tenantId,
+          organizationId: scope.organizationId,
+          code: seed.code,
+          name: seed.name,
+          rate: seed.rate,
+          priority: 0,
+          isCompound: false,
+          isDefault: isFirst,
+          createdAt: now,
+          updatedAt: now,
+        })
+      )
+      isFirst = false
+    }
+  })
+}
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['sales.*'],
+    employee: ['sales.*'],
+  },
+
+  async onTenantCreated({ em, tenantId, organizationId }) {
+    const exists = await em.findOne(SalesSettings, { tenantId, organizationId })
+    if (!exists) {
+      em.persist(
+        em.create(SalesSettings, {
+          tenantId,
+          organizationId,
+          orderNumberFormat: DEFAULT_ORDER_NUMBER_FORMAT,
+          quoteNumberFormat: DEFAULT_QUOTE_NUMBER_FORMAT,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        })
+      )
+    }
+
+    for (const kind of ['order', 'quote'] as const) {
+      const seq = await em.findOne(SalesDocumentSequence, {
+        tenantId,
+        organizationId,
+        documentKind: kind,
+      })
+      if (!seq) {
+        em.persist(
+          em.create(SalesDocumentSequence, {
+            tenantId,
+            organizationId,
+            documentKind: kind,
+            currentValue: 0,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+          })
+        )
+      }
+    }
+
+    await em.flush()
+  },
+
+  async seedDefaults({ em, tenantId, organizationId }) {
+    const scope = { tenantId, organizationId }
+    await seedSalesTaxRates(em, scope)
+    await seedSalesStatusDictionaries(em, scope)
+    await seedSalesAdjustmentKinds(em, scope)
+    await ensureExampleShippingMethods(em, scope)
+    await ensureExamplePaymentMethods(em, scope)
+  },
+
+  async seedExamples({ em, container, tenantId, organizationId }) {
+    const scope = { tenantId, organizationId }
+    await seedSalesExamples(em, container, scope)
+  },
+}
+
+export default setup

package/src/modules/staff/setup.ts

@@ -0,0 +1,27 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+import { seedStaffAddressTypes, seedStaffTeamExamples } from './lib/seeds'
+
+export const setup: ModuleSetupConfig = {
+  seedDefaults: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedStaffAddressTypes(ctx.em, scope)
+  },
+
+  seedExamples: async (ctx) => {
+    const scope = { tenantId: ctx.tenantId, organizationId: ctx.organizationId }
+    await seedStaffTeamExamples(ctx.em, scope)
+  },
+
+  defaultRoleFeatures: {
+    admin: ['staff.*', 'staff.leave_requests.manage'],
+    employee: [
+      'staff.leave_requests.send',
+      'staff.my_availability.view',
+      'staff.my_availability.manage',
+      'staff.my_leave_requests.view',
+      'staff.my_leave_requests.send',
+    ],
+  },
+}
+
+export default setup

package/src/modules/workflows/acl.ts

@@ -19,8 +19,6 @@ export const features = [
   { id: 'workflows.tasks.complete', title: 'Complete workflow tasks', module: moduleId },
   { id: 'workflows.signals.send', title: 'Send workflow signals', module: moduleId },
   { id: 'workflows.events.view', title: 'View workflow events', module: moduleId },
-  // Note: Event triggers are now embedded in workflow definitions.
-  // Trigger management permissions are covered by workflows.definitions.edit
 ]
 
 export default features

package/src/modules/workflows/api/__tests__/instances.route.test.ts

@@ -194,14 +194,11 @@ describe('Workflow Instances API', () => {
       const request = new NextRequest('http://localhost/api/workflows/instances?entityType=order&entityId=order-123')
       await listInstances(request)
 
-      // The implementation uses JSONB $contains queries for metadata filtering
       expect(mockEm.findAndCount).toHaveBeenCalledWith(
         WorkflowInstance,
         expect.objectContaining({
-          $and: expect.arrayContaining([
-            { metadata: { $contains: { entityType: 'order' } } },
-            { metadata: { $contains: { entityId: 'order-123' } } },
-          ]),
+          'metadata.entityType': 'order',
+          'metadata.entityId': 'order-123',
         }),
         expect.any(Object)
       )