src.llm_interpreter.analysis.business_insights

Business insights engine for executive reporting.

This module calculates business-focused metrics like ROI, opportunity sizing, and generates strategic recommendations for CMOs and senior marketers.

Author: AMMM Team Created: 2025-04-10 Last Modified: 2025-04-10

Module Contents

class src.llm_interpreter.analysis.business_insights.Priority(*args, **kwds)

Bases: enum.Enum

Priority levels for strategic recommendations.

class src.llm_interpreter.analysis.business_insights.RiskLevel(*args, **kwds)

Bases: enum.Enum

Risk levels for recommendations.

class src.llm_interpreter.analysis.business_insights.ChannelROI

ROI metrics for a channel.

class src.llm_interpreter.analysis.business_insights.OpportunitySizing

Opportunity sizing for budget optimization.

class src.llm_interpreter.analysis.business_insights.StrategicRecommendation

A strategic business recommendation.

class src.llm_interpreter.analysis.business_insights.QuickWin

Quick win opportunity.

class src.llm_interpreter.analysis.business_insights.BusinessInsightsEngine(insights: src.llm_interpreter.analysis.insights.StructuredInsights, business_context: src.llm_interpreter.inputs.config_parser.BusinessContext, csv_data: src.llm_interpreter.inputs.schema_map.AllCSVData)

Generates business-focused insights for executive reporting.

Calculates ROI, identifies opportunities, and generates strategic recommendations.

calculate_channel_roi() → list[ChannelROI]

Calculate ROI for all channels.

size_optimization_opportunity() → OpportunitySizing | None

Size the budget optimization opportunity.

generate_strategic_recommendations() → list[StrategicRecommendation]

Generate prioritized strategic recommendations.

identify_quick_wins() → list[QuickWin]

Identify quick win opportunities.

generate_executive_summary() → str

Generate 1-paragraph executive summary.

src.llm_interpreter.analysis.business_insights.analyze_business_insights(insights: src.llm_interpreter.analysis.insights.StructuredInsights, business_context: src.llm_interpreter.inputs.config_parser.BusinessContext, csv_data: src.llm_interpreter.inputs.schema_map.AllCSVData) → BusinessInsightsEngine

Analyze business insights from technical analysis.

Parameters:

  • insights – Technical insights from analysis engine

  • business_context – Business context from config

  • csv_data – Raw CSV data for detailed metrics

Returns:

BusinessInsightsEngine with calculated metrics