local-deep-research 0.4.4__py3-none-any.whl → 0.5.2__py3-none-any.whl

local_deep_research/web/templates/pages/star_reviews.html

@@ -0,0 +1,803 @@
+{% extends "base.html" %}
+
+{% block title %}Star Reviews Analytics{% endblock %}
+
+{% block extra_head %}
+<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+<style>
+    .star-reviews-container {
+        max-width: 1200px;
+        margin: 0 auto;
+        padding: 2rem;
+    }
+
+    .metrics-header {
+        background: var(--gradient-bg);
+        color: var(--text-primary);
+        padding: 2rem;
+        border-radius: 0.75rem;
+        margin-bottom: 2rem;
+        text-align: center;
+        border: 1px solid var(--border-color);
+        box-shadow: var(--card-shadow);
+    }
+
+    .metrics-grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+        gap: 1.5rem;
+        margin-bottom: 2rem;
+    }
+
+    .metric-card {
+        background: var(--bg-secondary);
+        border-radius: 0.75rem;
+        padding: 1.5rem;
+        box-shadow: var(--card-shadow);
+        border: 1px solid var(--border-color);
+        transition: transform 0.2s ease;
+    }
+
+    .metric-card:hover {
+        transform: translateY(-2px);
+    }
+
+    .metric-card h3 {
+        margin-top: 0;
+        color: var(--text-primary);
+        border-bottom: 2px solid var(--border-color);
+        padding-bottom: 0.75rem;
+        margin-bottom: 1rem;
+        font-size: 1.125rem;
+    }
+
+    .chart-container {
+        position: relative;
+        height: 400px;
+        margin-bottom: 1rem;
+    }
+
+    .overall-stats {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+        gap: 1.25rem;
+        margin-bottom: 2rem;
+    }
+
+    .stat-item {
+        text-align: center;
+        padding: 1rem;
+        background: var(--bg-tertiary);
+        border-radius: 0.5rem;
+        border: 1px solid var(--border-color);
+    }
+
+    .stat-value {
+        font-size: 1.5rem;
+        font-weight: bold;
+        color: var(--accent-primary);
+        display: block;
+    }
+
+    .stat-label {
+        font-size: 0.75rem;
+        color: var(--text-secondary);
+        margin-top: 0.25rem;
+        text-transform: uppercase;
+        letter-spacing: 0.05em;
+    }
+
+    .star-rating {
+        color: var(--warning-color);
+        font-size: 1.2em;
+    }
+
+    .rating-distribution {
+        margin: 1rem 0;
+    }
+
+    .rating-distribution h4 {
+        color: var(--text-primary);
+        margin-bottom: 1rem;
+        text-align: center;
+    }
+
+    .rating-bar {
+        display: flex;
+        align-items: center;
+        margin: 0.5rem 0;
+        gap: 0.75rem;
+    }
+
+    .rating-label {
+        min-width: 60px;
+        font-weight: 500;
+        color: var(--text-secondary);
+        font-size: 0.875rem;
+    }
+
+    .rating-progress {
+        flex: 1;
+        height: 16px;
+        background: var(--bg-tertiary);
+        border-radius: 0.5rem;
+        overflow: hidden;
+    }
+
+    .rating-fill {
+        height: 100%;
+        background: linear-gradient(90deg, var(--accent-primary), var(--accent-secondary));
+        transition: width 0.3s ease;
+        border-radius: 0.5rem;
+    }
+
+    .rating-count {
+        font-weight: 500;
+        min-width: 30px;
+        text-align: right;
+        color: var(--text-secondary);
+        font-size: 0.875rem;
+    }
+
+    .period-selector {
+        margin-bottom: 1.5rem;
+    }
+
+    .period-selector label {
+        color: var(--text-secondary);
+        margin-right: 0.5rem;
+        font-weight: 500;
+    }
+
+    .period-selector select {
+        padding: 0.5rem 1rem;
+        border: 1px solid var(--border-color);
+        border-radius: 0.375rem;
+        background: var(--bg-secondary);
+        color: var(--text-primary);
+        cursor: pointer;
+        transition: border-color 0.2s ease;
+    }
+
+    .period-selector select:focus {
+        outline: none;
+        border-color: var(--accent-primary);
+        box-shadow: 0 0 0 3px rgba(110, 79, 246, 0.1);
+    }
+
+    .recent-ratings {
+        max-height: 500px;
+        overflow-y: auto;
+    }
+
+    .rating-item {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        padding: 0.75rem;
+        border-bottom: 1px solid var(--border-color);
+        transition: background-color 0.2s ease;
+    }
+
+    .rating-item:hover {
+        background-color: var(--bg-tertiary);
+    }
+
+    .rating-item:last-child {
+        border-bottom: none;
+    }
+
+    .rating-details {
+        flex: 1;
+    }
+
+    .rating-query {
+        font-weight: 500;
+        color: var(--text-primary);
+        margin-bottom: 0.25rem;
+    }
+
+    .rating-meta {
+        font-size: 0.8125rem;
+        color: var(--text-muted);
+    }
+
+    .rating-score {
+        display: flex;
+        align-items: center;
+        gap: 0.375rem;
+        color: var(--text-primary);
+    }
+
+    .rating-link {
+        color: var(--accent-tertiary);
+        text-decoration: none;
+        font-weight: 500;
+        transition: color 0.2s ease;
+    }
+
+    .rating-link:hover {
+        color: var(--accent-secondary);
+        text-decoration: underline;
+    }
+
+    .info-section {
+        margin-bottom: 2rem;
+    }
+
+    .info-card {
+        background: var(--bg-secondary);
+        border: 1px solid var(--border-color);
+        border-radius: 0.75rem;
+        padding: 1.5rem;
+        margin-bottom: 1.5rem;
+        display: flex;
+        align-items: flex-start;
+        gap: 1rem;
+        box-shadow: var(--card-shadow);
+    }
+
+    .info-icon {
+        font-size: 2rem;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        width: 60px;
+        height: 60px;
+        background: var(--bg-tertiary);
+        border-radius: 50%;
+        flex-shrink: 0;
+    }
+
+    .info-content h3 {
+        margin: 0 0 0.75rem 0;
+        color: var(--accent-primary);
+        font-size: 1.25rem;
+    }
+
+    .info-content p {
+        margin: 0;
+        color: var(--text-secondary);
+        line-height: 1.6;
+    }
+
+    .info-grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+        gap: 1.25rem;
+    }
+
+    .info-item {
+        background: var(--bg-secondary);
+        border: 1px solid var(--border-color);
+        border-radius: 0.5rem;
+        padding: 1.25rem;
+        text-align: center;
+        transition: transform 0.2s ease, box-shadow 0.2s ease;
+    }
+
+    .info-item:hover {
+        transform: translateY(-2px);
+        box-shadow: var(--card-shadow);
+    }
+
+    .info-item-icon {
+        font-size: 1.75rem;
+        margin-bottom: 0.75rem;
+    }
+
+    .info-item h4 {
+        margin: 0 0 0.5rem 0;
+        color: var(--text-primary);
+        font-size: 1rem;
+    }
+
+    .info-item p {
+        margin: 0;
+        color: var(--text-secondary);
+        font-size: 0.875rem;
+        line-height: 1.5;
+    }
+
+    .loading {
+        text-align: center;
+        padding: 2.5rem;
+        color: var(--text-secondary);
+        background: var(--bg-secondary);
+        border-radius: 0.5rem;
+        border: 1px solid var(--border-color);
+    }
+
+    .error {
+        background: rgba(250, 92, 124, 0.1);
+        color: var(--error-color);
+        padding: 1rem;
+        border-radius: 0.5rem;
+        margin: 1.25rem 0;
+        border: 1px solid rgba(250, 92, 124, 0.2);
+    }
+
+    @media (max-width: 768px) {
+        .metrics-grid {
+            grid-template-columns: 1fr;
+        }
+
+        .overall-stats {
+            grid-template-columns: repeat(2, 1fr);
+        }
+
+        .info-card {
+            flex-direction: column;
+            text-align: center;
+        }
+
+        .info-grid {
+            grid-template-columns: 1fr;
+        }
+
+        .star-reviews-container {
+            padding: 1rem;
+        }
+    }
+</style>
+{% endblock %}
+
+{% block content %}
+<div class="star-reviews-container">
+    <div class="metrics-header">
+        <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 10px;">
+            <h1>⭐ Star Reviews Analytics</h1>
+            <a href="/metrics/" style="background: var(--bg-tertiary); color: var(--text-primary); padding: 0.5rem 1rem; border-radius: 0.375rem; text-decoration: none; font-size: 0.875rem; border: 1px solid var(--border-color); transition: background-color 0.2s ease;">
+                ← Back to Metrics
+            </a>
+        </div>
+        <p>Comprehensive analysis of user satisfaction ratings</p>
+    </div>
+
+    <div class="period-selector">
+        <label for="period-select">Time Period: </label>
+        <select id="period-select">
+            <option value="7d">Last 7 days</option>
+            <option value="30d" selected>Last 30 days</option>
+            <option value="3m">Last 3 months</option>
+            <option value="1y">Last year</option>
+            <option value="all">All time</option>
+        </select>
+    </div>
+
+    <div id="loading" class="loading">
+        <div>Loading star reviews data...</div>
+    </div>
+
+    <div id="error" class="error" style="display: none;"></div>
+
+    <div id="content" style="display: none;">
+        <!-- Overall Statistics -->
+        <div class="metric-card">
+            <h3>📊 Overall Satisfaction</h3>
+            <div class="overall-stats">
+                <div class="stat-item">
+                    <span class="stat-value" id="avg-rating">0.0</span>
+                    <div class="stat-label">Average Rating</div>
+                </div>
+                <div class="stat-item">
+                    <span class="stat-value" id="total-ratings">0</span>
+                    <div class="stat-label">Total Ratings</div>
+                </div>
+                <div class="stat-item">
+                    <span class="stat-value" id="satisfaction-rate">0%</span>
+                    <div class="stat-label">Satisfaction Rate</div>
+                </div>
+            </div>
+
+            <div class="rating-distribution">
+                <h4>Rating Distribution</h4>
+                <div class="rating-bar">
+                    <div class="rating-label">5 ⭐</div>
+                    <div class="rating-progress">
+                        <div class="rating-fill" id="rating-5" style="width: 0%;"></div>
+                    </div>
+                    <div class="rating-count" id="count-5">0</div>
+                </div>
+                <div class="rating-bar">
+                    <div class="rating-label">4 ⭐</div>
+                    <div class="rating-progress">
+                        <div class="rating-fill" id="rating-4" style="width: 0%;"></div>
+                    </div>
+                    <div class="rating-count" id="count-4">0</div>
+                </div>
+                <div class="rating-bar">
+                    <div class="rating-label">3 ⭐</div>
+                    <div class="rating-progress">
+                        <div class="rating-fill" id="rating-3" style="width: 0%;"></div>
+                    </div>
+                    <div class="rating-count" id="count-3">0</div>
+                </div>
+                <div class="rating-bar">
+                    <div class="rating-label">2 ⭐</div>
+                    <div class="rating-progress">
+                        <div class="rating-fill" id="rating-2" style="width: 0%;"></div>
+                    </div>
+                    <div class="rating-count" id="count-2">0</div>
+                </div>
+                <div class="rating-bar">
+                    <div class="rating-label">1 ⭐</div>
+                    <div class="rating-progress">
+                        <div class="rating-fill" id="rating-1" style="width: 0%;"></div>
+                    </div>
+                    <div class="rating-count" id="count-1">0</div>
+                </div>
+            </div>
+        </div>
+
+        <div class="metrics-grid">
+            <!-- LLM Model Ratings Chart -->
+            <div class="metric-card">
+                <h3>🤖 LLM Model Performance</h3>
+                <div class="chart-container">
+                    <canvas id="llm-ratings-chart"></canvas>
+                </div>
+            </div>
+
+            <!-- Search Engine Ratings Chart -->
+            <div class="metric-card">
+                <h3>🔍 Search Engine Performance</h3>
+                <div class="chart-container">
+                    <canvas id="search-engine-ratings-chart"></canvas>
+                </div>
+            </div>
+
+            <!-- Rating Trends Over Time -->
+            <div class="metric-card">
+                <h3>📈 Rating Trends</h3>
+                <div class="chart-container">
+                    <canvas id="rating-trends-chart"></canvas>
+                </div>
+            </div>
+
+            <!-- Recent Ratings -->
+            <div class="metric-card">
+                <h3>🕐 Recent Ratings</h3>
+                <div class="recent-ratings" id="recent-ratings">
+                    <!-- Recent ratings will be populated here -->
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <div class="info-section">
+        <div class="info-card">
+            <div class="info-icon">📊</div>
+            <div class="info-content">
+                <h3>Data-Driven Research Optimization</h3>
+                <p>Use your personal rating history to optimize your research workflow. Instead of relying on intuition alone, leverage actual performance statistics to identify which LLM models, search engines, and research approaches deliver the best results for your specific needs.</p>
+            </div>
+        </div>
+
+        <div class="info-grid">
+            <div class="info-item">
+                <div class="info-item-icon">🤖</div>
+                <h4>Model Performance</h4>
+                <p>Compare LLM models based on your actual satisfaction ratings to choose the best performing one for your research style.</p>
+            </div>
+
+            <div class="info-item">
+                <div class="info-item-icon">🔍</div>
+                <h4>Search Engine Insights</h4>
+                <p>Discover which search engines consistently deliver higher-quality results for your research topics and preferences.</p>
+            </div>
+
+            <div class="info-item">
+                <div class="info-item-icon">📈</div>
+                <h4>Trend Analysis</h4>
+                <p>Track your satisfaction trends over time to understand how your research effectiveness evolves and identify optimization opportunities.</p>
+            </div>
+
+            <div class="info-item">
+                <div class="info-item-icon">🎯</div>
+                <h4>Personalized Recommendations</h4>
+                <p>Make informed decisions about your research configuration based on your personal usage patterns and satisfaction data.</p>
+            </div>
+        </div>
+    </div>
+</div>
+
+<script>
+let llmChart, searchEngineChart, trendsChart;
+
+// Initialize page
+document.addEventListener('DOMContentLoaded', function() {
+    loadStarReviews();
+
+    // Period selector change handler
+    document.getElementById('period-select').addEventListener('change', loadStarReviews);
+});
+
+async function loadStarReviews() {
+    console.log('Loading star reviews...');
+    const period = document.getElementById('period-select').value;
+
+    showLoading();
+
+    try {
+        console.log('Fetching data for period:', period);
+        const response = await fetch(`/metrics/api/star-reviews?period=${period}`);
+
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+
+        const data = await response.json();
+        console.log('Received data:', data);
+
+        if (data.error) {
+            showError(data.error);
+            return;
+        }
+
+        console.log('Updating charts and stats...');
+        updateOverallStats(data.overall_stats);
+        updateLLMChart(data.llm_ratings);
+        updateSearchEngineChart(data.search_engine_ratings);
+        updateTrendsChart(data.rating_trends);
+        updateRecentRatings(data.recent_ratings);
+
+        showContent();
+        console.log('Star reviews loaded successfully');
+
+    } catch (error) {
+        console.error('Error loading star reviews:', error);
+        showError('Failed to load star reviews data: ' + error.message);
+    }
+}
+
+function showLoading() {
+    document.getElementById('loading').style.display = 'block';
+    document.getElementById('content').style.display = 'none';
+    document.getElementById('error').style.display = 'none';
+}
+
+function showContent() {
+    document.getElementById('loading').style.display = 'none';
+    document.getElementById('content').style.display = 'block';
+    document.getElementById('error').style.display = 'none';
+}
+
+function showError(message) {
+    document.getElementById('loading').style.display = 'none';
+    document.getElementById('content').style.display = 'none';
+    document.getElementById('error').style.display = 'block';
+    document.getElementById('error').textContent = message;
+}
+
+function updateOverallStats(stats) {
+    document.getElementById('avg-rating').textContent = stats.avg_rating;
+    document.getElementById('total-ratings').textContent = stats.total_ratings;
+
+    // Calculate satisfaction rate (4+ stars)
+    const satisfactionRate = stats.total_ratings > 0 ?
+        Math.round(((stats.rating_distribution['4'] + stats.rating_distribution['5']) / stats.total_ratings) * 100) : 0;
+    document.getElementById('satisfaction-rate').textContent = satisfactionRate + '%';
+
+    // Update rating distribution
+    const total = stats.total_ratings || 1;
+    for (let i = 1; i <= 5; i++) {
+        const count = stats.rating_distribution[i.toString()] || 0;
+        const percentage = Math.round((count / total) * 100);
+
+        document.getElementById(`rating-${i}`).style.width = percentage + '%';
+        document.getElementById(`count-${i}`).textContent = count;
+    }
+}
+
+function updateLLMChart(llmRatings) {
+    const ctx = document.getElementById('llm-ratings-chart').getContext('2d');
+
+    if (llmChart) {
+        llmChart.destroy();
+    }
+
+    // Sort by rating and take top 10
+    const sortedData = llmRatings.sort((a, b) => b.avg_rating - a.avg_rating).slice(0, 10);
+
+    llmChart = new Chart(ctx, {
+        type: 'bar',
+        data: {
+            labels: sortedData.map(item => item.model || 'Unknown'),
+            datasets: [{
+                label: 'Average Rating',
+                data: sortedData.map(item => item.avg_rating),
+                backgroundColor: 'rgba(54, 162, 235, 0.8)',
+                borderColor: 'rgba(54, 162, 235, 1)',
+                borderWidth: 1
+            }]
+        },
+        options: {
+            responsive: true,
+            maintainAspectRatio: false,
+            scales: {
+                y: {
+                    beginAtZero: true,
+                    max: 5,
+                    title: {
+                        display: true,
+                        text: 'Average Rating (Stars)'
+                    }
+                },
+                x: {
+                    title: {
+                        display: true,
+                        text: 'LLM Models'
+                    }
+                }
+            },
+            plugins: {
+                legend: {
+                    display: false
+                },
+                tooltip: {
+                    callbacks: {
+                        afterLabel: function(context) {
+                            const index = context.dataIndex;
+                            const item = sortedData[index];
+                            return [
+                                `Ratings: ${item.rating_count}`,
+                                `Satisfaction: ${item.satisfaction_rate}%`
+                            ];
+                        }
+                    }
+                }
+            }
+        }
+    });
+}
+
+function updateSearchEngineChart(searchEngineRatings) {
+    const ctx = document.getElementById('search-engine-ratings-chart').getContext('2d');
+
+    if (searchEngineChart) {
+        searchEngineChart.destroy();
+    }
+
+    // Sort by rating and take top 10
+    const sortedData = searchEngineRatings.sort((a, b) => b.avg_rating - a.avg_rating).slice(0, 10);
+
+    searchEngineChart = new Chart(ctx, {
+        type: 'bar',
+        data: {
+            labels: sortedData.map(item => item.search_engine || 'Unknown'),
+            datasets: [{
+                label: 'Average Rating',
+                data: sortedData.map(item => item.avg_rating),
+                backgroundColor: 'rgba(255, 99, 132, 0.8)',
+                borderColor: 'rgba(255, 99, 132, 1)',
+                borderWidth: 1
+            }]
+        },
+        options: {
+            responsive: true,
+            maintainAspectRatio: false,
+            scales: {
+                y: {
+                    beginAtZero: true,
+                    max: 5,
+                    title: {
+                        display: true,
+                        text: 'Average Rating (Stars)'
+                    }
+                },
+                x: {
+                    title: {
+                        display: true,
+                        text: 'Search Engines'
+                    }
+                }
+            },
+            plugins: {
+                legend: {
+                    display: false
+                },
+                tooltip: {
+                    callbacks: {
+                        afterLabel: function(context) {
+                            const index = context.dataIndex;
+                            const item = sortedData[index];
+                            return [
+                                `Ratings: ${item.rating_count}`,
+                                `Satisfaction: ${item.satisfaction_rate}%`
+                            ];
+                        }
+                    }
+                }
+            }
+        }
+    });
+}
+
+function updateTrendsChart(ratingTrends) {
+    const ctx = document.getElementById('rating-trends-chart').getContext('2d');
+
+    if (trendsChart) {
+        trendsChart.destroy();
+    }
+
+    trendsChart = new Chart(ctx, {
+        type: 'line',
+        data: {
+            labels: ratingTrends.map(item => new Date(item.date).toLocaleDateString()),
+            datasets: [{
+                label: 'Average Rating',
+                data: ratingTrends.map(item => item.avg_rating),
+                borderColor: 'rgba(75, 192, 192, 1)',
+                backgroundColor: 'rgba(75, 192, 192, 0.2)',
+                borderWidth: 2,
+                fill: true,
+                tension: 0.4
+            }]
+        },
+        options: {
+            responsive: true,
+            maintainAspectRatio: false,
+            scales: {
+                y: {
+                    beginAtZero: true,
+                    max: 5,
+                    title: {
+                        display: true,
+                        text: 'Average Rating'
+                    }
+                },
+                x: {
+                    title: {
+                        display: true,
+                        text: 'Date'
+                    }
+                }
+            },
+            plugins: {
+                legend: {
+                    display: false
+                }
+            }
+        }
+    });
+}
+
+function updateRecentRatings(recentRatings) {
+    const container = document.getElementById('recent-ratings');
+    container.innerHTML = '';
+
+    if (recentRatings.length === 0) {
+        container.innerHTML = '<div style="text-align: center; padding: 20px; color: #718096;">No recent ratings found</div>';
+        return;
+    }
+
+    recentRatings.forEach(rating => {
+        const item = document.createElement('div');
+        item.className = 'rating-item';
+
+        const stars = '⭐'.repeat(rating.rating);
+        const date = new Date(rating.rated_at).toLocaleDateString();
+
+        item.innerHTML = `
+            <div class="rating-details">
+                <div class="rating-query">
+                    <a href="/research/results/${rating.research_id}" class="rating-link">
+                        ${rating.query}
+                    </a>
+                </div>
+                <div class="rating-meta">
+                    ${rating.llm_model} • ${rating.mode} • ${date}
+                </div>
+            </div>
+            <div class="rating-score">
+                <span class="star-rating">${stars}</span>
+                <span>${rating.rating}/5</span>
+            </div>
+        `;
+
+        container.appendChild(item);
+    });
+}
+</script>
+{% endblock %}