@open-mercato/core 0.6.7-develop.6751.1.ac823a3d26 → 0.6.7-develop.6758.1.697eade236

package/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.client.tsx

@@ -3,13 +3,14 @@
 import * as React from 'react'
 import type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'
 import { useWidgetData, type WidgetDataFetcher } from '@open-mercato/ui/backend/dashboard/widgetData'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { useLocale, useT } from '@open-mercato/shared/lib/i18n/context'
 import { BarChart, type BarChartDataItem } from '@open-mercato/ui/backend/charts'
 import { DateRangeSelect, type DateRangePreset } from '@open-mercato/ui/backend/date-range'
 import { Input } from '@open-mercato/ui/primitives/input'
 import { DEFAULT_SETTINGS, hydrateSettings, type SalesByRegionSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
-import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createCurrencyFormatters } from '../../../lib/formatters'
+import { UnlabelledAmountNotice } from '../../../components/UnlabelledAmountNotice'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('dashboards').child({ component: 'sales-by-region' })
@@ -42,10 +43,13 @@ const SalesByRegionWidget: React.FC<DashboardWidgetComponentProps<SalesByRegionS
   onRefreshStateChange,
 }) => {
   const t = useT()
+  const locale = useLocale()
   const hydrated = React.useMemo(() => hydrateSettings(settings), [settings])
   const [data, setData] = React.useState<BarChartDataItem[]>([])
+  const [currency, setCurrency] = React.useState<string | null>(null)
   const [loading, setLoading] = React.useState(true)
   const [error, setError] = React.useState<string | null>(null)
+  const money = React.useMemo(() => createCurrencyFormatters(currency, '--', locale), [currency, locale])
 
   const fetchWidgetData = useWidgetData()
   const refresh = React.useCallback(async () => {
@@ -59,6 +63,7 @@ const SalesByRegionWidget: React.FC<DashboardWidgetComponentProps<SalesByRegionS
         Revenue: item.value ?? 0,
       }))
       setData(chartData)
+      setCurrency(result.metadata?.currency ?? null)
     } catch (err) {
       logger.error('Failed to load sales by region data', { err })
       setError(t('dashboards.analytics.widgets.salesByRegion.error', 'Failed to load data'))
@@ -106,19 +111,24 @@ const SalesByRegionWidget: React.FC<DashboardWidgetComponentProps<SalesByRegionS
   }
 
   return (
-    <BarChart
-      data={data}
-      index="region"
-      categories={['Revenue']}
-      categoryLabels={{ Revenue: t('dashboards.analytics.widgets.topCustomers.column.revenue', 'Revenue') }}
-      loading={loading}
-      error={error}
-      layout="horizontal"
-      valueFormatter={formatCurrencyCompact}
-      colors={['cyan']}
-      showLegend={false}
-      emptyMessage={t('dashboards.analytics.widgets.salesByRegion.empty', 'No regional sales data for this period')}
-    />
+    <div className="flex flex-col h-full">
+      <div className="flex-1 min-h-0">
+        <BarChart
+          data={data}
+          index="region"
+          categories={['Revenue']}
+          categoryLabels={{ Revenue: t('dashboards.analytics.widgets.topCustomers.column.revenue', 'Revenue') }}
+          loading={loading}
+          error={error}
+          layout="horizontal"
+          valueFormatter={money.formatCompact}
+          colors={['cyan']}
+          showLegend={false}
+          emptyMessage={t('dashboards.analytics.widgets.salesByRegion.empty', 'No regional sales data for this period')}
+        />
+      </div>
+      <UnlabelledAmountNotice currency={currency} loading={loading} error={error} />
+    </div>
   )
 }
 

package/src/modules/dashboards/widgets/dashboard/top-customers/widget.client.tsx

