Update codebase

2026-08-09 16:56:13 +03:00
parent 95e2e4f35d
commit b64debaa88
1058 changed files with 164327 additions and 113928 deletions
@@ -0,0 +1,136 @@
+<?php
+// ============================================================
+// ride/siroWallet/summary.php
+// ملخّص محفظة سيرو — شهري وإجمالي مع تفصيل الإيداع والصرف
+// ============================================================
+//
+// لماذا ملف جديد بدل تعديل get.php:
+//   • get.php يُرجع SUM(amount) واحداً للشهر الجاري فقط، بعمود بلا اسم
+//     (المفتاح يصل للعميل كـ "SUM(amount)")، ولا يفرّق بين الإيداع والصرف.
+//   • get.php يستدعي printSuccess()/printFailure() وهما غير معرّفتين في
+//     payment_server/v2 إطلاقاً (لا في functions.php ولا في connect.php) —
+//     معرّفتان محلياً داخل ملفَّي syriatel فقط. أي أن get.php يسقط بخطأ
+//     "undefined function" فور اجتياز المصادقة.
+//   • فحص حيّ في 2026-08-03: get.php يُرجع 404 على v1 و v2 معاً — أي أنه
+//     غير منشور أصلاً، بينما driverWallet/get.php يُرجع 401 (موجود).
+//
+// لذلك هذا الملف مكتفٍ بذاته: لا يعتمد إلا على connect.php و json_encode.
+//
+// الرد:
+//   month_to_date / previous_month / all_time، ولكلٍّ:
+//     credits    → مجموع الحركات الموجبة (إيداع)
+//     debits     → مجموع الحركات السالبة (صرف/سحب) كقيمة موجبة
+//     net        → الصافي
+//     tx_count   → عدد الحركات
+//   by_payment_method → تفصيل الشهر الجاري حسب وسيلة الدفع
+// ============================================================
+
+require_once __DIR__ . '/../../connect.php';
+
+// connect.php ينفّذ authenticateJWT() ويُسقط الطلب عند الفشل، فالوصول إلى
+// هنا يعني توكناً صالحاً. نقصر الملخّص المالي على الأدوار الإدارية.
+$role = $decodedToken->role ?? null;
+if ($role !== 'admin' && $role !== 'super_admin') {
+    http_response_code(403);
+    echo json_encode([
+        'status'  => 'failure',
+        'message' => 'Forbidden. Admin access required.',
+    ], JSON_UNESCAPED_UNICODE);
+    exit;
+}
+
+/**
+ * مجاميع نافذة زمنية واحدة.
+ * الحركات السالبة تُعاد كقيمة موجبة في debits ليقرأها العميل مباشرة.
+ */
+function siroWalletWindow(PDO $con, ?string $from, ?string $to): array
+{
+    $where  = '';
+    $params = [];
+    if ($from !== null && $to !== null) {
+        $where = 'WHERE createdAt >= :from AND createdAt < :to';
+        $params = [':from' => $from, ':to' => $to];
+    }
+
+    $stmt = $con->prepare("
+        SELECT
+            COALESCE(SUM(CASE WHEN amount > 0 THEN amount ELSE 0 END), 0) AS credits,
+            COALESCE(SUM(CASE WHEN amount < 0 THEN -amount ELSE 0 END), 0) AS debits,
+            COALESCE(SUM(amount), 0)                                      AS net,
+            COUNT(*)                                                      AS tx_count
+        FROM `siroWallet`
+        $where
+    ");
+    $stmt->execute($params);
+    $row = $stmt->fetch(PDO::FETCH_ASSOC) ?: [];
+
+    return [
+        'credits'  => (float)($row['credits']  ?? 0),
+        'debits'   => (float)($row['debits']   ?? 0),
+        'net'      => (float)($row['net']      ?? 0),
+        'tx_count' => (int)  ($row['tx_count'] ?? 0),
+    ];
+}
+
+try {
+    // حدود الشهر تُحسب في PHP لا في SQL، حتى تتبع المنطقة الزمنية للتطبيق
+    // ويسهل اختبارها، ولتفادي BETWEEN على TIMESTAMP الذي يُسقط آخر يوم.
+    $startThisMonth = date('Y-m-01 00:00:00');
+    $startNextMonth = date('Y-m-01 00:00:00', strtotime('first day of next month'));
+    $startPrevMonth = date('Y-m-01 00:00:00', strtotime('first day of last month'));
+
+    $monthToDate   = siroWalletWindow($con, $startThisMonth, $startNextMonth);
+    $previousMonth = siroWalletWindow($con, $startPrevMonth, $startThisMonth);
+    $allTime       = siroWalletWindow($con, null, null);
+
+    // تفصيل الشهر الجاري حسب وسيلة الدفع
+    $stmt = $con->prepare("
+        SELECT
+            paymentMethod,
+            COALESCE(SUM(amount), 0) AS net,
+            COUNT(*)                 AS tx_count
+        FROM `siroWallet`
+        WHERE createdAt >= :from AND createdAt < :to
+        GROUP BY paymentMethod
+        ORDER BY net DESC
+    ");
+    $stmt->execute([':from' => $startThisMonth, ':to' => $startNextMonth]);
+
+    $byMethod = [];
+    foreach ($stmt->fetchAll(PDO::FETCH_ASSOC) as $r) {
+        $byMethod[] = [
+            'payment_method' => $r['paymentMethod'] !== '' ? $r['paymentMethod'] : 'unknown',
+            'net'            => (float)$r['net'],
+            'tx_count'       => (int)$r['tx_count'],
+        ];
+    }
+
+    // نسبة التغيّر عن الشهر السابق — الواجهة تعرضها كمؤشّر اتجاه
+    $prevNet = $previousMonth['net'];
+    $growth  = ($prevNet != 0.0)
+        ? round((($monthToDate['net'] - $prevNet) / abs($prevNet)) * 100, 2)
+        : null;
+
+    echo json_encode([
+        'status' => 'success',
+        'data'   => [
+            'month_to_date'      => $monthToDate,
+            'previous_month'     => $previousMonth,
+            'all_time'           => $allTime,
+            'growth_percent'     => $growth, // null عندما لا يوجد أساس للمقارنة
+            'by_payment_method'  => $byMethod,
+            'period' => [
+                'month_start' => $startThisMonth,
+                'generated_at' => date('Y-m-d H:i:s'),
+            ],
+        ],
+    ], JSON_UNESCAPED_UNICODE);
+
+} catch (Throwable $e) {
+    error_log('[siroWallet/summary] ' . $e->getMessage());
+    http_response_code(500);
+    echo json_encode([
+        'status'  => 'failure',
+        'message' => 'An internal error occurred.',
+    ], JSON_UNESCAPED_UNICODE);
+}