<?php
/**
 * Overview Admin View
 *
 * Unified dashboard and analytics overview
 */

if (!defined('ABSPATH')) {
    exit;
}

// Render the page header with navigation tabs
$this->render_header(
    __('Overview', 'answerrails'),
    __('Dashboard and analytics for your AI chat assistant.', 'answerrails')
);

// #174 (D10, the Overview tidy-up): the free Overview is
// health/status facts + volume counts + the #140 C1 grounding-outcomes
// card. The analytics summary (BI tiles, structured fallbacks, top
// sources, quality distribution) is Pro content rendered through the E9
// insertion points (`answerrails_overview_sections`); ideas, knowledge
// gaps and invalid-URL monitoring live in the Business Intelligence
// admin, not here, and this screen has no recent-conversations detail
// section at all (Chat Logs is that surface). Content is simply present
// or absent.

// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only display parameter; no state change
$raw_time_range = isset($_GET['range']) ? sanitize_text_field(wp_unslash($_GET['range'])) : '24h';

$time_ranges = array(
    '24h' => array(
        'label'  => __('Last 24 Hours', 'answerrails'),
        'period' => '24_hours',
        'start'  => '-24 hours',
    ),
    '7d'  => array(
        'label'  => __('Last 7 Days', 'answerrails'),
        'period' => '7_days',
        'start'  => '-7 days',
    ),
    '30d' => array(
        'label'  => __('Last 30 Days', 'answerrails'),
        'period' => '30_days',
        'start'  => '-30 days',
    ),
    '90d' => array(
        'label'  => __('Last 90 Days', 'answerrails'),
        'period' => '90_days',
        'start'  => '-90 days',
    ),
    'all' => array(
        'label'  => __('All Time', 'answerrails'),
        'period' => 'all_time',
        'start'  => null,
    ),
);

$time_range = array_key_exists($raw_time_range, $time_ranges) ? $raw_time_range : '24h';
$range      = $time_ranges[$time_range];

$end_timestamp   = current_time('timestamp');
$start_timestamp = null;

if (!empty($range['start'])) {
    $start_timestamp = strtotime($range['start'], $end_timestamp);
}

$range_label = $range['label'];
$rag_period  = $range['period'];

$date_query = array();
if ($start_timestamp) {
    $date_query[] = array(
        'after'     => gmdate('Y-m-d H:i:s', $start_timestamp),
        'before'    => gmdate('Y-m-d H:i:s', $end_timestamp),
        'inclusive' => true,
    );
}

$total_conversations   = 0;
$total_messages        = 0;
$chatlog_ids           = array();
$sampled_conversations = 0;

$chatlog_limit = (int) apply_filters('answerrails_overview_chatlog_limit', 500);
if ($chatlog_limit <= 0) {
    $chatlog_limit = 500;
}

if (post_type_exists('answerrails_chatlog')) {
    $metrics_args = array(
        'post_type'      => 'answerrails_chatlog',
        'post_status'    => 'publish',
        'orderby'        => 'date',
        'order'          => 'DESC',
        'posts_per_page' => $chatlog_limit,
        'paged'          => 1,
        'no_found_rows'  => false,
        'fields'         => 'ids',
    );

    if (!empty($date_query)) {
        $metrics_args['date_query'] = $date_query;
    }

    $metrics_query = new WP_Query($metrics_args);

    $total_conversations   = (int) $metrics_query->found_posts;
    $chatlog_ids           = array_map('intval', $metrics_query->posts);
    $sampled_conversations = count($chatlog_ids);

    wp_reset_postdata();

    // #174: this scan counts VOLUME only — no per-conversation quality or
    // deflection aggregation, and no detail collection. Chat Logs is the
    // detail surface, and the quality work is the E9 analytics summary's
    // business (its consumer computes from the chatlog ids passed in the
    // E9 context).
    foreach ($chatlog_ids as $post_id) {
        $content      = get_post_field('post_content', $post_id);
        $conversation = json_decode($content, true);
        if (is_array($conversation) && !empty($conversation)) {
            $total_messages += count($conversation);
        }
    }
}

