@open-mercato/core 0.4.2-canary-ba1d84349b → 0.4.2-canary-07dbc98202

package/src/modules/notifications/workers/create-notification.worker.ts

@@ -0,0 +1,122 @@
+import type { EntityManager } from '@mikro-orm/core'
+import type { Knex } from 'knex'
+import { Notification } from '../data/entities'
+import type { CreateNotificationInput, CreateRoleNotificationInput, CreateFeatureNotificationInput } from '../data/validators'
+import { buildNotificationEntity, emitNotificationCreated, emitNotificationCreatedBatch } from '../lib/notificationFactory'
+import { getRecipientUserIdsForFeature, getRecipientUserIdsForRole } from '../lib/notificationRecipients'
+
+function getKnex(em: EntityManager): Knex {
+  return (em.getConnection() as unknown as { getKnex: () => Knex }).getKnex()
+}
+
+export const NOTIFICATIONS_QUEUE_NAME = 'notifications'
+
+export type CreateNotificationJob = {
+  type: 'create'
+  input: CreateNotificationInput
+  tenantId: string
+  organizationId?: string | null
+}
+
+export type CreateRoleNotificationJob = {
+  type: 'create-role'
+  input: CreateRoleNotificationInput
+  tenantId: string
+  organizationId?: string | null
+}
+
+export type CreateFeatureNotificationJob = {
+  type: 'create-feature'
+  input: CreateFeatureNotificationInput
+  tenantId: string
+  organizationId?: string | null
+}
+
+export type CleanupExpiredJob = {
+  type: 'cleanup-expired'
+}
+
+export type NotificationJob = CreateNotificationJob | CreateRoleNotificationJob | CreateFeatureNotificationJob | CleanupExpiredJob
+
+export const metadata = {
+  queue: NOTIFICATIONS_QUEUE_NAME,
+  id: 'notifications:create',
+  concurrency: 5,
+}
+
+type HandlerContext = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+export default async function handle(
+  job: { payload: NotificationJob },
+  ctx: HandlerContext
+): Promise<void> {
+  const { payload } = job
+
+  if (payload.type === 'create') {
+    const em = (ctx.resolve('em') as EntityManager).fork()
+    const eventBus = ctx.resolve('eventBus') as { emit: (event: string, payload: unknown) => Promise<void> }
+    const { input, tenantId, organizationId } = payload
+    const { recipientUserId, ...content } = input
+    const notification = buildNotificationEntity(em, content, recipientUserId, { tenantId, organizationId })
+
+    await em.persistAndFlush(notification)
+
+    await emitNotificationCreated(eventBus, notification, { tenantId, organizationId })
+  } else if (payload.type === 'create-role') {
+    const em = (ctx.resolve('em') as EntityManager).fork()
+    const eventBus = ctx.resolve('eventBus') as { emit: (event: string, payload: unknown) => Promise<void> }
+    const { input, tenantId, organizationId } = payload
+
+    const knex = getKnex(em)
+    const recipientUserIds = await getRecipientUserIdsForRole(knex, tenantId, input.roleId)
+    if (recipientUserIds.length === 0) {
+      return
+    }
+
+    const { roleId: _roleId, ...content } = input
+    const notifications: Notification[] = []
+    for (const recipientUserId of recipientUserIds) {
+      const notification = buildNotificationEntity(em, content, recipientUserId, { tenantId, organizationId })
+      notifications.push(notification)
+    }
+
+    await em.persistAndFlush(notifications)
+
+    await emitNotificationCreatedBatch(eventBus, notifications, { tenantId, organizationId })
+  } else if (payload.type === 'create-feature') {
+    const em = (ctx.resolve('em') as EntityManager).fork()
+    const eventBus = ctx.resolve('eventBus') as { emit: (event: string, payload: unknown) => Promise<void> }
+    const { input, tenantId, organizationId } = payload
+
+    const knex = getKnex(em)
+    const recipientUserIds = await getRecipientUserIdsForFeature(knex, tenantId, input.requiredFeature)
+
+    if (recipientUserIds.length === 0) {
+      return
+    }
+
+    const notifications: Notification[] = []
+    const { requiredFeature: _requiredFeature, ...content } = input
+    for (const recipientUserId of recipientUserIds) {
+      const notification = buildNotificationEntity(em, content, recipientUserId, { tenantId, organizationId })
+      notifications.push(notification)
+    }
+
+    await em.persistAndFlush(notifications)
+
+    await emitNotificationCreatedBatch(eventBus, notifications, { tenantId, organizationId })
+  } else if (payload.type === 'cleanup-expired') {
+    const em = (ctx.resolve('em') as EntityManager).fork()
+    const knex = getKnex(em)
+
+    await knex('notifications')
+      .where('expires_at', '<', knex.fn.now())
+      .whereNotIn('status', ['actioned', 'dismissed'])
+      .update({
+        status: 'dismissed',
+        dismissed_at: knex.fn.now(),
+      })
+  }
+}

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

