@open-mercato/core 0.6.8-develop.6998.1.d2bc46c56c → 0.6.8-develop.7001.1.03608ab252

package/src/modules/warranty_claims/backend/components/WarrantyWorkspace.tsx

@@ -0,0 +1,66 @@
+"use client"
+
+import * as React from 'react'
+import { Tabs, TabsList, TabsTrigger } from '@open-mercato/ui/primitives/tabs'
+
+export type WarrantyWorkspaceTab = {
+  id: string
+  label: string
+  count?: number
+  disabled?: boolean
+}
+
+type WarrantyWorkspaceProps = {
+  title: string
+  description?: string
+  action?: React.ReactNode
+  tabs?: WarrantyWorkspaceTab[]
+  activeTab?: string
+  onTabChange?: (value: string) => void
+  summary?: React.ReactNode
+  contentClassName?: string
+  children: React.ReactNode
+}
+
+export function WarrantyWorkspace({
+  title,
+  description,
+  action,
+  tabs,
+  activeTab,
+  onTabChange,
+  summary,
+  contentClassName,
+  children,
+}: WarrantyWorkspaceProps) {
+  return (
+    <section className="overflow-hidden rounded-xl border border-border bg-card">
+      <div className="flex flex-col gap-4 px-8 pb-6 pt-7 sm:flex-row sm:items-center sm:justify-between">
+        <div className="min-w-0">
+          <h1 className="text-2xl font-bold tracking-tight text-foreground">{title}</h1>
+          {description ? <p className="mt-1 text-sm text-muted-foreground">{description}</p> : null}
+        </div>
+        {action ? <div className="shrink-0">{action}</div> : null}
+      </div>
+      {summary ?? null}
+      {tabs?.length && activeTab && onTabChange ? (
+        <Tabs value={activeTab} onValueChange={onTabChange} variant="underline">
+          <TabsList className="flex h-auto w-full gap-1 overflow-x-auto px-7 pb-2" aria-label={title}>
+            {tabs.map((tab) => (
+              <TabsTrigger
+                key={tab.id}
+                value={tab.id}
+                count={tab.count}
+                disabled={tab.disabled}
+                className="shrink-0 gap-2 px-4 pb-2 pt-3 [&_[data-slot=tabs-trigger-count]]:h-auto [&_[data-slot=tabs-trigger-count]]:min-w-0 [&_[data-slot=tabs-trigger-count]]:rounded-md [&_[data-slot=tabs-trigger-count]]:bg-muted [&_[data-slot=tabs-trigger-count]]:px-1.5 [&_[data-slot=tabs-trigger-count]]:py-0.5 [&_[data-slot=tabs-trigger-count]]:text-overline [&_[data-slot=tabs-trigger-count]]:text-muted-foreground"
+              >
+                {tab.label}
+              </TabsTrigger>
+            ))}
+          </TabsList>
+        </Tabs>
+      ) : null}
+      <div className={`min-w-0 [&>[data-component-handle]>div:first-child_[data-slot=button]]:h-8 [&>[data-component-handle]>div:first-child_[data-slot=search-input-wrapper]]:h-8 [&_[data-slot=table-header]_[data-slot=table-row]]:h-9 [&_[data-slot=table-body]_[data-slot=table-row]]:h-16 ${contentClassName ?? ''}`}>{children}</div>
+    </section>
+  )
+}

package/src/modules/warranty_claims/backend/components/claimReasonOptions.ts