@@ -3,13 +3,14 @@
 import * as React from 'react'
 import type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'
 import { useWidgetData, type WidgetDataFetcher } from '@open-mercato/ui/backend/dashboard/widgetData'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { useLocale, useT } from '@open-mercato/shared/lib/i18n/context'
 import { TopNTable, type TopNTableColumn } from '@open-mercato/ui/backend/charts'
 import { DateRangeSelect, type DateRangePreset } from '@open-mercato/ui/backend/date-range'
 import { Input } from '@open-mercato/ui/primitives/input'
 import { DEFAULT_SETTINGS, hydrateSettings, type TopCustomersSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
-import { formatCurrencySafe } from '../../../lib/formatters'
+import { createCurrencyFormatters } from '../../../lib/formatters'
+import { UnlabelledAmountNotice } from '../../../components/UnlabelledAmountNotice'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('dashboards').child({ component: 'top-customers' })
@@ -54,10 +55,13 @@ const TopCustomersWidget: React.FC<DashboardWidgetComponentProps<TopCustomersSet
   onRefreshStateChange,
 }) => {
   const t = useT()
+  const locale = useLocale()
   const hydrated = React.useMemo(() => hydrateSettings(settings), [settings])
   const [data, setData] = React.useState<CustomerRow[]>([])
+  const [currency, setCurrency] = React.useState<string | null>(null)
   const [loading, setLoading] = React.useState(true)
   const [error, setError] = React.useState<string | null>(null)
+  const money = React.useMemo(() => createCurrencyFormatters(currency, '--', locale), [currency, locale])
 
   const unknownLabel = t('dashboards.analytics.labels.unknown', 'Unknown')
   const columns: TopNTableColumn<CustomerRow>[] = React.useMemo(
@@ -76,10 +80,10 @@ const TopCustomersWidget: React.FC<DashboardWidgetComponentProps<TopCustomersSet
         key: 'revenue',
         header: t('dashboards.analytics.widgets.topCustomers.column.revenue', 'Revenue'),
         align: 'right',
-        formatter: (value: unknown) => formatCurrencySafe(value),
+        formatter: (value: unknown) => money.formatSafe(value),
       },
     ],
-    [t, unknownLabel],
+    [t, unknownLabel, money],
   )
 
   const fetchWidgetData = useWidgetData()
@@ -95,6 +99,7 @@ const TopCustomersWidget: React.FC<DashboardWidgetComponentProps<TopCustomersSet
         revenue: item.value ?? 0,
       }))
       setData(tableData)
+      setCurrency(result.metadata?.currency ?? null)
     } catch (err) {
       logger.error('Failed to load top customers data', { err })
       setError(t('dashboards.analytics.widgets.topCustomers.error', 'Failed to load data'))
@@ -142,13 +147,18 @@ const TopCustomersWidget: React.FC<DashboardWidgetComponentProps<TopCustomersSet
   }
 
   return (
-    <TopNTable
-      data={data}
-      columns={columns}
-      loading={loading}
-      error={error}
-      emptyMessage={t('dashboards.analytics.widgets.topCustomers.empty', 'No customer data for this period')}
-    />
+    <div className="flex flex-col h-full">
+      <div className="flex-1 min-h-0">
+        <TopNTable
+          data={data}
+          columns={columns}
+          loading={loading}
+          error={error}
+          emptyMessage={t('dashboards.analytics.widgets.topCustomers.empty', 'No customer data for this period')}
+        />
+      </div>
+      <UnlabelledAmountNotice currency={currency} loading={loading} error={error} />
+    </div>
   )
 }
 

package/src/modules/dashboards/widgets/dashboard/top-products/widget.client.tsx

@@ -3,7 +3,7 @@
 import * as React from 'react'
 import type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'
 import { useWidgetData, type WidgetDataFetcher } from '@open-mercato/ui/backend/dashboard/widgetData'
-import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { useLocale, useT } from '@open-mercato/shared/lib/i18n/context'
 import { BarChart, type BarChartDataItem } from '@open-mercato/ui/backend/charts'
 import { DateRangeSelect, InlineDateRangeSelect, type DateRangePreset } from '@open-mercato/ui/backend/date-range'
 import { Input } from '@open-mercato/ui/primitives/input'
