feat(F-096): completed feature

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

@@ -257,6 +257,43 @@ export async function registerCatalogRoutes(
     return reply.send(serializeProduct(product, productImages));
   });
 
+  app.post('/products/:id/generate-seo', async (request, reply) => {
+    const user = await deps.authenticate(request);
+    requireRole(user, 'admin');
+    const { id } = parseJson(idParamSchema, request.params);
+    const product = await repository.findById(id);
+    if (!product) throw new AppError(404, 'NOT_FOUND', 'Product not found');
+
+    const settingsResult = await deps.pool.query<{ key: string; value: string }>(
+      `SELECT key, value FROM store_settings WHERE key = ANY($1::text[])`,
+      [['ai_base_url', 'ai_model', 'ai_api_key', 'ai_seo_title_prompt', 'ai_seo_description_prompt']],
+    );
+    const settings = Object.fromEntries(settingsResult.rows.map((row) => [row.key, row.value]));
+    const baseUrl = settings.ai_base_url?.trim();
+    const model = settings.ai_model?.trim();
+    const apiKey = settings.ai_api_key?.trim();
+    if (!baseUrl || !model || !apiKey) {
+      throw new AppError(422, 'AI_NOT_CONFIGURED', 'Configura proveedor, URL base, modelo y API key en Ajustes → IA para SEO');
+    }
+
+    const replacements: Record<string, string> = {
+      name: product.name,
+      description: product.description ?? '',
+      brand: product.brand?.name ?? '',
+    };
+    const promptFor = (template: string | undefined, fallback: string) =>
+      (template || fallback).replace(/\{\{(name|description|brand)\}\}/g, (_, key: string) => replacements[key] ?? '');
+    const patch: { seoTitle?: string; seoDescription?: string } = {};
+    if (!product.seoTitle?.trim()) {
+      patch.seoTitle = (await generateWithModel(baseUrl, model, apiKey, promptFor(settings.ai_seo_title_prompt, 'Genera un título SEO breve para {{name}}. Devuelve solo el título.'))).slice(0, 200);
+    }
+    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.'))).slice(0, 500);
+    }
+    const updated = await repository.update(id, patch);
+    return reply.send(serializeProduct(updated ?? product));
+  });
+
   const searchSchema: FastifySchema = {
     tags: ['Catalog'],
     summary: 'Search products (público)',
@@ -635,6 +672,20 @@ function mapProductError(error: unknown): Error {
   return error instanceof Error ? error : new Error('Unknown product error');
 }
 
+async function generateWithModel(baseUrl: string, model: string, apiKey: string, prompt: string): Promise<string> {
+  const response = await fetch(`${baseUrl.replace(/\/$/, '')}/chat/completions`, {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+    body: JSON.stringify({ model, messages: [{ role: 'user', content: prompt }], temperature: 0.4 }),
+    signal: AbortSignal.timeout(30_000),
+  });
+  const payload = await response.json().catch(() => null) as { choices?: Array<{ message?: { content?: unknown } }>; error?: { message?: string } } | null;
+  if (!response.ok) throw new AppError(502, 'AI_PROVIDER_ERROR', payload?.error?.message ?? `El proveedor IA respondió ${response.status}`);
+  const content = payload?.choices?.[0]?.message?.content;
+  if (typeof content !== 'string' || !content.trim()) throw new AppError(502, 'AI_EMPTY_RESPONSE', 'El modelo IA no devolvió contenido');
+  return content.trim();
+}
+
 function sanitizeSearchTelemetryQuery(query: string | undefined): string | undefined {
   if (query === undefined) {
     return undefined;

project/src/modules/store-settings/api/settings.routes.ts

@@ -21,6 +21,12 @@ const updateSettingsSchema = z.object({
   footerText: z.string().max(400).optional(),
   facebookUrl: z.string().url().optional().or(z.literal('')),
   instagramUrl: z.string().url().optional().or(z.literal('')),
+  aiProvider: z.string().max(80).optional(),
+  aiBaseUrl: z.string().url().optional().or(z.literal('')),
+  aiModel: z.string().max(120).optional(),
+  aiApiKey: z.string().max(500).optional(),
+  aiSeoTitlePrompt: z.string().max(2000).optional(),
+  aiSeoDescriptionPrompt: z.string().max(4000).optional(),
 });
 
 const SETTING_KEYS: Record<string, string> = {
@@ -32,6 +38,12 @@ const SETTING_KEYS: Record<string, string> = {
   footerText: 'footer_text',
   facebookUrl: 'facebook_url',
   instagramUrl: 'instagram_url',
+  aiProvider: 'ai_provider',
+  aiBaseUrl: 'ai_base_url',
+  aiModel: 'ai_model',
+  aiApiKey: 'ai_api_key',
+  aiSeoTitlePrompt: 'ai_seo_title_prompt',
+  aiSeoDescriptionPrompt: 'ai_seo_description_prompt',
 };
 
 export async function registerStoreSettingsRoutes(
@@ -63,6 +75,13 @@ export async function registerStoreSettingsRoutes(
       footerText: map['footer_text'] ?? '',
       facebookUrl: map['facebook_url'] ?? '',
       instagramUrl: map['instagram_url'] ?? '',
+      aiProvider: map['ai_provider'] ?? '',
+      aiBaseUrl: map['ai_base_url'] ?? '',
+      aiModel: map['ai_model'] ?? '',
+      aiApiKey: '',
+      aiApiKeyConfigured: Boolean(map['ai_api_key']),
+      aiSeoTitlePrompt: map['ai_seo_title_prompt'] ?? 'Genera un título SEO breve y atractivo para este producto: {{name}}. Devuelve solo el título.',
+      aiSeoDescriptionPrompt: map['ai_seo_description_prompt'] ?? 'Genera una meta descripción SEO en español, clara y persuasiva, para este producto: {{name}}. Devuelve solo la descripción.',
     });
   });
 
@@ -118,6 +137,13 @@ export async function registerStoreSettingsRoutes(
       footerText: map['footer_text'] ?? '',
       facebookUrl: map['facebook_url'] ?? '',
       instagramUrl: map['instagram_url'] ?? '',
+      aiProvider: map['ai_provider'] ?? '',
+      aiBaseUrl: map['ai_base_url'] ?? '',
+      aiModel: map['ai_model'] ?? '',
+      aiApiKey: '',
+      aiApiKeyConfigured: Boolean(map['ai_api_key']),
+      aiSeoTitlePrompt: map['ai_seo_title_prompt'] ?? 'Genera un título SEO breve y atractivo para este producto: {{name}}. Devuelve solo el título.',
+      aiSeoDescriptionPrompt: map['ai_seo_description_prompt'] ?? 'Genera una meta descripción SEO en español, clara y persuasiva, para este producto: {{name}}. Devuelve solo la descripción.',
     });
   });
 }