<?php
/**
 * income_summary_s2s.php — ملخّص دخل السائق المارّ بالمحفظة
 * ─────────────────────────────────────────────────────────────
 * ‏يجيب على سؤال واحد: هل قناة تحصيل هذا السائق حيّة؟
 *
 * ‏تستعمله بوابة الائتمان في محرك الالتزامات. سائق الكاش الذي يحصّل
 * ‏نقداً ولا تمرّ أرباحه بالمحفظة يظهر بأرباح صفر كل يوم، فسقف الخصم
 * ‏اليومي صفر، فلا يُحصَّل منه شيء أبداً — ومنحه وقوداً أو صيانة بالدَّين
 * ‏يعني تسليمه قيمةً فعلية مقابل وعد بالسداد من قناة لا يمرّ بها ماله.
 *
 * ‏المقياس الأساسي أيام لا مبلغ: السؤال ليس «كم يكسب؟» بل «هل المال
 * ‏يمرّ من هنا بانتظام؟». دخل واحد كبير قد يكون استرداداً أو تسوية
 * ‏حادثة؛ اثنا عشر يوماً متفرّقاً قناةٌ تعمل.
 *
 * ‏قراءة فقط — لا تكتب شيئاً ولا تلمس رصيداً.
 */

require_once __DIR__ . '/../../jwtconnect.php';

// ‏نداء خادم-لخادم حصراً. الرد يُبنى عليه قرار منح ائتمان، فلا يُفتح
// ‏لجلسة سائق قد تسأل عن غيره.
$providedKey = $_SERVER['HTTP_X_S2S_API_KEY'] ?? '';
$expectedKey = getenv('S2S_SHARED_KEY') ?: '';
if (empty($expectedKey) || empty($providedKey) || !hash_equals($expectedKey, $providedKey)) {
    http_response_code(401);
    printFailure('Unauthorized: Invalid or missing X-S2S-Api-Key.');
    exit;
}

$driverID = filterRequest('driverID');
$windowDays = (int) (filterRequest('window_days', 'numeric') ?: 30);

if (empty($driverID)) {
    printFailure('Missing required parameter: driverID');
    exit;
}

// ‏نافذة محدودة: مسح سنوات من الحركات لكل فحص أهلية حِمل بلا فائدة —
// ‏دخلُ سائقٍ قبل ستة أشهر لا يقول شيئاً عن قناته اليوم.
if ($windowDays < 1 || $windowDays > 180) {
    $windowDays = 30;
}

try {
    // ‏الصفوف الموجبة وحدها. السالبة خصومات (عمولة، التزامات) وعدّها
    // ‏هنا كان سيجعل سائقاً يُخصم منه كثيراً يبدو ذا قناة نشطة.
    //
    // ‏وباستثناء صفوف الالتزامات صراحةً: 'obligation' مرجعها هذا المحرك
    // ‏نفسه، ولو ظهرت يوماً بمبلغ موجب (تصحيح، استرداد) لصارت البوابة
    // ‏تقيس أثر نفسها.
    $st = $con->prepare("
        SELECT
            COUNT(DISTINCT DATE(dateCreated)) AS days_with_income,
            COALESCE(SUM(amount), 0)          AS total_income,
            MAX(DATE(dateCreated))            AS last_income_date
        FROM driverWallet
        WHERE driverID = ?
          AND amount > 0
          AND paymentMethod <> 'obligation'
          AND dateCreated >= DATE_SUB(CURDATE(), INTERVAL ? DAY)
    ");
    $st->execute([$driverID, $windowDays]);
    $row = $st->fetch(PDO::FETCH_ASSOC) ?: [];

    printSuccess([
        'driver_id'        => $driverID,
        'window_days'      => $windowDays,
        'days_with_income' => (int) ($row['days_with_income'] ?? 0),
        'total_income'     => (float) ($row['total_income'] ?? 0),
        'last_income_date' => $row['last_income_date'] ?? null,
    ]);
} catch (PDOException $e) {
    error_log('[obligation/income_summary] ' . $e->getMessage());
    http_response_code(500);
    printFailure('Failed to read income summary');
}