@open-mercato/core 0.6.8-develop.6924.1.a8d208fcdc → 0.6.8-develop.6930.1.1e5976efc3

package/src/modules/eudr/api/plots/import/route.ts

@@ -0,0 +1,369 @@
+import { z } from 'zod'
+import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
+import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
+import type { CommandBus, CommandRuntimeContext } from '@open-mercato/shared/lib/commands'
+import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { getAllMutationGuardInstances } from '@open-mercato/shared/lib/crud/mutation-guard-store'
+import {
+  bridgeLegacyGuard,
+  runMutationGuards,
+  type MutationGuard,
+  type MutationGuardInput,
+} from '@open-mercato/shared/lib/crud/mutation-guard-registry'
+import type { QueryEngine } from '@open-mercato/shared/lib/query/types'
+import { E } from '#generated/entities.ids.generated'
+import { collectFeatures } from '../../../lib/geometry'
+import { plotCreateSchema } from '../../../data/validators'
+
+const logger = createLogger('eudr').child({ component: 'api/plots/import' })
+
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['eudr.plots.manage'] },
+}
+
+const importSchema = z.object({
+  supplierEntityId: z.string().uuid(),
+  defaultCountry: z.string().regex(/^[A-Za-z]{2}$/).transform((value) => value.toUpperCase()).optional(),
+  featureCollection: z.unknown(),
+})
+
+type PlotImportInput = z.infer<typeof importSchema>
+type PlotImportFailure = { index: number; name: string; errorKey: string }
+type RequestContext = { ctx: CommandRuntimeContext; organizationId: string; tenantId: string }
+type CommandCreateResult = { entityId?: string; id?: string }
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function optionalString(value: unknown): string | null {
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+function optionalNumber(value: unknown): number | null {
+  return typeof value === 'number' && Number.isFinite(value) ? value : null
+}
+
+function resolveUserFeatures(auth: unknown): string[] {
+  const features = (auth as { features?: unknown })?.features
+  if (!Array.isArray(features)) return []
+  return features.filter((value): value is string => typeof value === 'string')
+}
+
+async function runGuards(
+  ctx: CommandRuntimeContext,
+  input: MutationGuardInput,
+): Promise<{
+  ok: boolean
+  errorBody?: Record<string, unknown>
+  errorStatus?: number
+  modifiedPayload?: Record<string, unknown>
+  afterSuccessCallbacks: Array<{ guard: MutationGuard; metadata: Record<string, unknown> | null }>
+}> {
+  const legacyGuard = bridgeLegacyGuard(ctx.container)
+  const guards = [...getAllMutationGuardInstances(), ...(legacyGuard ? [legacyGuard] : [])]
+  return runMutationGuards(guards, input, {
+    userFeatures: resolveUserFeatures(ctx.auth),
+  })
+}
+
+async function runGuardAfterSuccessCallbacks(
+  callbacks: Array<{ guard: MutationGuard; metadata: Record<string, unknown> | null }>,
+  input: {
+    tenantId: string
+    organizationId: string
+    userId: string
+    resourceKind: string
+    resourceId: string
+    operation: 'create'
+    requestMethod: string
+    requestHeaders: Headers
+  },
+): Promise<void> {
+  for (const callback of callbacks) {
+    if (!callback.guard.afterSuccess) continue
+    try {
+      await callback.guard.afterSuccess({
+        ...input,
+        metadata: callback.metadata ?? null,
+      })
+    } catch (err) {
+      logger.warn('Mutation guard afterSuccess callback failed', { err })
+    }
+  }
+}
+
+async function resolveRequestContext(req: Request): Promise<RequestContext> {
+  const container = await createRequestContainer()
+  const auth = await getAuthFromRequest(req)
+  const { translate } = await resolveTranslations()
+
+  if (!auth || !auth.tenantId) {
+    throw new CrudHttpError(401, { error: translate('eudr.errors.unauthorized', 'Unauthorized') })
+  }
+
+  const scope = await resolveOrganizationScopeForRequest({ container, auth, request: req })
+  const organizationId = scope?.selectedId ?? auth.orgId ?? null
+  if (!organizationId) {
+    throw new CrudHttpError(400, {
+      error: translate('eudr.errors.organization_required', 'Organization context is required'),
+    })
+  }
+
+  return {
+    tenantId: auth.tenantId,
+    organizationId,
+    ctx: {
+      container,
+      auth,
+      organizationScope: scope,
+      selectedOrganizationId: organizationId,
+      organizationIds: scope?.filterIds ?? (auth.orgId ? [auth.orgId] : null),
+      request: req,
+    },
+  }
+}
+
+function featureProperties(feature: unknown): Record<string, unknown> {
+  if (!isRecord(feature)) return {}
+  const properties = feature.properties
+  return isRecord(properties) ? properties : {}
+}
+
+function featureGeometryType(feature: unknown): string | null {
+  if (!isRecord(feature)) return null
+  if (feature.type === 'Feature' && isRecord(feature.geometry) && typeof feature.geometry.type === 'string') {
+    return feature.geometry.type
+  }
+  return typeof feature.type === 'string' ? feature.type : null
+}
+
+function resolveFeatureName(properties: Record<string, unknown>, index: number): string {
+  return optionalString(properties.name)
+    ?? optionalString(properties.ProductionPlace)
+    ?? `Plot ${index + 1}`
+}
+
+function errorKeyFromError(error: unknown): string {
+  if (isCrudHttpError(error)) {
+    const bodyError = error.body?.error
+    return typeof bodyError === 'string' && bodyError.length > 0 ? bodyError : 'eudr.errors.plot_import_failed'
+  }
+  if (error instanceof z.ZodError) {
+    const firstMessage = error.issues[0]?.message
+    return typeof firstMessage === 'string' && firstMessage.length > 0 ? firstMessage : 'eudr.errors.plot_import_failed'
+  }
+  return 'eudr.errors.plot_import_failed'
+}
+
+async function loadSupplierDisplayName(
+  queryEngine: QueryEngine,
+  scope: { tenantId: string; organizationId: string },
+  supplierEntityId: string,
+): Promise<string | null> {
+  // Soft cross-module read (FK-id convention) via the query engine — no direct
+  // customers entity import; degrades to null when the peer is absent so the
+  // import still succeeds without a snapshot.
+  try {
+    const customersEntityId = (E as Record<string, Record<string, string>>).customers?.customer_entity
+    if (!customersEntityId) return null
+    const result = await queryEngine.query<Record<string, unknown>>(customersEntityId, {
+      fields: ['id', 'display_name'],
+      filters: { id: { $in: [supplierEntityId] } },
+      page: { page: 1, pageSize: 1 },
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+    })
+    const rawName = result.items[0]?.display_name ?? result.items[0]?.displayName
+    return typeof rawName === 'string' && rawName.length ? rawName : null
+  } catch {
+    return null
+  }
+}
+
+async function createPlotFromFeature(args: {
+  commandBus: CommandBus
+  ctx: CommandRuntimeContext
+  scope: { tenantId: string; organizationId: string }
+  input: PlotImportInput
+  feature: unknown
+  index: number
+  supplierDisplayName: string | null
+}): Promise<{ id: string | null }> {
+  const properties = featureProperties(args.feature)
+  const name = resolveFeatureName(properties, args.index)
+  const originCountry = optionalString(properties.ProducerCountry) ?? args.input.defaultCountry ?? null
+  if (!originCountry) throw new CrudHttpError(400, { error: 'eudr.errors.importCountryMissing' })
+
+  const area = optionalNumber(properties.Area)
+  const base = {
+    supplierEntityId: args.input.supplierEntityId,
+    name,
+    originCountry,
+    geometry: args.feature,
+    producerName: optionalString(properties.ProducerName),
+    areaHa: featureGeometryType(args.feature) === 'Point' && area !== null ? area : undefined,
+    supplierSnapshot: args.supplierDisplayName ? { displayName: args.supplierDisplayName } : undefined,
+  }
+  const parsed = plotCreateSchema.parse(base)
+  const { result } = await args.commandBus.execute<typeof parsed & { tenantId: string; organizationId: string }, CommandCreateResult>(
+    'eudr.plots.create',
+    {
+      input: {
+        ...parsed,
+        tenantId: args.scope.tenantId,
+        organizationId: args.scope.organizationId,
+      },
+      ctx: args.ctx,
+      metadata: {
+        tenantId: args.scope.tenantId,
+        organizationId: args.scope.organizationId,
+        resourceKind: 'eudr.plot',
+        context: { cacheAliases: ['eudr.plot'] },
+      },
+    },
+  )
+  return { id: result?.entityId ?? result?.id ?? null }
+}
+
+export async function POST(req: Request) {
+  try {
+    const requestContext = await resolveRequestContext(req)
+    const { translate } = await resolveTranslations()
+    const payload = await req.json().catch(() => ({}))
+    const input = importSchema.parse(payload)
+    const guardResult = await runGuards(requestContext.ctx, {
+      tenantId: requestContext.tenantId,
+      organizationId: requestContext.organizationId,
+      userId: requestContext.ctx.auth?.sub ?? '',
+      resourceKind: 'eudr.plot',
+      resourceId: null,
+      operation: 'create',
+      requestMethod: req.method,
+      requestHeaders: req.headers,
+      mutationPayload: {
+        supplierEntityId: input.supplierEntityId,
+        defaultCountry: input.defaultCountry ?? null,
+      },
+    })
+    if (!guardResult.ok) {
+      return Response.json(
+        guardResult.errorBody ?? { error: translate('eudr.errors.operation_blocked', 'Operation blocked by guard') },
+        { status: guardResult.errorStatus ?? 422 },
+      )
+    }
+    const guardPatch = guardResult.modifiedPayload ?? null
+    const effectiveSupplierEntityId = typeof guardPatch?.supplierEntityId === 'string' && guardPatch.supplierEntityId.length
+      ? guardPatch.supplierEntityId
+      : input.supplierEntityId
+    const effectiveDefaultCountry = typeof guardPatch?.defaultCountry === 'string' && guardPatch.defaultCountry.length
+      ? guardPatch.defaultCountry
+      : input.defaultCountry
+
+    const featureResult = collectFeatures(input.featureCollection)
+    if (!featureResult.ok) {
+      return Response.json({ errorKey: featureResult.errorKey }, { status: 400 })
+    }
+
+    const commandBus = requestContext.ctx.container.resolve('commandBus') as CommandBus
+    const failed: PlotImportFailure[] = []
+    const createdIds: string[] = []
+    const effectiveInput: PlotImportInput = {
+      ...input,
+      supplierEntityId: effectiveSupplierEntityId,
+      defaultCountry: effectiveDefaultCountry,
+    }
+
+    const importScope = { tenantId: requestContext.tenantId, organizationId: requestContext.organizationId }
+    const supplierDisplayName = await loadSupplierDisplayName(
+      requestContext.ctx.container.resolve('queryEngine') as QueryEngine,
+      importScope,
+      effectiveSupplierEntityId,
+    )
+
+    for (const [index, feature] of featureResult.features.entries()) {
+      const name = resolveFeatureName(featureProperties(feature), index)
+      try {
+        const created = await createPlotFromFeature({
+          commandBus,
+          ctx: requestContext.ctx,
+          scope: importScope,
+          input: effectiveInput,
+          feature,
+          index,
+          supplierDisplayName,
+        })
+        if (created.id) createdIds.push(created.id)
+      } catch (error) {
+        failed.push({ index, name, errorKey: errorKeyFromError(error) })
+      }
+    }
+
+    if (guardResult.afterSuccessCallbacks.length) {
+      for (const id of createdIds) {
+        await runGuardAfterSuccessCallbacks(guardResult.afterSuccessCallbacks, {
+          tenantId: requestContext.tenantId,
+          organizationId: requestContext.organizationId,
+          userId: requestContext.ctx.auth?.sub ?? '',
+          resourceKind: 'eudr.plot',
+          resourceId: id,
+          operation: 'create',
+          requestMethod: req.method,
+          requestHeaders: req.headers,
+        })
+      }
+    }
+
+    return Response.json({ created: createdIds.length, failed })
+  } catch (error) {
+    if (isCrudHttpError(error)) {
+      return Response.json(error.body, { status: error.status })
+    }
+    const { translate } = await resolveTranslations()
+    if (error instanceof z.ZodError) {
+      return Response.json(
+        { error: translate('eudr.errors.plot_import_failed', 'Failed to import plots') },
+        { status: 400 },
+      )
+    }
+    logger.error('Plot import failed', { err: error })
+    return Response.json(
+      { error: translate('eudr.errors.plot_import_failed', 'Failed to import plots') },
+      { status: 500 },
+    )
+  }
+}
+
+const importResponseSchema = z.object({
+  created: z.number(),
+  failed: z.array(z.object({
+    index: z.number(),
+    name: z.string(),
+    errorKey: z.string(),
+  })),
+})
+
+export const openApi: OpenApiRouteDoc = {
+  tag: 'EUDR',
+  summary: 'Import EUDR plots from GeoJSON',
+  methods: {
+    POST: {
+      summary: 'Import plots',
+      requestBody: {
+        contentType: 'application/json',
+        schema: importSchema,
+      },
+      responses: [
+        { status: 200, description: 'Import result', schema: importResponseSchema },
+        { status: 400, description: 'Invalid import payload', schema: z.object({ error: z.string().optional(), errorKey: z.string().optional() }) },
+        { status: 401, description: 'Unauthorized', schema: z.object({ error: z.string() }) },
+        { status: 403, description: 'Forbidden', schema: z.object({ error: z.string() }) },
+        { status: 500, description: 'Plot import failed', schema: z.object({ error: z.string() }) },
+      ],
+    },
+  },
+}

package/src/modules/eudr/api/plots/route.ts

@@ -0,0 +1,296 @@
+import type { EntityManager, FilterQuery } from '@mikro-orm/postgresql'
+import { z } from 'zod'
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { splitCustomFieldPayload } from '@open-mercato/shared/lib/crud/custom-fields'
+import { buildIlikeTerm } from '@open-mercato/shared/lib/db/buildIlikeTerm'
+import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
+import { withScopedPayload } from '@open-mercato/shared/lib/api/scoped'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { E } from '#generated/entities.ids.generated'
+import { EudrPlot } from '../../data/entities'
+import { resolveDetailReadScope } from '../../lib/detail-read-scope'
+import {
+  EUDR_PLOT_TYPES,
+  plotCreateSchema,
+  plotUpdateSchema,
+} from '../../data/validators'
+import {
+  createEudrCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultOkResponseSchema,
+} from '../openapi'
+
+type TranslateFn = (key: string, fallback?: string) => string
+
+const rawBodySchema = z.object({}).passthrough()
+
+const listSchema = z.object({
+  page: z.coerce.number().min(1).default(1),
+  pageSize: z.coerce.number().min(1).max(100).default(50),
+  search: z.string().optional(),
+  supplierEntityId: z.string().uuid().optional(),
+  plotType: z.enum(EUDR_PLOT_TYPES).optional(),
+  isActive: z.string().optional(),
+  originCountry: z.string().length(2).optional(),
+  id: z.string().uuid().optional(),
+  ids: z.string().optional(),
+  sortField: z.string().optional(),
+  sortDir: z.enum(['asc', 'desc']).optional(),
+})
+
+type PlotListQuery = z.infer<typeof listSchema>
+
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ['eudr.plots.view'] },
+  POST: { requireAuth: true, requireFeatures: ['eudr.plots.manage'] },
+  PUT: { requireAuth: true, requireFeatures: ['eudr.plots.manage'] },
+  DELETE: { requireAuth: true, requireFeatures: ['eudr.plots.manage'] },
+}
+
+export const metadata = routeMetadata
+
+function toIsoString(value: unknown): string | null {
+  if (value instanceof Date) return value.toISOString()
+  if (typeof value !== 'string' || value.length === 0) return null
+  const date = new Date(value)
+  return Number.isNaN(date.getTime()) ? value : date.toISOString()
+}
+
+function asStringOrNull(value: unknown): string | null {
+  return typeof value === 'string' ? value : null
+}
+
+function stringArray(value: unknown): string[] {
+  if (!Array.isArray(value)) return []
+  return value.filter((entry): entry is string => typeof entry === 'string')
+}
+
+function resolveDeleteInput(parsed: unknown, ctx: { request?: Request }, translate: TranslateFn) {
+  const record = parsed && typeof parsed === 'object' ? recordFrom(parsed) : {}
+  const body = record.body && typeof record.body === 'object' ? recordFrom(record.body) : null
+  const query = record.query && typeof record.query === 'object' ? recordFrom(record.query) : null
+  const requestId = ctx.request ? new URL(ctx.request.url).searchParams.get('id') : null
+  const id = asStringOrNull(body?.id) ?? asStringOrNull(record.id) ?? asStringOrNull(query?.id) ?? requestId
+  if (!id) throw new CrudHttpError(400, { error: translate('eudr.errors.plot_required', 'Plot id is required') })
+  return { id }
+}
+
+function recordFrom(value: object): Record<string, unknown> {
+  return value as Record<string, unknown>
+}
+
+function buildFilters(query: PlotListQuery): Record<string, unknown> {
+  const filters: Record<string, unknown> = {}
+  if (query.id) filters.id = { $eq: query.id }
+  if (query.supplierEntityId) filters.supplier_entity_id = { $eq: query.supplierEntityId }
+  if (query.plotType) filters.plot_type = { $eq: query.plotType }
+  if (query.originCountry) filters.origin_country = { $eq: query.originCountry.toUpperCase() }
+  const isActive = parseBooleanToken(query.isActive)
+  if (isActive !== null) filters.is_active = { $eq: isActive }
+  const search = typeof query.search === 'string' ? query.search.trim() : ''
+  if (search) {
+    const searchPattern = buildIlikeTerm(search)
+    filters.$or = [
+      { name: { $ilike: searchPattern } },
+      { external_id: { $ilike: searchPattern } },
+    ]
+  }
+  return filters
+}
+
+function transformPlotItem(item: unknown) {
+  if (!item || typeof item !== 'object') return item
+  const record = item as Record<string, unknown>
+  // Bare list items intentionally omit `geometry`; the afterList hook attaches
+  // it (with decryption) for id/ids detail reads only.
+  return {
+    id: record.id,
+    supplierEntityId: record.supplier_entity_id ?? null,
+    supplierSnapshot: record.supplier_snapshot ?? null,
+    name: record.name ?? null,
+    externalId: record.external_id ?? null,
+    originCountry: record.origin_country ?? null,
+    plotType: record.plot_type ?? null,
+    areaHa: record.area_ha ?? null,
+    validationWarnings: stringArray(record.validation_warnings),
+    producerName: record.producer_name ?? null,
+    isActive: typeof record.is_active === 'boolean' ? record.is_active : parseBooleanToken(typeof record.is_active === 'string' ? record.is_active : null),
+    createdAt: toIsoString(record.created_at),
+    updatedAt: toIsoString(record.updated_at),
+  }
+}
+
+const listFields = [
+  'id',
+  'supplier_entity_id',
+  'supplier_snapshot',
+  'name',
+  'external_id',
+  'origin_country',
+  'plot_type',
+  'area_ha',
+  'validation_warnings',
+  'is_active',
+  'created_at',
+  'updated_at',
+]
+
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: EudrPlot,
+    idField: 'id',
+    orgField: 'organizationId',
+    tenantField: 'tenantId',
+    softDeleteField: 'deletedAt',
+  },
+  indexer: { entityType: E.eudr.eudr_plot },
+  list: {
+    schema: listSchema,
+    entityId: E.eudr.eudr_plot,
+    fields: listFields,
+    sortFieldMap: {
+      created_at: 'created_at',
+      createdAt: 'created_at',
+      updated_at: 'updated_at',
+      updatedAt: 'updated_at',
+      name: 'name',
+      area_ha: 'area_ha',
+      areaHa: 'area_ha',
+    },
+    buildFilters,
+    transformItem: transformPlotItem,
+  },
+  actions: {
+    create: {
+      commandId: 'eudr.plots.create',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        const { base, custom } = splitCustomFieldPayload(scoped)
+        const parsed = plotCreateSchema.parse(base)
+        const input = { ...parsed, tenantId: scoped.tenantId, organizationId: scoped.organizationId }
+        return Object.keys(custom).length ? { ...input, customFields: custom } : input
+      },
+      response: ({ result }) => ({ id: result?.entityId ?? result?.id ?? null }),
+      status: 201,
+    },
+    update: {
+      commandId: 'eudr.plots.update',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        const { base, custom } = splitCustomFieldPayload(scoped)
+        const parsed = plotUpdateSchema.parse(base)
+        const input = { ...parsed, tenantId: scoped.tenantId, organizationId: scoped.organizationId }
+        return Object.keys(custom).length ? { ...input, customFields: custom } : input
+      },
+      response: ({ result }) => {
+        const updatedAt = result?.updatedAt
+        return {
+          ok: true,
+          updatedAt: updatedAt instanceof Date ? updatedAt.toISOString() : (typeof updatedAt === 'string' ? updatedAt : null),
+        }
+      },
+    },
+    delete: {
+      commandId: 'eudr.plots.delete',
+      schema: rawBodySchema,
+      mapInput: async ({ parsed, ctx }) => {
+        const { translate } = await resolveTranslations()
+        return resolveDeleteInput(parsed, ctx, translate)
+      },
+      response: () => ({ ok: true }),
+    },
+  },
+  hooks: {
+    afterList: async (payload, ctx) => {
+      const detailRead = (typeof ctx.query.id === 'string' && ctx.query.id.length > 0)
+        || (typeof ctx.query.ids === 'string' && ctx.query.ids.length > 0)
+      if (!detailRead) return
+      const items: unknown[] = Array.isArray(payload?.items) ? payload.items : []
+      if (!items.length) return
+      const scope = resolveDetailReadScope(ctx)
+      if (!scope) return
+      const ids = items
+        .map((item) => (item && typeof item === 'object' ? asStringOrNull((item as Record<string, unknown>).id) : null))
+        .filter((id): id is string => id !== null)
+      if (!ids.length) return
+      const em = ctx.container.resolve('em') as EntityManager
+      const where: FilterQuery<EudrPlot> = {
+        id: { $in: ids },
+        deletedAt: null,
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationFilter,
+      }
+      const decrypted = await findWithDecryption(
+        em,
+        EudrPlot,
+        where,
+        {},
+        { tenantId: scope.tenantId, organizationId: scope.decryptionOrganizationId },
+      )
+      const byId = new Map(decrypted.map((plot) => [plot.id, plot]))
+      for (const item of items) {
+        if (!item || typeof item !== 'object') continue
+        const record = item as Record<string, unknown>
+        const id = asStringOrNull(record.id)
+        const plot = id ? byId.get(id) : null
+        if (!plot) continue
+        record.geometry = plot.geometry ?? null
+        record.producerName = plot.producerName ?? null
+        record.description = plot.description ?? null
+      }
+    },
+  },
+})
+
+export const GET = crud.GET
+export const POST = crud.POST
+export const PUT = crud.PUT
+export const DELETE = crud.DELETE
+
+const plotListItemSchema = z.object({
+  id: z.string().uuid(),
+  supplierEntityId: z.string().uuid().nullable().optional(),
+  supplierSnapshot: z.object({
+    displayName: z.string().nullable().optional(),
+  }).nullable().optional(),
+  name: z.string().nullable().optional(),
+  externalId: z.string().nullable().optional(),
+  originCountry: z.string().nullable().optional(),
+  plotType: z.enum(EUDR_PLOT_TYPES).nullable().optional(),
+  areaHa: z.union([z.string(), z.number()]).nullable().optional(),
+  geometry: z.unknown().nullable().optional().describe(
+    'Present only on detail reads requested with id or ids; omitted from bare paginated list reads.',
+  ),
+  validationWarnings: z.array(z.string()),
+  producerName: z.string().nullable().optional(),
+  isActive: z.boolean().nullable().optional(),
+  createdAt: z.string().nullable().optional(),
+  updatedAt: z.string().nullable().optional(),
+})
+
+export const openApi = createEudrCrudOpenApi({
+  resourceName: 'Plot',
+  querySchema: listSchema,
+  listResponseSchema: createPagedListResponseSchema(plotListItemSchema),
+  create: {
+    schema: plotCreateSchema,
+    description: 'Creates an EUDR supplier plot for the scoped organization.',
+  },
+  update: {
+    schema: plotUpdateSchema,
+    responseSchema: defaultOkResponseSchema,
+    description: 'Updates an EUDR supplier plot.',
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: 'Deletes an EUDR supplier plot by id. Request body or query may provide the identifier.',
+  },
+})