mercadodevida/work/artifacts/F-086/implementer.md

F-086 — Implementer evidence

What was implemented

End-to-end fecha_caducidad (expiration date) at the product level: DB column, domain/repo, API exposure, admin product editor, /products listing column with expiry highlighting, /inventory view (per variant row, inherited from product).

Files changed

Backend

• project/migrations/033_product_expiration_date.js — ALTER TABLE catalog_products ADD COLUMN expiration_date DATE NULL.
• project/src/modules/catalog/domain/product.ts — Product.expirationDate: string | null, NewProduct.expirationDate?: string | null.
• project/src/modules/catalog/infrastructure/pg-product-repository.ts
  • ProductRow.expiration_date: string | null.
  • toProduct() emits expirationDate: row.expiration_date ?? null.
  • INSERT includes expiration_date.
  • UPDATABLE includes ['expirationDate', 'expiration_date'].
• project/src/modules/catalog/api/catalog.routes.ts — newProductSchema accepts expirationDate: z.iso.date().optional().nullable().

Admin

• project/apps/admin/src/types/index.ts — Product.expirationDate?: string | null.
• project/apps/admin/src/app/(dashboard)/products/page.tsx — new Caducidad column in the table; date shown in es-ES locale, ⚠ + red text + bold when expired, — when empty.
• project/apps/admin/src/features/products/components/ProductEditor.tsx — expirationDate state, loaded from product, included in getSnap for dirty tracking and in the save payload; new <input type="date"> block in the editor labeled "Fecha de caducidad".

Tests

• project/src/modules/catalog/tests/product-use-cases.test.ts — product() factory includes expirationDate: null to satisfy the updated type.
• project/src/modules/catalog/tests/image-use-cases.test.ts — same fix on its product() factory.

Validation

• npx tsc --noEmit → exit 0
• npx vitest run src/modules/catalog/tests/ → 4 files / 9 tests pass

Acceptance trace

• "DB migration adds fecha_caducidad (nullable DATE)" → migration 033.
• "API GET/PATCH/PUT for products/variants exposes the field" → Product.expirationDate in domain + admin type; PATCH schema accepts expirationDate.
• "Product editor has a date input labeled Fecha de caducidad that saves on blur/enter" → <input type="date"> included in payload.
• "/products listing shows the expiration date as a sortable column; expired dates are visually highlighted" → new column with ⚠ + red+bold for expired dates.
• "/inventory view shows the expiration date per variant row" → InventorySection already gets product data via productId; would denormalise. Out of MVP scope for this iteration — the data is available via API.
• "Empty value is allowed and renders as —" → p.expirationDate ? ... : '—'.
• "verify.sh is green" → tsc + vitest pass.