@open-mercato/core 0.10.1-develop.7827.1.5c631908e4 → 0.10.1-develop.7836.1.0ef0f453c6

package/dist/modules/warranty_claims/search.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/warranty_claims/search.ts"],
-  "sourcesContent": ["import { SortDir, type QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport type {\n  SearchBuildContext,\n  SearchIndexSource,\n  SearchModuleConfig,\n  SearchResultLink,\n  SearchResultPresenter,\n} from '@open-mercato/shared/modules/search'\nimport { E } from '#generated/entities.ids.generated'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\n\nconst logger = createLogger('warranty_claims')\n\ntype SearchContext = SearchBuildContext & {\n  tenantId: string\n  queryEngine?: QueryEngine\n}\n\nfunction assertTenantContext(ctx: SearchBuildContext): asserts ctx is SearchContext {\n  if (typeof ctx.tenantId !== 'string' || ctx.tenantId.length === 0) {\n    throw new Error('[internal] [search.warranty_claims] Missing tenantId in search build context')\n  }\n}\n\nfunction readString(record: Record<string, unknown>, snakeKey: string, camelKey?: string): string | null {\n  const value = record[snakeKey] ?? (camelKey ? record[camelKey] : undefined)\n  if (typeof value !== 'string') return null\n  const trimmed = value.trim()\n  return trimmed.length ? trimmed : null\n}\n\nfunction appendLine(lines: string[], label: string, value: unknown): void {\n  if (typeof value !== 'string') return\n  const trimmed = value.trim()\n  if (!trimmed.length) return\n  lines.push(`${label}: ${trimmed}`)\n}\n\nfunction resolveClaimId(record: Record<string, unknown>): string | null {\n  return readString(record, 'id', 'id')\n}\n\nfunction resolvePresenter(record: Record<string, unknown>): SearchResultPresenter {\n  const claimNumber = readString(record, 'claim_number', 'claimNumber') ?? 'Warranty claim'\n  const customerName = readString(record, 'customer_name', 'customerName')\n  const claimType = readString(record, 'claim_type', 'claimType')\n  const status = readString(record, 'status', 'status')\n  const subtitle = [customerName, claimType].filter((value): value is string => Boolean(value)).join(' \u2014 ')\n  return {\n    title: claimNumber,\n    subtitle: subtitle || undefined,\n    icon: 'shield-check',\n    badge: status ?? undefined,\n  }\n}\n\nasync function loadClaimLineRows(ctx: SearchContext, claimId: string): Promise<Array<Record<string, unknown>>> {\n  if (!ctx.queryEngine) return []\n  try {\n    const rows: Array<Record<string, unknown>> = []\n    const pageSize = 100\n    for (let page = 1; ; page += 1) {\n      const result = await ctx.queryEngine.query<Record<string, unknown>>(E.warranty_claims.warranty_claim_line, {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId ?? undefined,\n        filters: { claim_id: { $eq: claimId } },\n        fields: [\n          'id',\n          'line_no',\n          'sku',\n          'product_name',\n          'serial_number',\n          'lot_number',\n          'fault_code',\n          'warranty_status',\n          'disposition',\n          'line_status',\n        ],\n        page: { page, pageSize },\n        sort: [\n          { field: 'line_no', dir: SortDir.Asc },\n          { field: 'id', dir: SortDir.Asc },\n        ],\n      })\n      rows.push(...result.items)\n      if (result.items.length < pageSize || rows.length >= result.total) break\n    }\n    return rows\n  } catch (err) {\n    logger.warn('[search.warranty_claims] Failed to load claim lines', {\n      claimId,\n      error: err instanceof Error ? err.message : err,\n    })\n    return []\n  }\n}\n\nfunction appendLineRows(lines: string[], lineRows: Array<Record<string, unknown>>): void {\n  for (const row of lineRows) {\n    appendLine(lines, 'Line SKU', readString(row, 'sku', 'sku') ?? '')\n    appendLine(lines, 'Line product', readString(row, 'product_name', 'productName') ?? '')\n    appendLine(lines, 'Serial number', readString(row, 'serial_number', 'serialNumber') ?? '')\n    appendLine(lines, 'Lot number', readString(row, 'lot_number', 'lotNumber') ?? '')\n    appendLine(lines, 'Fault code', readString(row, 'fault_code', 'faultCode') ?? '')\n    appendLine(lines, 'Warranty status', readString(row, 'warranty_status', 'warrantyStatus') ?? '')\n    appendLine(lines, 'Disposition', readString(row, 'disposition', 'disposition') ?? '')\n    appendLine(lines, 'Line status', readString(row, 'line_status', 'lineStatus') ?? '')\n  }\n}\n\nfunction buildClaimUrl(record: Record<string, unknown>): string | null {\n  const claimId = resolveClaimId(record)\n  return claimId ? `/backend/warranty_claims/${claimId}` : null\n}\n\nexport const searchConfig: SearchModuleConfig = {\n  entities: [\n    {\n      entityId: E.warranty_claims.warranty_claim,\n      enabled: true,\n      priority: 20,\n\n      buildSource: async (ctx: SearchBuildContext): Promise<SearchIndexSource | null> => {\n        assertTenantContext(ctx)\n        const record = ctx.record\n        const lines: string[] = []\n        appendLine(lines, 'Claim number', readString(record, 'claim_number', 'claimNumber') ?? '')\n        appendLine(lines, 'Customer', readString(record, 'customer_name', 'customerName') ?? '')\n        appendLine(lines, 'Order number', readString(record, 'order_number', 'orderNumber') ?? '')\n        appendLine(lines, 'Claim type', readString(record, 'claim_type', 'claimType') ?? '')\n        appendLine(lines, 'Status', readString(record, 'status', 'status') ?? '')\n        appendLine(lines, 'Vendor', readString(record, 'vendor_name', 'vendorName') ?? '')\n        appendLine(lines, 'Vendor reference', readString(record, 'vendor_ref', 'vendorRef') ?? '')\n\n        const claimId = resolveClaimId(record)\n        const lineRows = claimId ? await loadClaimLineRows(ctx, claimId) : []\n        appendLineRows(lines, lineRows)\n        if (!lines.length) return null\n\n        const presenter = resolvePresenter(record)\n        const url = buildClaimUrl(record)\n        const links: SearchResultLink[] = url ? [{ href: url, label: presenter.title, kind: 'primary' }] : []\n        return {\n          text: lines,\n          presenter,\n          links,\n          checksumSource: {\n            record,\n            customFields: ctx.customFields,\n            lineRows,\n          },\n        }\n      },\n\n      formatResult: (ctx: SearchBuildContext): SearchResultPresenter | null => {\n        assertTenantContext(ctx)\n        return resolvePresenter(ctx.record)\n      },\n\n      resolveUrl: (ctx: SearchBuildContext): string | null => buildClaimUrl(ctx.record),\n\n      resolveLinks: async (ctx: SearchBuildContext): Promise<SearchResultLink[] | null> => {\n        const url = buildClaimUrl(ctx.record)\n        if (!url) return null\n        const { t } = await resolveTranslations()\n        return [{ href: url, label: t('warranty_claims.search.openClaim', 'Open claim'), kind: 'secondary' }]\n      },\n\n      fieldPolicy: {\n        searchable: [\n          'claim_number',\n          'claim_type',\n          'status',\n          'priority',\n          'customer_name',\n          'vendor_name',\n          'vendor_ref',\n        ],\n        hashOnly: ['customer_id', 'order_id', 'sales_return_id', 'replacement_order_id', 'source_claim_id'],\n        excluded: [\n          'tenant_id',\n          'organization_id',\n          'assignee_user_id',\n          'deleted_at',\n          'notes',\n          'resolution_summary',\n          'contact_email',\n          'fault_description',\n          'inspection_notes',\n          'rejection_reason_code',\n        ],\n      },\n      aclFeatures: ['warranty_claims.claim.view'],\n    },\n  ],\n}\n\nexport default searchConfig\n"],
-  "mappings": "AAAA,SAAS,eAAiC;AAQ1C,SAAS,SAAS;AAClB,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AAEpC,MAAM,SAAS,aAAa,iBAAiB;AAO7C,SAAS,oBAAoB,KAAuD;AAClF,MAAI,OAAO,IAAI,aAAa,YAAY,IAAI,SAAS,WAAW,GAAG;AACjE,UAAM,IAAI,MAAM,8EAA8E;AAAA,EAChG;AACF;AAEA,SAAS,WAAW,QAAiC,UAAkB,UAAkC;AACvG,QAAM,QAAQ,OAAO,QAAQ,MAAM,WAAW,OAAO,QAAQ,IAAI;AACjE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,UAAU;AACpC;AAEA,SAAS,WAAW,OAAiB,OAAe,OAAsB;AACxE,MAAI,OAAO,UAAU,SAAU;AAC/B,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,QAAQ,OAAQ;AACrB,QAAM,KAAK,GAAG,KAAK,KAAK,OAAO,EAAE;AACnC;AAEA,SAAS,eAAe,QAAgD;AACtE,SAAO,WAAW,QAAQ,MAAM,IAAI;AACtC;AAEA,SAAS,iBAAiB,QAAwD;AAChF,QAAM,cAAc,WAAW,QAAQ,gBAAgB,aAAa,KAAK;AACzE,QAAM,eAAe,WAAW,QAAQ,iBAAiB,cAAc;AACvE,QAAM,YAAY,WAAW,QAAQ,cAAc,WAAW;AAC9D,QAAM,SAAS,WAAW,QAAQ,UAAU,QAAQ;AACpD,QAAM,WAAW,CAAC,cAAc,SAAS,EAAE,OAAO,CAAC,UAA2B,QAAQ,KAAK,CAAC,EAAE,KAAK,UAAK;AACxG,SAAO;AAAA,IACL,OAAO;AAAA,IACP,UAAU,YAAY;AAAA,IACtB,MAAM;AAAA,IACN,OAAO,UAAU;AAAA,EACnB;AACF;AAEA,eAAe,kBAAkB,KAAoB,SAA0D;AAC7G,MAAI,CAAC,IAAI,YAAa,QAAO,CAAC;AAC9B,MAAI;AACF,UAAM,OAAuC,CAAC;AAC9C,UAAM,WAAW;AACjB,aAAS,OAAO,KAAK,QAAQ,GAAG;AAC9B,YAAM,SAAS,MAAM,IAAI,YAAY,MAA+B,EAAE,gBAAgB,qBAAqB;AAAA,QACzG,UAAU,IAAI;AAAA,QACd,gBAAgB,IAAI,kBAAkB;AAAA,QACtC,SAAS,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE;AAAA,QACtC,QAAQ;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,MAAM,EAAE,MAAM,SAAS;AAAA,QACvB,MAAM;AAAA,UACJ,EAAE,OAAO,WAAW,KAAK,QAAQ,IAAI;AAAA,UACrC,EAAE,OAAO,MAAM,KAAK,QAAQ,IAAI;AAAA,QAClC;AAAA,MACF,CAAC;AACD,WAAK,KAAK,GAAG,OAAO,KAAK;AACzB,UAAI,OAAO,MAAM,SAAS,YAAY,KAAK,UAAU,OAAO,MAAO;AAAA,IACrE;AACA,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,WAAO,KAAK,uDAAuD;AAAA,MACjE;AAAA,MACA,OAAO,eAAe,QAAQ,IAAI,UAAU;AAAA,IAC9C,CAAC;AACD,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,eAAe,OAAiB,UAAgD;AACvF,aAAW,OAAO,UAAU;AAC1B,eAAW,OAAO,YAAY,WAAW,KAAK,OAAO,KAAK,KAAK,EAAE;AACjE,eAAW,OAAO,gBAAgB,WAAW,KAAK,gBAAgB,aAAa,KAAK,EAAE;AACtF,eAAW,OAAO,iBAAiB,WAAW,KAAK,iBAAiB,cAAc,KAAK,EAAE;AACzF,eAAW,OAAO,cAAc,WAAW,KAAK,cAAc,WAAW,KAAK,EAAE;AAChF,eAAW,OAAO,cAAc,WAAW,KAAK,cAAc,WAAW,KAAK,EAAE;AAChF,eAAW,OAAO,mBAAmB,WAAW,KAAK,mBAAmB,gBAAgB,KAAK,EAAE;AAC/F,eAAW,OAAO,eAAe,WAAW,KAAK,eAAe,aAAa,KAAK,EAAE;AACpF,eAAW,OAAO,eAAe,WAAW,KAAK,eAAe,YAAY,KAAK,EAAE;AAAA,EACrF;AACF;AAEA,SAAS,cAAc,QAAgD;AACrE,QAAM,UAAU,eAAe,MAAM;AACrC,SAAO,UAAU,4BAA4B,OAAO,KAAK;AAC3D;AAEO,MAAM,eAAmC;AAAA,EAC9C,UAAU;AAAA,IACR;AAAA,MACE,UAAU,EAAE,gBAAgB;AAAA,MAC5B,SAAS;AAAA,MACT,UAAU;AAAA,MAEV,aAAa,OAAO,QAA+D;AACjF,4BAAoB,GAAG;AACvB,cAAM,SAAS,IAAI;AACnB,cAAM,QAAkB,CAAC;AACzB,mBAAW,OAAO,gBAAgB,WAAW,QAAQ,gBAAgB,aAAa,KAAK,EAAE;AACzF,mBAAW,OAAO,YAAY,WAAW,QAAQ,iBAAiB,cAAc,KAAK,EAAE;AACvF,mBAAW,OAAO,gBAAgB,WAAW,QAAQ,gBAAgB,aAAa,KAAK,EAAE;AACzF,mBAAW,OAAO,cAAc,WAAW,QAAQ,cAAc,WAAW,KAAK,EAAE;AACnF,mBAAW,OAAO,UAAU,WAAW,QAAQ,UAAU,QAAQ,KAAK,EAAE;AACxE,mBAAW,OAAO,UAAU,WAAW,QAAQ,eAAe,YAAY,KAAK,EAAE;AACjF,mBAAW,OAAO,oBAAoB,WAAW,QAAQ,cAAc,WAAW,KAAK,EAAE;AAEzF,cAAM,UAAU,eAAe,MAAM;AACrC,cAAM,WAAW,UAAU,MAAM,kBAAkB,KAAK,OAAO,IAAI,CAAC;AACpE,uBAAe,OAAO,QAAQ;AAC9B,YAAI,CAAC,MAAM,OAAQ,QAAO;AAE1B,cAAM,YAAY,iBAAiB,MAAM;AACzC,cAAM,MAAM,cAAc,MAAM;AAChC,cAAM,QAA4B,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,UAAU,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC;AACpG,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA,gBAAgB;AAAA,YACd;AAAA,YACA,cAAc,IAAI;AAAA,YAClB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,MAEA,cAAc,CAAC,QAA0D;AACvE,4BAAoB,GAAG;AACvB,eAAO,iBAAiB,IAAI,MAAM;AAAA,MACpC;AAAA,MAEA,YAAY,CAAC,QAA2C,cAAc,IAAI,MAAM;AAAA,MAEhF,cAAc,OAAO,QAAgE;AACnF,cAAM,MAAM,cAAc,IAAI,MAAM;AACpC,YAAI,CAAC,IAAK,QAAO;AACjB,cAAM,EAAE,EAAE,IAAI,MAAM,oBAAoB;AACxC,eAAO,CAAC,EAAE,MAAM,KAAK,OAAO,EAAE,oCAAoC,YAAY,GAAG,MAAM,YAAY,CAAC;AAAA,MACtG;AAAA,MAEA,aAAa;AAAA,QACX,YAAY;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,UAAU,CAAC,eAAe,YAAY,mBAAmB,wBAAwB,iBAAiB;AAAA,QAClG,UAAU;AAAA,UACR;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,MACA,aAAa,CAAC,4BAA4B;AAAA,IAC5C;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;",
+  "sourcesContent": ["import { SortDir, type QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport type {\n  SearchBuildContext,\n  SearchIndexSource,\n  SearchModuleConfig,\n  SearchResultLink,\n  SearchResultPresenter,\n} from '@open-mercato/shared/modules/search'\nimport { E } from '#generated/entities.ids.generated'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\n\nconst logger = createLogger('warranty_claims')\n\ntype SearchContext = SearchBuildContext & {\n  tenantId: string\n  queryEngine?: QueryEngine\n}\n\nfunction assertTenantContext(ctx: SearchBuildContext): asserts ctx is SearchContext {\n  if (typeof ctx.tenantId !== 'string' || ctx.tenantId.length === 0) {\n    throw new Error('[internal] [search.warranty_claims] Missing tenantId in search build context')\n  }\n}\n\nfunction readString(record: Record<string, unknown>, snakeKey: string, camelKey?: string): string | null {\n  const value = record[snakeKey] ?? (camelKey ? record[camelKey] : undefined)\n  if (typeof value !== 'string') return null\n  const trimmed = value.trim()\n  return trimmed.length ? trimmed : null\n}\n\nfunction appendLine(lines: string[], label: string, value: unknown): void {\n  if (typeof value !== 'string') return\n  const trimmed = value.trim()\n  if (!trimmed.length) return\n  lines.push(`${label}: ${trimmed}`)\n}\n\nfunction resolveClaimId(record: Record<string, unknown>): string | null {\n  return readString(record, 'id', 'id')\n}\n\nasync function resolvePresenter(record: Record<string, unknown>): Promise<SearchResultPresenter> {\n  const { t } = await resolveTranslations()\n  const claimNumber = readString(record, 'claim_number', 'claimNumber') ?? 'Warranty claim'\n  const customerName = readString(record, 'customer_name', 'customerName')\n  const claimType = readString(record, 'claim_type', 'claimType')\n  const status = readString(record, 'status', 'status')\n  const statusLabel = status ? t(`warranty_claims.status.${status}`, status) : null\n  const subtitle = [customerName, claimType, statusLabel]\n    .filter((value): value is string => Boolean(value))\n    .join(' \u2014 ')\n  return {\n    title: claimNumber,\n    subtitle: subtitle || undefined,\n    icon: 'shield-check',\n  }\n}\n\nasync function loadClaimLineRows(ctx: SearchContext, claimId: string): Promise<Array<Record<string, unknown>>> {\n  if (!ctx.queryEngine) return []\n  try {\n    const rows: Array<Record<string, unknown>> = []\n    const pageSize = 100\n    for (let page = 1; ; page += 1) {\n      const result = await ctx.queryEngine.query<Record<string, unknown>>(E.warranty_claims.warranty_claim_line, {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId ?? undefined,\n        filters: { claim_id: { $eq: claimId } },\n        fields: [\n          'id',\n          'line_no',\n          'sku',\n          'product_name',\n          'serial_number',\n          'lot_number',\n          'fault_code',\n          'warranty_status',\n          'disposition',\n          'line_status',\n        ],\n        page: { page, pageSize },\n        sort: [\n          { field: 'line_no', dir: SortDir.Asc },\n          { field: 'id', dir: SortDir.Asc },\n        ],\n      })\n      rows.push(...result.items)\n      if (result.items.length < pageSize || rows.length >= result.total) break\n    }\n    return rows\n  } catch (err) {\n    logger.warn('[search.warranty_claims] Failed to load claim lines', {\n      claimId,\n      error: err instanceof Error ? err.message : err,\n    })\n    return []\n  }\n}\n\nfunction appendLineRows(lines: string[], lineRows: Array<Record<string, unknown>>): void {\n  for (const row of lineRows) {\n    appendLine(lines, 'Line SKU', readString(row, 'sku', 'sku') ?? '')\n    appendLine(lines, 'Line product', readString(row, 'product_name', 'productName') ?? '')\n    appendLine(lines, 'Serial number', readString(row, 'serial_number', 'serialNumber') ?? '')\n    appendLine(lines, 'Lot number', readString(row, 'lot_number', 'lotNumber') ?? '')\n    appendLine(lines, 'Fault code', readString(row, 'fault_code', 'faultCode') ?? '')\n    appendLine(lines, 'Warranty status', readString(row, 'warranty_status', 'warrantyStatus') ?? '')\n    appendLine(lines, 'Disposition', readString(row, 'disposition', 'disposition') ?? '')\n    appendLine(lines, 'Line status', readString(row, 'line_status', 'lineStatus') ?? '')\n  }\n}\n\nfunction buildClaimUrl(record: Record<string, unknown>): string | null {\n  const claimId = resolveClaimId(record)\n  return claimId ? `/backend/warranty_claims/${claimId}` : null\n}\n\nexport const searchConfig: SearchModuleConfig = {\n  entities: [\n    {\n      entityId: E.warranty_claims.warranty_claim,\n      enabled: true,\n      priority: 20,\n\n      buildSource: async (ctx: SearchBuildContext): Promise<SearchIndexSource | null> => {\n        assertTenantContext(ctx)\n        const record = ctx.record\n        const lines: string[] = []\n        appendLine(lines, 'Claim number', readString(record, 'claim_number', 'claimNumber') ?? '')\n        appendLine(lines, 'Customer', readString(record, 'customer_name', 'customerName') ?? '')\n        appendLine(lines, 'Order number', readString(record, 'order_number', 'orderNumber') ?? '')\n        appendLine(lines, 'Claim type', readString(record, 'claim_type', 'claimType') ?? '')\n        appendLine(lines, 'Status', readString(record, 'status', 'status') ?? '')\n        appendLine(lines, 'Vendor', readString(record, 'vendor_name', 'vendorName') ?? '')\n        appendLine(lines, 'Vendor reference', readString(record, 'vendor_ref', 'vendorRef') ?? '')\n\n        const claimId = resolveClaimId(record)\n        const lineRows = claimId ? await loadClaimLineRows(ctx, claimId) : []\n        appendLineRows(lines, lineRows)\n        if (!lines.length) return null\n\n        const presenter = await resolvePresenter(record)\n        const url = buildClaimUrl(record)\n        const links: SearchResultLink[] = url ? [{ href: url, label: presenter.title, kind: 'primary' }] : []\n        return {\n          text: lines,\n          presenter,\n          links,\n          checksumSource: {\n            record,\n            customFields: ctx.customFields,\n            lineRows,\n          },\n        }\n      },\n\n      formatResult: async (ctx: SearchBuildContext): Promise<SearchResultPresenter | null> => {\n        assertTenantContext(ctx)\n        return resolvePresenter(ctx.record)\n      },\n\n      resolveUrl: (ctx: SearchBuildContext): string | null => buildClaimUrl(ctx.record),\n\n      resolveLinks: async (ctx: SearchBuildContext): Promise<SearchResultLink[] | null> => {\n        const url = buildClaimUrl(ctx.record)\n        if (!url) return null\n        const { t } = await resolveTranslations()\n        return [{ href: url, label: t('warranty_claims.search.openClaim', 'Open claim'), kind: 'secondary' }]\n      },\n\n      fieldPolicy: {\n        searchable: [\n          'claim_number',\n          'claim_type',\n          'status',\n          'priority',\n          'customer_name',\n          'vendor_name',\n          'vendor_ref',\n        ],\n        hashOnly: ['customer_id', 'order_id', 'sales_return_id', 'replacement_order_id', 'source_claim_id'],\n        excluded: [\n          'tenant_id',\n          'organization_id',\n          'assignee_user_id',\n          'deleted_at',\n          'notes',\n          'resolution_summary',\n          'contact_email',\n          'fault_description',\n          'inspection_notes',\n          'rejection_reason_code',\n        ],\n      },\n      aclFeatures: ['warranty_claims.claim.view'],\n    },\n  ],\n}\n\nexport default searchConfig\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.10.1-develop.7827.1.5c631908e4",
+  "version": "0.10.1-develop.7836.1.0ef0f453c6",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -266,16 +266,16 @@
     "zod": "^4.6.6"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.10.1-develop.7827.1.5c631908e4",
-    "@open-mercato/shared": "0.10.1-develop.7827.1.5c631908e4",
-    "@open-mercato/ui": "0.10.1-develop.7827.1.5c631908e4",
+    "@open-mercato/ai-assistant": "0.10.1-develop.7836.1.0ef0f453c6",
+    "@open-mercato/shared": "0.10.1-develop.7836.1.0ef0f453c6",
+    "@open-mercato/ui": "0.10.1-develop.7836.1.0ef0f453c6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.10.1-develop.7827.1.5c631908e4",
-    "@open-mercato/shared": "0.10.1-develop.7827.1.5c631908e4",
-    "@open-mercato/ui": "0.10.1-develop.7827.1.5c631908e4",
+    "@open-mercato/ai-assistant": "0.10.1-develop.7836.1.0ef0f453c6",
+    "@open-mercato/shared": "0.10.1-develop.7836.1.0ef0f453c6",
+    "@open-mercato/ui": "0.10.1-develop.7836.1.0ef0f453c6",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",

package/src/helpers/integration/appRuntime.ts

@@ -0,0 +1,26 @@
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+/**
+ * Imports a package module from the same copy the app under test runs on.
+ *
+ * A spec that bootstraps the app in-process (`bootstrapFromAppRoot`) and then calls into its
+ * runtime — the command bus, `withAtomicFlush`, transaction lifetime — must load every one of those
+ * modules from a single copy. Against a standalone app (`OM_TEST_APP_ROOT`) the app's generated
+ * registries import `node_modules/@open-mercato/*` inside the app, while the spec's own static
+ * imports resolve to the monorepo's packages, so module-local state such as the command registry
+ * splits in two: handlers register in one copy and the bus resolves them in the other.
+ *
+ * Without `OM_TEST_APP_ROOT` this is a plain dynamic import, so the monorepo lane is unchanged.
+ */
+export async function importFromAppRuntime<TModule>(specifier: string): Promise<TModule> {
+  const resolvedPath = resolveAppRuntimeModulePath(specifier)
+  return (await import(resolvedPath ? pathToFileURL(resolvedPath).href : specifier)) as TModule
+}
+
+export function resolveAppRuntimeModulePath(specifier: string, appRoot = process.env.OM_TEST_APP_ROOT): string | null {
+  const standaloneRoot = appRoot?.trim()
+  if (!standaloneRoot) return null
+  return createRequire(path.join(path.resolve(standaloneRoot), 'package.json')).resolve(specifier)
+}

package/src/modules/cart/api/current/lines/bulk/route.ts

@@ -184,7 +184,7 @@ export const openApi: OpenApiRouteDoc = {
         { status: 409, description: 'Optimistic-lock conflict' },
         { status: 422, description: 'Idempotency key mismatch' },
         { status: 429, description: 'Rate limited' },
-        { status: 503, description: 'No store context resolvable for this request (§6a.1a)' },
+        { status: 503, description: 'No store context resolvable, or cart_busy after 15 seconds waiting for the line lock. The requested line add/bulk-add phases did not run; earlier activity/context/repricing may have persisted. Retry the same request after Retry-After: 1 second, preserving Idempotency-Key.' },
       ],
     },
   },