@@ -11,6 +11,8 @@ import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import { deriveResourceFromCommandId, invalidateCrudCache } from '@open-mercato/shared/lib/crud/cache'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'
 import { setRecordCustomFields } from '@open-mercato/core/modules/entities/lib/helpers'
 import { loadCustomFieldValues } from '@open-mercato/shared/lib/crud/custom-fields'
 import { normalizeCustomFieldValues } from '@open-mercato/shared/lib/custom-fields/normalize'
@@ -88,6 +90,7 @@ import { resolveDictionaryEntryValue } from '../lib/dictionaries'
 import { resolveStatusEntryIdByValue } from '../lib/statusHelpers'
 import { SalesDocumentNumberGenerator } from '../services/salesDocumentNumberGenerator'
 import { loadSalesSettings } from './settings'
+import { notificationTypes } from '../notifications'
 
 type DocumentAddressSnapshot = {
   id: string
@@ -3111,6 +3114,37 @@ const createQuoteCommand: CommandHandler<QuoteCreateInput, { quoteId: string }>
     })
     await em.flush()
 
+    // Create notification for users with sales.quotes.manage feature
+    try {
+      const notificationService = resolveNotificationService(ctx.container)
+      const typeDef = notificationTypes.find((type) => type.type === 'sales.quote.created')
+      if (typeDef) {
+        const totalAmount = quote.grandTotalGrossAmount && quote.currencyCode
+          ? `${quote.grandTotalGrossAmount} ${quote.currencyCode}`
+          : ''
+        const totalDisplay = totalAmount ? ` (${totalAmount})` : ''
+        const notificationInput = buildFeatureNotificationFromType(typeDef, {
+          requiredFeature: 'sales.quotes.manage',
+          bodyVariables: {
+            quoteNumber: quote.quoteNumber,
+            total: totalDisplay,
+            totalAmount,
+          },
+          sourceEntityType: 'sales:quote',
+          sourceEntityId: quote.id,
+          linkHref: `/backend/sales/quotes/${quote.id}`,
+        })
+
+        await notificationService.createForFeature(notificationInput, {
+          tenantId: quote.tenantId,
+          organizationId: quote.organizationId ?? null,
+        })
+      }
+    } catch (err) {
+      // Notification creation is non-critical, don't fail the command
+      console.error('[sales.quotes.create] Failed to create notification:', err)
+    }
+
     return { quoteId: quote.id }
   },
   captureAfter: async (_input, result, ctx) => {
@@ -3782,6 +3816,37 @@ const createOrderCommand: CommandHandler<OrderCreateInput, { orderId: string }>
     })
     await em.flush()
 
