Analytics Dashboard¶

The Analytics Dashboard provides comprehensive insights into citizen engagement patterns, system performance, and service effectiveness through interactive visualizations and real-time metrics.

Dashboard Overview¶

The main dashboard displays key metrics and trends in an intuitive, easy-to-understand format designed for government staff and administrators.

Key Metrics Cards¶

The dashboard features four primary metric cards:

Interactive Charts¶

Conversation Trends¶

xychart-beta
    title "Daily Conversations Over Time"
    x-axis [Mon, Tue, Wed, Thu, Fri, Sat, Sun]
    y-axis "Number of Conversations" 0 --> 200
    line [45, 67, 89, 123, 98, 34, 28]

The conversation trends chart shows:

• Peak Hours: Identify busiest times of day
• Weekly Patterns: Understand usage by day of week
• Seasonal Trends: Long-term usage patterns
• Special Events: Impact of holidays and events

Sentiment Distribution¶

pie title Sentiment Distribution (Last 30 Days)
    "Positive" : 65
    "Neutral" : 25
    "Negative" : 10

Top Topics¶

Interactive word cloud showing most discussed topics:

• Services: Most requested government services
• Policies: Frequently asked about policies
• Issues: Common problems and concerns
• Locations: Geographic distribution of inquiries

Real-time Monitoring¶

Live Updates¶

The dashboard updates in real-time, showing:

Alert System¶

flowchart TD
    A[Monitor Metrics] --> B{Threshold Exceeded?}
    B -->|Yes| C[Generate Alert]
    B -->|No| D[Continue Monitoring]
    C --> E[Notify Admin]
    C --> F[Update Dashboard]
    E --> G[Take Action]
    F --> D
    G --> D

Automated alerts for:

• High negative sentiment (>20% in 1 hour)
• System response time (>5 seconds average)
• Error rate spike (>5% in 10 minutes)
• Unusual traffic patterns

Data Filtering and Export¶

Filter Options¶

Users can filter data by:

Export Capabilities¶

# Export data in multiple formats
EXPORT_FORMATS = {
    "csv": "Comma-separated values",
    "json": "JSON data format",
    "pdf": "PDF report",
    "excel": "Excel spreadsheet"
}

# Example export API call
GET /api/v1/analytics/export?format=csv&date_range=30d&metrics=conversations,sentiment

Performance Analytics¶

Response Time Analysis¶

Track AI and system performance:

System Health Dashboard¶

graph TB
    subgraph "System Components"
        A[Web Server] --> B[Application]
        B --> C[AI Engine]
        B --> D[Database]
        B --> E[External APIs]
    end

    subgraph "Health Status"
        F[✅ Healthy]
        G[⚠️ Warning]
        H[❌ Critical]
    end

    A --> F
    C --> F
    D --> F
    E --> G

User Engagement Analytics¶

Conversation Flow Analysis¶

Track how users navigate through conversations:

sankey-beta
    User Start,Greeting,100
    Greeting,Service Inquiry,60
    Greeting,Information Request,30
    Greeting,Complaint,10
    Service Inquiry,Resolved,45
    Service Inquiry,Escalated,15
    Information Request,Satisfied,28
    Information Request,Follow-up,2
    Complaint,Human Agent,8
    Complaint,Self-Resolved,2

User Satisfaction Metrics¶

• Resolution Rate: 87% of conversations marked as resolved
• User Ratings: Average 4.⅖ stars
• Return Users: 34% of users return within 30 days
• Escalation Rate: 8% of conversations escalated to human agents

Geographic Analytics¶

Usage by Location¶

Interactive map showing conversation density:

• Heat map of conversation volume
• Regional breakdown of common topics
• Service area coverage analysis
• Response time by location

Demographic Insights¶

xychart-beta
    title "Usage by Age Group"
    x-axis [18-24, 25-34, 35-44, 45-54, 55-64, 65+]
    y-axis "Percentage of Users" 0 --> 30
    bar [12, 28, 24, 18, 12, 6]

Administrative Features¶

User Management Analytics¶

Track administrative activities:

• Admin login frequency
• Feature usage by role
• Configuration changes
• System modifications

Audit Trails¶

Complete audit logging:

{
    "timestamp": "2025-01-01T10:30:00Z",
    "user": "admin_user",
    "action": "export_data",
    "resource": "analytics_dashboard",
    "details": {
        "format": "csv",
        "date_range": "30d",
        "metrics": ["conversations", "sentiment"]
    }
}

Custom Reports¶

Report Builder¶

Create custom reports with:

• Drag-and-drop interface
• Multiple chart types
• Custom date ranges
• Automated scheduling

Scheduled Reports¶

# Example scheduled report configuration
SCHEDULED_REPORTS = {
    "daily_summary": {
        "frequency": "daily",
        "time": "09:00",
        "recipients": ["admin@city.gov"],
        "format": "pdf"
    },
    "weekly_trends": {
        "frequency": "weekly",
        "day": "monday",
        "time": "08:00",
        "metrics": ["conversations", "sentiment", "concerns"]
    }
}

API Integration¶

Analytics API Endpoints¶

# Get dashboard data
GET /api/v1/analytics/dashboard
{
    "date_range": "7d",
    "metrics": ["conversations", "sentiment", "performance"]
}

# Get detailed metrics
GET /api/v1/analytics/metrics
{
    "metric": "conversations",
    "granularity": "hourly",
    "start_date": "2025-01-01",
    "end_date": "2025-01-07"
}

# Export data
GET /api/v1/analytics/export
{
    "format": "csv",
    "date_range": "30d",
    "include": ["conversations", "sentiment", "topics"]
}

Custom Dashboards¶

Build custom dashboards using the API:

// Fetch dashboard data
const response = await fetch('/api/v1/analytics/dashboard', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer ' + apiKey
    }
});

const data = await response.json();

// Update custom dashboard components
updateConversationChart(data.conversations);
updateSentimentPie(data.sentiment);
updateMetricsCards(data.metrics);

Performance Optimization¶

Caching Strategy¶

• Real-time data: No caching
• Hourly aggregates: 5-minute cache
• Daily summaries: 1-hour cache
• Historical data: 24-hour cache

Data Retention¶

DATA_RETENTION = {
    "raw_conversations": "90 days",
    "hourly_aggregates": "1 year",
    "daily_summaries": "5 years",
    "monthly_reports": "10 years"
}

Troubleshooting¶

Common Issues¶

Dashboard Not Loading¶

1. Check browser compatibility:
2. Chrome 90+, Firefox 88+, Safari 14+
3. JavaScript enabled

4. Cookies enabled

5. Clear browser cache:

   # Hard refresh
   Ctrl+F5 (Windows) or Cmd+Shift+R (macOS)
   

6. Check network connectivity:

   # Test API endpoints
   curl http://localhost:5000/api/v1/analytics/dashboard
   

Charts Not Displaying¶

1. Verify data availability:

   # Check if analytics data exists
   from src.analytics import get_dashboard_data
   data = get_dashboard_data(date_range='7d')
   print(f"Data points: {len(data)}")
   

2. Check JavaScript console for errors

3. Verify Plotly.js library is loaded

Slow Performance¶

• Reduce date range for large datasets
• Enable data aggregation for historical views
• Use pagination for detailed reports
• Optimize database queries

Security and Privacy¶

Data Protection¶

Compliance¶

• GDPR compliance: Right to be forgotten implemented
• Data retention policies: Automatic data purging
• Privacy by design: Analytics built with privacy in mind

Next Steps¶

• Concern Reporting - Track and manage citizen issues
• API Reference - Integrate analytics into your systems
• Chat Assistant - Understand conversation data sources