@open-mercato/core 0.6.7-develop.6756.1.5300c41145 → 0.6.7-develop.6758.1.697eade236

package/dist/modules/sales/api/document-history/route.js

@@ -135,7 +135,8 @@ const historyEntrySchema = z.object({
     statusFrom: z.string().nullable().optional(),
     statusTo: z.string().nullable().optional(),
     documentKind: z.enum(["order", "quote"]).optional(),
-    commandId: z.string().optional()
+    commandId: z.string().optional(),
+    changedFields: z.array(z.string()).optional()
   }).optional()
 });
 const documentHistoryResponseSchema = z.object({

package/dist/modules/sales/api/document-history/route.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/sales/api/document-history/route.ts"],
-  "sourcesContent": ["import { z } from 'zod'\nimport { ActionLogService } from '@open-mercato/core/modules/audit_logs/services/actionLogService'\nimport { loadAuditLogDisplayMaps } from '@open-mercato/core/modules/audit_logs/api/audit-logs/display'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\nimport { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'\nimport { resolveOrganizationScopeFilter } from '@open-mercato/core/modules/directory/utils/organizationScopeFilter'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { NextResponse } from 'next/server'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\nimport type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { buildHistoryEntries } from '../../lib/historyHelpers'\nimport { SalesNote } from '../../data/entities'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('sales')\n\n// Spec: SPEC-006-2026-01-23-order-status-history\n\nexport const metadata = {\n  GET: { requireAuth: true },\n}\n\nconst querySchema = z.object({\n  kind: z.enum(['order', 'quote']),\n  id: z.string().uuid(),\n  limit: z.coerce.number().min(1).max(100).default(50),\n  before: z.string().optional(),\n  after: z.string().optional(),\n  types: z.string().optional(), // comma-separated: status,action,comment\n})\n\nexport type DocumentHistoryEntryKind = 'status' | 'action' | 'comment'\n\nconst HISTORY_TYPES: ReadonlySet<DocumentHistoryEntryKind> = new Set(['status', 'action', 'comment'])\n\nexport function parseDocumentHistoryTypes(input: string | null | undefined): Set<DocumentHistoryEntryKind> {\n  const raw = typeof input === 'string' ? input.trim() : ''\n  if (!raw) return new Set()\n  const values = raw\n    .split(',')\n    .map((part) => part.trim().toLowerCase())\n    .filter((value) => value.length > 0)\n  const result = new Set<DocumentHistoryEntryKind>()\n  values.forEach((value) => {\n    if (HISTORY_TYPES.has(value as DocumentHistoryEntryKind)) {\n      result.add(value as DocumentHistoryEntryKind)\n    }\n  })\n  return result\n}\n\nexport async function GET(req: Request) {\n  try {\n    const url = new URL(req.url)\n    const query = querySchema.parse(Object.fromEntries(url.searchParams))\n\n    const container = await createRequestContainer()\n    const auth = await getAuthFromRequest(req)\n    const { translate } = await resolveTranslations()\n\n    if (!auth || !auth.tenantId) {\n      throw new CrudHttpError(401, { error: translate('sales.documents.errors.unauthorized', 'Unauthorized') })\n    }\n\n    const scope = await resolveOrganizationScopeForRequest({ container, auth, request: req })\n    // Resolve the organization scope the same way every other scoped read does.\n    // Under \"All organizations\" (super-admin) `rbacOrganizationId` is null and\n    // `where` is empty, so the read scopes by tenant + resource only instead of\n    // failing \u2014 the document's `id` is a tenant-unique UUID, so no cross-org leak.\n    const orgFilter = resolveOrganizationScopeFilter(scope, auth)\n    const organizationId = orgFilter.rbacOrganizationId\n\n    const requiredFeature = query.kind === 'order' ? 'sales.orders.view' : 'sales.quotes.view'\n    const rbac = container.resolve('rbacService') as RbacService\n    const hasAccess = await rbac.userHasAllFeatures(auth.sub, [requiredFeature], {\n      tenantId: auth.tenantId,\n      organizationId,\n    })\n    if (!hasAccess) {\n      throw new CrudHttpError(403, { error: translate('api.errors.forbidden', 'Forbidden') })\n    }\n\n    const resourceKind = query.kind === 'order' ? 'sales.order' : 'sales.quote'\n\n    const actionLogService = container.resolve('actionLogService') as ActionLogService\n    const em = (container.resolve('em') as EntityManager).fork()\n\n    const [actionLogList, notes] = await Promise.all([\n      actionLogService.list({\n        tenantId: auth.tenantId,\n        organizationId: organizationId ?? undefined,\n        resourceKind,\n        resourceId: query.id,\n        includeRelated: true,\n        limit: query.limit,\n        before: query.before ? new Date(query.before) : undefined,\n        after: query.after ? new Date(query.after) : undefined,\n      }),\n      findWithDecryption(\n        em,\n        SalesNote,\n        {\n          contextType: query.kind,\n          contextId: query.id,\n          tenantId: auth.tenantId,\n          ...orgFilter.where,\n          deletedAt: null,\n        },\n        { orderBy: { createdAt: 'DESC' } },\n        { tenantId: auth.tenantId, organizationId: organizationId ?? undefined },\n      ),\n    ])\n    const logs = actionLogList.items as ActionLog[]\n\n    const allUserIds = [\n      ...logs.map((l) => l.actorUserId).filter((v): v is string => !!v),\n      ...notes.map((n) => n.authorUserId).filter((v): v is string => !!v),\n    ]\n\n    const displayMaps = await loadAuditLogDisplayMaps(em, {\n      userIds: allUserIds,\n      tenantIds: [],\n      organizationIds: [],\n    })\n\n    let items = buildHistoryEntries({ actionLogs: logs, notes, kind: query.kind, displayUsers: displayMaps.users })\n    const typesFilter = parseDocumentHistoryTypes(query.types)\n    if (typesFilter.size > 0) {\n      items = items.filter((entry) => typesFilter.has(entry.kind as DocumentHistoryEntryKind))\n    }\n\n    let nextCursor: string | undefined = undefined\n    if (logs.length === query.limit && items.length > 0) {\n      const last = items[items.length - 1]\n      nextCursor = Buffer.from(`${last.occurredAt}|${last.id}`).toString('base64')\n    }\n\n    return NextResponse.json({ items, nextCursor })\n  } catch (err) {\n    if (isCrudHttpError(err)) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    logger.error('sales.document-history.get failed', { err })\n    const { translate } = await resolveTranslations()\n    return NextResponse.json(\n      { error: translate('sales.documents.history.error', 'Failed to load history.') },\n      { status: 400 }\n    )\n  }\n}\n\nconst historyActorSchema = z.object({\n  id: z.string().uuid().nullable(),\n  label: z.string(),\n})\n\nconst historyEntrySchema = z.object({\n  id: z.string(),\n  occurredAt: z.string().datetime(),\n  kind: z.enum(['status', 'action', 'comment']),\n  action: z.string(),\n  actor: historyActorSchema,\n  source: z.enum(['action_log', 'note']),\n  metadata: z.object({\n    statusFrom: z.string().nullable().optional(),\n    statusTo: z.string().nullable().optional(),\n    documentKind: z.enum(['order', 'quote']).optional(),\n    commandId: z.string().optional(),\n  }).optional(),\n})\n\nconst documentHistoryResponseSchema = z.object({\n  items: z.array(historyEntrySchema),\n  nextCursor: z.string().optional(),\n})\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Sales',\n  summary: 'Get document change history',\n  methods: {\n    GET: {\n      summary: 'List history entries for an order or quote',\n      query: querySchema,\n      responses: [\n        { status: 200, description: 'History entries', schema: documentHistoryResponseSchema },\n        { status: 400, description: 'Invalid query', schema: z.object({ error: z.string() }) },\n        { status: 401, description: 'Unauthorized', schema: z.object({ error: z.string() }) },\n        { status: 403, description: 'Forbidden', schema: z.object({ error: z.string() }) },\n        { status: 404, description: 'Document not found', schema: z.object({ error: z.string() }) },\n      ],\n    },\n  },\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { z } from 'zod'\nimport { ActionLogService } from '@open-mercato/core/modules/audit_logs/services/actionLogService'\nimport { loadAuditLogDisplayMaps } from '@open-mercato/core/modules/audit_logs/api/audit-logs/display'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\nimport { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'\nimport { resolveOrganizationScopeFilter } from '@open-mercato/core/modules/directory/utils/organizationScopeFilter'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { NextResponse } from 'next/server'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\nimport type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { buildHistoryEntries } from '../../lib/historyHelpers'\nimport { SalesNote } from '../../data/entities'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('sales')\n\n// Spec: SPEC-006-2026-01-23-order-status-history\n\nexport const metadata = {\n  GET: { requireAuth: true },\n}\n\nconst querySchema = z.object({\n  kind: z.enum(['order', 'quote']),\n  id: z.string().uuid(),\n  limit: z.coerce.number().min(1).max(100).default(50),\n  before: z.string().optional(),\n  after: z.string().optional(),\n  types: z.string().optional(), // comma-separated: status,action,comment\n})\n\nexport type DocumentHistoryEntryKind = 'status' | 'action' | 'comment'\n\nconst HISTORY_TYPES: ReadonlySet<DocumentHistoryEntryKind> = new Set(['status', 'action', 'comment'])\n\nexport function parseDocumentHistoryTypes(input: string | null | undefined): Set<DocumentHistoryEntryKind> {\n  const raw = typeof input === 'string' ? input.trim() : ''\n  if (!raw) return new Set()\n  const values = raw\n    .split(',')\n    .map((part) => part.trim().toLowerCase())\n    .filter((value) => value.length > 0)\n  const result = new Set<DocumentHistoryEntryKind>()\n  values.forEach((value) => {\n    if (HISTORY_TYPES.has(value as DocumentHistoryEntryKind)) {\n      result.add(value as DocumentHistoryEntryKind)\n    }\n  })\n  return result\n}\n\nexport async function GET(req: Request) {\n  try {\n    const url = new URL(req.url)\n    const query = querySchema.parse(Object.fromEntries(url.searchParams))\n\n    const container = await createRequestContainer()\n    const auth = await getAuthFromRequest(req)\n    const { translate } = await resolveTranslations()\n\n    if (!auth || !auth.tenantId) {\n      throw new CrudHttpError(401, { error: translate('sales.documents.errors.unauthorized', 'Unauthorized') })\n    }\n\n    const scope = await resolveOrganizationScopeForRequest({ container, auth, request: req })\n    // Resolve the organization scope the same way every other scoped read does.\n    // Under \"All organizations\" (super-admin) `rbacOrganizationId` is null and\n    // `where` is empty, so the read scopes by tenant + resource only instead of\n    // failing \u2014 the document's `id` is a tenant-unique UUID, so no cross-org leak.\n    const orgFilter = resolveOrganizationScopeFilter(scope, auth)\n    const organizationId = orgFilter.rbacOrganizationId\n\n    const requiredFeature = query.kind === 'order' ? 'sales.orders.view' : 'sales.quotes.view'\n    const rbac = container.resolve('rbacService') as RbacService\n    const hasAccess = await rbac.userHasAllFeatures(auth.sub, [requiredFeature], {\n      tenantId: auth.tenantId,\n      organizationId,\n    })\n    if (!hasAccess) {\n      throw new CrudHttpError(403, { error: translate('api.errors.forbidden', 'Forbidden') })\n    }\n\n    const resourceKind = query.kind === 'order' ? 'sales.order' : 'sales.quote'\n\n    const actionLogService = container.resolve('actionLogService') as ActionLogService\n    const em = (container.resolve('em') as EntityManager).fork()\n\n    const [actionLogList, notes] = await Promise.all([\n      actionLogService.list({\n        tenantId: auth.tenantId,\n        organizationId: organizationId ?? undefined,\n        resourceKind,\n        resourceId: query.id,\n        includeRelated: true,\n        limit: query.limit,\n        before: query.before ? new Date(query.before) : undefined,\n        after: query.after ? new Date(query.after) : undefined,\n      }),\n      findWithDecryption(\n        em,\n        SalesNote,\n        {\n          contextType: query.kind,\n          contextId: query.id,\n          tenantId: auth.tenantId,\n          ...orgFilter.where,\n          deletedAt: null,\n        },\n        { orderBy: { createdAt: 'DESC' } },\n        { tenantId: auth.tenantId, organizationId: organizationId ?? undefined },\n      ),\n    ])\n    const logs = actionLogList.items as ActionLog[]\n\n    const allUserIds = [\n      ...logs.map((l) => l.actorUserId).filter((v): v is string => !!v),\n      ...notes.map((n) => n.authorUserId).filter((v): v is string => !!v),\n    ]\n\n    const displayMaps = await loadAuditLogDisplayMaps(em, {\n      userIds: allUserIds,\n      tenantIds: [],\n      organizationIds: [],\n    })\n\n    let items = buildHistoryEntries({ actionLogs: logs, notes, kind: query.kind, displayUsers: displayMaps.users })\n    const typesFilter = parseDocumentHistoryTypes(query.types)\n    if (typesFilter.size > 0) {\n      items = items.filter((entry) => typesFilter.has(entry.kind as DocumentHistoryEntryKind))\n    }\n\n    let nextCursor: string | undefined = undefined\n    if (logs.length === query.limit && items.length > 0) {\n      const last = items[items.length - 1]\n      nextCursor = Buffer.from(`${last.occurredAt}|${last.id}`).toString('base64')\n    }\n\n    return NextResponse.json({ items, nextCursor })\n  } catch (err) {\n    if (isCrudHttpError(err)) {\n      return NextResponse.json(err.body, { status: err.status })\n    }\n    logger.error('sales.document-history.get failed', { err })\n    const { translate } = await resolveTranslations()\n    return NextResponse.json(\n      { error: translate('sales.documents.history.error', 'Failed to load history.') },\n      { status: 400 }\n    )\n  }\n}\n\nconst historyActorSchema = z.object({\n  id: z.string().uuid().nullable(),\n  label: z.string(),\n})\n\nconst historyEntrySchema = z.object({\n  id: z.string(),\n  occurredAt: z.string().datetime(),\n  kind: z.enum(['status', 'action', 'comment']),\n  action: z.string(),\n  actor: historyActorSchema,\n  source: z.enum(['action_log', 'note']),\n  metadata: z.object({\n    statusFrom: z.string().nullable().optional(),\n    statusTo: z.string().nullable().optional(),\n    documentKind: z.enum(['order', 'quote']).optional(),\n    commandId: z.string().optional(),\n    changedFields: z.array(z.string()).optional(),\n  }).optional(),\n})\n\nconst documentHistoryResponseSchema = z.object({\n  items: z.array(historyEntrySchema),\n  nextCursor: z.string().optional(),\n})\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Sales',\n  summary: 'Get document change history',\n  methods: {\n    GET: {\n      summary: 'List history entries for an order or quote',\n      query: querySchema,\n      responses: [\n        { status: 200, description: 'History entries', schema: documentHistoryResponseSchema },\n        { status: 400, description: 'Invalid query', schema: z.object({ error: z.string() }) },\n        { status: 401, description: 'Unauthorized', schema: z.object({ error: z.string() }) },\n        { status: 403, description: 'Forbidden', schema: z.object({ error: z.string() }) },\n        { status: 404, description: 'Document not found', schema: z.object({ error: z.string() }) },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/sales/lib/historyHelpers.js

@@ -1,3 +1,65 @@
+import { isRecord } from "@open-mercato/shared/lib/utils";
+const DOCUMENT_LINE_UPSERT_COMMANDS = /* @__PURE__ */ 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"
+];
+function readSnapshotLines(snapshot) {
+  if (!isRecord(snapshot) || !Array.isArray(snapshot.lines)) return [];
+  return snapshot.lines.filter(isRecord);
+}
+function historyValuesEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  try {
+    return JSON.stringify(left) === JSON.stringify(right);
+  } catch {
+    return false;
+  }
+}
+function deriveDocumentLineChangedFields(log) {
+  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, line])
+  );
+  const afterLines = readSnapshotLines(log.snapshotAfter);
+  const changedFields = /* @__PURE__ */ new Set();
+  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));
+}
+function deriveHistoryChangedFields(log) {
+  if (DOCUMENT_LINE_UPSERT_COMMANDS.has(log.commandId)) {
+    return deriveDocumentLineChangedFields(log);
+  }
+  const persisted = Array.isArray(log.changedFields) ? log.changedFields.filter((field) => typeof field === "string" && field.trim().length > 0) : [];
+  return Array.from(new Set(persisted));
+}
 function extractStatusFromSnapshot(snapshot) {
   if (!snapshot || typeof snapshot !== "object") return null;
   const s = snapshot;
@@ -28,9 +90,14 @@ function detectStatusChange(log) {
 }
 function normalizeActionLogToHistoryEntry(log, kind, displayUsers) {
   const statusChange = detectStatusChange(log);
+  const changedFields = deriveHistoryChangedFields(log);
   let entryKind = "action";
   let action = log.actionLabel || log.commandId;
-  let metadata = { documentKind: kind, commandId: log.commandId };
+  let metadata = {
+    documentKind: kind,
+    commandId: log.commandId,
+    ...changedFields.length > 0 ? { changedFields } : {}
+  };
   if (statusChange) {
     const hasStatusValues = statusChange.statusFrom != null || statusChange.statusTo != null;
     if (hasStatusValues) {
@@ -75,6 +142,7 @@ function buildHistoryEntries(input) {
 }
 export {
   buildHistoryEntries,
+  deriveHistoryChangedFields,
   detectStatusChange,
   normalizeActionLogToHistoryEntry,
   normalizeNoteToHistoryEntry

package/dist/modules/sales/lib/historyHelpers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/sales/lib/historyHelpers.ts"],
-  "sourcesContent": ["import type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\nimport type { SalesNote } from '../data/entities'\n\nexport type HistoryEntry = {\n  id: string\n  occurredAt: string\n  kind: 'status' | 'action' | 'comment'\n  action: string\n  actor: { id: string | null; label: string }\n  source: 'action_log' | 'note'\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: 'order' | 'quote'\n    commandId?: string\n  }\n}\n\nfunction extractStatusFromSnapshot(snapshot: unknown): string | null {\n  if (!snapshot || typeof snapshot !== 'object') return null\n  const s = snapshot as Record<string, unknown>\n  // Dedicated logStatusChange entries: { status: \"value\" }\n  if (typeof s.status === 'string') return s.status\n  // Regular update snapshots: { order: { status, fulfillment_status, payment_status, ... } }\n  if (s.order && typeof s.order === 'object') {\n    const order = s.order as Record<string, unknown>\n    const orderStatus = typeof order.status === 'string' ? order.status : null\n    const fulfillmentStatus = typeof order.fulfillment_status === 'string' ? order.fulfillment_status : null\n    const paymentStatus = typeof order.payment_status === 'string' ? order.payment_status : null\n    return orderStatus ?? fulfillmentStatus ?? paymentStatus ?? null\n  }\n  // Regular update snapshots: { quote: { status: \"value\", ... } }\n  if (s.quote && typeof s.quote === 'object') {\n    const quote = s.quote as Record<string, unknown>\n    if (typeof quote.status === 'string') return quote.status\n  }\n  return null\n}\n\nexport function detectStatusChange(log: ActionLog): {\n  statusFrom: string | null\n  statusTo: string | null\n} | null {\n  const after = extractStatusFromSnapshot(log.snapshotAfter)\n  const before = log.snapshotBefore\n    ? extractStatusFromSnapshot(log.snapshotBefore)\n    : null\n  // Creation (no snapshotBefore): always one status entry (initial value or \"created\")\n  if (!log.snapshotBefore) {\n    return { statusFrom: null, statusTo: after ?? null }\n  }\n  if (before !== after && (before !== null || after !== null)) {\n    return { statusFrom: before, statusTo: after ?? null }\n  }\n  return null\n}\n\n/**\n * Normalizes ActionLog to HistoryEntry (status/action/comment).\n */\nexport function normalizeActionLogToHistoryEntry(\n  log: ActionLog,\n  kind: 'order' | 'quote',\n  displayUsers?: Record<string, string>,\n): HistoryEntry {\n  const statusChange = detectStatusChange(log)\n  let entryKind: 'status' | 'action' = 'action'\n  let action = log.actionLabel || log.commandId\n  let metadata: HistoryEntry['metadata'] = { documentKind: kind, commandId: log.commandId }\n  if (statusChange) {\n    const hasStatusValues = statusChange.statusFrom != null || statusChange.statusTo != null\n    if (hasStatusValues) {\n      entryKind = 'status'\n      action = statusChange.statusTo ?? 'unknown'\n      metadata = { ...metadata, statusFrom: statusChange.statusFrom, statusTo: statusChange.statusTo }\n    }\n    // When both are null (e.g. Create return/shipment/payment with non-document snapshot), keep as action and use actionLabel\n  }\n  const actorLabel = log.actorUserId\n    ? (displayUsers?.[log.actorUserId] ?? log.actorUserId)\n    : 'system'\n  return {\n    id: log.id,\n    occurredAt: log.createdAt.toISOString(),\n    kind: entryKind,\n    action,\n    actor: { id: log.actorUserId, label: actorLabel },\n    source: 'action_log',\n    metadata,\n  }\n}\n\nexport function normalizeNoteToHistoryEntry(\n  note: SalesNote,\n  kind: 'order' | 'quote',\n  displayUsers?: Record<string, string>,\n): HistoryEntry {\n  const actorLabel = note.authorUserId\n    ? (displayUsers?.[note.authorUserId] ?? note.authorUserId)\n    : 'system'\n  return {\n    id: note.id,\n    occurredAt: note.createdAt.toISOString(),\n    kind: 'comment',\n    action: note.body,\n    actor: { id: note.authorUserId ?? null, label: actorLabel },\n    source: 'note',\n    metadata: { documentKind: kind },\n  }\n}\n\nexport type HistoryBuilderInput = {\n  actionLogs: ActionLog[]\n  notes?: SalesNote[]\n  kind: 'order' | 'quote'\n  displayUsers?: Record<string, string>\n}\n\nexport function buildHistoryEntries(input: HistoryBuilderInput): HistoryEntry[] {\n  const logEntries = input.actionLogs.map((log) =>\n    normalizeActionLogToHistoryEntry(log, input.kind, input.displayUsers)\n  )\n  const noteEntries = (input.notes ?? []).map((note) =>\n    normalizeNoteToHistoryEntry(note, input.kind, input.displayUsers)\n  )\n  return [...logEntries, ...noteEntries].sort(\n    (a, b) => new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime()\n  )\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\nimport { isRecord } from '@open-mercato/shared/lib/utils'\nimport type { SalesNote } from '../data/entities'\n\nexport type HistoryEntry = {\n  id: string\n  occurredAt: string\n  kind: 'status' | 'action' | 'comment'\n  action: string\n  actor: { id: string | null; label: string }\n  source: 'action_log' | 'note'\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: 'order' | 'quote'\n    commandId?: string\n    changedFields?: string[]\n  }\n}\n\nconst DOCUMENT_LINE_UPSERT_COMMANDS = new Set([\n  'sales.orders.lines.upsert',\n  'sales.quotes.lines.upsert',\n])\n\nconst USER_EDITABLE_LINE_FIELDS = [\n  'productId',\n  'productVariantId',\n  'name',\n  'description',\n  'comment',\n  'quantity',\n  'quantityUnit',\n  'currencyCode',\n  'unitPriceNet',\n  'unitPriceGross',\n  'discountAmount',\n  'discountPercent',\n  'taxRate',\n  'configuration',\n  'promotionCode',\n  'customFields',\n  'statusEntryId',\n] as const\n\nfunction readSnapshotLines(snapshot: unknown): Array<Record<string, unknown>> {\n  if (!isRecord(snapshot) || !Array.isArray(snapshot.lines)) return []\n  return snapshot.lines.filter(isRecord)\n}\n\nfunction historyValuesEqual(left: unknown, right: unknown): boolean {\n  if (Object.is(left, right)) return true\n  try {\n    return JSON.stringify(left) === JSON.stringify(right)\n  } catch {\n    return false\n  }\n}\n\n/**\n * Derives a concise, user-editable field list for document line updates.\n * Calculated totals and normalized UoM fields are intentionally excluded so\n * the timeline describes the user's edit rather than downstream recalculation.\n */\nfunction deriveDocumentLineChangedFields(log: ActionLog): string[] {\n  if (!DOCUMENT_LINE_UPSERT_COMMANDS.has(log.commandId)) return []\n\n  const beforeById = new Map(\n    readSnapshotLines(log.snapshotBefore)\n      .filter((line) => typeof line.id === 'string')\n      .map((line) => [line.id as string, line]),\n  )\n  const afterLines = readSnapshotLines(log.snapshotAfter)\n\n  const changedFields = new Set<string>()\n  for (const afterLine of afterLines) {\n    if (typeof afterLine.id !== 'string') continue\n    const beforeLine = beforeById.get(afterLine.id)\n    if (!beforeLine) continue\n\n    for (const field of USER_EDITABLE_LINE_FIELDS) {\n      if (!historyValuesEqual(beforeLine[field], afterLine[field])) {\n        changedFields.add(field)\n      }\n    }\n  }\n\n  return USER_EDITABLE_LINE_FIELDS.filter((field) => changedFields.has(field))\n}\n\nexport function deriveHistoryChangedFields(log: ActionLog): string[] {\n  if (DOCUMENT_LINE_UPSERT_COMMANDS.has(log.commandId)) {\n    return deriveDocumentLineChangedFields(log)\n  }\n  const persisted = Array.isArray(log.changedFields)\n    ? log.changedFields.filter((field): field is string => typeof field === 'string' && field.trim().length > 0)\n    : []\n  return Array.from(new Set(persisted))\n}\n\nfunction extractStatusFromSnapshot(snapshot: unknown): string | null {\n  if (!snapshot || typeof snapshot !== 'object') return null\n  const s = snapshot as Record<string, unknown>\n  // Dedicated logStatusChange entries: { status: \"value\" }\n  if (typeof s.status === 'string') return s.status\n  // Regular update snapshots: { order: { status, fulfillment_status, payment_status, ... } }\n  if (s.order && typeof s.order === 'object') {\n    const order = s.order as Record<string, unknown>\n    const orderStatus = typeof order.status === 'string' ? order.status : null\n    const fulfillmentStatus = typeof order.fulfillment_status === 'string' ? order.fulfillment_status : null\n    const paymentStatus = typeof order.payment_status === 'string' ? order.payment_status : null\n    return orderStatus ?? fulfillmentStatus ?? paymentStatus ?? null\n  }\n  // Regular update snapshots: { quote: { status: \"value\", ... } }\n  if (s.quote && typeof s.quote === 'object') {\n    const quote = s.quote as Record<string, unknown>\n    if (typeof quote.status === 'string') return quote.status\n  }\n  return null\n}\n\nexport function detectStatusChange(log: ActionLog): {\n  statusFrom: string | null\n  statusTo: string | null\n} | null {\n  const after = extractStatusFromSnapshot(log.snapshotAfter)\n  const before = log.snapshotBefore\n    ? extractStatusFromSnapshot(log.snapshotBefore)\n    : null\n  // Creation (no snapshotBefore): always one status entry (initial value or \"created\")\n  if (!log.snapshotBefore) {\n    return { statusFrom: null, statusTo: after ?? null }\n  }\n  if (before !== after && (before !== null || after !== null)) {\n    return { statusFrom: before, statusTo: after ?? null }\n  }\n  return null\n}\n\n/**\n * Normalizes ActionLog to HistoryEntry (status/action/comment).\n */\nexport function normalizeActionLogToHistoryEntry(\n  log: ActionLog,\n  kind: 'order' | 'quote',\n  displayUsers?: Record<string, string>,\n): HistoryEntry {\n  const statusChange = detectStatusChange(log)\n  const changedFields = deriveHistoryChangedFields(log)\n  let entryKind: 'status' | 'action' = 'action'\n  let action = log.actionLabel || log.commandId\n  let metadata: HistoryEntry['metadata'] = {\n    documentKind: kind,\n    commandId: log.commandId,\n    ...(changedFields.length > 0 ? { changedFields } : {}),\n  }\n  if (statusChange) {\n    const hasStatusValues = statusChange.statusFrom != null || statusChange.statusTo != null\n    if (hasStatusValues) {\n      entryKind = 'status'\n      action = statusChange.statusTo ?? 'unknown'\n      metadata = { ...metadata, statusFrom: statusChange.statusFrom, statusTo: statusChange.statusTo }\n    }\n    // When both are null (e.g. Create return/shipment/payment with non-document snapshot), keep as action and use actionLabel\n  }\n  const actorLabel = log.actorUserId\n    ? (displayUsers?.[log.actorUserId] ?? log.actorUserId)\n    : 'system'\n  return {\n    id: log.id,\n    occurredAt: log.createdAt.toISOString(),\n    kind: entryKind,\n    action,\n    actor: { id: log.actorUserId, label: actorLabel },\n    source: 'action_log',\n    metadata,\n  }\n}\n\nexport function normalizeNoteToHistoryEntry(\n  note: SalesNote,\n  kind: 'order' | 'quote',\n  displayUsers?: Record<string, string>,\n): HistoryEntry {\n  const actorLabel = note.authorUserId\n    ? (displayUsers?.[note.authorUserId] ?? note.authorUserId)\n    : 'system'\n  return {\n    id: note.id,\n    occurredAt: note.createdAt.toISOString(),\n    kind: 'comment',\n    action: note.body,\n    actor: { id: note.authorUserId ?? null, label: actorLabel },\n    source: 'note',\n    metadata: { documentKind: kind },\n  }\n}\n\nexport type HistoryBuilderInput = {\n  actionLogs: ActionLog[]\n  notes?: SalesNote[]\n  kind: 'order' | 'quote'\n  displayUsers?: Record<string, string>\n}\n\nexport function buildHistoryEntries(input: HistoryBuilderInput): HistoryEntry[] {\n  const logEntries = input.actionLogs.map((log) =>\n    normalizeActionLogToHistoryEntry(log, input.kind, input.displayUsers)\n  )\n  const noteEntries = (input.notes ?? []).map((note) =>\n    normalizeNoteToHistoryEntry(note, input.kind, input.displayUsers)\n  )\n  return [...logEntries, ...noteEntries].sort(\n    (a, b) => new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime()\n  )\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/sales/widgets/injection/document-history/widget.client.js

@@ -23,6 +23,44 @@ const KIND_BG_COLORS = {
   action: "bg-muted",
   comment: "bg-muted"
 };
+const CHANGED_FIELD_LABELS = {
+  productId: { key: "sales.documents.history.fields.product", fallback: "Product" },
+  productVariantId: { key: "sales.documents.history.fields.variant", fallback: "Variant" },
+  name: { key: "sales.documents.history.fields.name", fallback: "Name" },
+  description: { key: "sales.documents.history.fields.description", fallback: "Description" },
+  comment: { key: "sales.documents.history.fields.comment", fallback: "Comment" },
+  quantity: { key: "sales.documents.history.fields.quantity", fallback: "Quantity" },
+  quantityUnit: { key: "sales.documents.history.fields.quantityUnit", fallback: "Quantity unit" },
+  currencyCode: { key: "sales.documents.history.fields.currency", fallback: "Currency" },
+  unitPriceNet: { key: "sales.documents.history.fields.unitPriceNet", fallback: "Net unit price" },
+  unitPriceGross: { key: "sales.documents.history.fields.unitPriceGross", fallback: "Gross unit price" },
+  discountAmount: { key: "sales.documents.history.fields.discountAmount", fallback: "Discount amount" },
+  discountPercent: { key: "sales.documents.history.fields.discountPercent", fallback: "Discount percent" },
+  taxRate: { key: "sales.documents.history.fields.taxRate", fallback: "Tax class" },
+  configuration: { key: "sales.documents.history.fields.configuration", fallback: "Configuration" },
+  promotionCode: { key: "sales.documents.history.fields.promotionCode", fallback: "Promotion code" },
+  customFields: { key: "sales.documents.history.fields.customFields", fallback: "Custom fields" },
+  statusEntryId: { key: "sales.documents.history.fields.status", fallback: "Status" }
+};
+function normalizeChangedField(field) {
+  const segment = field.split(".").pop() ?? field;
+  return segment.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function humanizeChangedField(field) {
+  const normalized = normalizeChangedField(field);
+  const spaced = normalized.replace(/([a-z0-9])([A-Z])/g, "$1 $2").trim();
+  return spaced.length > 0 ? `${spaced[0].toUpperCase()}${spaced.slice(1)}` : field;
+}
+function translateChangedField(t, field) {
+  const normalized = normalizeChangedField(field);
+  const translation = CHANGED_FIELD_LABELS[normalized];
+  return translation ? t(translation.key, translation.fallback) : humanizeChangedField(field);
+}
+function translateAction(t, entry) {
+  const commandId = entry.metadata?.commandId;
+  if (!commandId?.startsWith("sales.")) return entry.action;
+  return t(`sales.audit.${commandId.slice("sales.".length)}`, entry.action);
+}
 function StatusDot({ color, className }) {
   if (!color) return /* @__PURE__ */ jsx("span", { className: cn("h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex", className) });
   return /* @__PURE__ */ jsx(
@@ -58,10 +96,16 @@ function TimelineItem({
   statusMap,
   isLast
 }) {
+  const t = useT();
   const KindIcon = KIND_ICONS[entry.kind];
   const relativeTime = formatRelativeTime(entry.occurredAt);
   const absoluteTime = formatDateTime(entry.occurredAt);
   const isStatusChange = entry.kind === "status" && entry.metadata?.statusTo;
+  const action = translateAction(t, entry);
+  const actorLabel = entry.actor.id ? entry.actor.label : t("sales.documents.history.actor.system", "System");
+  const changedFieldLabels = Array.from(
+    new Set((entry.metadata?.changedFields ?? []).map((field) => translateChangedField(t, field)))
+  );
   return /* @__PURE__ */ jsxs("div", { "data-testid": "timeline-entry", className: "relative flex gap-3", children: [
     !isLast && /* @__PURE__ */ jsx("div", { className: "absolute left-[11px] top-6 bottom-0 w-px bg-border", "aria-hidden": true }),
     /* @__PURE__ */ jsx(
@@ -78,7 +122,7 @@ function TimelineItem({
       /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2 flex-wrap", children: [
         /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1.5 text-xs font-medium text-foreground", children: [
           /* @__PURE__ */ jsx(User, { className: "h-3 w-3 text-muted-foreground", "aria-hidden": true }),
-          entry.actor.label
+          actorLabel
         ] }),
         /* @__PURE__ */ jsx(
           "span",
@@ -96,7 +140,12 @@ function TimelineItem({
           statusTo: entry.metadata?.statusTo,
           statusMap
         }
-      ) : /* @__PURE__ */ jsx("div", { className: "text-sm text-foreground", children: entry.action })
+      ) : /* @__PURE__ */ jsxs("div", { className: "space-y-0.5", children: [
+        /* @__PURE__ */ jsx("div", { className: "text-sm text-foreground", children: action }),
+        entry.kind === "action" && changedFieldLabels.length > 0 ? /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: t("sales.documents.history.changedFields", "Changed fields: {fields}", {
+          fields: changedFieldLabels.join(", ")
+        }) }) : null
+      ] })
     ] }) })
   ] });
 }

package/dist/modules/sales/widgets/injection/document-history/widget.client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/sales/widgets/injection/document-history/widget.client.tsx"],
-  "sourcesContent": ["\"use client\"\n\nimport * as React from \"react\"\nimport { Spinner } from \"@open-mercato/ui/primitives/spinner\"\nimport { useT } from \"@open-mercato/shared/lib/i18n/context\"\nimport { apiCall } from \"@open-mercato/ui/backend/utils/apiCall\"\nimport { formatRelativeTime, formatDateTime } from \"@open-mercato/shared/lib/time\"\nimport { cn } from \"@open-mercato/shared/lib/utils\"\nimport type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'\nimport { ArrowRightLeft, Zap, MessageSquare, User, Filter, ChevronDown, Check } from 'lucide-react'\n\nexport type TimelineEntry = {\n  id: string\n  occurredAt: string\n  kind: \"status\" | \"action\" | \"comment\"\n  action: string\n  actor: { id: string | null; label: string }\n  source: \"action_log\" | \"note\"\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: \"order\" | \"quote\"\n    commandId?: string\n  }\n}\n\ntype StatusOption = {\n  value: string\n  label: string\n  color: string | null\n  icon: string | null\n}\n\ntype TimelineContext = {\n  kind: \"order\" | \"quote\"\n  record: { id: string }\n}\n\nconst isValidContext = (ctx: unknown): ctx is TimelineContext =>\n  ctx !== null &&\n  typeof ctx === 'object' &&\n  'kind' in ctx &&\n  'record' in ctx &&\n  ((ctx as TimelineContext).kind === 'order' || (ctx as TimelineContext).kind === 'quote') &&\n  typeof (ctx as TimelineContext).record === 'object' &&\n  (ctx as TimelineContext).record !== null &&\n  'id' in (ctx as TimelineContext).record &&\n  typeof (ctx as TimelineContext).record.id === 'string'\n\nconst KIND_ICONS = {\n  status: ArrowRightLeft,\n  action: Zap,\n  comment: MessageSquare,\n}\n\nconst KIND_ICON_COLORS = {\n  status: 'text-foreground',\n  action: 'text-foreground',\n  comment: 'text-foreground',\n}\n\nconst KIND_BG_COLORS = {\n  status: 'bg-muted',\n  action: 'bg-muted',\n  comment: 'bg-muted',\n}\n\nfunction StatusDot({ color, className }: { color: string | null | undefined; className?: string }) {\n  if (!color) return <span className={cn('h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex', className)} />\n  return (\n    <span\n      className={cn('h-2.5 w-2.5 rounded-full border border-border/70 inline-flex', className)}\n      style={{ backgroundColor: color }}\n      aria-hidden\n    />\n  )\n}\n\nfunction StatusTransition({\n  statusFrom,\n  statusTo,\n  statusMap,\n}: {\n  statusFrom: string | null | undefined\n  statusTo: string | null | undefined\n  statusMap: Record<string, StatusOption>\n}) {\n  const from = statusFrom ? (statusMap[statusFrom] ?? { value: statusFrom, label: statusFrom, color: null, icon: null }) : null\n  const to = statusTo ? (statusMap[statusTo] ?? { value: statusTo, label: statusTo, color: null, icon: null }) : null\n\n  return (\n    <div className=\"flex items-center gap-1.5 flex-wrap\">\n      {from ? (\n        <span className=\"inline-flex items-center gap-1 text-xs text-muted-foreground\">\n          <StatusDot color={from.color} />\n          <span>{from.label}</span>\n        </span>\n      ) : null}\n      {from && to ? (\n        <ArrowRightLeft className=\"h-3 w-3 text-muted-foreground/60 shrink-0\" />\n      ) : null}\n      {to ? (\n        <span className=\"inline-flex items-center gap-1 text-xs font-medium text-foreground\">\n          <StatusDot color={to.color} />\n          <span>{to.label}</span>\n        </span>\n      ) : null}\n    </div>\n  )\n}\n\nfunction TimelineItem({\n  entry,\n  statusMap,\n  isLast,\n}: {\n  entry: TimelineEntry\n  statusMap: Record<string, StatusOption>\n  isLast: boolean\n}) {\n  const KindIcon = KIND_ICONS[entry.kind]\n  const relativeTime = formatRelativeTime(entry.occurredAt)\n  const absoluteTime = formatDateTime(entry.occurredAt)\n\n  const isStatusChange = entry.kind === 'status' && entry.metadata?.statusTo\n\n  return (\n    <div data-testid=\"timeline-entry\" className=\"relative flex gap-3\">\n      {/* Vertical connector line */}\n      {!isLast && (\n        <div className=\"absolute left-[11px] top-6 bottom-0 w-px bg-border\" aria-hidden />\n      )}\n\n      {/* Icon circle */}\n      <div\n        className={cn(\n          'relative z-10 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-border',\n          KIND_BG_COLORS[entry.kind],\n        )}\n      >\n        <KindIcon className={cn('h-3 w-3', KIND_ICON_COLORS[entry.kind])} aria-hidden />\n      </div>\n\n      {/* Content card */}\n      <div className=\"flex-1 pb-4\">\n        <div className=\"group rounded-lg border bg-card p-3 space-y-1.5\">\n          {/* Header: actor + time */}\n          <div className=\"flex items-center justify-between gap-2 flex-wrap\">\n            <span className=\"inline-flex items-center gap-1.5 text-xs font-medium text-foreground\">\n              <User className=\"h-3 w-3 text-muted-foreground\" aria-hidden />\n              {entry.actor.label}\n            </span>\n            <span\n              className=\"text-xs text-muted-foreground\"\n              title={absoluteTime ?? undefined}\n            >\n              {relativeTime ?? absoluteTime}\n            </span>\n          </div>\n\n          {/* Body */}\n          {isStatusChange ? (\n            <StatusTransition\n              statusFrom={entry.metadata?.statusFrom}\n              statusTo={entry.metadata?.statusTo}\n              statusMap={statusMap}\n            />\n          ) : (\n            <div className=\"text-sm text-foreground\">{entry.action}</div>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n\ntype FilterKind = 'all' | 'status' | 'action' | 'comment'\n\ntype FilterOption = { value: FilterKind; label: string }\n\nfunction FilterDropdown({ filter, onChange }: { filter: FilterKind; onChange: (kind: FilterKind) => void }) {\n  const t = useT()\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    function onDocClick(e: MouseEvent) {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    function onKey(e: KeyboardEvent) {\n      if (e.key === 'Escape') setOpen(false)\n    }\n    document.addEventListener('mousedown', onDocClick)\n    document.addEventListener('keydown', onKey)\n    return () => {\n      document.removeEventListener('mousedown', onDocClick)\n      document.removeEventListener('keydown', onKey)\n    }\n  }, [open])\n\n  const options: FilterOption[] = [\n    { value: 'all', label: t('sales.documents.history.filter.all', 'All') },\n    { value: 'status', label: t('sales.documents.history.filter.status', 'Status changes') },\n    { value: 'action', label: t('sales.documents.history.filter.actions', 'Actions') },\n    { value: 'comment', label: t('sales.documents.history.filter.comments', 'Comments') },\n  ]\n\n  const activeLabel = options.find(o => o.value === filter)?.label\n\n  return (\n    <div className=\"relative\" ref={ref}>\n      <button\n        type=\"button\"\n        aria-haspopup=\"listbox\"\n        aria-expanded={open}\n        onClick={() => setOpen(prev => !prev)}\n        className=\"inline-flex items-center gap-1.5 rounded-md border border-input bg-background px-2.5 py-1 text-xs font-medium shadow-sm hover:bg-accent hover:text-accent-foreground transition-colors select-none\"\n      >\n        <Filter className=\"h-3 w-3\" aria-hidden />\n        {t('sales.documents.history.filter.label', 'Filters')}\n        {filter !== 'all' && (\n          <span className=\"text-muted-foreground\">: {activeLabel}</span>\n        )}\n        <ChevronDown className={cn('h-3 w-3 transition-transform duration-150', open && 'rotate-180')} aria-hidden />\n      </button>\n      {open && (\n        <div\n          role=\"listbox\"\n          aria-label={t('sales.documents.history.filter.label', 'Filters')}\n          className=\"absolute left-0 top-full mt-1 z-dropdown w-48 rounded-md border bg-background p-1 shadow-md\"\n        >\n          {options.map(opt => (\n            <button\n              key={opt.value}\n              type=\"button\"\n              role=\"option\"\n              aria-selected={filter === opt.value}\n              onClick={() => { onChange(opt.value); setOpen(false) }}\n              className=\"flex w-full items-center gap-2 rounded px-2 py-1.5 text-sm hover:bg-accent\"\n            >\n              <Check className={cn('h-3.5 w-3.5 shrink-0', filter === opt.value ? 'opacity-100' : 'opacity-0')} aria-hidden />\n              {opt.label}\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport const DocumentHistoryWidget: React.FC<InjectionWidgetComponentProps<unknown, unknown>> = ({ context }) => {\n  const t = useT()\n  const [entries, setEntries] = React.useState<TimelineEntry[]>([])\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n  const [statusMap, setStatusMap] = React.useState<Record<string, StatusOption>>({})\n  const [filter, setFilter] = React.useState<FilterKind>('all')\n\n  React.useEffect(() => {\n    const urls = [\n      '/api/sales/order-statuses?pageSize=100',\n      '/api/sales/shipment-statuses?pageSize=100',\n      '/api/sales/payment-statuses?pageSize=100',\n    ]\n    const map: Record<string, StatusOption> = {}\n    const merge = (items: unknown[]) => {\n      if (!Array.isArray(items)) return\n      for (const item of items) {\n        if (!item || typeof item !== 'object') continue\n        const d = item as Record<string, unknown>\n        const value = typeof d.value === 'string' ? d.value : null\n        if (!value) continue\n        map[value] = {\n          value,\n          label: typeof d.label === 'string' && d.label.length ? d.label : value,\n          color: typeof d.color === 'string' && d.color.length ? d.color : null,\n          icon: typeof d.icon === 'string' && d.icon.length ? d.icon : null,\n        }\n      }\n    }\n    Promise.all(urls.map((url) => apiCall<{ items?: unknown[] }>(url)))\n      .then((responses) => {\n        for (const res of responses) {\n          if (res.ok && Array.isArray(res.result?.items)) merge(res.result.items)\n        }\n        setStatusMap(map)\n      })\n      .catch(() => {})\n  }, [])\n\n  React.useEffect(() => {\n    if (!isValidContext(context)) {\n      setLoading(false)\n      setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n    apiCall<{ items: TimelineEntry[] }>(\n      `/api/sales/document-history?kind=${context.kind}&id=${context.record.id}`\n    )\n      .then((res) => {\n        if (res.ok && Array.isArray(res.result?.items)) {\n          setEntries(res.result.items)\n        } else {\n          setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n        }\n      })\n      .catch(() => setError(t(\"sales.documents.history.error\", \"Failed to load history.\")))\n      .finally(() => setLoading(false))\n  }, [context, t])\n\n  const filtered = React.useMemo(\n    () => filter === 'all' ? entries : entries.filter(e => e.kind === filter),\n    [entries, filter]\n  )\n\n  return (\n    <div className=\"space-y-4\">\n      {/* Filter dropdown */}\n      <div>\n        <FilterDropdown filter={filter} onChange={setFilter} />\n      </div>\n\n      {/* Content */}\n      {loading ? (\n        <div className=\"flex items-center justify-center h-24\">\n          <Spinner />\n        </div>\n      ) : error ? (\n        <div className=\"text-destructive text-sm\">{error}</div>\n      ) : !filtered.length ? (\n        <div className=\"text-muted-foreground text-sm py-6 text-center\">\n          {t(\"sales.documents.history.empty\", \"No history entries yet.\")}\n        </div>\n      ) : (\n        <div className=\"relative\">\n          {filtered.map((entry, index) => (\n            <TimelineItem\n              key={entry.id}\n              entry={entry}\n              statusMap={statusMap}\n              isLast={index === filtered.length - 1}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport default DocumentHistoryWidget\n"],
-  "mappings": ";AAoEqB,cAyBb,YAzBa;AAlErB,YAAY,WAAW;AACvB,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,SAAS,oBAAoB,sBAAsB;AACnD,SAAS,UAAU;AAEnB,SAAS,gBAAgB,KAAK,eAAe,MAAM,QAAQ,aAAa,aAAa;AA6BrF,MAAM,iBAAiB,CAAC,QACtB,QAAQ,QACR,OAAO,QAAQ,YACf,UAAU,OACV,YAAY,QACV,IAAwB,SAAS,WAAY,IAAwB,SAAS,YAChF,OAAQ,IAAwB,WAAW,YAC1C,IAAwB,WAAW,QACpC,QAAS,IAAwB,UACjC,OAAQ,IAAwB,OAAO,OAAO;AAEhD,MAAM,aAAa;AAAA,EACjB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEA,MAAM,mBAAmB;AAAA,EACvB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEA,MAAM,iBAAiB;AAAA,EACrB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEA,SAAS,UAAU,EAAE,OAAO,UAAU,GAA6D;AACjG,MAAI,CAAC,MAAO,QAAO,oBAAC,UAAK,WAAW,GAAG,oFAAoF,SAAS,GAAG;AACvI,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,GAAG,gEAAgE,SAAS;AAAA,MACvF,OAAO,EAAE,iBAAiB,MAAM;AAAA,MAChC,eAAW;AAAA;AAAA,EACb;AAEJ;AAEA,SAAS,iBAAiB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,OAAO,aAAc,UAAU,UAAU,KAAK,EAAE,OAAO,YAAY,OAAO,YAAY,OAAO,MAAM,MAAM,KAAK,IAAK;AACzH,QAAM,KAAK,WAAY,UAAU,QAAQ,KAAK,EAAE,OAAO,UAAU,OAAO,UAAU,OAAO,MAAM,MAAM,KAAK,IAAK;AAE/G,SACE,qBAAC,SAAI,WAAU,uCACZ;AAAA,WACC,qBAAC,UAAK,WAAU,gEACd;AAAA,0BAAC,aAAU,OAAO,KAAK,OAAO;AAAA,MAC9B,oBAAC,UAAM,eAAK,OAAM;AAAA,OACpB,IACE;AAAA,IACH,QAAQ,KACP,oBAAC,kBAAe,WAAU,6CAA4C,IACpE;AAAA,IACH,KACC,qBAAC,UAAK,WAAU,sEACd;AAAA,0BAAC,aAAU,OAAO,GAAG,OAAO;AAAA,MAC5B,oBAAC,UAAM,aAAG,OAAM;AAAA,OAClB,IACE;AAAA,KACN;AAEJ;AAEA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,WAAW,WAAW,MAAM,IAAI;AACtC,QAAM,eAAe,mBAAmB,MAAM,UAAU;AACxD,QAAM,eAAe,eAAe,MAAM,UAAU;AAEpD,QAAM,iBAAiB,MAAM,SAAS,YAAY,MAAM,UAAU;AAElE,SACE,qBAAC,SAAI,eAAY,kBAAiB,WAAU,uBAEzC;AAAA,KAAC,UACA,oBAAC,SAAI,WAAU,sDAAqD,eAAW,MAAC;AAAA,IAIlF;AAAA,MAAC;AAAA;AAAA,QACC,WAAW;AAAA,UACT;AAAA,UACA,eAAe,MAAM,IAAI;AAAA,QAC3B;AAAA,QAEA,8BAAC,YAAS,WAAW,GAAG,WAAW,iBAAiB,MAAM,IAAI,CAAC,GAAG,eAAW,MAAC;AAAA;AAAA,IAChF;AAAA,IAGA,oBAAC,SAAI,WAAU,eACb,+BAAC,SAAI,WAAU,mDAEb;AAAA,2BAAC,SAAI,WAAU,qDACb;AAAA,6BAAC,UAAK,WAAU,wEACd;AAAA,8BAAC,QAAK,WAAU,iCAAgC,eAAW,MAAC;AAAA,UAC3D,MAAM,MAAM;AAAA,WACf;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV,OAAO,gBAAgB;AAAA,YAEtB,0BAAgB;AAAA;AAAA,QACnB;AAAA,SACF;AAAA,MAGC,iBACC;AAAA,QAAC;AAAA;AAAA,UACC,YAAY,MAAM,UAAU;AAAA,UAC5B,UAAU,MAAM,UAAU;AAAA,UAC1B;AAAA;AAAA,MACF,IAEA,oBAAC,SAAI,WAAU,2BAA2B,gBAAM,QAAO;AAAA,OAE3D,GACF;AAAA,KACF;AAEJ;AAMA,SAAS,eAAe,EAAE,QAAQ,SAAS,GAAiE;AAC1G,QAAM,IAAI,KAAK;AACf,QAAM,CAAC,MAAM,OAAO,IAAI,MAAM,SAAS,KAAK;AAC5C,QAAM,MAAM,MAAM,OAAuB,IAAI;AAE7C,QAAM,UAAU,MAAM;AACpB,QAAI,CAAC,KAAM;AACX,aAAS,WAAW,GAAe;AACjC,UAAI,IAAI,WAAW,CAAC,IAAI,QAAQ,SAAS,EAAE,MAAc,EAAG,SAAQ,KAAK;AAAA,IAC3E;AACA,aAAS,MAAM,GAAkB;AAC/B,UAAI,EAAE,QAAQ,SAAU,SAAQ,KAAK;AAAA,IACvC;AACA,aAAS,iBAAiB,aAAa,UAAU;AACjD,aAAS,iBAAiB,WAAW,KAAK;AAC1C,WAAO,MAAM;AACX,eAAS,oBAAoB,aAAa,UAAU;AACpD,eAAS,oBAAoB,WAAW,KAAK;AAAA,IAC/C;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAET,QAAM,UAA0B;AAAA,IAC9B,EAAE,OAAO,OAAO,OAAO,EAAE,sCAAsC,KAAK,EAAE;AAAA,IACtE,EAAE,OAAO,UAAU,OAAO,EAAE,yCAAyC,gBAAgB,EAAE;AAAA,IACvF,EAAE,OAAO,UAAU,OAAO,EAAE,0CAA0C,SAAS,EAAE;AAAA,IACjF,EAAE,OAAO,WAAW,OAAO,EAAE,2CAA2C,UAAU,EAAE;AAAA,EACtF;AAEA,QAAM,cAAc,QAAQ,KAAK,OAAK,EAAE,UAAU,MAAM,GAAG;AAE3D,SACE,qBAAC,SAAI,WAAU,YAAW,KACxB;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,iBAAc;AAAA,QACd,iBAAe;AAAA,QACf,SAAS,MAAM,QAAQ,UAAQ,CAAC,IAAI;AAAA,QACpC,WAAU;AAAA,QAEV;AAAA,8BAAC,UAAO,WAAU,WAAU,eAAW,MAAC;AAAA,UACvC,EAAE,wCAAwC,SAAS;AAAA,UACnD,WAAW,SACV,qBAAC,UAAK,WAAU,yBAAwB;AAAA;AAAA,YAAG;AAAA,aAAY;AAAA,UAEzD,oBAAC,eAAY,WAAW,GAAG,6CAA6C,QAAQ,YAAY,GAAG,eAAW,MAAC;AAAA;AAAA;AAAA,IAC7G;AAAA,IACC,QACC;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,cAAY,EAAE,wCAAwC,SAAS;AAAA,QAC/D,WAAU;AAAA,QAET,kBAAQ,IAAI,SACX;AAAA,UAAC;AAAA;AAAA,YAEC,MAAK;AAAA,YACL,MAAK;AAAA,YACL,iBAAe,WAAW,IAAI;AAAA,YAC9B,SAAS,MAAM;AAAE,uBAAS,IAAI,KAAK;AAAG,sBAAQ,KAAK;AAAA,YAAE;AAAA,YACrD,WAAU;AAAA,YAEV;AAAA,kCAAC,SAAM,WAAW,GAAG,wBAAwB,WAAW,IAAI,QAAQ,gBAAgB,WAAW,GAAG,eAAW,MAAC;AAAA,cAC7G,IAAI;AAAA;AAAA;AAAA,UARA,IAAI;AAAA,QASX,CACD;AAAA;AAAA,IACH;AAAA,KAEJ;AAEJ;AAEO,MAAM,wBAAmF,CAAC,EAAE,QAAQ,MAAM;AAC/G,QAAM,IAAI,KAAK;AACf,QAAM,CAAC,SAAS,UAAU,IAAI,MAAM,SAA0B,CAAC,CAAC;AAChE,QAAM,CAAC,SAAS,UAAU,IAAI,MAAM,SAAS,IAAI;AACjD,QAAM,CAAC,OAAO,QAAQ,IAAI,MAAM,SAAwB,IAAI;AAC5D,QAAM,CAAC,WAAW,YAAY,IAAI,MAAM,SAAuC,CAAC,CAAC;AACjF,QAAM,CAAC,QAAQ,SAAS,IAAI,MAAM,SAAqB,KAAK;AAE5D,QAAM,UAAU,MAAM;AACpB,UAAM,OAAO;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,MAAoC,CAAC;AAC3C,UAAM,QAAQ,CAAC,UAAqB;AAClC,UAAI,CAAC,MAAM,QAAQ,KAAK,EAAG;AAC3B,iBAAW,QAAQ,OAAO;AACxB,YAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,cAAM,IAAI;AACV,cAAM,QAAQ,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ;AACtD,YAAI,CAAC,MAAO;AACZ,YAAI,KAAK,IAAI;AAAA,UACX;AAAA,UACA,OAAO,OAAO,EAAE,UAAU,YAAY,EAAE,MAAM,SAAS,EAAE,QAAQ;AAAA,UACjE,OAAO,OAAO,EAAE,UAAU,YAAY,EAAE,MAAM,SAAS,EAAE,QAAQ;AAAA,UACjE,MAAM,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,SAAS,EAAE,OAAO;AAAA,QAC/D;AAAA,MACF;AAAA,IACF;AACA,YAAQ,IAAI,KAAK,IAAI,CAAC,QAAQ,QAA+B,GAAG,CAAC,CAAC,EAC/D,KAAK,CAAC,cAAc;AACnB,iBAAW,OAAO,WAAW;AAC3B,YAAI,IAAI,MAAM,MAAM,QAAQ,IAAI,QAAQ,KAAK,EAAG,OAAM,IAAI,OAAO,KAAK;AAAA,MACxE;AACA,mBAAa,GAAG;AAAA,IAClB,CAAC,EACA,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACnB,GAAG,CAAC,CAAC;AAEL,QAAM,UAAU,MAAM;AACpB,QAAI,CAAC,eAAe,OAAO,GAAG;AAC5B,iBAAW,KAAK;AAChB,eAAS,EAAE,iCAAiC,yBAAyB,CAAC;AACtE;AAAA,IACF;AAEA,eAAW,IAAI;AACf,aAAS,IAAI;AACb;AAAA,MACE,oCAAoC,QAAQ,IAAI,OAAO,QAAQ,OAAO,EAAE;AAAA,IAC1E,EACG,KAAK,CAAC,QAAQ;AACb,UAAI,IAAI,MAAM,MAAM,QAAQ,IAAI,QAAQ,KAAK,GAAG;AAC9C,mBAAW,IAAI,OAAO,KAAK;AAAA,MAC7B,OAAO;AACL,iBAAS,EAAE,iCAAiC,yBAAyB,CAAC;AAAA,MACxE;AAAA,IACF,CAAC,EACA,MAAM,MAAM,SAAS,EAAE,iCAAiC,yBAAyB,CAAC,CAAC,EACnF,QAAQ,MAAM,WAAW,KAAK,CAAC;AAAA,EACpC,GAAG,CAAC,SAAS,CAAC,CAAC;AAEf,QAAM,WAAW,MAAM;AAAA,IACrB,MAAM,WAAW,QAAQ,UAAU,QAAQ,OAAO,OAAK,EAAE,SAAS,MAAM;AAAA,IACxE,CAAC,SAAS,MAAM;AAAA,EAClB;AAEA,SACE,qBAAC,SAAI,WAAU,aAEb;AAAA,wBAAC,SACC,8BAAC,kBAAe,QAAgB,UAAU,WAAW,GACvD;AAAA,IAGC,UACC,oBAAC,SAAI,WAAU,yCACb,8BAAC,WAAQ,GACX,IACE,QACF,oBAAC,SAAI,WAAU,4BAA4B,iBAAM,IAC/C,CAAC,SAAS,SACZ,oBAAC,SAAI,WAAU,kDACZ,YAAE,iCAAiC,yBAAyB,GAC/D,IAEA,oBAAC,SAAI,WAAU,YACZ,mBAAS,IAAI,CAAC,OAAO,UACpB;AAAA,MAAC;AAAA;AAAA,QAEC;AAAA,QACA;AAAA,QACA,QAAQ,UAAU,SAAS,SAAS;AAAA;AAAA,MAH/B,MAAM;AAAA,IAIb,CACD,GACH;AAAA,KAEJ;AAEJ;AAEA,IAAO,wBAAQ;",
+  "sourcesContent": ["\"use client\"\n\nimport * as React from \"react\"\nimport { Spinner } from \"@open-mercato/ui/primitives/spinner\"\nimport { useT, type TranslateFn } from \"@open-mercato/shared/lib/i18n/context\"\nimport { apiCall } from \"@open-mercato/ui/backend/utils/apiCall\"\nimport { formatRelativeTime, formatDateTime } from \"@open-mercato/shared/lib/time\"\nimport { cn } from \"@open-mercato/shared/lib/utils\"\nimport type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'\nimport { ArrowRightLeft, Zap, MessageSquare, User, Filter, ChevronDown, Check } from 'lucide-react'\n\nexport type TimelineEntry = {\n  id: string\n  occurredAt: string\n  kind: \"status\" | \"action\" | \"comment\"\n  action: string\n  actor: { id: string | null; label: string }\n  source: \"action_log\" | \"note\"\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: \"order\" | \"quote\"\n    commandId?: string\n    changedFields?: string[]\n  }\n}\n\ntype StatusOption = {\n  value: string\n  label: string\n  color: string | null\n  icon: string | null\n}\n\ntype TimelineContext = {\n  kind: \"order\" | \"quote\"\n  record: { id: string }\n}\n\nconst isValidContext = (ctx: unknown): ctx is TimelineContext =>\n  ctx !== null &&\n  typeof ctx === 'object' &&\n  'kind' in ctx &&\n  'record' in ctx &&\n  ((ctx as TimelineContext).kind === 'order' || (ctx as TimelineContext).kind === 'quote') &&\n  typeof (ctx as TimelineContext).record === 'object' &&\n  (ctx as TimelineContext).record !== null &&\n  'id' in (ctx as TimelineContext).record &&\n  typeof (ctx as TimelineContext).record.id === 'string'\n\nconst KIND_ICONS = {\n  status: ArrowRightLeft,\n  action: Zap,\n  comment: MessageSquare,\n}\n\nconst KIND_ICON_COLORS = {\n  status: 'text-foreground',\n  action: 'text-foreground',\n  comment: 'text-foreground',\n}\n\nconst KIND_BG_COLORS = {\n  status: 'bg-muted',\n  action: 'bg-muted',\n  comment: 'bg-muted',\n}\n\nconst CHANGED_FIELD_LABELS: Record<string, { key: string; fallback: string }> = {\n  productId: { key: 'sales.documents.history.fields.product', fallback: 'Product' },\n  productVariantId: { key: 'sales.documents.history.fields.variant', fallback: 'Variant' },\n  name: { key: 'sales.documents.history.fields.name', fallback: 'Name' },\n  description: { key: 'sales.documents.history.fields.description', fallback: 'Description' },\n  comment: { key: 'sales.documents.history.fields.comment', fallback: 'Comment' },\n  quantity: { key: 'sales.documents.history.fields.quantity', fallback: 'Quantity' },\n  quantityUnit: { key: 'sales.documents.history.fields.quantityUnit', fallback: 'Quantity unit' },\n  currencyCode: { key: 'sales.documents.history.fields.currency', fallback: 'Currency' },\n  unitPriceNet: { key: 'sales.documents.history.fields.unitPriceNet', fallback: 'Net unit price' },\n  unitPriceGross: { key: 'sales.documents.history.fields.unitPriceGross', fallback: 'Gross unit price' },\n  discountAmount: { key: 'sales.documents.history.fields.discountAmount', fallback: 'Discount amount' },\n  discountPercent: { key: 'sales.documents.history.fields.discountPercent', fallback: 'Discount percent' },\n  taxRate: { key: 'sales.documents.history.fields.taxRate', fallback: 'Tax class' },\n  configuration: { key: 'sales.documents.history.fields.configuration', fallback: 'Configuration' },\n  promotionCode: { key: 'sales.documents.history.fields.promotionCode', fallback: 'Promotion code' },\n  customFields: { key: 'sales.documents.history.fields.customFields', fallback: 'Custom fields' },\n  statusEntryId: { key: 'sales.documents.history.fields.status', fallback: 'Status' },\n}\n\nfunction normalizeChangedField(field: string): string {\n  const segment = field.split('.').pop() ?? field\n  return segment.replace(/_([a-z])/g, (_, letter: string) => letter.toUpperCase())\n}\n\nfunction humanizeChangedField(field: string): string {\n  const normalized = normalizeChangedField(field)\n  const spaced = normalized.replace(/([a-z0-9])([A-Z])/g, '$1 $2').trim()\n  return spaced.length > 0 ? `${spaced[0].toUpperCase()}${spaced.slice(1)}` : field\n}\n\nfunction translateChangedField(t: TranslateFn, field: string): string {\n  const normalized = normalizeChangedField(field)\n  const translation = CHANGED_FIELD_LABELS[normalized]\n  return translation ? t(translation.key, translation.fallback) : humanizeChangedField(field)\n}\n\nfunction translateAction(t: TranslateFn, entry: TimelineEntry): string {\n  const commandId = entry.metadata?.commandId\n  if (!commandId?.startsWith('sales.')) return entry.action\n  return t(`sales.audit.${commandId.slice('sales.'.length)}`, entry.action)\n}\n\nfunction StatusDot({ color, className }: { color: string | null | undefined; className?: string }) {\n  if (!color) return <span className={cn('h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex', className)} />\n  return (\n    <span\n      className={cn('h-2.5 w-2.5 rounded-full border border-border/70 inline-flex', className)}\n      style={{ backgroundColor: color }}\n      aria-hidden\n    />\n  )\n}\n\nfunction StatusTransition({\n  statusFrom,\n  statusTo,\n  statusMap,\n}: {\n  statusFrom: string | null | undefined\n  statusTo: string | null | undefined\n  statusMap: Record<string, StatusOption>\n}) {\n  const from = statusFrom ? (statusMap[statusFrom] ?? { value: statusFrom, label: statusFrom, color: null, icon: null }) : null\n  const to = statusTo ? (statusMap[statusTo] ?? { value: statusTo, label: statusTo, color: null, icon: null }) : null\n\n  return (\n    <div className=\"flex items-center gap-1.5 flex-wrap\">\n      {from ? (\n        <span className=\"inline-flex items-center gap-1 text-xs text-muted-foreground\">\n          <StatusDot color={from.color} />\n          <span>{from.label}</span>\n        </span>\n      ) : null}\n      {from && to ? (\n        <ArrowRightLeft className=\"h-3 w-3 text-muted-foreground/60 shrink-0\" />\n      ) : null}\n      {to ? (\n        <span className=\"inline-flex items-center gap-1 text-xs font-medium text-foreground\">\n          <StatusDot color={to.color} />\n          <span>{to.label}</span>\n        </span>\n      ) : null}\n    </div>\n  )\n}\n\nfunction TimelineItem({\n  entry,\n  statusMap,\n  isLast,\n}: {\n  entry: TimelineEntry\n  statusMap: Record<string, StatusOption>\n  isLast: boolean\n}) {\n  const t = useT()\n  const KindIcon = KIND_ICONS[entry.kind]\n  const relativeTime = formatRelativeTime(entry.occurredAt)\n  const absoluteTime = formatDateTime(entry.occurredAt)\n\n  const isStatusChange = entry.kind === 'status' && entry.metadata?.statusTo\n  const action = translateAction(t, entry)\n  const actorLabel = entry.actor.id\n    ? entry.actor.label\n    : t('sales.documents.history.actor.system', 'System')\n  const changedFieldLabels = Array.from(\n    new Set((entry.metadata?.changedFields ?? []).map((field) => translateChangedField(t, field))),\n  )\n\n  return (\n    <div data-testid=\"timeline-entry\" className=\"relative flex gap-3\">\n      {/* Vertical connector line */}\n      {!isLast && (\n        <div className=\"absolute left-[11px] top-6 bottom-0 w-px bg-border\" aria-hidden />\n      )}\n\n      {/* Icon circle */}\n      <div\n        className={cn(\n          'relative z-10 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-border',\n          KIND_BG_COLORS[entry.kind],\n        )}\n      >\n        <KindIcon className={cn('h-3 w-3', KIND_ICON_COLORS[entry.kind])} aria-hidden />\n      </div>\n\n      {/* Content card */}\n      <div className=\"flex-1 pb-4\">\n        <div className=\"group rounded-lg border bg-card p-3 space-y-1.5\">\n          {/* Header: actor + time */}\n          <div className=\"flex items-center justify-between gap-2 flex-wrap\">\n            <span className=\"inline-flex items-center gap-1.5 text-xs font-medium text-foreground\">\n              <User className=\"h-3 w-3 text-muted-foreground\" aria-hidden />\n              {actorLabel}\n            </span>\n            <span\n              className=\"text-xs text-muted-foreground\"\n              title={absoluteTime ?? undefined}\n            >\n              {relativeTime ?? absoluteTime}\n            </span>\n          </div>\n\n          {/* Body */}\n          {isStatusChange ? (\n            <StatusTransition\n              statusFrom={entry.metadata?.statusFrom}\n              statusTo={entry.metadata?.statusTo}\n              statusMap={statusMap}\n            />\n          ) : (\n            <div className=\"space-y-0.5\">\n              <div className=\"text-sm text-foreground\">{action}</div>\n              {entry.kind === 'action' && changedFieldLabels.length > 0 ? (\n                <div className=\"text-xs text-muted-foreground\">\n                  {t('sales.documents.history.changedFields', 'Changed fields: {fields}', {\n                    fields: changedFieldLabels.join(', '),\n                  })}\n                </div>\n              ) : null}\n            </div>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n\ntype FilterKind = 'all' | 'status' | 'action' | 'comment'\n\ntype FilterOption = { value: FilterKind; label: string }\n\nfunction FilterDropdown({ filter, onChange }: { filter: FilterKind; onChange: (kind: FilterKind) => void }) {\n  const t = useT()\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    function onDocClick(e: MouseEvent) {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    function onKey(e: KeyboardEvent) {\n      if (e.key === 'Escape') setOpen(false)\n    }\n    document.addEventListener('mousedown', onDocClick)\n    document.addEventListener('keydown', onKey)\n    return () => {\n      document.removeEventListener('mousedown', onDocClick)\n      document.removeEventListener('keydown', onKey)\n    }\n  }, [open])\n\n  const options: FilterOption[] = [\n    { value: 'all', label: t('sales.documents.history.filter.all', 'All') },\n    { value: 'status', label: t('sales.documents.history.filter.status', 'Status changes') },\n    { value: 'action', label: t('sales.documents.history.filter.actions', 'Actions') },\n    { value: 'comment', label: t('sales.documents.history.filter.comments', 'Comments') },\n  ]\n\n  const activeLabel = options.find(o => o.value === filter)?.label\n\n  return (\n    <div className=\"relative\" ref={ref}>\n      <button\n        type=\"button\"\n        aria-haspopup=\"listbox\"\n        aria-expanded={open}\n        onClick={() => setOpen(prev => !prev)}\n        className=\"inline-flex items-center gap-1.5 rounded-md border border-input bg-background px-2.5 py-1 text-xs font-medium shadow-sm hover:bg-accent hover:text-accent-foreground transition-colors select-none\"\n      >\n        <Filter className=\"h-3 w-3\" aria-hidden />\n        {t('sales.documents.history.filter.label', 'Filters')}\n        {filter !== 'all' && (\n          <span className=\"text-muted-foreground\">: {activeLabel}</span>\n        )}\n        <ChevronDown className={cn('h-3 w-3 transition-transform duration-150', open && 'rotate-180')} aria-hidden />\n      </button>\n      {open && (\n        <div\n          role=\"listbox\"\n          aria-label={t('sales.documents.history.filter.label', 'Filters')}\n          className=\"absolute left-0 top-full mt-1 z-dropdown w-48 rounded-md border bg-background p-1 shadow-md\"\n        >\n          {options.map(opt => (\n            <button\n              key={opt.value}\n              type=\"button\"\n              role=\"option\"\n              aria-selected={filter === opt.value}\n              onClick={() => { onChange(opt.value); setOpen(false) }}\n              className=\"flex w-full items-center gap-2 rounded px-2 py-1.5 text-sm hover:bg-accent\"\n            >\n              <Check className={cn('h-3.5 w-3.5 shrink-0', filter === opt.value ? 'opacity-100' : 'opacity-0')} aria-hidden />\n              {opt.label}\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport const DocumentHistoryWidget: React.FC<InjectionWidgetComponentProps<unknown, unknown>> = ({ context }) => {\n  const t = useT()\n  const [entries, setEntries] = React.useState<TimelineEntry[]>([])\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n  const [statusMap, setStatusMap] = React.useState<Record<string, StatusOption>>({})\n  const [filter, setFilter] = React.useState<FilterKind>('all')\n\n  React.useEffect(() => {\n    const urls = [\n      '/api/sales/order-statuses?pageSize=100',\n      '/api/sales/shipment-statuses?pageSize=100',\n      '/api/sales/payment-statuses?pageSize=100',\n    ]\n    const map: Record<string, StatusOption> = {}\n    const merge = (items: unknown[]) => {\n      if (!Array.isArray(items)) return\n      for (const item of items) {\n        if (!item || typeof item !== 'object') continue\n        const d = item as Record<string, unknown>\n        const value = typeof d.value === 'string' ? d.value : null\n        if (!value) continue\n        map[value] = {\n          value,\n          label: typeof d.label === 'string' && d.label.length ? d.label : value,\n          color: typeof d.color === 'string' && d.color.length ? d.color : null,\n          icon: typeof d.icon === 'string' && d.icon.length ? d.icon : null,\n        }\n      }\n    }\n    Promise.all(urls.map((url) => apiCall<{ items?: unknown[] }>(url)))\n      .then((responses) => {\n        for (const res of responses) {\n          if (res.ok && Array.isArray(res.result?.items)) merge(res.result.items)\n        }\n        setStatusMap(map)\n      })\n      .catch(() => {})\n  }, [])\n\n  React.useEffect(() => {\n    if (!isValidContext(context)) {\n      setLoading(false)\n      setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n    apiCall<{ items: TimelineEntry[] }>(\n      `/api/sales/document-history?kind=${context.kind}&id=${context.record.id}`\n    )\n      .then((res) => {\n        if (res.ok && Array.isArray(res.result?.items)) {\n          setEntries(res.result.items)\n        } else {\n          setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n        }\n      })\n      .catch(() => setError(t(\"sales.documents.history.error\", \"Failed to load history.\")))\n      .finally(() => setLoading(false))\n  }, [context, t])\n\n  const filtered = React.useMemo(\n    () => filter === 'all' ? entries : entries.filter(e => e.kind === filter),\n    [entries, filter]\n  )\n\n  return (\n    <div className=\"space-y-4\">\n      {/* Filter dropdown */}\n      <div>\n        <FilterDropdown filter={filter} onChange={setFilter} />\n      </div>\n\n      {/* Content */}\n      {loading ? (\n        <div className=\"flex items-center justify-center h-24\">\n          <Spinner />\n        </div>\n      ) : error ? (\n        <div className=\"text-destructive text-sm\">{error}</div>\n      ) : !filtered.length ? (\n        <div className=\"text-muted-foreground text-sm py-6 text-center\">\n          {t(\"sales.documents.history.empty\", \"No history entries yet.\")}\n        </div>\n      ) : (\n        <div className=\"relative\">\n          {filtered.map((entry, index) => (\n            <TimelineItem\n              key={entry.id}\n              entry={entry}\n              statusMap={statusMap}\n              isLast={index === filtered.length - 1}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport default DocumentHistoryWidget\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.7-develop.6756.1.5300c41145",
+  "version": "0.6.7-develop.6758.1.697eade236",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -254,16 +254,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6756.1.5300c41145",
-    "@open-mercato/shared": "0.6.7-develop.6756.1.5300c41145",
-    "@open-mercato/ui": "0.6.7-develop.6756.1.5300c41145",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6758.1.697eade236",
+    "@open-mercato/shared": "0.6.7-develop.6758.1.697eade236",
+    "@open-mercato/ui": "0.6.7-develop.6758.1.697eade236",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6756.1.5300c41145",
-    "@open-mercato/shared": "0.6.7-develop.6756.1.5300c41145",
-    "@open-mercato/ui": "0.6.7-develop.6756.1.5300c41145",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6758.1.697eade236",
+    "@open-mercato/shared": "0.6.7-develop.6758.1.697eade236",
+    "@open-mercato/ui": "0.6.7-develop.6758.1.697eade236",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

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) {

package/src/modules/sales/widgets/injection/document-history/widget.client.tsx

@@ -2,7 +2,7 @@
 
 import * as React from "react"
 import { Spinner } from "@open-mercato/ui/primitives/spinner"
-import { useT } from "@open-mercato/shared/lib/i18n/context"
+import { useT, type TranslateFn } from "@open-mercato/shared/lib/i18n/context"
 import { apiCall } from "@open-mercato/ui/backend/utils/apiCall"
 import { formatRelativeTime, formatDateTime } from "@open-mercato/shared/lib/time"
 import { cn } from "@open-mercato/shared/lib/utils"
@@ -21,6 +21,7 @@ export type TimelineEntry = {
     statusTo?: string | null
     documentKind?: "order" | "quote"
     commandId?: string
+    changedFields?: string[]
   }
 }
 
@@ -65,6 +66,49 @@ const KIND_BG_COLORS = {
   comment: 'bg-muted',
 }
 
+const CHANGED_FIELD_LABELS: Record<string, { key: string; fallback: string }> = {
+  productId: { key: 'sales.documents.history.fields.product', fallback: 'Product' },
+  productVariantId: { key: 'sales.documents.history.fields.variant', fallback: 'Variant' },
+  name: { key: 'sales.documents.history.fields.name', fallback: 'Name' },
+  description: { key: 'sales.documents.history.fields.description', fallback: 'Description' },
+  comment: { key: 'sales.documents.history.fields.comment', fallback: 'Comment' },
+  quantity: { key: 'sales.documents.history.fields.quantity', fallback: 'Quantity' },
+  quantityUnit: { key: 'sales.documents.history.fields.quantityUnit', fallback: 'Quantity unit' },
+  currencyCode: { key: 'sales.documents.history.fields.currency', fallback: 'Currency' },
+  unitPriceNet: { key: 'sales.documents.history.fields.unitPriceNet', fallback: 'Net unit price' },
+  unitPriceGross: { key: 'sales.documents.history.fields.unitPriceGross', fallback: 'Gross unit price' },
+  discountAmount: { key: 'sales.documents.history.fields.discountAmount', fallback: 'Discount amount' },
+  discountPercent: { key: 'sales.documents.history.fields.discountPercent', fallback: 'Discount percent' },
+  taxRate: { key: 'sales.documents.history.fields.taxRate', fallback: 'Tax class' },
+  configuration: { key: 'sales.documents.history.fields.configuration', fallback: 'Configuration' },
+  promotionCode: { key: 'sales.documents.history.fields.promotionCode', fallback: 'Promotion code' },
+  customFields: { key: 'sales.documents.history.fields.customFields', fallback: 'Custom fields' },
+  statusEntryId: { key: 'sales.documents.history.fields.status', fallback: 'Status' },
+}
+
+function normalizeChangedField(field: string): string {
+  const segment = field.split('.').pop() ?? field
+  return segment.replace(/_([a-z])/g, (_, letter: string) => letter.toUpperCase())
+}
+
+function humanizeChangedField(field: string): string {
+  const normalized = normalizeChangedField(field)
+  const spaced = normalized.replace(/([a-z0-9])([A-Z])/g, '$1 $2').trim()
+  return spaced.length > 0 ? `${spaced[0].toUpperCase()}${spaced.slice(1)}` : field
+}
+
+function translateChangedField(t: TranslateFn, field: string): string {
+  const normalized = normalizeChangedField(field)
+  const translation = CHANGED_FIELD_LABELS[normalized]
+  return translation ? t(translation.key, translation.fallback) : humanizeChangedField(field)
+}
+
+function translateAction(t: TranslateFn, entry: TimelineEntry): string {
+  const commandId = entry.metadata?.commandId
+  if (!commandId?.startsWith('sales.')) return entry.action
+  return t(`sales.audit.${commandId.slice('sales.'.length)}`, entry.action)
+}
+
 function StatusDot({ color, className }: { color: string | null | undefined; className?: string }) {
   if (!color) return <span className={cn('h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex', className)} />
   return (
@@ -118,11 +162,19 @@ function TimelineItem({
   statusMap: Record<string, StatusOption>
   isLast: boolean
 }) {
+  const t = useT()
   const KindIcon = KIND_ICONS[entry.kind]
   const relativeTime = formatRelativeTime(entry.occurredAt)
   const absoluteTime = formatDateTime(entry.occurredAt)
 
   const isStatusChange = entry.kind === 'status' && entry.metadata?.statusTo
+  const action = translateAction(t, entry)
+  const actorLabel = entry.actor.id
+    ? entry.actor.label
+    : t('sales.documents.history.actor.system', 'System')
+  const changedFieldLabels = Array.from(
+    new Set((entry.metadata?.changedFields ?? []).map((field) => translateChangedField(t, field))),
+  )
 
   return (
     <div data-testid="timeline-entry" className="relative flex gap-3">
@@ -148,7 +200,7 @@ function TimelineItem({
           <div className="flex items-center justify-between gap-2 flex-wrap">
             <span className="inline-flex items-center gap-1.5 text-xs font-medium text-foreground">
               <User className="h-3 w-3 text-muted-foreground" aria-hidden />
-              {entry.actor.label}
+              {actorLabel}
             </span>
             <span
               className="text-xs text-muted-foreground"
@@ -166,7 +218,16 @@ function TimelineItem({
               statusMap={statusMap}
             />
           ) : (
-            <div className="text-sm text-foreground">{entry.action}</div>
+            <div className="space-y-0.5">
+              <div className="text-sm text-foreground">{action}</div>
+              {entry.kind === 'action' && changedFieldLabels.length > 0 ? (
+                <div className="text-xs text-muted-foreground">
+                  {t('sales.documents.history.changedFields', 'Changed fields: {fields}', {
+                    fields: changedFieldLabels.join(', '),
+                  })}
+                </div>
+              ) : null}
+            </div>
           )}
         </div>
       </div>