@@ -0,0 +1,57 @@
+"use client"
+
+import type { CrudFieldOption } from '@open-mercato/ui/backend/CrudForm'
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'
+import { localizeDictionaryLabel } from '../../lib/dictionaryLabels'
+
+const CLAIM_REASON_DICTIONARY_KEY = 'warranty_claims.warranty_claim_reason'
+
+type DictionaryListItem = {
+  id?: string
+  key?: string
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function toStringOrNull(value: unknown): string | null {
+  return typeof value === 'string' && value.length ? value : null
+}
+
+function normalizeDictionaryOption(item: unknown): CrudFieldOption | null {
+  if (!isRecord(item)) return null
+  const value = toStringOrNull(item.value)
+  if (!value) return null
+  const label = toStringOrNull(item.label) ?? value
+  return { value, label }
+}
+
+export async function fetchClaimReasonOptions(t: TranslateFn): Promise<CrudFieldOption[]> {
+  const dictionaries = await readApiResultOrThrow<{ items?: DictionaryListItem[] }>(
+    '/api/dictionaries',
+    undefined,
+    {
+      fallback: { items: [] },
+      errorMessage: t('warranty_claims.form.error.dictionaryLoad'),
+    },
+  )
+  const dictionary = (dictionaries.items ?? []).find((item) => item.key === CLAIM_REASON_DICTIONARY_KEY)
+  if (!dictionary?.id) return []
+  const entries = await readApiResultOrThrow<{ items?: unknown[] }>(
+    `/api/dictionaries/${encodeURIComponent(dictionary.id)}/entries`,
+    undefined,
+    {
+      fallback: { items: [] },
+      errorMessage: t('warranty_claims.form.error.dictionaryLoad'),
+    },
+  )
+  return (entries.items ?? [])
+    .map(normalizeDictionaryOption)
+    .filter((option): option is CrudFieldOption => option !== null)
+    .map((option) => ({
+      value: option.value,
+      label: localizeDictionaryLabel(t, 'reason', option.value, option.label),
+    }))
+}

package/src/modules/warranty_claims/backend/components/claimSla.tsx

@@ -0,0 +1,127 @@
+"use client"
+
+import * as React from 'react'
+import { useLocale, useT } from '@open-mercato/shared/lib/i18n/context'
+import { formatDateTime, formatRelativeTime } from '@open-mercato/shared/lib/time'
+import { StatusBadge } from '@open-mercato/ui/primitives/status-badge'
+
+export type ClaimSlaTier = 'none' | 'ok' | 'at_risk' | 'overdue' | 'paused'
+
+export type ClaimSlaState = {
+  tier: ClaimSlaTier
+  dueAt: Date | null
+  pausedAt: Date | null
+}
+
+export const CLAIM_SLA_DEFAULT_AT_RISK_PCT = 75
+
+const SLA_TERMINAL_STATUSES = new Set(['draft', 'resolved', 'closed', 'rejected', 'cancelled'])
+const SLA_CLOCK_INTERVAL_MS = 30_000
+const slaClockListeners = new Set<() => void>()
+let slaClockNow = Date.now()
+let slaClockInterval: ReturnType<typeof setInterval> | null = null
+
+function subscribeSlaClock(listener: () => void): () => void {
+  slaClockListeners.add(listener)
+  if (!slaClockInterval) {
+    slaClockNow = Date.now()
+    slaClockInterval = setInterval(() => {
+      slaClockNow = Date.now()
+      for (const notify of slaClockListeners) notify()
+    }, SLA_CLOCK_INTERVAL_MS)
+  }
+  return () => {
+    slaClockListeners.delete(listener)
+    if (slaClockListeners.size === 0 && slaClockInterval) {
+      clearInterval(slaClockInterval)
+      slaClockInterval = null
+    }
+  }
+}
+
+function useSlaClock(): number {
+  return React.useSyncExternalStore(subscribeSlaClock, () => slaClockNow, () => 0)
+}
+
+function parseDate(value: string | null | undefined): Date | null {
+  if (!value) return null
+  const parsed = new Date(value)
+  return Number.isNaN(parsed.getTime()) ? null : parsed
+}
+
+export function computeClaimSlaState(input: {
+  slaDueAt?: string | null
+  slaPausedAt?: string | null
+  submittedAt?: string | null
+  status?: string | null
+  atRiskThresholdPct?: number
+  now?: number
+}): ClaimSlaState {
+  const dueAt = parseDate(input.slaDueAt)
+  const pausedAt = parseDate(input.slaPausedAt)
+  const status = typeof input.status === 'string' ? input.status : ''
+  if (!dueAt || SLA_TERMINAL_STATUSES.has(status)) {
+    return { tier: 'none', dueAt, pausedAt }
+  }
+  if (pausedAt) return { tier: 'paused', dueAt, pausedAt }
+  const now = input.now ?? Date.now()
+  if (now >= dueAt.getTime()) return { tier: 'overdue', dueAt, pausedAt }
+  const submittedAt = parseDate(input.submittedAt)
+  if (submittedAt && dueAt.getTime() > submittedAt.getTime()) {
+    const thresholdPct = input.atRiskThresholdPct ?? CLAIM_SLA_DEFAULT_AT_RISK_PCT
+    const elapsedPct = ((now - submittedAt.getTime()) / (dueAt.getTime() - submittedAt.getTime())) * 100
+    if (elapsedPct >= thresholdPct) return { tier: 'at_risk', dueAt, pausedAt }
+  }
+  return { tier: 'ok', dueAt, pausedAt }
+}
+
+const SLA_TIER_TEXT_CLASSES: Record<Exclude<ClaimSlaTier, 'none' | 'paused'>, string> = {
+  ok: 'text-sm text-muted-foreground',
+  at_risk: 'text-sm font-medium text-status-warning-text',
+  overdue: 'text-sm font-medium text-status-error-text',
+}
+
+export function ClaimSlaIndicator({
+  slaDueAt,
+  slaPausedAt,
+  submittedAt,
+  status,
+  atRiskThresholdPct,
+  className,
+}: {
+  slaDueAt?: string | null
+  slaPausedAt?: string | null
+  submittedAt?: string | null
+  status?: string | null
+  atRiskThresholdPct?: number
+  className?: string
+}) {
+  const t = useT()
+  const locale = useLocale()
+  const now = useSlaClock()
+  const state = computeClaimSlaState({ slaDueAt, slaPausedAt, submittedAt, status, atRiskThresholdPct, now })
+  if (state.tier === 'none') {
+    return <span className={className ?? 'text-sm text-muted-foreground'}>{t('warranty_claims.common.noValue')}</span>
+  }
+  if (state.tier === 'paused') {
+    return (
+      <StatusBadge variant="neutral" dot className={className}>
+        {t('warranty_claims.sla.paused')}
+      </StatusBadge>
+    )
+  }
+  const relative = formatRelativeTime(state.dueAt ? state.dueAt.toISOString() : null, { locale })
+  const absolute = formatDateTime(state.dueAt ? state.dueAt.toISOString() : null)
+  const prefix =
+    state.tier === 'overdue'
+      ? `${t('warranty_claims.sla.overdue')} — `
+      : state.tier === 'at_risk'
+        ? `${t('warranty_claims.sla.atRisk')} — `
+        : ''
+  return (
+    <span className={className ?? SLA_TIER_TEXT_CLASSES[state.tier]} title={absolute ?? undefined}>
+      {prefix}
+      {relative ?? t('warranty_claims.common.noValue')}
+    </span>
+  )
+}

package/src/modules/warranty_claims/backend/components/orderLookup.ts

@@ -0,0 +1,109 @@
+import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import type { CrudFieldOption } from '@open-mercato/ui/backend/CrudForm'
+
+export type LoadOrderOptionsParams = {
+  customerId?: string | null
+  onAccessChange?: (accessDenied: boolean) => void
+  fallbackLabel?: string
+}
+
+export type LoadSalesReturnOptionsParams = {
+  orderId?: string | null
+  fallbackLabel?: string
+}
+
+const DEFAULT_FALLBACK_LABEL = '—'
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function toStringOrNull(value: unknown): string | null {
+  return typeof value === 'string' && value.trim().length ? value.trim() : null
+}
+
+function normalizeOrderOption(item: unknown, fallbackLabel: string): CrudFieldOption | null {
+  if (!isRecord(item)) return null
+  const id = toStringOrNull(item.id)
+  if (!id) return null
+  return { value: id, label: toStringOrNull(item.orderNumber) ?? fallbackLabel }
+}
+
+function normalizeSalesReturnOption(item: unknown, fallbackLabel: string): CrudFieldOption | null {
+  if (!isRecord(item)) return null
+  const id = toStringOrNull(item.id)
+  if (!id) return null
+  const returnNumber = toStringOrNull(item.return_number) ?? toStringOrNull(item.returnNumber)
+  return { value: id, label: returnNumber ?? fallbackLabel }
+}
+
+export async function loadOrderOptions(
+  query?: string,
+  params?: LoadOrderOptionsParams,
+): Promise<CrudFieldOption[]> {
+  const searchParams = new URLSearchParams({ page: '1', pageSize: '20' })
+  const trimmed = query?.trim()
+  if (trimmed) searchParams.set('search', trimmed)
+  if (params?.customerId) searchParams.set('customerId', params.customerId)
+  const response = await apiCall<{ items?: unknown[] }>(
+    `/api/sales/orders?${searchParams.toString()}`,
+    undefined,
+    { fallback: { items: [] } },
+  )
+  if (response.ok === false && response.status === 403) {
+    params?.onAccessChange?.(true)
+    return []
+  }
+  params?.onAccessChange?.(false)
+  const fallbackLabel = params?.fallbackLabel ?? DEFAULT_FALLBACK_LABEL
+  const items = Array.isArray(response.result?.items) ? response.result.items : []
+  return items
+    .map((item) => normalizeOrderOption(item, fallbackLabel))
+    .filter((option): option is CrudFieldOption => option !== null)
+}
+
+export async function resolveOrderLabel(value: string, fallbackLabel: string = DEFAULT_FALLBACK_LABEL): Promise<string> {
+  const response = await apiCall<{ items?: unknown[] }>(
+    `/api/sales/orders?${new URLSearchParams({ id: value, page: '1', pageSize: '1' }).toString()}`,
+    undefined,
+    { fallback: { items: [] } },
+  )
+  const option = (response.result?.items ?? [])
+    .map((item) => normalizeOrderOption(item, fallbackLabel))
+    .find((item): item is CrudFieldOption => item !== null)
+  return option?.label ?? fallbackLabel
+}
+
+export async function loadSalesReturnOptions(
+  query?: string,
+  params?: LoadSalesReturnOptionsParams,
+): Promise<CrudFieldOption[]> {
+  const orderId = params?.orderId
+  if (!orderId) return []
+  const searchParams = new URLSearchParams({ orderId, page: '1', pageSize: '50' })
+  const response = await apiCall<{ items?: unknown[] }>(
+    `/api/sales/returns?${searchParams.toString()}`,
+    undefined,
+    { fallback: { items: [] } },
+  )
+  const fallbackLabel = params?.fallbackLabel ?? DEFAULT_FALLBACK_LABEL
+  const items = Array.isArray(response.result?.items) ? response.result.items : []
+  const options = items
+    .map((item) => normalizeSalesReturnOption(item, fallbackLabel))
+    .filter((option): option is CrudFieldOption => option !== null)
+  const needle = query?.trim().toLowerCase()
+  if (!needle) return options
+  return options.filter((option) => option.label.toLowerCase().includes(needle))
+}
+
+export async function resolveSalesReturnLabel(value: string, fallbackLabel: string = DEFAULT_FALLBACK_LABEL): Promise<string> {
+  const response = await apiCall<{ items?: unknown[] }>(
+    `/api/sales/returns?${new URLSearchParams({ ids: value, page: '1', pageSize: '1' }).toString()}`,
+    undefined,
+    { fallback: { items: [] } },
+  )
+  const option = (response.result?.items ?? [])
+    .map((item) => normalizeSalesReturnOption(item, fallbackLabel))
+    .find((item): item is CrudFieldOption => item !== null)
+  return option?.label ?? fallbackLabel
+}