feat(F-112): completed feature

project/frontend/src/app/products/[slug]/page.tsx

@@ -207,6 +207,23 @@ export default async function ProductPage({ params }: Props) {
             </div>
           )}
 
+          {/* Disclaimer IA (F-112) */}
+          {product.aiAssisted && (
+            <aside
+              role="note"
+              aria-label="Aviso sobre contenido generado por IA"
+              className="mt-8 rounded-2xl border border-amber-200 bg-amber-50 p-4 text-sm text-amber-900"
+            >
+              <p className="font-semibold mb-1">Aviso sobre el contenido de esta ficha</p>
+              <p className="mb-2">
+                Parte del contenido de esta ficha puede haber sido generado o asistido mediante inteligencia artificial y revisado antes de su publicación.
+              </p>
+              <p>
+                Composición y características pueden cambiar, consultar etiqueta del fabricante.
+              </p>
+            </aside>
+          )}
+
           {/* Categories */}
           {productCats.length > 0 && (
             <div className="mt-6">

project/frontend/src/types/api.ts

@@ -38,6 +38,7 @@ export interface Product {
   imageUrl?: string;
   unitWeightKg?: number;
   minPurchaseQty?: number;
+  aiAssisted?: boolean;
 }
 
 export interface Category {

project/migrations/040_product_ai_assisted.js

@@ -0,0 +1,20 @@
+/**
+ * Adds `ai_assisted boolean NOT NULL DEFAULT false` to catalog_products so the
+ * storefront can render a disclaimer when the product was authored or
+ * assisted by AI (F-112).
+ *
+ * @param {import('node-pg-migrate').MigrationBuilder} pgm
+ */
+export const up = (pgm) => {
+  pgm.sql(
+    `ALTER TABLE catalog_products ADD COLUMN IF NOT EXISTS ai_assisted boolean NOT NULL DEFAULT false`,
+  );
+  pgm.sql(
+    `CREATE INDEX IF NOT EXISTS catalog_products_ai_assisted_idx ON catalog_products (ai_assisted) WHERE ai_assisted`,
+  );
+};
+
+export const down = (pgm) => {
+  pgm.sql(`DROP INDEX IF EXISTS catalog_products_ai_assisted_idx`);
+  pgm.sql(`ALTER TABLE catalog_products DROP COLUMN IF EXISTS ai_assisted`);
+};

project/src/modules/catalog/api/catalog.routes.ts

@@ -97,6 +97,7 @@ const newProductSchema = z.object({
   expirationDate: z.iso.date().optional().nullable(),
   unitWeightKg: z.number().positive().max(1000).optional(),
   minPurchaseQty: z.number().int().min(1).max(999).optional(),
+  aiAssisted: z.boolean().optional(),
 });
 
 const productPatchSchema = newProductSchema
@@ -287,7 +288,7 @@ export async function registerCatalogRoutes(
     };
     const promptFor = (template: string | undefined, fallback: string) =>
       (template || fallback).replace(/\{\{(name|description|brand)\}\}/g, (_, key: string) => replacements[key] ?? '');
-    const patch: { description?: string; seoTitle?: string; seoDescription?: string } = {};
+    const patch: { description?: string; seoTitle?: string; seoDescription?: string; aiAssisted?: boolean } = {};
     if (!product.description?.trim()) {
       const raw = await generateWithModel(baseUrl, model, apiKey, promptFor(settings.ai_product_description_prompt, 'Escribe una descripción comercial clara y útil en español para este producto: {{name}}. Devuelve SOLO HTML válido y seguro (párrafos <p>, y si procede listas <ul><li> y <strong> para resaltar). No uses títulos ni markdown.'));
       patch.description = aiTextToHtml(raw).slice(0, 4_000);
@@ -298,6 +299,10 @@ export async function registerCatalogRoutes(
     if (!product.seoDescription?.trim()) {
       patch.seoDescription = (await generateWithModel(baseUrl, model, apiKey, promptFor(settings.ai_seo_description_prompt, 'Genera una meta descripción SEO en español para {{name}}. Devuelve solo la descripción.'))).replace(/<[^>]*>/g, '').trim().slice(0, 500);
     }
+    if (Object.keys(patch).length > 0) {
+      // F-112: cualquier generación automática marca la ficha como asistida por IA.
+      patch.aiAssisted = true;
+    }
     const updated = await repository.update(id, patch);
     return reply.send(serializeProduct(updated ?? product));
   });
@@ -775,6 +780,7 @@ function serializeProduct(product: Product, images: ProductImage[] = []) {
     expirationDate: product.expirationDate,
     unitWeightKg: product.unitWeightKg,
     minPurchaseQty: product.minPurchaseQty,
+    aiAssisted: product.aiAssisted,
     createdAt: product.createdAt.toISOString(),
     updatedAt: product.updatedAt.toISOString(),
   };

project/src/modules/catalog/domain/product.ts

@@ -55,6 +55,8 @@ export interface Product {
   unitWeightKg: number;
   /** Cantidad mínima de compra; el frontend bloquea pedidos por debajo. */
   minPurchaseQty: number;
+  /** F-112: marcado cuando la ficha fue asistida por IA y debe mostrar disclaimer. */
+  aiAssisted: boolean;
   createdAt: Date;
   updatedAt: Date;
 }
@@ -74,6 +76,7 @@ export interface NewProduct {
   expirationDate?: string | null;
   unitWeightKg?: number;
   minPurchaseQty?: number;
+  aiAssisted?: boolean;
 }
 
 /** Fields a product update may set. Undefined = leave unchanged. */

project/src/modules/catalog/infrastructure/pg-product-repository.ts

@@ -28,6 +28,7 @@ export interface ProductRow {
   expiration_date: string | null;
   unit_weight_kg: string | number;
   min_purchase_qty: number;
+  ai_assisted: boolean;
   created_at: Date;
   updated_at: Date;
 }
@@ -58,6 +59,7 @@ const UPDATABLE: ReadonlyArray<[keyof ProductPatch, string]> = [
   ['brandId', 'brand_id'],
   ['expirationDate', 'expiration_date'],
   ['unitWeightKg', 'unit_weight_kg'],
+  ['aiAssisted', 'ai_assisted'],
   ['minPurchaseQty', 'min_purchase_qty'],
 ];
 
@@ -97,8 +99,8 @@ export class PgProductRepository implements ProductRepository {
     try {
       await client.query('BEGIN');
       const result = await client.query<ProductRow>(
-        `INSERT INTO catalog_products (name, slug, description, state, seo_title, seo_description, brand_id, expiration_date, unit_weight_kg, min_purchase_qty)
-         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
+        `INSERT INTO catalog_products (name, slug, description, state, seo_title, seo_description, brand_id, expiration_date, unit_weight_kg, min_purchase_qty, ai_assisted)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)
          RETURNING *, ARRAY[]::uuid[] AS category_ids`,
         [
           input.name,
@@ -111,6 +113,7 @@ export class PgProductRepository implements ProductRepository {
           input.expirationDate ?? null,
           input.unitWeightKg ?? 1,
           input.minPurchaseQty ?? 1,
+          input.aiAssisted ?? false,
         ],
       );
       const row = result.rows[0];
@@ -313,6 +316,7 @@ export function toProduct(row: ProductRow): Product {
     categoryIds: row.category_ids ?? [],
     expirationDate: row.expiration_date ?? null,
     unitWeightKg: Number(row.unit_weight_kg ?? 1),
+    aiAssisted: row.ai_assisted ?? false,
     minPurchaseQty: row.min_purchase_qty ?? 1,
     createdAt: row.created_at,
     updatedAt: row.updated_at,

project/src/modules/catalog/tests/image-use-cases.test.ts

@@ -19,6 +19,7 @@ function product(input: Partial<Product> & Pick<Product, 'id' | 'name' | 'slug'>
     expirationDate: null,
     unitWeightKg: 1,
     minPurchaseQty: 1,
+    aiAssisted: false,
     createdAt: new Date('2026-01-01T00:00:00Z'),
     updatedAt: new Date('2026-01-01T00:00:00Z'),
     ...input,

project/src/modules/catalog/tests/product-use-cases.test.ts

@@ -23,6 +23,7 @@ function product(input: Partial<Product> & Pick<Product, 'id' | 'name' | 'slug'>
     expirationDate: null,
     unitWeightKg: 1,
     minPurchaseQty: 1,
+    aiAssisted: false,
     createdAt: new Date('2026-01-01T00:00:00Z'),
     updatedAt: new Date('2026-01-01T00:00:00Z'),
     ...input,