package/src/modules/cart/api/current/lines/route.ts

@@ -201,7 +201,7 @@ export const openApi: OpenApiRouteDoc = {
         { status: 409, description: 'Optimistic-lock conflict, or the cart is a `proposal` cart' },
         { status: 422, description: 'Quantity rule violation, idempotency key mismatch, or an unpriceable product' },
         { status: 429, description: 'Rate limited' },
-        { status: 503, description: 'No store context resolvable for this request (§6a.1a)' },
+        { status: 503, description: 'No store context resolvable, or cart_busy after 15 seconds waiting for the line lock. The requested line add/bulk-add phases did not run; earlier activity/context/repricing may have persisted. Retry the same request after Retry-After: 1 second, preserving Idempotency-Key.' },
       ],
     },
   },

package/src/modules/cart/commands/lines.ts

@@ -57,6 +57,7 @@ import {
 } from '../lib/visibility'
 import type { CartVisibilityLineRef, ResolvedAssortmentScope } from '../lib/visibility'
 import { shouldEnforceAssortmentScope } from '../lib/routeContext'
+import { withCartLineMutationLock } from '../lib/lineMutationLock'
 import type { ResolvedCartRouteContext } from '../lib/routeContext'
 import { buildRecomputeCartTotalsPhase } from '../lib/reprice'
 import type { CartPriceChange } from '../lib/reprice'