// The Performance Metrics "Response Time" row's series: chat-log turn
// response times over the 50 newest logs. (#377 D4: the success figure is
// no longer computed here — it is the Chat card's, read below.)
$response_times = array();

if (post_type_exists('answerrails_chatlog')) {
    $perf_args = array(
        'post_type'      => 'answerrails_chatlog',
        'post_status'    => 'publish',
        'posts_per_page' => 50,
        'orderby'        => 'date',
        'order'          => 'DESC',
    );

    $perf_query = new WP_Query($perf_args);

    if ($perf_query->have_posts()) {
        while ($perf_query->have_posts()) {
            $perf_query->the_post();
            $post_id = get_the_ID();
            $content = get_post_field('post_content', $post_id);
            $turns   = json_decode($content, true);

            if (is_array($turns)) {
                foreach ($turns as $turn) {
                    if (isset($turn['metadata']['response_time'])) {
                        $response_times[] = $turn['metadata']['response_time'] / 1000;
                    }
                }
            }
        }
        wp_reset_postdata();
    }
}

$avg_response_time = !empty($response_times) ? array_sum($response_times) / count($response_times) : null;

// #377 D4: the API Success Rate tile and its Performance Metrics row read
// the Chat card's own figure and status — the same snapshot the health
// widget renders (cached per window), never a second series. The tile
// stays: it is the free list's only built-in row, and the
// experience_scores extension point renders into this list.
$ar_chat_health = class_exists('AnswerRails_API_Health_Monitor')
    ? ((new AnswerRails_API_Health_Monitor())->get_dashboard_snapshot(AnswerRails_Utils::get_active_provider(), $this->range_window($time_range))['chat'] ?? array())
    : array('status' => 'unknown');
$ar_chat_success = AnswerRails_Admin::chat_success_summary($ar_chat_health);

// The free Experience Scores list carries the OPERATIONAL summary only
// (API success). The business summaries (quality, deflection) are the E9
// analytics summary's content — a consumer appends rows at the
// experience_scores insertion point below.
$status_summaries = array();

$status_summaries[] = array(
    'label'       => __('API Success Rate', 'answerrails'),
    'description' => __('Successful chat calls over the selected range — the Chat card\'s figure.', 'answerrails'),
    'value'       => $ar_chat_success['value'],
    'unit'        => '%',
    'precision'   => 0,
    'percent'     => null !== $ar_chat_success['value'] ? max(0, min(100, (float) $ar_chat_success['value'])) : 0,
    'state'       => $ar_chat_success['state'],
);

$api_key       = AnswerRails_Utils::get_api_key();
$chat_enabled  = get_option('answerrails_chat_enabled', '0');
$system_status = (!empty($api_key) && '1' === $chat_enabled);

// The grounding-outcomes card metrics (#140 C1). This is the ONLY
// assembly path here since the tidy-up — the old can('analytics') branch
// (get_analytics + detect_knowledge_gaps) left with the BI surfaces.
// Per-turn metric RECORDING is unaffected and always runs.
$overview_metrics = array();
if (class_exists('AnswerRails_RAG_Analytics')) {
    $overview_metrics = (new AnswerRails_RAG_Analytics())->get_overview_metrics($rag_period);
}

// E9 (#174, `answerrails_overview_sections`): the context handed to
// every insertion point below — the range, the sampled conversation ids,
// and the free-card metrics, so the pro analytics summary can compute
// without re-deriving the scan.
$ar_overview_context = array(
    'range'                 => $time_range,
    'range_label'           => $range_label,
    'period'                => $rag_period,
    'chatlog_ids'           => $chatlog_ids,
    'total_conversations'   => $total_conversations,
    'sampled_conversations' => $sampled_conversations,
    'overview_metrics'      => $overview_metrics,
);

// The overview nonce left with overview-page.js (#174): its two
// consumers (conversation-detail toggle, invalid-URL clear) left the page.
?>