+    // Create notification for users with sales.orders.manage feature
+    try {
+      const notificationService = resolveNotificationService(ctx.container)
+      const typeDef = notificationTypes.find((type) => type.type === 'sales.order.created')
+      if (typeDef) {
+        const totalAmount = order.grandTotalGrossAmount && order.currencyCode
+          ? `${order.grandTotalGrossAmount} ${order.currencyCode}`
+          : ''
+        const totalDisplay = totalAmount ? ` (${totalAmount})` : ''
+        const notificationInput = buildFeatureNotificationFromType(typeDef, {
+          requiredFeature: 'sales.orders.manage',
+          bodyVariables: {
+            orderNumber: order.orderNumber,
+            total: totalDisplay,
+            totalAmount,
+          },
+          sourceEntityType: 'sales:order',
+          sourceEntityId: order.id,
+          linkHref: `/backend/sales/orders/${order.id}`,
+        })
+
+        await notificationService.createForFeature(notificationInput, {
+          tenantId: order.tenantId,
+          organizationId: order.organizationId ?? null,
+        })
+      }
+    } catch (err) {
+      // Notification creation is non-critical, don't fail the command
+      console.error('[sales.orders.create] Failed to create notification:', err)
+    }
+
     return { orderId: order.id }
   },
   captureAfter: async (_input, result, ctx) => {

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

@@ -35,6 +35,9 @@ import { invalidateCrudCache } from '@open-mercato/shared/lib/crud/cache'
 import { emitCrudSideEffects } from '@open-mercato/shared/lib/commands/helpers'
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
 import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { notificationTypes } from '../notifications'
 
 export type PaymentAllocationSnapshot = {
   id: string
@@ -422,6 +425,36 @@ const createPaymentCommand: CommandHandler<
     const totals = await recomputeOrderPaymentTotals(em, order)
     await em.flush()
     await invalidateOrderCache(ctx.container, order, ctx.auth?.tenantId ?? null)
+
+    // Create notification for payment received
+    try {
+      const notificationService = resolveNotificationService(ctx.container)
+      const typeDef = notificationTypes.find((type) => type.type === 'sales.payment.received')
+      if (typeDef) {
+        const amountDisplay = payment.amount && payment.currencyCode
+          ? `${payment.currencyCode} ${payment.amount}`
+          : ''
+        const notificationInput = buildFeatureNotificationFromType(typeDef, {
+          requiredFeature: 'sales.orders.manage',
+          bodyVariables: {
+            orderNumber: order.orderNumber ?? '',
+            amount: amountDisplay,
+          },
+          sourceEntityType: 'sales:order',
+          sourceEntityId: order.id,
+          linkHref: `/backend/sales/orders/${order.id}`,
+        })
+
+        await notificationService.createForFeature(notificationInput, {
+          tenantId: payment.tenantId,
+          organizationId: payment.organizationId ?? null,
+        })
+      }
+    } catch (err) {
+      // Notification creation is non-critical, don't fail the command
+      console.error('[sales.payments.create] Failed to create notification:', err)
+    }
+
     return { paymentId: payment.id, orderTotals: totals }
   },
   captureAfter: async (_input, result, ctx) => {

package/src/modules/sales/i18n/de.json

@@ -9,6 +9,26 @@
       "title": "Vertriebsmanagement",
       "description": "Angebote, Aufträge, Fulfillment, Rechnungsstellung und Zahlungen verbunden mit dem Produktkatalog."
     },
+    "notifications": {
+      "order": {
+        "created": {
+          "title": "Neue Bestellung",
+          "body": "Bestellung {orderNumber} wurde erstellt{total}"
+        }
+      },
+      "quote": {
+        "created": {
+          "title": "Neues Angebot",
+          "body": "Angebot {quoteNumber} wurde erstellt{total}"
+        }
+      },
+      "renderer": {
+        "viewOrder": "Bestellung anzeigen",
+        "viewQuote": "Angebot anzeigen",
+        "assignedToYou": "Ihnen zugewiesen",
+        "pendingReview": "Ausstehende Prüfung"
+      }
+    },
     "quotes": {
       "send": {
         "action": "An Kunden senden",

package/src/modules/sales/i18n/en.json

@@ -9,6 +9,26 @@
       "title": "Sales Management",
       "description": "Quotes, orders, fulfillment, invoicing, and payments connected to the product catalog."
     },
+    "notifications": {
+      "order": {
+        "created": {
+          "title": "New Sales Order",
+          "body": "Sales order {orderNumber} has been created{total}"
+        }
+      },
+      "quote": {
+        "created": {
+          "title": "New Sales Quote",
+          "body": "Sales quote {quoteNumber} has been created{total}"
+        }
+      },
+      "renderer": {
+        "viewOrder": "View Order",
+        "viewQuote": "View Quote",
+        "assignedToYou": "Assigned to you",
+        "pendingReview": "Pending review"
+      }
+    },
     "quotes": {
       "send": {
         "action": "Send to customer",
@@ -1516,5 +1536,9 @@
   "sales.search.badge.deliveryWindow": "Delivery window",
   "sales.search.badge.paymentMethod": "Payment method",
   "sales.search.badge.taxRate": "Tax rate",
-  "sales.search.badge.documentTag": "Document tag"
+  "sales.search.badge.documentTag": "Document tag",
+  "sales.notifications.payment.received.title": "Payment Received",
+  "sales.notifications.payment.received.body": "Payment of {amount} received for order #{orderNumber}",
+  "sales.notifications.quote.expiring.title": "Quote Expiring Soon",
+  "sales.notifications.quote.expiring.body": "Quote #{quoteNumber} expires in {daysUntilExpiry} days ({expiresAt})"
 }

package/src/modules/sales/i18n/es.json

@@ -9,6 +9,26 @@
       "title": "Gestión de ventas",
       "description": "Cotizaciones, pedidos, cumplimiento, facturación y pagos conectados al catálogo de productos."
     },
+    "notifications": {
+      "order": {
+        "created": {
+          "title": "Nuevo pedido de venta",
+          "body": "El pedido {orderNumber} ha sido creado{total}"
+        }
+      },
+      "quote": {
+        "created": {
+          "title": "Nueva cotización",
+          "body": "La cotización {quoteNumber} ha sido creada{total}"
+        }
+      },
+      "renderer": {
+        "viewOrder": "Ver pedido",
+        "viewQuote": "Ver cotización",
+        "assignedToYou": "Asignado a usted",
+        "pendingReview": "Pendiente de revisión"
+      }
+    },
     "quotes": {
       "send": {
         "action": "Enviar al cliente",

package/src/modules/sales/i18n/pl.json

@@ -9,6 +9,26 @@
       "title": "Sprzedaż",
       "description": "Oferty, zamówienia, realizacja, fakturowanie i płatności powiązane z katalogiem produktów."
     },
+    "notifications": {
+      "order": {
+        "created": {
+          "title": "Nowe zamówienie",
+          "body": "Zamówienie {orderNumber} zostało utworzone{total}"
+        }
+      },
+      "quote": {
+        "created": {
+          "title": "Nowa oferta",
+          "body": "Oferta {quoteNumber} została utworzona{total}"
+        }
+      },
+      "renderer": {
+        "viewOrder": "Zobacz zamówienie",
+        "viewQuote": "Zobacz ofertę",
+        "assignedToYou": "Przypisane do Ciebie",
+        "pendingReview": "Oczekuje na przegląd"
+      }
+    },
     "quotes": {
       "send": {
         "action": "Wyślij do klienta",

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

@@ -0,0 +1,65 @@
+'use client'
+
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+import { SalesOrderCreatedRenderer } from './widgets/notifications/SalesOrderCreatedRenderer'
+import { SalesQuoteCreatedRenderer } from './widgets/notifications/SalesQuoteCreatedRenderer'
+
+/**
+ * Client-side notification type definitions with custom renderers.
+ * These should be used in client components where custom rendering is needed.
+ *
+ * Example usage:
+ * ```tsx
+ * import { salesNotificationTypes } from '@open-mercato/core/modules/sales/notifications.client'
+ *
+ * // Use in NotificationPanel or NotificationItem
+ * const renderer = salesNotificationTypes.find(t => t.type === notification.type)?.Renderer
+ * if (renderer) {
+ *   return <renderer notification={notification} onAction={...} onDismiss={...} actions={...} />
+ * }
+ * ```
+ */
+export const salesNotificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'sales.order.created',
+    module: 'sales',
+    titleKey: 'sales.notifications.order.created.title',
+    bodyKey: 'sales.notifications.order.created.body',
+    icon: 'shopping-cart',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/orders/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/orders/{sourceEntityId}',
+    Renderer: SalesOrderCreatedRenderer,
+    expiresAfterHours: 168,
+  },
+  {
+    type: 'sales.quote.created',
+    module: 'sales',
+    titleKey: 'sales.notifications.quote.created.title',
+    bodyKey: 'sales.notifications.quote.created.body',
+    icon: 'file-text',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/quotes/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/quotes/{sourceEntityId}',
+    Renderer: SalesQuoteCreatedRenderer,
+    expiresAfterHours: 168,
+  },
+]
+
+export default salesNotificationTypes

package/src/modules/sales/notifications.ts

@@ -0,0 +1,82 @@
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+
+export const notificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'sales.order.created',
+    module: 'sales',
+    titleKey: 'sales.notifications.order.created.title',
+    bodyKey: 'sales.notifications.order.created.body',
+    icon: 'shopping-cart',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/orders/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/orders/{sourceEntityId}',
+    expiresAfterHours: 168, // 7 days
+  },
+  {
+    type: 'sales.quote.created',
+    module: 'sales',
+    titleKey: 'sales.notifications.quote.created.title',
+    bodyKey: 'sales.notifications.quote.created.body',
+    icon: 'file-text',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/quotes/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/quotes/{sourceEntityId}',
+    expiresAfterHours: 168, // 7 days
+  },
+  {
+    type: 'sales.payment.received',
+    module: 'sales',
+    titleKey: 'sales.notifications.payment.received.title',
+    bodyKey: 'sales.notifications.payment.received.body',
+    icon: 'credit-card',
+    severity: 'success',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/orders/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/orders/{sourceEntityId}',
+    expiresAfterHours: 168, // 7 days
+  },
+  {
+    type: 'sales.quote.expiring',
+    module: 'sales',
+    titleKey: 'sales.notifications.quote.expiring.title',
+    bodyKey: 'sales.notifications.quote.expiring.body',
+    icon: 'clock',
+    severity: 'warning',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend/sales/quotes/{sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend/sales/quotes/{sourceEntityId}',
+    expiresAfterHours: 72, // 3 days
+  },
+]
+
+export default notificationTypes

package/src/modules/sales/subscribers/quote-expiring-notification.ts

@@ -0,0 +1,53 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { resolveNotificationService } from '../../notifications/lib/notificationService'
+import { buildFeatureNotificationFromType } from '../../notifications/lib/notificationBuilder'
+import { notificationTypes } from '../notifications'
+
+export const metadata = {
+  event: 'sales.quote.expiring',
+  persistent: true,
+  id: 'sales:quote-expiring-notification',
+}
+
+type QuoteExpiringPayload = {
+  quoteId: string
+  quoteNumber: string
+  expiresAt: string
+  daysUntilExpiry: number
+  customerName?: string | null
+  totalAmount?: string | null
+  tenantId: string
+  organizationId?: string | null
+}
+
+type ResolverContext = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+export default async function handle(payload: QuoteExpiringPayload, ctx: ResolverContext) {
+  try {
+    const notificationService = resolveNotificationService(ctx)
+    const typeDef = notificationTypes.find((type) => type.type === 'sales.quote.expiring')
+    if (!typeDef) return
+
+    const notificationInput = buildFeatureNotificationFromType(typeDef, {
+      requiredFeature: 'sales.quotes.manage',
+      bodyVariables: {
+        quoteNumber: payload.quoteNumber,
+        expiresAt: payload.expiresAt,
+        daysUntilExpiry: String(payload.daysUntilExpiry),
+        customerName: payload.customerName ?? '',
+      },
+      sourceEntityType: 'sales:quote',
+      sourceEntityId: payload.quoteId,
+      linkHref: `/backend/sales/quotes/${payload.quoteId}`,
+    })
+
+    await notificationService.createForFeature(notificationInput, {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null,
+    })
+  } catch (err) {
+    console.error('[sales:quote-expiring-notification] Failed to create notification:', err)
+  }
+}