modules/planning.py

from typing import List, Dict, Any

def plan_campaign_budget(total_budget: float, platforms: List[str]) -> Dict[str, Any]:
    """
    Suggests budget allocation across multiple platforms.
    """
    # Industry standard allocations (Simplified)
    weights = {
        "google": 0.40,
        "meta": 0.35,
        "tiktok": 0.15,
        "linkedin": 0.10,
        "twitter": 0.05
    }
    
    total_weight = sum(weights.get(p.lower(), 0.10) for p in platforms)
    allocation = {}
    
    for p in platforms:
        p_lower = p.lower()
        weight = weights.get(p_lower, 0.10)
        percentage = weight / total_weight
        allocation[p] = {
            "budget": round(total_budget * percentage, 2),
            "percentage": f"{percentage*100:.1f}%"
        }
        
    return allocation

def calculate_ad_math(spend: float, clicks: int, conversions: int, revenue: float) -> Dict[str, Any]:
    """
    Calculates key advertising metrics.
    """
    cpc = spend / clicks if clicks > 0 else 0
    cpa = spend / conversions if conversions > 0 else 0
    roas = revenue / spend if spend > 0 else 0
    cr = (conversions / clicks) * 100 if clicks > 0 else 0
    
    return {
        "cpc": round(cpc, 2),
        "cpa": round(cpa, 2),
        "roas": round(roas, 2),
        "conversion_rate": f"{cr:.2f}%"
    }