# Business Metrics Dashboard

## Overview

The business metrics dashboard provides real-time visibility into key performance indicators across user engagement, conversion, revenue, and content performance.

## Dashboard Endpoint

```http
GET /v1/metrics/dashboards/business
Authorization: Bearer <token>
```

## Dashboard Response Structure

```json
{
  "dashboard_type": "business",
  "generated_at": "2024-01-01T12:00:00Z",
  "period": "current",
  "kpis": {
    "user_engagement": {
      "dau": 2847,
      "wau": 15632,
      "mau": 45891,
      "dau_growth_rate": 12.5,
      "retention_7d": 68.3,
      "retention_30d": 42.1
    },
    "conversion": {
      "signup_conversion_24h": 3.2,
      "chat_engagement_rate": 78.5,
      "voice_adoption_rate": 34.7,
      "premium_conversion_rate": 8.9
    },
    "revenue": {
      "revenue_30d_usd": 127849.50,
      "arpu_monthly": 18.75,
      "ltv_estimate": 156.80,
      "churn_rate": 4.2
    },
    "content": {
      "content_engagement_score": 8.7,
      "meditation_completion_rate": 82.4,
      "avg_session_duration_minutes": 23.6,
      "repeat_usage_rate": 71.2
    },
    "technical": {
      "api_performance_score": 96.8,
      "uptime_percentage": 99.94,
      "avg_response_time_ms": 247,
      "error_rate_percentage": 0.12
    }
  },
  "trends": {
    "7d": {
      "dau_change": "+8.2%",
      "conversion_change": "+0.3%",
      "revenue_change": "+15.7%"
    },
    "30d": {
      "mau_change": "+23.1%",
      "retention_change": "+2.8%",
      "arpu_change": "+12.4%"
    }
  },
  "alerts": [
    {
      "kpi": "chat_engagement_rate",
      "current_value": 58.2,
      "threshold": 60.0,
      "severity": "warning",
      "trend": "declining"
    }
  ]
}
```

## KPI Categories

### User Engagement Metrics
- **DAU/WAU/MAU**: Core user activity metrics
- **Retention Rates**: 7-day and 30-day user retention
- **Session Metrics**: Duration, frequency, depth

### Conversion Metrics
- **Signup Conversion**: Visitor to user conversion
- **Feature Adoption**: Chat, voice, premium features
- **Engagement Funnel**: User journey progression

### Revenue Metrics
- **Revenue Tracking**: 30-day rolling revenue
- **ARPU**: Average revenue per user
- **LTV**: Customer lifetime value estimates
- **Churn Rate**: User attrition rates

### Content Performance
- **Engagement Score**: Content interaction quality
- **Completion Rates**: Meditation, lecture completion
- **Content Preferences**: Popular topics and formats

### Technical Performance
- **API Performance**: Response times and reliability
- **System Uptime**: Service availability
- **Error Rates**: System reliability metrics

## Dashboard Integration

### Frontend Integration

```javascript
import { BusinessMetricsClient } from '@lilith/sdk';

const metricsClient = new BusinessMetricsClient({
  baseUrl: process.env.OBSERVABILITY_URL,
  authToken: process.env.API_TOKEN
});

// Get real-time dashboard
const dashboard = await metricsClient.getDashboard();

// Display key metrics
console.log(`DAU: ${dashboard.kpis.user_engagement.dau}`);
console.log(`Conversion: ${dashboard.kpis.conversion.signup_conversion_24h}%`);
console.log(`Revenue: $${dashboard.kpis.revenue.revenue_30d_usd}`);
```

### Alerting Integration

```javascript
// Check for KPI alerts
const alerts = dashboard.alerts;
if (alerts.length > 0) {
  for (const alert of alerts) {
    await notificationService.sendAlert({
      title: `KPI Alert: ${alert.kpi}`,
      message: `${alert.kpi} is ${alert.current_value} (threshold: ${alert.threshold})`,
      severity: alert.severity,
      team: 'product-analytics'
    });
  }
}
```

---
*Generated automatically by business-metrics-docs-generator.js*
*Last updated: 2025-09-26T09:29:19.729Z*