@@ -16,7 +16,8 @@ import {
 } from '@open-mercato/ui/primitives/select'
 import { DEFAULT_SETTINGS, hydrateSettings, type TopProductsSettings } from './config'
 import type { WidgetDataResponse } from '../../../services/widgetDataService'
-import { formatCurrencyCompact } from '../../../lib/formatters'
+import { createCurrencyFormatters } from '../../../lib/formatters'
+import { UnlabelledAmountNotice } from '../../../components/UnlabelledAmountNotice'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('dashboards').child({ component: 'top-products' })
@@ -68,11 +69,14 @@ const TopProductsWidget: React.FC<DashboardWidgetComponentProps<TopProductsSetti
   onRefreshStateChange,
 }) => {
   const t = useT()
+  const locale = useLocale()
   const hydrated = React.useMemo(() => hydrateSettings(settings), [settings])
   const [data, setData] = React.useState<BarChartDataItem[]>([])
+  const [currency, setCurrency] = React.useState<string | null>(null)
   const [loading, setLoading] = React.useState(true)
   const [error, setError] = React.useState<string | null>(null)
   const fetchingRef = React.useRef(false)
+  const money = React.useMemo(() => createCurrencyFormatters(currency, '--', locale), [currency, locale])
 
   const fetchWidgetData = useWidgetData()
   const refresh = React.useCallback(async () => {
@@ -88,6 +92,7 @@ const TopProductsWidget: React.FC<DashboardWidgetComponentProps<TopProductsSetti
         Revenue: item.value ?? 0,
       }))
       setData(chartData)
+      setCurrency(result.metadata?.currency ?? null)
     } catch (err) {
       logger.error('Failed to load top products data', { err })
       setError(t('dashboards.analytics.widgets.topProducts.error', 'Failed to load data'))
@@ -172,12 +177,13 @@ const TopProductsWidget: React.FC<DashboardWidgetComponentProps<TopProductsSetti
           loading={loading}
           error={error}
           layout={hydrated.layout}
-          valueFormatter={formatCurrencyCompact}
+          valueFormatter={money.formatCompact}
           colors={['emerald']}
           showLegend={false}
           emptyMessage={t('dashboards.analytics.widgets.topProducts.empty', 'No product sales data for this period')}
         />
       </div>
+      <UnlabelledAmountNotice currency={currency} loading={loading} error={error} />
     </div>
   )
 }

package/src/modules/notifications/api/route.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/core'
+import { runWithCacheTenant } from '@open-mercato/cache'
+import {
+  buildCollectionTags,
+  debugCrudCache,
+  isCrudCacheEnabled,
+  resolveCrudCache,
+} from '@open-mercato/shared/lib/crud/cache'
 import { Notification } from '../data/entities'
 import { listNotificationsSchema, createNotificationSchema } from '../data/validators'
 import { toNotificationDto } from '../lib/notificationMapper'
@@ -22,6 +29,49 @@ export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['notifications.create'] },
 }
 
