Proeycto de images-worker creado

mvp/image-worker/skills/reformix-api.md

@@ -0,0 +1,40 @@
+# API de la app principal Reformix
+
+## Responsabilidad
+Entregar los renders generados al endpoint /ingesta de la app Reformix.
+
+## Endpoint
+POST {REFORMIX_API_URL}/api/leads/{leadId}/ingesta
+Authorization: Bearer {FUNNEL_API_KEY}
+Content-Type: application/json
+
+## Body
+{
+  "items": [
+    {
+      "tipo": "foto",
+      "zona": "cocina",       // zona que se procesó
+      "momento": "despues",   // siempre "despues" para renders generados
+      "imagen": "data:image/png;base64,..."
+    }
+    // un item por cada zona procesada
+  ],
+  "finalizar": true   // siempre true, dispara PDF + email + WhatsApp
+}
+
+## Enums válidos (no usar otros valores)
+tipo item: "foto" | "texto"
+momento: "antes" | "despues"
+zona: "cocina" | "bano" | "salon" | "comedor" | "integral" | "otro"
+
+## Códigos de respuesta
+200 { ok: true } → éxito
+401 → FUNNEL_API_KEY incorrecta
+404 → leadId no existe, no reintentar
+422 → payload mal formado, revisar el body
+
+## Reintentos
+En caso de error 5xx o error de red:
+→ reintentar 3 veces con 2 segundos de espera entre intentos
+→ si sigue fallando, loguear como error crítico con el leadId
+→ nunca reintentar en caso de 404