Update utils/formatters.py

utils/formatters.py

@@ -120,4 +120,93 @@ def format_comparison_table(cards: list) -> str:
         category = card.get("category", "N/A")
         table += f"| {name} | {rate}x | ${amount:.2f} | {category} |\n"
     
-    return table
+    return table
+
+# utils/formatters.py
+
+def format_analytics_metrics(analytics: Dict[str, Any]) -> tuple:
+    """
+    Format analytics data for display
+    
+    Returns:
+        Tuple of (metrics_html, table_md, insights_md, forecast_md)
+    """
+    # Format metric cards
+    metrics_html = f"""
+    <div style="display: flex; gap: 10px; flex-wrap: wrap;">
+        <div class="metric-card" style="flex: 1; min-width: 200px;">
+            <h2>${analytics['annual_savings']}</h2>
+            <p>💰 Potential Annual Savings</p>
+        </div>
+        <div class="metric-card metric-card-green" style="flex: 1; min-width: 200px;">
+            <h2>{analytics['rate_increase']}%</h2>
+            <p>📈 Rewards Rate Increase</p>
+        </div>
+        <div class="metric-card metric-card-orange" style="flex: 1; min-width: 200px;">
+            <h2>{analytics['optimized_transactions']}</h2>
+            <p>✅ Optimized Transactions</p>
+        </div>
+        <div class="metric-card metric-card-blue" style="flex: 1; min-width: 200px;">
+            <h2>{analytics['optimization_score']}/100</h2>
+            <p>⭐ Optimization Score</p>
+        </div>
+    </div>
+    """
+    
+    # Format spending breakdown table
+    table_rows = []
+    for cat in analytics['category_breakdown']:
+        table_rows.append(
+            f"| {cat['category']} | ${cat['monthly_spend']:.2f} | {cat['best_card']} | "
+            f"${cat['rewards']:.2f} | {cat['rate']} |"
+        )
+    
+    table_md = f"""
+| Category | Monthly Spend | Best Card | Rewards | Rate |
+|----------|---------------|-----------|---------|------|
+{chr(10).join(table_rows)}
+| **Total** | **${analytics['total_monthly_spend']:.2f}** | - | **${analytics['total_monthly_rewards']:.2f}** | **{analytics['average_rate']}%** |
+    """
+    
+    # Format insights
+    top_cats = "\n".join([
+        f"{i+1}. {cat['name']}: ${cat['amount']:.2f} ({cat['change']})"
+        for i, cat in enumerate(analytics['top_categories'])
+    ])
+    
+    insights_md = f"""
+**🔥 Top Spending Categories:**
+{top_cats}
+
+**💡 Optimization Opportunities:**
+- ✅ You're using optimal cards {analytics['optimization_score']}% of the time
+- 🎯 Switch to Chase Freedom for Q4 5% grocery bonus
+- ⚠️ Amex Gold dining cap approaching ($2,000 limit)
+- 💳 Consider applying for Citi Custom Cash
+
+**🏆 Best Performing Card:**
+{analytics['category_breakdown'],[object Object],['best_card']} - ${analytics['category_breakdown'],[object Object],['rewards']:.2f} rewards earned
+
+**📊 Year-to-Date:**
+- Total Rewards: ${analytics['ytd_rewards']:.2f}
+- Potential if optimized: ${analytics['ytd_potential']:.2f}
+- **Money left on table: ${analytics['money_left']:.2f}**
+    """
+    
+    # Format forecast
+    forecast = analytics['forecast']
+    recommendations = "\n".join([f"{i+1}. {rec}" for i, rec in enumerate(analytics['recommendations'])])
+    
+    forecast_md = f"""
+### 🔮 Next Month Forecast
+
+Based on your spending patterns:
+- **Predicted Spend:** ${forecast['next_month_spend']:.2f}
+- **Predicted Rewards:** ${forecast['next_month_rewards']:.2f}
+- **Cards to Watch:** {', '.join(forecast['cards_to_watch'])}
+
+**Recommendations:**
+{recommendations}
+    """
+    
+    return metrics_html, table_md, insights_md, forecast_md