+const NOTIFICATIONS_LIST_TTL_MS = 10_000
+const NOTIFICATIONS_LIST_CACHE_VERSION = 1
+const NOTIFICATIONS_LIST_RESOURCE = 'notifications.notification'
+
+type NotificationsListPayload = {
+  items: ReturnType<typeof toNotificationDto>[]
+  total: number
+  page: number
+  pageSize: number
+  totalPages: number
+}
+
+function buildNotificationsListCacheKey(
+  userId: string,
+  input: z.infer<typeof listNotificationsSchema>,
+): string {
+  const filterSignature = JSON.stringify({
+    status: Array.isArray(input.status)
+      ? [...input.status].sort((left, right) => left.localeCompare(right))
+      : input.status ?? null,
+    type: input.type ?? null,
+    severity: input.severity ?? null,
+    sourceEntityType: input.sourceEntityType ?? null,
+    sourceEntityId: input.sourceEntityId ?? null,
+    since: input.since ?? null,
+    page: input.page,
+    pageSize: input.pageSize,
+  })
+  return `notifications:list:v${NOTIFICATIONS_LIST_CACHE_VERSION}:u=${userId}:filters=${filterSignature}`
+}
+
+function isNotificationsListPayload(value: unknown): value is NotificationsListPayload {
+  if (!value || typeof value !== 'object') return false
+  const payload = value as Partial<NotificationsListPayload>
+  return (
+    Array.isArray(payload.items)
+    && typeof payload.total === 'number'
+    && typeof payload.page === 'number'
+    && typeof payload.pageSize === 'number'
+    && typeof payload.totalPages === 'number'
+  )
+}
+
 export async function GET(req: Request) {
   const { ctx, scope } = await resolveNotificationContext(req)
   const em = ctx.container.resolve('em') as EntityManager
@@ -29,9 +79,27 @@ export async function GET(req: Request) {
   const url = new URL(req.url)
   const queryParams = Object.fromEntries(url.searchParams.entries())
   const input = listNotificationsSchema.parse(queryParams)
+  const userId = scope.userId
+  const cache = userId && isCrudCacheEnabled()
+    ? resolveCrudCache(ctx.container)
+    : null
+  const cacheKey = cache && userId ? buildNotificationsListCacheKey(userId, input) : null
+
+  if (cache && cacheKey) {
+    try {
+      const cached = await runWithCacheTenant(scope.tenantId, () => cache.get(cacheKey))
+      if (isNotificationsListPayload(cached)) {
+        return Response.json(cached)
+      }
+    } catch (error) {
+      debugCrudCache('notifications-list-cache-read-failed', {
+        error: error instanceof Error ? error.message : String(error),
+      })
+    }
+  }
 
   const filters: Record<string, unknown> = {
-    recipientUserId: scope.userId,
+    recipientUserId: userId,
     tenantId: scope.tenantId,
     ...buildNotificationReadScopeWhere(scope),
   }
@@ -68,13 +136,30 @@ export async function GET(req: Request) {
 
   const items = notifications.map(toNotificationDto)
 
-  return Response.json({
+  const payload: NotificationsListPayload = {
     items,
     total,
     page: input.page,
     pageSize: input.pageSize,
     totalPages: Math.ceil(total / input.pageSize),
-  })
+  }
+
+  if (cache && cacheKey) {
+    try {
+      await runWithCacheTenant(scope.tenantId, () =>
+        cache.set(cacheKey, payload, {
+          ttl: NOTIFICATIONS_LIST_TTL_MS,
+          tags: buildCollectionTags(NOTIFICATIONS_LIST_RESOURCE, scope.tenantId, [null]),
+        }),
+      )
+    } catch (error) {
+      debugCrudCache('notifications-list-cache-write-failed', {
+        error: error instanceof Error ? error.message : String(error),
+      })
+    }
+  }
+
+  return Response.json(payload)
 }
 
 export async function POST(req: Request) {

package/src/modules/sales/analytics.ts

@@ -9,6 +9,7 @@ export const analyticsConfig: AnalyticsModuleConfig = {
         tableName: 'sales_orders',
         dateField: 'placed_at',
         defaultScopeFields: ['tenant_id', 'organization_id'],
+        currencyField: 'currencyCode',
       },
       fieldMappings: {
         id: { dbColumn: 'id', type: 'uuid' },
@@ -40,9 +41,11 @@ export const analyticsConfig: AnalyticsModuleConfig = {
         tableName: 'sales_order_lines',
         dateField: 'created_at',
         defaultScopeFields: ['tenant_id', 'organization_id'],
+        currencyField: 'currencyCode',
       },
       fieldMappings: {
         id: { dbColumn: 'id', type: 'uuid' },
+        currencyCode: { dbColumn: 'currency_code', type: 'text' },
         totalGrossAmount: { dbColumn: 'total_gross_amount', type: 'numeric' },
         totalNetAmount: { dbColumn: 'total_net_amount', type: 'numeric' },
         unitGrossPrice: { dbColumn: 'unit_gross_price', type: 'numeric' },
@@ -64,6 +67,7 @@ export const analyticsConfig: AnalyticsModuleConfig = {
         tableName: 'sales_quotes',
         dateField: 'created_at',
         defaultScopeFields: ['tenant_id', 'organization_id'],
+        currencyField: 'currencyCode',
       },
       fieldMappings: {
         id: { dbColumn: 'id', type: 'uuid' },

package/src/modules/sales/api/document-history/route.ts

@@ -171,6 +171,7 @@ const historyEntrySchema = z.object({
     statusTo: z.string().nullable().optional(),
     documentKind: z.enum(['order', 'quote']).optional(),
     commandId: z.string().optional(),
+    changedFields: z.array(z.string()).optional(),
   }).optional(),
 })
 

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

@@ -927,8 +927,27 @@
   "sales.documents.form.submit": "Erstellen",
   "sales.documents.form.success": "Verkaufsdokument erstellt.",
   "sales.documents.form.title": "Verkaufsdokument erstellen",
+  "sales.documents.history.actor.system": "System",
+  "sales.documents.history.changedFields": "Geänderte Felder: {fields}",
   "sales.documents.history.empty": "Noch keine Verlaufseinträge.",
   "sales.documents.history.error": "Verlauf konnte nicht geladen werden.",
+  "sales.documents.history.fields.comment": "Kommentar",
+  "sales.documents.history.fields.configuration": "Konfiguration",
+  "sales.documents.history.fields.currency": "Währung",
+  "sales.documents.history.fields.customFields": "Benutzerdefinierte Felder",
+  "sales.documents.history.fields.description": "Beschreibung",
+  "sales.documents.history.fields.discountAmount": "Rabattbetrag",
+  "sales.documents.history.fields.discountPercent": "Rabattprozentsatz",
+  "sales.documents.history.fields.name": "Name",
+  "sales.documents.history.fields.product": "Produkt",
+  "sales.documents.history.fields.promotionCode": "Aktionscode",
+  "sales.documents.history.fields.quantity": "Menge",
+  "sales.documents.history.fields.quantityUnit": "Mengeneinheit",
+  "sales.documents.history.fields.status": "Status",
+  "sales.documents.history.fields.taxRate": "Steuerklasse",
+  "sales.documents.history.fields.unitPriceGross": "Bruttostückpreis",
+  "sales.documents.history.fields.unitPriceNet": "Nettostückpreis",
+  "sales.documents.history.fields.variant": "Variante",
   "sales.documents.history.filter.actions": "Aktionen",
   "sales.documents.history.filter.all": "Alle",
   "sales.documents.history.filter.comments": "Kommentare",

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

@@ -927,8 +927,27 @@
   "sales.documents.form.submit": "Create",
   "sales.documents.form.success": "Sales document created.",
   "sales.documents.form.title": "Create sales document",
+  "sales.documents.history.actor.system": "System",
+  "sales.documents.history.changedFields": "Changed fields: {fields}",
   "sales.documents.history.empty": "No history entries yet.",
   "sales.documents.history.error": "Failed to load history.",
+  "sales.documents.history.fields.comment": "Comment",
+  "sales.documents.history.fields.configuration": "Configuration",
+  "sales.documents.history.fields.currency": "Currency",
+  "sales.documents.history.fields.customFields": "Custom fields",
+  "sales.documents.history.fields.description": "Description",
+  "sales.documents.history.fields.discountAmount": "Discount amount",
+  "sales.documents.history.fields.discountPercent": "Discount percent",
+  "sales.documents.history.fields.name": "Name",
+  "sales.documents.history.fields.product": "Product",
+  "sales.documents.history.fields.promotionCode": "Promotion code",
+  "sales.documents.history.fields.quantity": "Quantity",
+  "sales.documents.history.fields.quantityUnit": "Quantity unit",
+  "sales.documents.history.fields.status": "Status",
+  "sales.documents.history.fields.taxRate": "Tax class",
+  "sales.documents.history.fields.unitPriceGross": "Gross unit price",
+  "sales.documents.history.fields.unitPriceNet": "Net unit price",
+  "sales.documents.history.fields.variant": "Variant",
   "sales.documents.history.filter.actions": "Actions",
   "sales.documents.history.filter.all": "All",
   "sales.documents.history.filter.comments": "Comments",

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

@@ -927,8 +927,27 @@
   "sales.documents.form.submit": "Crear",
   "sales.documents.form.success": "Documento de ventas creado.",
   "sales.documents.form.title": "Crear documento de ventas",
+  "sales.documents.history.actor.system": "Sistema",
+  "sales.documents.history.changedFields": "Campos modificados: {fields}",
   "sales.documents.history.empty": "Aún no hay entradas en el historial.",
   "sales.documents.history.error": "No se pudo cargar el historial.",
+  "sales.documents.history.fields.comment": "Comentario",
+  "sales.documents.history.fields.configuration": "Configuración",
+  "sales.documents.history.fields.currency": "Moneda",
+  "sales.documents.history.fields.customFields": "Campos personalizados",
+  "sales.documents.history.fields.description": "Descripción",
+  "sales.documents.history.fields.discountAmount": "Importe de descuento",
+  "sales.documents.history.fields.discountPercent": "Porcentaje de descuento",
+  "sales.documents.history.fields.name": "Nombre",
+  "sales.documents.history.fields.product": "Producto",
+  "sales.documents.history.fields.promotionCode": "Código promocional",
+  "sales.documents.history.fields.quantity": "Cantidad",
+  "sales.documents.history.fields.quantityUnit": "Unidad de cantidad",
+  "sales.documents.history.fields.status": "Estado",
+  "sales.documents.history.fields.taxRate": "Clase fiscal",
+  "sales.documents.history.fields.unitPriceGross": "Precio unitario bruto",
+  "sales.documents.history.fields.unitPriceNet": "Precio unitario neto",
+  "sales.documents.history.fields.variant": "Variante",
   "sales.documents.history.filter.actions": "Acciones",
   "sales.documents.history.filter.all": "Todos",
   "sales.documents.history.filter.comments": "Comentarios",

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

@@ -927,8 +927,27 @@
   "sales.documents.form.submit": "Utwórz",
   "sales.documents.form.success": "Dokument sprzedaży utworzony.",
   "sales.documents.form.title": "Utwórz dokument sprzedaży",
+  "sales.documents.history.actor.system": "System",
+  "sales.documents.history.changedFields": "Zmienione pola: {fields}",
   "sales.documents.history.empty": "Brak wpisów w historii.",
   "sales.documents.history.error": "Nie udało się załadować historii.",
+  "sales.documents.history.fields.comment": "Komentarz",
+  "sales.documents.history.fields.configuration": "Konfiguracja",
+  "sales.documents.history.fields.currency": "Waluta",
+  "sales.documents.history.fields.customFields": "Pola niestandardowe",
+  "sales.documents.history.fields.description": "Opis",
+  "sales.documents.history.fields.discountAmount": "Kwota rabatu",
+  "sales.documents.history.fields.discountPercent": "Procent rabatu",
+  "sales.documents.history.fields.name": "Nazwa",
+  "sales.documents.history.fields.product": "Produkt",
+  "sales.documents.history.fields.promotionCode": "Kod promocyjny",
+  "sales.documents.history.fields.quantity": "Ilość",
+  "sales.documents.history.fields.quantityUnit": "Jednostka ilości",
+  "sales.documents.history.fields.status": "Status",
+  "sales.documents.history.fields.taxRate": "Klasa podatkowa",
+  "sales.documents.history.fields.unitPriceGross": "Cena jednostkowa brutto",
+  "sales.documents.history.fields.unitPriceNet": "Cena jednostkowa netto",
+  "sales.documents.history.fields.variant": "Wariant",
   "sales.documents.history.filter.actions": "Akcje",
   "sales.documents.history.filter.all": "Wszystkie",
   "sales.documents.history.filter.comments": "Komentarze",

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

@@ -1,4 +1,5 @@
 import type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'
+import { isRecord } from '@open-mercato/shared/lib/utils'
 import type { SalesNote } from '../data/entities'
 
 export type HistoryEntry = {
@@ -13,9 +14,90 @@ export type HistoryEntry = {
     statusTo?: string | null
     documentKind?: 'order' | 'quote'
     commandId?: string
+    changedFields?: string[]
   }
 }
 
+const DOCUMENT_LINE_UPSERT_COMMANDS = new Set([
+  'sales.orders.lines.upsert',
+  'sales.quotes.lines.upsert',
+])
+
+const USER_EDITABLE_LINE_FIELDS = [
+  'productId',
+  'productVariantId',
+  'name',
+  'description',
+  'comment',
+  'quantity',
+  'quantityUnit',
+  'currencyCode',
+  'unitPriceNet',
+  'unitPriceGross',
+  'discountAmount',
+  'discountPercent',
+  'taxRate',
+  'configuration',
+  'promotionCode',
+  'customFields',
+  'statusEntryId',
+] as const
+
+function readSnapshotLines(snapshot: unknown): Array<Record<string, unknown>> {
+  if (!isRecord(snapshot) || !Array.isArray(snapshot.lines)) return []
+  return snapshot.lines.filter(isRecord)
+}
+
+function historyValuesEqual(left: unknown, right: unknown): boolean {
+  if (Object.is(left, right)) return true
+  try {
+    return JSON.stringify(left) === JSON.stringify(right)
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Derives a concise, user-editable field list for document line updates.
+ * Calculated totals and normalized UoM fields are intentionally excluded so
+ * the timeline describes the user's edit rather than downstream recalculation.
+ */
+function deriveDocumentLineChangedFields(log: ActionLog): string[] {
+  if (!DOCUMENT_LINE_UPSERT_COMMANDS.has(log.commandId)) return []
+
+  const beforeById = new Map(
+    readSnapshotLines(log.snapshotBefore)
+      .filter((line) => typeof line.id === 'string')
+      .map((line) => [line.id as string, line]),
+  )
+  const afterLines = readSnapshotLines(log.snapshotAfter)
+
+  const changedFields = new Set<string>()
+  for (const afterLine of afterLines) {
+    if (typeof afterLine.id !== 'string') continue
+    const beforeLine = beforeById.get(afterLine.id)
+    if (!beforeLine) continue
+
+    for (const field of USER_EDITABLE_LINE_FIELDS) {
+      if (!historyValuesEqual(beforeLine[field], afterLine[field])) {
+        changedFields.add(field)
+      }
+    }
+  }
+
+  return USER_EDITABLE_LINE_FIELDS.filter((field) => changedFields.has(field))
+}
+
+export function deriveHistoryChangedFields(log: ActionLog): string[] {
+  if (DOCUMENT_LINE_UPSERT_COMMANDS.has(log.commandId)) {
+    return deriveDocumentLineChangedFields(log)
+  }
+  const persisted = Array.isArray(log.changedFields)
+    ? log.changedFields.filter((field): field is string => typeof field === 'string' && field.trim().length > 0)
+    : []
+  return Array.from(new Set(persisted))
+}
+
 function extractStatusFromSnapshot(snapshot: unknown): string | null {
   if (!snapshot || typeof snapshot !== 'object') return null
   const s = snapshot as Record<string, unknown>
@@ -64,9 +146,14 @@ export function normalizeActionLogToHistoryEntry(
   displayUsers?: Record<string, string>,
 ): HistoryEntry {
   const statusChange = detectStatusChange(log)
+  const changedFields = deriveHistoryChangedFields(log)
   let entryKind: 'status' | 'action' = 'action'
   let action = log.actionLabel || log.commandId
-  let metadata: HistoryEntry['metadata'] = { documentKind: kind, commandId: log.commandId }
+  let metadata: HistoryEntry['metadata'] = {
+    documentKind: kind,
+    commandId: log.commandId,
+    ...(changedFields.length > 0 ? { changedFields } : {}),
+  }
   if (statusChange) {
     const hasStatusValues = statusChange.statusFrom != null || statusChange.statusTo != null
     if (hasStatusValues) {