@open-mercato/core 0.6.8-develop.6925.1.cefa200fa4 → 0.6.8-develop.6930.1.1e5976efc3

package/src/modules/eudr/subscribers/recompute-completeness-on-attachment-created.ts

@@ -0,0 +1,189 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { sql } from 'kysely'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { EudrEvidenceSubmission, EudrPlot } from '../data/entities'
+import { computeSubmissionCompleteness } from '../lib/completeness'
+
+const logger = createLogger('eudr').child({ component: 'attachment-created-completeness' })
+
+const EVIDENCE_SUBMISSION_ENTITY_ID = 'eudr:eudr_evidence_submission'
+
+export const metadata = {
+  event: 'attachments.attachment.created',
+  persistent: false,
+  id: 'eudr:attachment-created-completeness',
+}
+
+type AttachmentCountDatabase = {
+  attachments: {
+    entity_id: string
+    record_id: string
+    tenant_id: string | null
+    organization_id: string | null
+  }
+}
+
+type AttachmentEventPayload = {
+  entityId?: unknown
+  recordId?: unknown
+  tenantId?: unknown
+  organizationId?: unknown
+}
+
+type ScopedAttachmentPayload = {
+  recordId: string
+  tenantId: string
+  organizationId: string
+}
+
+type EventBusLike = {
+  emitEvent(
+    eventName: string,
+    payload: Record<string, unknown>,
+    options?: { tenantId?: string | null; organizationId?: string | null },
+  ): Promise<void> | void
+}
+
+export type AttachmentSubscriberContext = {
+  resolve: <T = unknown>(name: string) => T
+  container?: { resolve<T = unknown>(name: string): T }
+}
+
+function parsePayload(payload: AttachmentEventPayload): ScopedAttachmentPayload | null {
+  if (payload.entityId !== EVIDENCE_SUBMISSION_ENTITY_ID) return null
+  if (typeof payload.recordId !== 'string' || payload.recordId.trim().length === 0) return null
+  if (typeof payload.tenantId !== 'string' || payload.tenantId.trim().length === 0) return null
+  if (typeof payload.organizationId !== 'string' || payload.organizationId.trim().length === 0) return null
+  return {
+    recordId: payload.recordId,
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId,
+  }
+}
+
+function parseCountValue(value: string | number | bigint | null | undefined): number | undefined {
+  if (typeof value === 'number') return Number.isFinite(value) ? value : undefined
+  if (typeof value === 'bigint') return Number(value)
+  if (typeof value === 'string') {
+    const parsed = Number(value)
+    return Number.isFinite(parsed) ? parsed : undefined
+  }
+  return undefined
+}
+
+async function countLinkedAttachments(
+  em: EntityManager,
+  scope: ScopedAttachmentPayload,
+): Promise<number | undefined> {
+  try {
+    const db = em.getKysely<AttachmentCountDatabase>()
+    const row = await db
+      .selectFrom('attachments')
+      .select(sql<string | number | bigint>`count(*)`.as('attachment_count'))
+      .where('entity_id', '=', EVIDENCE_SUBMISSION_ENTITY_ID)
+      .where('record_id', '=', scope.recordId)
+      .where('tenant_id', '=', scope.tenantId)
+      .where('organization_id', '=', scope.organizationId)
+      .executeTakeFirst()
+    return parseCountValue(row?.attachment_count)
+  } catch {
+    return undefined
+  }
+}
+
+async function countActivePlots(
+  em: EntityManager,
+  submission: EudrEvidenceSubmission,
+): Promise<number> {
+  const plotIds = Array.from(new Set(Array.isArray(submission.plotIds) ? submission.plotIds : []))
+  if (plotIds.length === 0) return 0
+  return em.count(EudrPlot, {
+    id: { $in: plotIds },
+    tenantId: submission.tenantId,
+    organizationId: submission.organizationId,
+    deletedAt: null,
+    isActive: true,
+  })
+}
+
+async function emitSubmissionReindex(
+  ctx: AttachmentSubscriberContext,
+  submission: EudrEvidenceSubmission,
+): Promise<void> {
+  const bus = ctx.resolve<EventBusLike>('eventBus')
+  await bus.emitEvent(
+    'query_index.upsert_one',
+    {
+      entityType: EVIDENCE_SUBMISSION_ENTITY_ID,
+      recordId: submission.id,
+      organizationId: submission.organizationId,
+      tenantId: submission.tenantId,
+      crudAction: 'updated',
+    },
+    {
+      organizationId: submission.organizationId,
+      tenantId: submission.tenantId,
+    },
+  )
+}
+
+export async function recomputeSubmissionCompletenessFromAttachmentPayload(
+  payload: AttachmentEventPayload,
+  ctx: AttachmentSubscriberContext,
+): Promise<void> {
+  const scopedPayload = parsePayload(payload)
+  if (!scopedPayload) return
+
+  const baseEm = ctx.resolve<EntityManager>('em')
+  const em = baseEm.fork()
+  const submission = await findOneWithDecryption(
+    em,
+    EudrEvidenceSubmission,
+    {
+      id: scopedPayload.recordId,
+      tenantId: scopedPayload.tenantId,
+      organizationId: scopedPayload.organizationId,
+      deletedAt: null,
+    },
+    undefined,
+    {
+      tenantId: scopedPayload.tenantId,
+      organizationId: scopedPayload.organizationId,
+    },
+  )
+  if (!submission) return
+
+  const [activePlotCount, linkedAttachmentCount] = await Promise.all([
+    countActivePlots(em, submission),
+    countLinkedAttachments(em, scopedPayload),
+  ])
+  const completeness = computeSubmissionCompleteness({
+    originCountry: submission.originCountry ?? null,
+    geolocation: submission.geolocation ?? null,
+    quantityKg: submission.quantityKg ?? null,
+    harvestFrom: submission.harvestFrom ?? null,
+    harvestTo: submission.harvestTo ?? null,
+    producerName: submission.producerName ?? null,
+    attachmentIds: submission.attachmentIds ?? [],
+  }, {
+    activePlotCount,
+    linkedAttachmentCount,
+  })
+  submission.completenessScore = completeness.score
+  submission.missingFields = [...completeness.missingFields]
+  // Projection update only: attachment CRUD already owns the undoable write.
+  await em.flush()
+  await emitSubmissionReindex(ctx, submission)
+}
+
+export default async function handleAttachmentCreated(
+  payload: AttachmentEventPayload,
+  ctx: AttachmentSubscriberContext,
+): Promise<void> {
+  try {
+    await recomputeSubmissionCompletenessFromAttachmentPayload(payload, ctx)
+  } catch (error) {
+    logger.warn('attachment-created completeness recompute failed', { err: error })
+  }
+}