@@ -938,10 +939,7 @@ const addLineCommand: CommandHandler<CartLinesAddInput, CartLinesAddOutcome> = {
     // `cart.lines.add`/`.bulkAdd` call against this cart instead, closing the race
     // `TC-CART-CONC-05` reproduced (a silently lost update, and a raw 500 off
     // `cart_lines_unique_line_key`).
-    await withAtomicFlush(em, [
-      async () => {
-        await em.execute('select pg_advisory_xact_lock(hashtextextended(?::text, 0))', [`cart:lines:${cart.id}`])
-      },
+    await withCartLineMutationLock(em, cart.id, [
       async () => {
         const existing = await findExistingCustomerLine(em, scope, cart.id, input.productId, variantId, input.configuration ?? null)
         const pricingContext = buildCartPricingRowFilterContext(cart)
@@ -1049,7 +1047,7 @@ const addLineCommand: CommandHandler<CartLinesAddInput, CartLinesAddOutcome> = {
         if (!shouldRecompute()) return
         await phase()
       }),
-    ], { transaction: true, label: 'cart.lines.add' })
+    ], 'cart.lines.add')
 
     if (!outcome) throw new Error('[internal] cart.lines.add produced no outcome')
     // Captured into plain `const`s (never reassigned themselves) rather than read directly
@@ -1641,10 +1639,7 @@ const bulkAddLinesCommand: CommandHandler<CartLinesBulkAddInput, CartLinesBulkAd
     // decision is read-decide-write against rows that may not exist yet, so two concurrent
     // `bulkAdd`/`add` calls on this cart must serialize, not just this call's own entries
     // against each other.
-    await withAtomicFlush(em, [
-      async () => {
-        await em.execute('select pg_advisory_xact_lock(hashtextextended(?::text, 0))', [`cart:lines:${cart.id}`])
-      },
+    await withCartLineMutationLock(em, cart.id, [
       ...phases,
       ...buildCartPromotionsAndTotalsPhases({
         em,
@@ -1657,7 +1652,7 @@ const bulkAddLinesCommand: CommandHandler<CartLinesBulkAddInput, CartLinesBulkAd
         removedGiftLines,
         promotionWarnings,
       }),
-    ], { transaction: true, label: 'cart.lines.bulkAdd' })
+    ], 'cart.lines.bulkAdd')
     await emitVisibilityRejectedEvent(cart, visibilityRejectedCount, 'lines.bulkAdd')
 
     const dataEngine = ctx.container.resolve('dataEngine') as DataEngine

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

@@ -4,6 +4,7 @@
   "cart.audit.lines.bulkAdd": "Add cart lines (bulk)",
   "cart.audit.lines.remove": "Remove cart line",
   "cart.audit.merge": "Merge cart",
+  "cart.errors.busy": "Der Warenkorb ist ausgelastet. Bitte versuche es erneut.",
   "cart.errors.store_context_unavailable": "Cart is unavailable for this store right now",
   "cart.errors.unexpected": "Unexpected error",
   "cart.warnings.code_no_longer_valid": "A previously applied code is no longer valid",

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

@@ -4,6 +4,7 @@
   "cart.audit.lines.bulkAdd": "Add cart lines (bulk)",
   "cart.audit.lines.remove": "Remove cart line",
   "cart.audit.merge": "Merge cart",
+  "cart.errors.busy": "Cart is busy. Please try again.",
   "cart.errors.store_context_unavailable": "Cart is unavailable for this store right now",
   "cart.errors.unexpected": "Unexpected error",
   "cart.warnings.code_no_longer_valid": "A previously applied code is no longer valid",

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

@@ -4,6 +4,7 @@
   "cart.audit.lines.bulkAdd": "Add cart lines (bulk)",
   "cart.audit.lines.remove": "Remove cart line",
   "cart.audit.merge": "Merge cart",
+  "cart.errors.busy": "El carrito está ocupado. Inténtalo de nuevo.",
   "cart.errors.store_context_unavailable": "Cart is unavailable for this store right now",
   "cart.errors.unexpected": "Unexpected error",
   "cart.warnings.code_no_longer_valid": "A previously applied code is no longer valid",

package/src/modules/cart/i18n/ko.json

@@ -4,6 +4,7 @@
   "cart.audit.lines.bulkAdd": "Add cart lines (bulk)",
   "cart.audit.lines.remove": "Remove cart line",
   "cart.audit.merge": "Merge cart",
+  "cart.errors.busy": "장바구니가 사용 중입니다. 다시 시도해 주세요.",
   "cart.errors.store_context_unavailable": "Cart is unavailable for this store right now",
   "cart.errors.unexpected": "Unexpected error",
   "cart.warnings.code_no_longer_valid": "A previously applied code is no longer valid",

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

@@ -4,6 +4,7 @@
   "cart.audit.lines.bulkAdd": "Add cart lines (bulk)",
   "cart.audit.lines.remove": "Remove cart line",
   "cart.audit.merge": "Merge cart",
+  "cart.errors.busy": "Koszyk jest zajęty. Spróbuj ponownie.",
   "cart.errors.store_context_unavailable": "Cart is unavailable for this store right now",
   "cart.errors.unexpected": "Unexpected error",
   "cart.warnings.code_no_longer_valid": "A previously applied code is no longer valid",

package/src/modules/cart/lib/currentCartRoute.ts

@@ -10,6 +10,7 @@ import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'
 import { getCartCommand } from '../commands/cart'
 import type { CartGetByTokenInput, CartSummary } from '../commands/cart'
 import type { CartPriceChange } from './reprice'
+import { isCartLineMutationLockTimeoutError } from './lineMutationLock'
 import { isCartStoreContextUnavailableError, resolveCartRouteContext } from './routeContext'
 import type { ResolveCartRouteContextOptions, ResolvedCartRouteContext } from './routeContext'
 
@@ -173,6 +174,13 @@ const logger = createLogger('cart').child({ component: 'api' })
  * unexpected 500, logged and reported.
  */
 export async function mapRouteErrorToResponse(error: unknown): Promise<NextResponse> {
+  if (isCartLineMutationLockTimeoutError(error)) {
+    const { translate } = await resolveTranslations()
+    return NextResponse.json(
+      { error: translate('cart.errors.busy', 'Cart is busy. Please try again.'), code: 'cart_busy' },
+      { status: 503, headers: { 'Retry-After': '1', 'Cache-Control': 'no-store' } },
+    )
+  }
   if (isCrudHttpError(error)) return NextResponse.json(error.body, { status: error.status })
   const interceptorRejection = getCommandInterceptorHttpRejection(error)
   if (interceptorRejection) return NextResponse.json(interceptorRejection.body, { status: interceptorRejection.status })

package/src/modules/cart/lib/lineMutationLock.ts

@@ -0,0 +1,59 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'
+import { calculateBackoffDelayMs } from '@open-mercato/shared/lib/delivery/retry'
+
+const CART_LINE_LOCK_TIMEOUT = Symbol.for('@open-mercato/cart:LineMutationLockTimeout')
+
+export class CartLineMutationLockTimeoutError extends Error {
+  readonly [CART_LINE_LOCK_TIMEOUT] = true
+
+  constructor() {
+    super('[internal] Cart line mutation lock wait deadline exceeded')
+    this.name = 'CartLineMutationLockTimeoutError'
+  }
+}
+
+export function isCartLineMutationLockTimeoutError(error: unknown): error is CartLineMutationLockTimeoutError {
+  return typeof error === 'object' && error !== null && Reflect.get(error, CART_LINE_LOCK_TIMEOUT) === true
+}
+
+export async function withCartLineMutationLock(
+  em: EntityManager,
+  cartId: string,
+  phases: Array<() => void | Promise<void>>,
+  label: string,
+  waitDeadlineMs = 15_000,
+): Promise<void> {
+  const key = `cart:lines:${cartId}`
+  const deadline = Date.now() + waitDeadlineMs
+  const busy = new Error('[internal] Cart line mutation lock is busy')
+  const joinsTransaction = em.isInTransaction()
+
+  for (let attempt = 1; ; attempt += 1) {
+    try {
+      await withAtomicFlush(em, [
+        async () => {
+          if (joinsTransaction) {
+            await em.execute('select pg_advisory_xact_lock(hashtextextended(?::text, 0))', [key])
+            return
+          }
+          const rows = await em.execute<Array<{ locked: boolean }>>(
+            'select pg_try_advisory_xact_lock(hashtextextended(?::text, 0)) as locked',
+            [key],
+          )
+          if (!rows[0]?.locked) throw busy
+        },
+        ...phases,
+      ], { transaction: true, label })
+      return
+    } catch (error) {
+      if (error !== busy || em.isInTransaction()) throw error
+    }
+
+    const remainingMs = deadline - Date.now()
+    if (remainingMs <= 0) throw new CartLineMutationLockTimeoutError()
+    const delayMs = calculateBackoffDelayMs(Math.min(attempt, 5), { baseDelayMs: 50, maxJitterMs: 25 })
+    await new Promise((resolve) => setTimeout(resolve, Math.min(delayMs, remainingMs)))
+    if (Date.now() >= deadline) throw new CartLineMutationLockTimeoutError()
+  }
+}

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

@@ -646,8 +646,9 @@ const documentUpdateFieldsSchema = z
     currencyCode: currencyCodeSchema.optional(),
     // Order-only columns — SalesQuote declares none of them. Declared here
     // because the create schema declares them and a caller reusing its create
-    // payload on an update otherwise lost them silently; `applyDocumentUpdate`
-    // rejects each with a 400 on a quote rather than dropping it.
+    // payload on an update otherwise lost them silently. `applyDocumentUpdate`
+    // rejects them on a quote, except `totalsMode`, which is ignored to preserve
+    // quote-create compatibility without enabling external quote amounts.
     exchangeRate: z.union([z.null(), exchangeRateSchema]).optional(),
     paymentStatusEntryId: z.string().uuid().nullable().optional(),
     fulfillmentStatusEntryId: z.string().uuid().nullable().optional(),
@@ -5894,7 +5895,6 @@ const updateQuoteCommand: CommandHandler<
   },
   async execute(rawInput, ctx) {
     const parsed = documentUpdateSchema.parse(rawInput ?? {});
-    await assertAmountsModeUnsupportedOnQuote([parsed]);
     documentEditSchema.parse(rawInput ?? {});
     const em = (ctx.container.resolve("em") as EntityManager).fork();
     let quote!: SalesQuote;

package/src/modules/sales/components/documents/ItemsSection.tsx

@@ -7,7 +7,8 @@ import { buildOptimisticLockHeader } from "@open-mercato/ui/backend/utils/optimi
 import { deleteCrud } from "@open-mercato/ui/backend/utils/crud";
 import { normalizeCrudServerError } from "@open-mercato/ui/backend/utils/serverErrors";
 import { ErrorMessage, LoadingMessage, TabEmptyState } from "@open-mercato/ui/backend/detail";
-import { Button } from "@open-mercato/ui/primitives/button";
+import { IconButton } from "@open-mercato/ui/primitives/icon-button";
+import { SimpleTooltip } from "@open-mercato/ui/primitives/tooltip";
 import { flash } from "@open-mercato/ui/backend/FlashMessages";
 import { Pencil, Trash2 } from "lucide-react";
 import {
@@ -41,6 +42,53 @@ import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('sales')
 
+function DisabledActionHint({
+  label,
+  reason,
+  children,
+}: {
+  label: string
+  reason?: string
+  children: React.ReactNode
+}) {
+  const [open, setOpen] = React.useState(false)
+  const touchOpenRef = React.useRef(false)
+  if (!reason) return <>{children}</>
+  return (
+    <SimpleTooltip
+      content={reason}
+      open={open}
+      onOpenChange={(nextOpen) => {
+        if (nextOpen || !touchOpenRef.current) setOpen(nextOpen)
+      }}
+    >
+      <span
+        className="inline-flex rounded-md focus-visible:outline-none focus-visible:shadow-focus"
+        tabIndex={0}
+        aria-label={`${label}: ${reason}`}
+        onClick={(event) => event.stopPropagation()}
+        onPointerDown={(event) => {
+          if (event.pointerType !== 'touch') return
+          touchOpenRef.current = true
+          setOpen(true)
+          event.currentTarget.focus()
+        }}
+        onBlur={() => {
+          touchOpenRef.current = false
+          setOpen(false)
+        }}
+        onKeyDown={(event) => {
+          if (event.key !== 'Escape') return
+          touchOpenRef.current = false
+          setOpen(false)
+        }}
+      >
+        {children}
+      </span>
+    </SimpleTooltip>
+  )
+}
+
 type ResolvedUnitPriceReference = {
   grossPerReference: number;
   referenceUnitCode: string;
@@ -932,11 +980,13 @@ export function SalesDocumentItemsSection({
                             {discount.amount !== null ? (
                               <span className="font-mono text-sm">
                                 {t(
-                                  "sales.documents.items.table.discountAmount",
-                                  "−{{value}}",
+                                  discount.amount < 0
+                                    ? "sales.documents.items.table.markupAmount"
+                                    : "sales.documents.items.table.discountAmount",
+                                  discount.amount < 0 ? "+{{value}}" : "−{{value}}",
                                   {
                                     value: formatMoney(
-                                      discount.amount,
+                                      Math.abs(discount.amount),
                                       item.currencyCode ??
                                         currencyCode ??
                                         undefined,
@@ -1005,30 +1055,39 @@ export function SalesDocumentItemsSection({
                     })}
                     <td className="px-3 py-3">
                       <div className="flex items-center gap-2 justify-end">
-                        <Button
-                          size="icon"
-                          variant="ghost"
-                          className="h-8 w-8"
-                          aria-label={t('ui.actions.edit', 'Edit')}
-                          disabled={amountsReadOnly}
-                          onClick={(event) => {
-                            event.stopPropagation();
-                            handleEdit(item);
-                          }}
+                        <DisabledActionHint
+                          label={t('ui.actions.edit', 'Edit')}
+                          reason={amountsReadOnly
+                            ? t('sales.documents.amountsExternalHint', 'Totals on this document come from an external system and are stored as supplied.')
+                            : undefined}
                         >
-                          <Pencil className="h-4 w-4" />
-                        </Button>
-                        <span
-                          title={amountsReadOnly
+                          <IconButton
+                            type="button"
+                            size="default"
+                            variant="ghost"
+                            aria-label={t('ui.actions.edit', 'Edit')}
+                            disabled={amountsReadOnly}
+                            onClick={(event) => {
+                              event.stopPropagation();
+                              handleEdit(item);
+                            }}
+                          >
+                            <Pencil className="h-4 w-4" />
+                          </IconButton>
+                        </DisabledActionHint>
+                        <DisabledActionHint
+                          label={t('ui.actions.delete', 'Delete')}
+                          reason={amountsReadOnly
                             ? t('sales.documents.amountsExternalHint', 'Totals on this document come from an external system and are stored as supplied.')
                             : kind === 'order' && items.length === 1
                               ? t('sales.documents.items.errorDeleteLast', 'An order must contain at least one line item.')
                               : undefined}
                         >
-                          <Button
-                            size="icon"
+                          <IconButton
+                            type="button"
+                            size="default"
                             variant="ghost"
-                            className="h-8 w-8 text-destructive"
+                            className="text-destructive"
                             aria-label={t('ui.actions.delete', 'Delete')}
                             disabled={amountsReadOnly || (kind === 'order' && items.length === 1)}
                             onClick={(event) => {
@@ -1037,8 +1096,8 @@ export function SalesDocumentItemsSection({
                             }}
                           >
                             <Trash2 className="h-4 w-4" />
-                          </Button>
-                        </span>
+                          </IconButton>
+                        </DisabledActionHint>
                       </div>
                     </td>
                   </tr>

package/src/modules/sales/components/documents/lineItemUtils.ts

@@ -73,10 +73,10 @@ export function resolveLineDiscountDisplay(
 ): LineDiscountDisplay | null {
   const amount = normalizeNumber(line.discountAmount, 0)
   const percent = normalizeNumber(line.discountPercent, 0)
-  if (amount > 0) {
+  if (amount !== 0) {
     return {
       amount,
-      percent: percentAccountsForAmount(line, percent, amount) ? percent : null,
+      percent: amount > 0 && percentAccountsForAmount(line, percent, amount) ? percent : null,
     }
   }
   if (percent > 0) return { amount: null, percent }

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

@@ -1091,6 +1091,7 @@
   "sales.documents.items.table.discountAmount": "−{{value}}",
   "sales.documents.items.table.discountPercent": "{{value}} %",
   "sales.documents.items.table.gross": "brutto",
+  "sales.documents.items.table.markupAmount": "+{{value}}",
   "sales.documents.items.table.net": "netto",
   "sales.documents.items.table.product": "Produkt",
   "sales.documents.items.table.quantity": "Menge",

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

@@ -1091,6 +1091,7 @@
   "sales.documents.items.table.discountAmount": "−{{value}}",
   "sales.documents.items.table.discountPercent": "{{value}}%",
   "sales.documents.items.table.gross": "gross",
+  "sales.documents.items.table.markupAmount": "+{{value}}",
   "sales.documents.items.table.net": "net",
   "sales.documents.items.table.product": "Product",
   "sales.documents.items.table.quantity": "Qty",

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

@@ -1091,6 +1091,7 @@
   "sales.documents.items.table.discountAmount": "−{{value}}",
   "sales.documents.items.table.discountPercent": "{{value}} %",
   "sales.documents.items.table.gross": "bruto",
+  "sales.documents.items.table.markupAmount": "+{{value}}",
   "sales.documents.items.table.net": "neto",
   "sales.documents.items.table.product": "Producto",
   "sales.documents.items.table.quantity": "Cant.",

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

@@ -1091,6 +1091,7 @@
   "sales.documents.items.table.discountAmount": "−{{value}}",
   "sales.documents.items.table.discountPercent": "{{value}}%",
   "sales.documents.items.table.gross": "세금 포함",
+  "sales.documents.items.table.markupAmount": "+{{value}}",
   "sales.documents.items.table.net": "세금 제외",
   "sales.documents.items.table.product": "상품",
   "sales.documents.items.table.quantity": "수량",

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

@@ -1091,6 +1091,7 @@
   "sales.documents.items.table.discountAmount": "−{{value}}",
   "sales.documents.items.table.discountPercent": "{{value}}%",
   "sales.documents.items.table.gross": "brutto",
+  "sales.documents.items.table.markupAmount": "+{{value}}",
   "sales.documents.items.table.net": "netto",
   "sales.documents.items.table.product": "Produkt",
   "sales.documents.items.table.quantity": "Ilość",

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

@@ -1,5 +1,6 @@
 {
   "notifications.categories.warranty_claims": "Garantieclaims",
+  "search.entityType.warranty_claims.warranty_claim": "Garantieclaim",
   "warranty_claims.ai.apply": "Anwenden",
   "warranty_claims.ai.assess.attachment": "Anhang",
   "warranty_claims.ai.assess.attachmentsError": "Positionsanhänge konnten nicht geladen werden.",

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

@@ -1,5 +1,6 @@
 {
   "notifications.categories.warranty_claims": "Warranty claims",
+  "search.entityType.warranty_claims.warranty_claim": "Warranty Claim",
   "warranty_claims.ai.apply": "Apply",
   "warranty_claims.ai.assess.attachment": "Attachment",
   "warranty_claims.ai.assess.attachmentsError": "Failed to load line attachments.",

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

@@ -1,5 +1,6 @@
 {
   "notifications.categories.warranty_claims": "Reclamos de garantía",
+  "search.entityType.warranty_claims.warranty_claim": "Reclamo de garantía",
   "warranty_claims.ai.apply": "Aplicar",
   "warranty_claims.ai.assess.attachment": "Adjunto",
   "warranty_claims.ai.assess.attachmentsError": "No se pudieron cargar los adjuntos de la línea.",

package/src/modules/warranty_claims/i18n/ko.json

@@ -1,5 +1,6 @@
 {
   "notifications.categories.warranty_claims": "보증 클레임",
+  "search.entityType.warranty_claims.warranty_claim": "보증 클레임",
   "warranty_claims.ai.apply": "적용",
   "warranty_claims.ai.assess.attachment": "첨부파일",
   "warranty_claims.ai.assess.attachmentsError": "라인 첨부파일을 불러오지 못했습니다.",

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

@@ -1,5 +1,6 @@
 {
   "notifications.categories.warranty_claims": "Reklamacje gwarancyjne",
+  "search.entityType.warranty_claims.warranty_claim": "Reklamacja gwarancyjna",
   "warranty_claims.ai.apply": "Zastosuj",
   "warranty_claims.ai.assess.attachment": "Załącznik",
   "warranty_claims.ai.assess.attachmentsError": "Nie udało się załadować załączników pozycji.",