<div class="answerrails-overview-page">
    <!-- Time Range Toggle -->
    <div class="answerrails-overview-controls">
        <div class="time-range-toggle">
            <?php foreach ($time_ranges as $range_key => $config): ?>
                <a href="<?php echo esc_url(add_query_arg('range', $range_key)); ?>"
                   class="<?php echo $time_range === $range_key ? 'active' : ''; ?>">
                    <?php
                    switch ($range_key) {
                        case '24h':
                            esc_html_e('24 Hours', 'answerrails');
                            break;
                        case '7d':
                            esc_html_e('7 Days', 'answerrails');
                            break;
                        case '30d':
                            esc_html_e('30 Days', 'answerrails');
                            break;
                        case '90d':
                            esc_html_e('90 Days', 'answerrails');
                            break;
                        case 'all':
                            esc_html_e('All Time', 'answerrails');
                            break;
                    }
                    ?>
                </a>
            <?php endforeach; ?>
        </div>
    </div>

    <!-- Master Status Widget -->
    <?php if (!$system_status): ?>
        <div class="master-status-alert">
            <span class="dashicons dashicons-warning"></span>
            <div>
                <strong><?php esc_html_e('Chat System Disabled', 'answerrails'); ?></strong>
                <?php if (empty($api_key)): ?>
                    <p><?php esc_html_e("Please configure your AI provider's API key in Settings.", 'answerrails'); ?></p>
                <?php else: ?>
                    <p><?php esc_html_e('Chat is currently disabled. Enable it in Settings.', 'answerrails'); ?></p>
                <?php endif; ?>
            </div>
        </div>
    <?php else: ?>
        <div class="master-status-active">
            <span class="dashicons dashicons-yes-alt"></span>
            <span><?php esc_html_e('Chat System Active', 'answerrails'); ?></span>
        </div>
    <?php endif; ?>

    <!-- API Health Monitoring Widget -->
    <?php $this->render_api_health_widget($time_range); ?>


    <!-- Main Grid Container -->
    <div class="answerrails-grid-container">
        <!-- Row 1: Key Metrics -->
        <div class="answerrails-card answerrails-span-3">
            <h3><?php esc_html_e('Total Conversations', 'answerrails'); ?></h3>
            <div class="metric-value"><?php echo esc_html(number_format_i18n($total_conversations)); ?></div>
            <div class="metric-label"><?php echo esc_html($range_label); ?></div>
        </div>

        <div class="answerrails-card answerrails-span-3">
            <h3><?php esc_html_e('Total Messages', 'answerrails'); ?></h3>
            <div class="metric-value"><?php echo esc_html(number_format_i18n($total_messages)); ?></div>
            <div class="metric-label"><?php esc_html_e('User & AI Combined', 'answerrails'); ?></div>
        </div>

        <?php
        // ⚠ The Grounding-outcomes card is the ONLY free analytics surface
        // — real counts from the #128 outcome instrumentation; zeros are
        // real counts too. The tier line is capability language; outcome
        // counterfactuals are FORBIDDEN and test-pinned
        // (IncentivePartitionTest).
        $ar_go_grounded   = (int) ($overview_metrics['grounded_turns'] ?? 0);
        $ar_go_ungrounded = (int) ($overview_metrics['ungrounded_turns'] ?? 0);
        $ar_go_handoff    = (int) ($overview_metrics['handoff_turns'] ?? 0);
        $ar_go_conv       = (int) ($overview_metrics['conversational_turns'] ?? 0);
        // #276 D2: two deflection families, one visitor experience, one
        // count — the handoff path and the #124/#128 integrity deflections.
        // The split lives in Chat Logs, not on this card.
        $ar_go_integrity  = (int) ($overview_metrics['integrity_deflected_turns'] ?? 0);
        $ar_go_deflected  = $ar_go_handoff + $ar_go_integrity;
        // #278 D3: the fifth segment. `moderation_unavailable` is NOT a
        // segment — it is the opposite claim (fix your provider, not your
        // guardrail worked) and gets its own line below the counts.
        $ar_go_moderated   = (int) ($overview_metrics['moderated_turns'] ?? 0);
        $ar_go_unavailable = (int) ($overview_metrics['moderation_unavailable_turns'] ?? 0);
        // ⚠ Every counted population reaches this decision, INCLUDING the
        // fail-closed one. It stays out of the segments (above) but it is
        // still evidence that the period had turns: left out here, a window
        // of nothing but fail-closed turns printed "No conversations in this
        // period yet." directly above the line saying some could not be
        // safety-checked, next to a non-zero Total Messages tile. Zeros are
        // real counts on this card; an empty-state that contradicts the line
        // beneath it is not. (Codex P2 on PR #284.)
        $ar_go_any        = ($ar_go_grounded + $ar_go_ungrounded + $ar_go_deflected + $ar_go_conv + $ar_go_moderated + $ar_go_unavailable) > 0;
        ?>
        <div class="answerrails-card answerrails-span-6" id="answerrails-grounding-outcomes">
            <h3><?php esc_html_e('Grounding outcomes', 'answerrails'); ?></h3>
            <?php if ($ar_go_any): ?>
                <div class="answerrails-grounding-counts">
                    <div class="answerrails-grounding-count">
                        <span class="metric-value"><?php echo esc_html(number_format_i18n($ar_go_grounded)); ?></span>
                        <span class="metric-label"><?php esc_html_e('Grounded — answered from your knowledge base', 'answerrails'); ?></span>
                    </div>
                    <div class="answerrails-grounding-count">
                        <span class="metric-value"><?php echo esc_html(number_format_i18n($ar_go_ungrounded)); ?></span>
                        <span class="metric-label"><?php esc_html_e('No grounding found — answered with general knowledge', 'answerrails'); ?></span>
                    </div>
                    <div class="answerrails-grounding-count">
                        <span class="metric-value"><?php echo esc_html(number_format_i18n($ar_go_deflected)); ?></span>
                        <?php // ⚠ Vocabulary rule: without escalation machinery the handoff PATH is a deflection — the label must not claim routing. #276 D2 generalised it further: the count now also carries the integrity deflections, which never touched a contact route at all. ?>
                        <span class="metric-label"><?php esc_html_e('Deflected — declined to answer rather than risk a wrong one', 'answerrails'); ?></span>
                    </div>
                    <div class="answerrails-grounding-count">
                        <span class="metric-value"><?php echo esc_html(number_format_i18n($ar_go_conv)); ?></span>
                        <?php // #136 (DD12): conversational turns are their own segment — real counts, no counterfactuals, no grounding claim. ?>
                        <span class="metric-label"><?php esc_html_e('Conversational — greetings and small talk; no grounding needed', 'answerrails'); ?></span>
                    </div>
                    <div class="answerrails-grounding-count">
                        <span class="metric-value"><?php echo esc_html(number_format_i18n($ar_go_moderated)); ?></span>
                        <?php // #278 D3: moderated turns were counted by Total Messages and by nothing else on this screen. No AI ran, so the label claims no answer — the #136 shape, real counts, its own label, no grounding claim. ?>
                        <span class="metric-label"><?php esc_html_e('Moderated — handled by the content-safety layer before any AI ran', 'answerrails'); ?></span>
                    </div>
                </div>
            <?php else: ?>
                <p class="card-description"><?php esc_html_e('No conversations in this period yet.', 'answerrails'); ?></p>
            <?php endif; ?>
            <?php if ($ar_go_unavailable > 0): ?>
                <p class="card-description answerrails-grounding-unavailable">
                    <?php printf(
                        /* translators: %s: number of turns that could not be safety-checked */
                        esc_html(_n(
                            '%s turn could not be safety-checked — the moderation service was unavailable (see API health)',
                            '%s turns could not be safety-checked — the moderation service was unavailable (see API health)',
                            $ar_go_unavailable,
                            'answerrails'
                        )),
                        esc_html(number_format_i18n($ar_go_unavailable))
                    ); ?>
                </p>
            <?php endif; ?>
            <p class="card-description answerrails-grounding-tier-line">
                <?php esc_html_e('Retrieves the top 5 passages per answer. Adjustable retrieval depth and product and URL sources are in AnswerRails Pro, a separate plugin.', 'answerrails'); ?>
            </p>
        </div>

        <?php
        // E9: the analytics summary insertion point — AnswerRails Pro
        // renders its tiles (grounding rate, answer quality, handoff rate,
        // retrieval relevance, structured fallbacks) here. Nothing hooked
        // = nothing rendered (no placeholder card).
        do_action('answerrails_overview_sections', array_merge($ar_overview_context, array('section' => 'analytics_tiles')));
        ?>

        <?php // ⚠ D10: there is no recent-conversations detail section on
              // either tier — it duplicates the free Chat Logs surface
              // (the Chat Logs submenu, deliberate free). ?>
        <?php
        // Knowledge Gaps live in the Business Intelligence admin (gap
        // mining rides pro analytics); Top Sources rides the E9 analytics
        // summary. Nothing hooked = nothing rendered.
        do_action('answerrails_overview_sections', array_merge($ar_overview_context, array('section' => 'analytics_detail')));
        ?>

        <?php // Invalid URL Monitoring lives in the Business Intelligence
              // admin with the rest of the drill-down surfaces. ?>

        <!-- Row 6: Experience Scores, Performance Metrics & System Health -->
        <div class="answerrails-card answerrails-span-4 status-summary-card">
            <div class="card-header">
                <div>
                    <h3><?php esc_html_e('Experience Scores', 'answerrails'); ?></h3>
                    <p class="card-description"><?php esc_html_e('Key health indicators for your assistant.', 'answerrails'); ?></p>
                </div>
            </div>
            <div class="status-summary-list">
                <?php foreach ($status_summaries as $summary): ?>
                    
                    <?php
                    $value_display = null !== $summary['value']
                        ? number_format_i18n($summary['value'], $summary['precision']) . $summary['unit']
                        : __('N/A', 'answerrails');
                    ?>
                    <div class="status-summary-item">
                        <div class="status-summary-header">
                            <span class="status-summary-title"><?php echo esc_html($summary['label']); ?></span>
                            <span class="status-summary-value"><?php echo esc_html($value_display); ?></span>
                        </div>
                        <div class="status-summary-bar">
                            <div class="status-summary-fill <?php echo esc_attr($summary['state']); ?>" style="width: <?php echo esc_attr($summary['percent']); ?>%;"></div>
                        </div>
                        <p class="status-summary-description"><?php echo esc_html($summary['description']); ?></p>
                    </div>
                <?php endforeach; ?>
                <?php
                // E9: pro appends its business summaries (quality score,
                // deflection rate) to this list.
                do_action('answerrails_overview_sections', array_merge($ar_overview_context, array('section' => 'experience_scores')));
                ?>
            </div>
        </div>

        <div class="answerrails-card answerrails-span-4">
            <h3><?php esc_html_e('Performance Metrics', 'answerrails'); ?></h3>
            <table class="performance-table">
                <thead>
                    <tr>
                        <th><?php esc_html_e('Metric', 'answerrails'); ?></th>
                        <th><?php esc_html_e('Value', 'answerrails'); ?></th>
                        <th><?php esc_html_e('Status', 'answerrails'); ?></th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td><?php esc_html_e('Response Time', 'answerrails'); ?></td>
                        <td><?php echo null !== $avg_response_time ? esc_html(number_format_i18n($avg_response_time, 2)) . 's' : esc_html__('N/A', 'answerrails'); ?></td>
                        <td>
                            <?php if (null !== $avg_response_time && $avg_response_time < 3): ?>
                                <span class="status-good"><?php esc_html_e('Good', 'answerrails'); ?></span>
                            <?php elseif (null !== $avg_response_time): ?>
                                <span class="status-warning"><?php esc_html_e('Slow', 'answerrails'); ?></span>
                            <?php else: ?>
                                <span class="status-neutral">&mdash;</span>
                            <?php endif; ?>
                        </td>
                    </tr>
                    <tr>
                        <td><?php esc_html_e('API Success Rate', 'answerrails'); ?></td>
                        <td><?php echo null !== $ar_chat_success['value'] ? esc_html(number_format_i18n($ar_chat_success['value'], 0)) . '%' : esc_html__('N/A', 'answerrails'); ?></td>
                        <td>
                            <?php if (null !== $ar_chat_success['word']): ?>
                                <span class="<?php echo esc_attr($ar_chat_success['row_class']); ?>"><?php echo esc_html($ar_chat_success['word']); ?></span>
                            <?php else: ?>
                                <span class="status-neutral">&mdash;</span>
                            <?php endif; ?>
                        </td>
                    </tr>
                    <tr>
                        <td><?php esc_html_e('Knowledge Items', 'answerrails'); ?></td>
                        <td>
                            <?php
                            if (post_type_exists('answerrails_kb')) {
                                $knowledge_count = wp_count_posts('answerrails_kb');
                                echo isset($knowledge_count->publish) ? esc_html(number_format_i18n($knowledge_count->publish)) : esc_html('0');
                            } else {
                                esc_html_e('N/A', 'answerrails');
                            }
                            ?>
                        </td>
                        <td>
                            <?php
                            if (post_type_exists('answerrails_kb')) {
                                $knowledge_count = wp_count_posts('answerrails_kb');
                                if (!empty($knowledge_count->publish)) {
                                    echo '<span class="status-good">' . esc_html__('Active', 'answerrails') . '</span>';
                                } else {
                                    echo '<span class="status-warning">' . esc_html__('Empty', 'answerrails') . '</span>';
                                }
                            } else {
                                echo '<span class="status-neutral">&mdash;</span>';
                            }
                            ?>
                        </td>
                    </tr>
                </tbody>
            </table>
        </div>

        <div class="answerrails-card answerrails-span-4">
            <h3><?php esc_html_e('System Health', 'answerrails'); ?></h3>
            <div class="health-checks">
                <div class="health-item">
                    <span class="dashicons <?php echo $system_status ? 'dashicons-yes' : 'dashicons-no'; ?>"></span>
                    <span><?php esc_html_e('Chat System:', 'answerrails'); ?> <?php echo $system_status ? esc_html__('Active', 'answerrails') : esc_html__('Disabled', 'answerrails'); ?></span>
                </div>
                <div class="health-item">
                    <span class="dashicons <?php echo !empty($api_key) ? 'dashicons-yes' : 'dashicons-no'; ?>"></span>
                    <span><?php esc_html_e('API Key:', 'answerrails'); ?> <?php echo !empty($api_key) ? esc_html__('Configured', 'answerrails') : esc_html__('Missing', 'answerrails'); ?></span>
                </div>
                <div class="health-item">
                    <?php $vector_store = get_option('answerrails_knowledge_vector_store_id'); ?>
                    <span class="dashicons <?php echo !empty($vector_store) ? 'dashicons-yes' : 'dashicons-warning'; ?>"></span>
                    <span><?php esc_html_e('Vector Store:', 'answerrails'); ?> <?php echo !empty($vector_store) ? esc_html__('Connected', 'answerrails') : esc_html__('Not Configured', 'answerrails'); ?></span>
                </div>
                <div class="health-item">
                    <?php $privacy_mode = AnswerRails_Logger::logging_mode(); /* #109: the effective mode, never the raw option */ ?>
                    <span class="dashicons dashicons-privacy"></span>
                    <span><?php esc_html_e('Privacy:', 'answerrails'); ?> <?php echo esc_html(ucfirst($privacy_mode)); ?> <?php esc_html_e('mode', 'answerrails'); ?></span>
                </div>
            </div>
        </div>

        <?php // ⚠ D9: there is no Business Ideas card here — ideas surface
              // only in the Business Intelligence admin, and the free build
              // renders no ideas empty-state anywhere. ?>

        <?php
        // E9: the quality-distribution insertion point — pro renders its
        // distribution card here; free renders nothing (no placeholder).
        do_action('answerrails_overview_sections', array_merge($ar_overview_context, array('section' => 'quality_distribution')));
        ?>
    </div>
</div>

<?php // #132 W5: inline styles moved to assets/css/overview.css (enqueued on this screen only). ?>

<?php // #132 W5: inline script moved to assets/js/overview-page.js (enqueued on this screen only). ?>
<?php
// Render the page footer
$this->render_footer();