package/src/modules/eudr/subscribers/recompute-completeness-on-attachment-deleted.ts

@@ -0,0 +1,31 @@
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import {
+  recomputeSubmissionCompletenessFromAttachmentPayload,
+  type AttachmentSubscriberContext,
+} from './recompute-completeness-on-attachment-created'
+
+const logger = createLogger('eudr').child({ component: 'attachment-deleted-completeness' })
+
+export const metadata = {
+  event: 'attachments.attachment.deleted',
+  persistent: false,
+  id: 'eudr:attachment-deleted-completeness',
+}
+
+type AttachmentEventPayload = {
+  entityId?: unknown
+  recordId?: unknown
+  tenantId?: unknown
+  organizationId?: unknown
+}
+
+export default async function handleAttachmentDeleted(
+  payload: AttachmentEventPayload,
+  ctx: AttachmentSubscriberContext,
+): Promise<void> {
+  try {
+    await recomputeSubmissionCompletenessFromAttachmentPayload(payload, ctx)
+  } catch (error) {
+    logger.warn('attachment-deleted completeness recompute failed', { err: error })
+  }
+}

package/src/modules/eudr/widgets/dashboard/compliance-overview/widget.client.tsx

@@ -0,0 +1,271 @@
+"use client"
+
+import * as React from 'react'
+import { useRouter } from 'next/navigation'
+import type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'
+import { useLocale, useT } from '@open-mercato/shared/lib/i18n/context'
+import { EmptyState } from '@open-mercato/ui/backend/EmptyState'
+import { ErrorMessage, LoadingMessage } from '@open-mercato/ui/backend/detail'
+import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import { Button } from '@open-mercato/ui/primitives/button'
+import { Leaf } from 'lucide-react'
+import type { EudrComplianceOverviewSettings } from './widget'
+
+type StatusCounts = Record<string, number>
+
+type ComplianceOverview = {
+  deadline: {
+    date: string
+    daysLeft: number
+  }
+  mappingsInScope?: number
+  submissions?: {
+    total: number
+    byStatus: StatusCounts
+    avgCompleteness: number | null
+    incomplete: number
+  }
+  statements: {
+    total: number
+    byStatus: StatusCounts
+    notReady: number
+    missingReference: number
+  }
+  riskReviewsDueSoon?: number
+}
+
+type Translate = (
+  key: string,
+  fallbackOrParams?: string | Record<string, string | number>,
+  params?: Record<string, string | number>,
+) => string
+
+const SUBMISSION_STATUSES = ['draft', 'submitted', 'verified', 'rejected'] as const
+const STATEMENT_STATUSES = ['draft', 'submitted', 'available', 'withdrawn', 'archived'] as const
+
+async function loadOverview(): Promise<ComplianceOverview> {
+  const call = await apiCall<ComplianceOverview>('/api/eudr/dashboard/widgets/compliance-overview')
+  if (!call.ok || !call.result) {
+    const message = `[internal] EUDR compliance overview request failed with status ${call.status}`
+    throw new Error(message)
+  }
+  return call.result
+}
+
+function formatDeadlineDate(value: string, locale: string): string {
+  const date = new Date(`${value}T00:00:00.000Z`)
+  if (Number.isNaN(date.getTime())) return value
+  return date.toLocaleDateString(locale || undefined)
+}
+
+function formatCompleteness(value: number | null, t: Translate): string {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return t('eudr.common.empty')
+  return `${Math.round(value)}%`
+}
+
+function isOverviewEmpty(data: ComplianceOverview): boolean {
+  return (data.mappingsInScope ?? 0) === 0
+    && (data.submissions?.total ?? 0) === 0
+    && data.statements.total === 0
+    && (data.riskReviewsDueSoon ?? 0) === 0
+}
+
+function StatusBreakdown({
+  title,
+  statuses,
+  byStatus,
+  labelPrefix,
+  t,
+}: {
+  title: string
+  statuses: readonly string[]
+  byStatus: StatusCounts
+  labelPrefix: string
+  t: Translate
+}) {
+  return (
+    <div className="space-y-1">
+      <p className="text-xs font-semibold uppercase text-muted-foreground">{title}</p>
+      <div className="flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted-foreground">
+        {statuses.map((status) => (
+          <span key={status}>
+            {t(`${labelPrefix}.${status}`)}: {byStatus[status] ?? 0}
+          </span>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+function StatTile({
+  label,
+  value,
+  href,
+  onOpen,
+}: {
+  label: string
+  value: number
+  href?: string
+  onOpen: (href: string) => void
+}) {
+  const content = (
+    <span className="flex w-full items-center justify-between gap-3">
+      <span className="text-left text-xs font-medium text-muted-foreground">{label}</span>
+      <span className="text-lg font-semibold text-foreground">{value}</span>
+    </span>
+  )
+
+  if (!href) {
+    return (
+      <div className="flex min-h-16 items-center rounded-md border bg-background px-3 py-2">
+        {content}
+      </div>
+    )
+  }
+
+  return (
+    <Button
+      type="button"
+      variant="outline"
+      className="min-h-16 w-full justify-start px-3 py-2"
+      onClick={() => onOpen(href)}
+    >
+      {content}
+    </Button>
+  )
+}
+
+const EudrComplianceOverviewWidget: React.FC<DashboardWidgetComponentProps<EudrComplianceOverviewSettings>> = ({
+  mode,
+  refreshToken,
+  onRefreshStateChange,
+}) => {
+  const t = useT()
+  const locale = useLocale()
+  const router = useRouter()
+  const [overview, setOverview] = React.useState<ComplianceOverview | null>(null)
+  const [loading, setLoading] = React.useState(true)
+  const [error, setError] = React.useState<string | null>(null)
+
+  const refresh = React.useCallback(async () => {
+    onRefreshStateChange?.(true)
+    setLoading(true)
+    setError(null)
+    try {
+      const data = await loadOverview()
+      setOverview(data)
+    } catch {
+      setError(t('eudr.dashboard.error'))
+    } finally {
+      setLoading(false)
+      onRefreshStateChange?.(false)
+    }
+  }, [onRefreshStateChange, t])
+
+  React.useEffect(() => {
+    refresh().catch(() => {})
+  }, [refresh, refreshToken])
+
+  if (mode === 'settings') {
+    return (
+      <p className="text-sm text-muted-foreground">{t('eudr.dashboard.noSettings')}</p>
+    )
+  }
+
+  if (loading) {
+    return <LoadingMessage label={t('eudr.dashboard.loading')} />
+  }
+
+  if (error) {
+    return <ErrorMessage label={error} />
+  }
+
+  if (!overview || isOverviewEmpty(overview)) {
+    return (
+      <EmptyState
+        size="sm"
+        variant="subtle"
+        icon={<Leaf className="h-5 w-5" aria-hidden />}
+        title={t('eudr.dashboard.empty.title')}
+        description={t('eudr.dashboard.empty.description')}
+      />
+    )
+  }
+
+  const deadlineDate = formatDeadlineDate(overview.deadline.date, locale)
+
+  return (
+    <div className="space-y-4">
+      <div className="space-y-1">
+        <p className="text-sm font-semibold">
+          {t('eudr.dashboard.daysToDeadline', {
+            daysLeft: overview.deadline.daysLeft,
+            date: deadlineDate,
+          })}
+        </p>
+        {overview.mappingsInScope !== undefined ? (
+          <p className="text-xs text-muted-foreground">
+            {t('eudr.dashboard.mappingsInScope', { count: overview.mappingsInScope })}
+          </p>
+        ) : null}
+      </div>
+
+      <div className="grid grid-cols-2 gap-2">
+        <StatTile
+          label={t('eudr.dashboard.notReady')}
+          value={overview.statements.notReady}
+          href="/backend/eudr/statements?status=draft"
+          onOpen={router.push}
+        />
+        {overview.submissions ? (
+          <StatTile
+            label={t('eudr.dashboard.incompleteSubmissions')}
+            value={overview.submissions.incomplete}
+            href="/backend/eudr/evidence-submissions"
+            onOpen={router.push}
+          />
+        ) : null}
+        <StatTile
+          label={t('eudr.dashboard.missingReference')}
+          value={overview.statements.missingReference}
+          href="/backend/eudr/statements"
+          onOpen={router.push}
+        />
+        {overview.riskReviewsDueSoon !== undefined ? (
+          <StatTile
+            label={t('eudr.dashboard.riskReviewsDueSoon')}
+            value={overview.riskReviewsDueSoon}
+            onOpen={router.push}
+          />
+        ) : null}
+      </div>
+
+      <div className="space-y-3 rounded-md border bg-muted/20 p-3">
+        {overview.submissions ? (
+          <>
+            <div className="flex items-center justify-between gap-3 text-sm">
+              <span className="text-muted-foreground">{t('eudr.dashboard.avgCompleteness')}</span>
+              <span className="font-medium">{formatCompleteness(overview.submissions.avgCompleteness, t)}</span>
+            </div>
+            <StatusBreakdown
+              title={t('eudr.dashboard.submissionsByStatus')}
+              statuses={SUBMISSION_STATUSES}
+              byStatus={overview.submissions.byStatus}
+              labelPrefix="eudr.submissionStatus"
+              t={t}
+            />
+          </>
+        ) : null}
+        <StatusBreakdown
+          title={t('eudr.dashboard.statementsByStatus')}
+          statuses={STATEMENT_STATUSES}
+          byStatus={overview.statements.byStatus}
+          labelPrefix="eudr.statementStatus"
+          t={t}
+        />
+      </div>
+    </div>
+  )
+}
+
+export default EudrComplianceOverviewWidget

package/src/modules/eudr/widgets/dashboard/compliance-overview/widget.ts

@@ -0,0 +1,24 @@
+import { lazyDashboardWidget, type DashboardWidgetModule } from '@open-mercato/shared/modules/dashboard/widgets'
+
+export type EudrComplianceOverviewSettings = Record<string, never>
+
+const EudrComplianceOverviewWidget = lazyDashboardWidget<EudrComplianceOverviewSettings>(() => import('./widget.client'))
+
+const widget: DashboardWidgetModule<EudrComplianceOverviewSettings> = {
+  metadata: {
+    id: 'eudr.dashboard.complianceOverview',
+    title: 'EUDR compliance',
+    description: 'Track due diligence readiness, evidence completeness, and upcoming EUDR review work.',
+    features: ['dashboards.view', 'eudr.statements.view'],
+    defaultSize: 'md',
+    defaultEnabled: false,
+    defaultSettings: {},
+    tags: ['eudr', 'compliance'],
+    category: 'compliance',
+    icon: 'leaf',
+    supportsRefresh: true,
+  },
+  Widget: EudrComplianceOverviewWidget,
+}
+
+export default widget

package/src/modules/eudr/widgets/injection/eudr-product-column/widget.client.tsx

@@ -0,0 +1,37 @@
+'use client'
+
+import * as React from 'react'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { Tag } from '@open-mercato/ui/primitives/tag'
+
+export type EudrProductColumnValue = {
+  commodity?: string | null
+  isInScope?: boolean | null
+} | null | undefined
+
+export default function EudrProductColumnWidget({ value }: { value: EudrProductColumnValue }) {
+  const t = useT()
+
+  if (!value || typeof value.commodity !== 'string' || value.commodity.length === 0) {
+    return (
+      <span className="text-muted-foreground" aria-label={t('eudr.productColumn.noMapping')}>
+        {t('eudr.common.empty')}
+      </span>
+    )
+  }
+
+  const inScope = value.isInScope !== false
+
+  return (
+    <span className="flex min-w-0 flex-wrap items-center gap-1.5">
+      <Tag variant={inScope ? 'success' : 'neutral'}>
+        {t(`eudr.commodity.${value.commodity}`)}
+      </Tag>
+      {!inScope ? (
+        <span className="text-xs text-muted-foreground">
+          {t('eudr.productColumn.outOfScope')}
+        </span>
+      ) : null}
+    </span>
+  )
+}

package/src/modules/eudr/widgets/injection/eudr-product-column/widget.ts

@@ -0,0 +1,30 @@
+import * as React from 'react'
+import type { InjectionColumnWidget } from '@open-mercato/shared/modules/widgets/injection'
+import EudrProductColumnWidget, { type EudrProductColumnValue } from './widget.client'
+
+const widget: InjectionColumnWidget = {
+  metadata: {
+    id: 'eudr.injection.product-column',
+    title: 'EUDR product column',
+    description: 'Renders EUDR commodity and scope information on catalog product lists.',
+    features: ['eudr.mappings.view'],
+    priority: 50,
+    enabled: true,
+  },
+  columns: [
+    {
+      id: 'eudr.product-column',
+      header: 'eudr.productColumn.header',
+      accessorKey: '_eudr',
+      size: 180,
+      sortable: false,
+      cell: ({ getValue }) => {
+        return React.createElement(EudrProductColumnWidget, {
+          value: getValue() as EudrProductColumnValue,
+        })
+      },
+    },
+  ],
+}
+
+export default widget