feat: Introduce combo readiness checks and strategy recommendations, updating i18n messages and e2e tests.

Author: diegosouzapw

src/app/(dashboard)/dashboard/combos/page.tsx

@@ -646,7 +646,68 @@
     "pricingMissingShort": "رسم",
     "warningRoundRobinSingleModel": "يعتبر Round - robin أكثر فائدة مع طرازين على الأقل.",
     "warningCostOptimizedPartialPricing": "فقط {priced} من طرازات {total} لها أسعار. قد يكون التوجيه مدركًا جزئيًا للتكلفة.",
-    "warningCostOptimizedNoPricing": "لم يتم العثور على بيانات تسعير لهذه المجموعة. قد يتم توجيه التكلفة المحسّنة بشكل غير متوقع."
+    "warningCostOptimizedNoPricing": "لم يتم العثور على بيانات تسعير لهذه المجموعة. قد يتم توجيه التكلفة المحسّنة بشكل غير متوقع.",
+    "readinessTitle": "هل أنت مستعد للحفظ؟",
+    "readinessDescription": "قم بمراجعة قائمة التحقق قبل إنشاء هذا التحرير والسرد أو تحديثه.",
+    "readinessCheckName": "اسم التحرير والسرد صالح",
+    "readinessCheckModels": "تم تحديد نموذج واحد على الأقل",
+    "readinessCheckWeights": "الإجمالي المرجح هو 100%",
+    "readinessCheckWeightsOptional": "قاعدة الوزن غير مطلوبة",
+    "readinessCheckPricing": "بيانات التسعير متاحة",
+    "readinessCheckPricingOptional": "قاعدة التسعير غير مطلوبة",
+    "saveBlockedTitle": "تم حظر الحفظ حتى يتم إصلاح العناصر التالية:",
+    "saveBlockName": "تحديد اسم التحرير والسرد.",
+    "saveBlockModels": "أضف نموذجًا واحدًا على الأقل.",
+    "saveBlockWeighted": "اضبط الأوزان على 100% (الحالي: {total}%).",
+    "saveBlockPricing": "أضف أسعارًا لنموذج واحد على الأقل أو اختر استراتيجية مختلفة.",
+    "recommendationsLabel": "Recommended setup",
+    "applyRecommendations": "Apply recommendations",
+    "recommendationsUpdated": "Recommendations updated for {strategy}.",
+    "recommendationsApplied": "Recommendations applied to this combo.",
+    "strategyRecommendations": {
+      "priority": {
+        "title": "Fail-safe baseline",
+        "description": "Use one primary model and keep fallback chain short and reliable.",
+        "tip1": "Put your most reliable model first.",
+        "tip2": "Keep 1-2 backup models with similar quality.",
+        "tip3": "Use safe retries to absorb transient provider failures."
+      },
+      "weighted": {
+        "title": "Controlled traffic split",
+        "description": "Great for canary rollouts and gradual migration between models.",
+        "tip1": "Start with conservative split like 90/10.",
+        "tip2": "Keep the total at 100% and auto-balance after changes.",
+        "tip3": "Monitor success and latency before increasing canary weight."
+      },
+      "round-robin": {
+        "title": "Predictable load sharing",
+        "description": "Best when models are equivalent and you need smooth distribution.",
+        "tip1": "Use at least 2 models.",
+        "tip2": "Set concurrency limits to avoid burst overload.",
+        "tip3": "Use queue timeout to fail fast under saturation."
+      },
+      "random": {
+        "title": "Quick spread with low setup",
+        "description": "Use when you need simple distribution without strict guarantees.",
+        "tip1": "Use models with similar latency profiles.",
+        "tip2": "Keep retries enabled to absorb random misses.",
+        "tip3": "Prefer this for experimentation, not strict SLAs."
+      },
+      "least-used": {
+        "title": "Adaptive balancing",
+        "description": "Routes to less-used models to reduce hotspots over time.",
+        "tip1": "Works better under continuous traffic.",
+        "tip2": "Combine with health checks for safer balancing.",
+        "tip3": "Track per-model usage to validate distribution gains."
+      },
+      "cost-optimized": {
+        "title": "Budget-first routing",
+        "description": "Routes to lower-cost models when pricing metadata is available.",
+        "tip1": "Ensure pricing coverage for all selected models.",
+        "tip2": "Keep a quality fallback for hard prompts.",
+        "tip3": "Use for batch/background jobs where cost is the main KPI."
+      }
+    }
   },
   "costs": {
     "title": "التكاليف",

src/i18n/messages/ar.json

@@ -646,7 +646,68 @@
     "pricingMissingShort": "без цена",
     "warningRoundRobinSingleModel": "Round - robin е най - полезен с поне 2 модела.",
     "warningCostOptimizedPartialPricing": "Само {priced} от {total} моделите имат ценообразуване. Маршрутизирането може да бъде частично съобразено с разходите.",
-    "warningCostOptimizedNoPricing": "Няма намерени данни за ценообразуване за тази комбинация. Оптимизираният по отношение на разходите маршрут може да е неочакван."
+    "warningCostOptimizedNoPricing": "Няма намерени данни за ценообразуване за тази комбинация. Оптимизираният по отношение на разходите маршрут може да е неочакван.",
+    "readinessTitle": "Готови ли сте да запазите?",
+    "readinessDescription": "Прегледайте контролния списък, преди да създадете или актуализирате тази комбинация.",
+    "readinessCheckName": "Комбо името е валидно",
+    "readinessCheckModels": "Избран е поне един модел",
+    "readinessCheckWeights": "Претеглената обща сума е 100%",
+    "readinessCheckWeightsOptional": "Правилото за тегло не се изисква",
+    "readinessCheckPricing": "Налични са данни за цените",
+    "readinessCheckPricingOptional": "Правилото за ценообразуване не се изисква",
+    "saveBlockedTitle": "Запазването е блокирано, докато не бъдат коригирани следните елементи:",
+    "saveBlockName": "Определете комбо име.",
+    "saveBlockModels": "Добавете поне един модел.",
+    "saveBlockWeighted": "Задайте тегла на 100% (текущо: {total}%).",
+    "saveBlockPricing": "Добавете цена за поне един модел или изберете различна стратегия.",
+    "recommendationsLabel": "Recommended setup",
+    "applyRecommendations": "Apply recommendations",
+    "recommendationsUpdated": "Recommendations updated for {strategy}.",
+    "recommendationsApplied": "Recommendations applied to this combo.",
+    "strategyRecommendations": {
+      "priority": {
+        "title": "Fail-safe baseline",
+        "description": "Use one primary model and keep fallback chain short and reliable.",
+        "tip1": "Put your most reliable model first.",
+        "tip2": "Keep 1-2 backup models with similar quality.",
+        "tip3": "Use safe retries to absorb transient provider failures."
+      },
+      "weighted": {
+        "title": "Controlled traffic split",
+        "description": "Great for canary rollouts and gradual migration between models.",
+        "tip1": "Start with conservative split like 90/10.",
+        "tip2": "Keep the total at 100% and auto-balance after changes.",
+        "tip3": "Monitor success and latency before increasing canary weight."
+      },
+      "round-robin": {
+        "title": "Predictable load sharing",
+        "description": "Best when models are equivalent and you need smooth distribution.",
+        "tip1": "Use at least 2 models.",
+        "tip2": "Set concurrency limits to avoid burst overload.",
+        "tip3": "Use queue timeout to fail fast under saturation."
+      },
+      "random": {
+        "title": "Quick spread with low setup",
+        "description": "Use when you need simple distribution without strict guarantees.",
+        "tip1": "Use models with similar latency profiles.",
+        "tip2": "Keep retries enabled to absorb random misses.",
+        "tip3": "Prefer this for experimentation, not strict SLAs."
+      },
+      "least-used": {
+        "title": "Adaptive balancing",
+        "description": "Routes to less-used models to reduce hotspots over time.",
+        "tip1": "Works better under continuous traffic.",
+        "tip2": "Combine with health checks for safer balancing.",
+        "tip3": "Track per-model usage to validate distribution gains."
+      },
+      "cost-optimized": {
+        "title": "Budget-first routing",
+        "description": "Routes to lower-cost models when pricing metadata is available.",
+        "tip1": "Ensure pricing coverage for all selected models.",
+        "tip2": "Keep a quality fallback for hard prompts.",
+        "tip3": "Use for batch/background jobs where cost is the main KPI."
+      }
+    }
   },
   "costs": {
     "title": "Разходи",

src/i18n/messages/bg.json

@@ -646,7 +646,68 @@
     "pricingMissingShort": "ingen pris",
     "warningRoundRobinSingleModel": "Round-robin er mest nyttig med mindst 2 modeller.",
     "warningCostOptimizedPartialPricing": "Kun {priced} af {total}-modeller har priser. Routing kan være delvist omkostningsbevidst.",
-    "warningCostOptimizedNoPricing": "Der blev ikke fundet nogen prisdata for denne kombination. Omkostningsoptimeret kan rute uventet."
+    "warningCostOptimizedNoPricing": "Der blev ikke fundet nogen prisdata for denne kombination. Omkostningsoptimeret kan rute uventet.",
+    "readinessTitle": "Klar til at spare?",
+    "readinessDescription": "Gennemgå tjeklisten, før du opretter eller opdaterer denne kombination.",
+    "readinessCheckName": "Kombinationsnavnet er gyldigt",
+    "readinessCheckModels": "Der er valgt mindst én model",
+    "readinessCheckWeights": "Vægtet total er 100 %",
+    "readinessCheckWeightsOptional": "Vægtregel ikke påkrævet",
+    "readinessCheckPricing": "Prisdata er tilgængelige",
+    "readinessCheckPricingOptional": "Reglen om prissætning er ikke påkrævet",
+    "saveBlockedTitle": "Gem er blokeret, indtil følgende elementer er rettet:",
+    "saveBlockName": "Definer et kombinationsnavn.",
+    "saveBlockModels": "Tilføj mindst én model.",
+    "saveBlockWeighted": "Indstil vægte til 100 % (aktuelt: {total}%).",
+    "saveBlockPricing": "Tilføj priser for mindst én model, eller vælg en anden strategi.",
+    "recommendationsLabel": "Recommended setup",
+    "applyRecommendations": "Apply recommendations",
+    "recommendationsUpdated": "Recommendations updated for {strategy}.",
+    "recommendationsApplied": "Recommendations applied to this combo.",
+    "strategyRecommendations": {
+      "priority": {
+        "title": "Fail-safe baseline",
+        "description": "Use one primary model and keep fallback chain short and reliable.",
+        "tip1": "Put your most reliable model first.",
+        "tip2": "Keep 1-2 backup models with similar quality.",
+        "tip3": "Use safe retries to absorb transient provider failures."
+      },
+      "weighted": {
+        "title": "Controlled traffic split",
+        "description": "Great for canary rollouts and gradual migration between models.",
+        "tip1": "Start with conservative split like 90/10.",
+        "tip2": "Keep the total at 100% and auto-balance after changes.",
+        "tip3": "Monitor success and latency before increasing canary weight."
+      },
+      "round-robin": {
+        "title": "Predictable load sharing",
+        "description": "Best when models are equivalent and you need smooth distribution.",
+        "tip1": "Use at least 2 models.",
+        "tip2": "Set concurrency limits to avoid burst overload.",
+        "tip3": "Use queue timeout to fail fast under saturation."
+      },
+      "random": {
+        "title": "Quick spread with low setup",
+        "description": "Use when you need simple distribution without strict guarantees.",
+        "tip1": "Use models with similar latency profiles.",
+        "tip2": "Keep retries enabled to absorb random misses.",
+        "tip3": "Prefer this for experimentation, not strict SLAs."
+      },
+      "least-used": {
+        "title": "Adaptive balancing",
+        "description": "Routes to less-used models to reduce hotspots over time.",
+        "tip1": "Works better under continuous traffic.",
+        "tip2": "Combine with health checks for safer balancing.",
+        "tip3": "Track per-model usage to validate distribution gains."
+      },
+      "cost-optimized": {
+        "title": "Budget-first routing",
+        "description": "Routes to lower-cost models when pricing metadata is available.",
+        "tip1": "Ensure pricing coverage for all selected models.",
+        "tip2": "Keep a quality fallback for hard prompts.",
+        "tip3": "Use for batch/background jobs where cost is the main KPI."
+      }
+    }
   },
   "costs": {
     "title": "Omkostninger",

src/i18n/messages/da.json

@@ -646,7 +646,68 @@
     "pricingMissingShort": "kein Preis",
     "warningRoundRobinSingleModel": "Round-Robin ist bei mindestens zwei Modellen am nützlichsten.",
     "warningCostOptimizedPartialPricing": "Nur {priced} der {total} Modelle haben Preise. Die Routenplanung kann teilweise kostenbewusst erfolgen.",
-    "warningCostOptimizedNoPricing": "Für diese Kombination wurden keine Preisdaten gefunden. Eine kostenoptimierte Route kann unerwartet erfolgen."
+    "warningCostOptimizedNoPricing": "Für diese Kombination wurden keine Preisdaten gefunden. Eine kostenoptimierte Route kann unerwartet erfolgen.",
+    "readinessTitle": "Bereit zum Speichern?",
+    "readinessDescription": "Prüfe die Checkliste, bevor du dieses Combo erstellst oder aktualisierst.",
+    "readinessCheckName": "Der Combo-Name ist gültig",
+    "readinessCheckModels": "Mindestens ein Modell ist ausgewählt",
+    "readinessCheckWeights": "Die Gewichtssumme beträgt 100 %",
+    "readinessCheckWeightsOptional": "Gewichtungsregel nicht erforderlich",
+    "readinessCheckPricing": "Preisdaten sind verfügbar",
+    "readinessCheckPricingOptional": "Preisregel nicht erforderlich",
+    "saveBlockedTitle": "Speichern ist blockiert, bis diese Punkte behoben sind:",
+    "saveBlockName": "Definiere einen Namen für das Combo.",
+    "saveBlockModels": "Füge mindestens ein Modell hinzu.",
+    "saveBlockWeighted": "Setze die Gewichte auf 100 % (aktuell: {total} %).",
+    "saveBlockPricing": "Füge Preise für mindestens ein Modell hinzu oder wähle eine andere Strategie.",
+    "recommendationsLabel": "Empfohlene Konfiguration",
+    "applyRecommendations": "Empfehlungen anwenden",
+    "recommendationsUpdated": "Empfehlungen für {strategy} aktualisiert.",
+    "recommendationsApplied": "Empfehlungen für dieses Combo wurden angewendet.",
+    "strategyRecommendations": {
+      "priority": {
+        "title": "Ausfallsichere Basis",
+        "description": "Nutze ein primäres Modell und halte die Fallback-Kette kurz und zuverlässig.",
+        "tip1": "Setze dein zuverlässigstes Modell an erste Stelle.",
+        "tip2": "Nutze 1-2 Backup-Modelle mit ähnlicher Qualität.",
+        "tip3": "Aktiviere sichere Retries, um temporäre Provider-Fehler abzufangen."
+      },
+      "weighted": {
+        "title": "Kontrollierte Traffic-Aufteilung",
+        "description": "Ideal für Canary-Rollouts und schrittweise Modellmigrationen.",
+        "tip1": "Starte mit einer konservativen Verteilung wie 90/10.",
+        "tip2": "Halte die Summe bei 100 % und gleiche nach Änderungen automatisch aus.",
+        "tip3": "Überwache Erfolg und Latenz, bevor du Canary-Gewichte erhöhst."
+      },
+      "round-robin": {
+        "title": "Vorhersehbare Lastverteilung",
+        "description": "Am besten, wenn Modelle gleichwertig sind und du eine stabile Verteilung brauchst.",
+        "tip1": "Nutze mindestens 2 Modelle.",
+        "tip2": "Setze Concurrency-Limits, um Lastspitzen zu vermeiden.",
+        "tip3": "Nutze Queue-Timeouts, um bei Sättigung schnell zu scheitern."
+      },
+      "random": {
+        "title": "Schnelle Verteilung mit wenig Setup",
+        "description": "Für einfache Verteilung ohne harte Garantien.",
+        "tip1": "Nutze Modelle mit ähnlichen Latenzprofilen.",
+        "tip2": "Lass Retries aktiv, um zufällige Fehlschläge abzufangen.",
+        "tip3": "Gut für Experimente, nicht für strenge SLAs."
+      },
+      "least-used": {
+        "title": "Adaptives Balancing",
+        "description": "Routet zu weniger genutzten Modellen und reduziert Hotspots über Zeit.",
+        "tip1": "Funktioniert besser bei kontinuierlichem Traffic.",
+        "tip2": "Kombiniere mit Health Checks für sichereres Balancing.",
+        "tip3": "Verfolge Nutzung pro Modell, um Verteilungsgewinne zu validieren."
+      },
+      "cost-optimized": {
+        "title": "Kostenorientiertes Routing",
+        "description": "Routet zu günstigeren Modellen, wenn Preisdaten verfügbar sind.",
+        "tip1": "Sichere Preisabdeckung für alle ausgewählten Modelle.",
+        "tip2": "Behalte einen Qualitäts-Fallback für schwierige Prompts.",
+        "tip3": "Ideal für Batch/Hintergrundjobs, bei denen Kosten das Haupt-KPI sind."
+      }
+    }
   },
   "costs": {
     "title": "Kosten",