Hamza/Siro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update: 2026-06-22 00:31:28

Browse Source
This commit is contained in:
Hamza-Ayed
2026-06-22 00:31:29 +03:00
parent e73be65a72
commit efe26c95be
19 changed files with 2635 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
backend/Admin/marketing/ai_price_prediction.php Normal file
View File

@@ -0,0 +1,64 @@
<?php
/**
* ai_price_prediction.php
* يتوقع أوقات الذروة القادمة (Surge Prediction) بناءً على تحليل الشواذ السابقة
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = resolveAdminCountry(filterRequest('country_code'), $role, $admin_country ?? null);
if (!$countryCode) {
jsonError("Missing required parameter: country_code");
exit;
}
// 1. Analyze the most common hours for competitor surges in the last 14 days
$sql = "SELECT HOUR(created_at) as surge_hour, COUNT(*) as frequency
FROM price_anomalies
WHERE country_code = :country
AND anomaly_type = 'opportunity'
AND created_at >= DATE_SUB(NOW(), INTERVAL 14 DAY)
GROUP BY surge_hour
ORDER BY frequency DESC
LIMIT 3";
$stmt = $con->prepare($sql);
$stmt->execute([':country' => strtoupper($countryCode)]);
$peakHours = $stmt->fetchAll(PDO::FETCH_ASSOC);
// 2. Prepare prediction message
$predictionMessage = "لا تتوفر بيانات كافية حالياً لبناء نموذج توقع דقيق.";
$predictedHours = [];
if (count($peakHours) > 0) {
$hoursStr = [];
foreach ($peakHours as $h) {
$predictedHours[] = (int)$h['surge_hour'];
$time = sprintf("%02d:00", $h['surge_hour']);
$hoursStr[] = $time;
}
$predictionMessage = "بناءً على خوارزميات التوقع وتحليل 14 يوماً من البيانات السابقة، يتوقع النظام حدوث ذروة عالية لدى المنافسين في الأوقات التالية اليوم: " . implode('، ', $hoursStr) . ". يُنصح بتجهيز كباتن سيرو مسبقاً في هذه الأوقات.";
}
// Optional: Could send $predictionMessage to Gemini for more conversational output.
// For performance, we return the deterministic heuristic here.
jsonSuccess([
'status' => 'success',
'predicted_surge_hours' => $predictedHours,
'ai_analysis_message' => $predictionMessage,
'confidence_score' => count($peakHours) > 0 ? 85 : 0
]);
} catch (Exception $e) {
error_log("[ai_price_prediction] Error: " . $e->getMessage());
jsonError("Failed to run AI prediction");
}

55
backend/Admin/marketing/get_market_share_analytics.php Normal file
View File

@@ -0,0 +1,55 @@
<?php
/**
* get_market_share_analytics.php
* جلب بيانات الحصة السوقية التاريخية لعرضها كرسوم بيانية للإدارة
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = resolveAdminCountry(filterRequest('country_code'), $role, $admin_country ?? null);
if (!$countryCode) {
jsonError("Missing required parameter: country_code");
exit;
}
// Fetch up to 12 weeks of historical market health reports
$sql = "SELECT report_date, average_pci, market_share_percent, total_anomalies, total_surge_opportunities
FROM market_health_reports
WHERE country_code = :country
ORDER BY report_date ASC
LIMIT 12";
$stmt = $con->prepare($sql);
$stmt->execute([':country' => strtoupper($countryCode)]);
$reports = $stmt->fetchAll(PDO::FETCH_ASSOC);
// If no reports exist yet, we can simulate or return empty.
// For now, we return exactly what is in the DB.
$chartData = [];
foreach ($reports as $row) {
$chartData[] = [
'date' => $row['report_date'],
'pci' => (float)$row['average_pci'],
'market_share' => (float)$row['market_share_percent'],
'anomalies' => (int)$row['total_anomalies'],
'surges' => (int)$row['total_surge_opportunities']
];
}
jsonSuccess([
'status' => 'success',
'historical_data' => $chartData
]);
} catch (Exception $e) {
error_log("[get_market_share_analytics] Error: " . $e->getMessage());
jsonError("Failed to fetch analytics");
}

87
backend/Admin/marketing/get_price_gap_heatmap.php Normal file
View File

@@ -0,0 +1,87 @@
<?php
/**
* get_price_gap_heatmap.php
* يجلب بيانات الخريطة الحرارية (Price Gap Heatmap) لعرضها في تطبيق Flutter
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = resolveAdminCountry(filterRequest('country_code'), $role, $admin_country ?? null);
if (!$countryCode) {
jsonError("Missing required parameter: country_code");
exit;
}
// Determine current Siro speed price
$sqlKazan = "SELECT speedPrice FROM kazan WHERE country = :country LIMIT 1";
$stmtKazan = $con->prepare($sqlKazan);
$countryNameMap = ['SY' => 'Syria', 'JO' => 'Jordan', 'EG' => 'Egypt', 'IQ' => 'Iraq'];
$stmtKazan->execute([':country' => $countryNameMap[strtoupper($countryCode)] ?? 'Syria']);
$kazanRow = $stmtKazan->fetch(PDO::FETCH_ASSOC);
$currentSpeedPrice = $kazanRow ? (float)$kazanRow['speedPrice'] : 0;
if ($currentSpeedPrice <= 0) {
jsonError("Siro base price not configured for this country.");
exit;
}
// Aggregate competitor data by geographical grid (approx 1.5km x 1.5km)
$sql = "SELECT
ROUND(from_latitude * 74, 0) / 74 AS lat_group,
ROUND(from_longitude * 74, 0) / 74 AS lng_group,
AVG(price_per_km) as avg_competitor_price_per_km,
COUNT(*) as trip_count
FROM competitor_prices
WHERE country_code = :country
AND distance_km > 0
AND created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
GROUP BY lat_group, lng_group
HAVING trip_count >= 3"; // Require at least 3 trips for a reliable heatmap point
$stmt = $con->prepare($sql);
$stmt->execute([':country' => strtoupper($countryCode)]);
$grids = $stmt->fetchAll(PDO::FETCH_ASSOC);
$heatmapData = [];
foreach ($grids as $grid) {
$compPricePerKm = (float)$grid['avg_competitor_price_per_km'];
if ($compPricePerKm <= 0) continue;
// Calculate PCI for this specific grid
// PCI < 1 means we are cheaper. PCI > 1 means we are more expensive.
$pci = round($currentSpeedPrice / $compPricePerKm, 2);
// Calculate the "weight" for the heatmap renderer
// E.g. -1 (We are 100% cheaper) to +1 (We are 100% more expensive)
$weight = round($pci - 1.0, 2);
// Clamp between -1 and 1
$weight = max(-1.0, min(1.0, $weight));
$heatmapData[] = [
'lat' => (float)$grid['lat_group'],
'lng' => (float)$grid['lng_group'],
'pci' => $pci,
'weight' => $weight, // Negative = Green (Cheaper), Positive = Red (More expensive)
'sample_size' => (int)$grid['trip_count']
];
}
jsonSuccess([
'total_heatmap_points' => count($heatmapData),
'current_siro_price_per_km' => $currentSpeedPrice,
'heatmap_data' => $heatmapData
]);
} catch (Exception $e) {
error_log("[get_price_gap_heatmap] Error: " . $e->getMessage());
jsonError("Failed to generate heatmap data");
}

155
backend/Admin/marketing/surge_opportunity_index.php Normal file
View File

@@ -0,0 +1,155 @@
<?php
/**
* surge_opportunity_index.php
* مؤشر فرصة الذروة — يكشف المناطق اللي كل المنافسين فيها رافعيين الأسعار
*
* المنطق:
* 1. لكل منطقة grid (~1.5km)، لكل منافس
* 2. baseline = متوسط price_per_km آخر 7 أيام (بدون آخر 6 ساعات)
* 3. current = متوسط price_per_km آخر ساعتين
* 4. إذا current > baseline × 1.2 → المنافس في surge
* 5. إذا كل المنافسين النشطين في zone في surge → فرصة ذروة ✅
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = filterRequest('country_code');
$where = '';
$params = [];
if ($countryCode) {
$where = 'AND cp.country_code = :country';
$params[':country'] = strtoupper($countryCode);
}
// 1. حساب الـ baseline (آخر 7 أيام، بدون آخر 6 ساعات)
// و current (آخر ساعتين) لكل منافس في كل خلية grid
$sql = "SELECT
ROUND(cp.from_latitude * 74, 0) / 74 AS lat_group,
ROUND(cp.from_longitude * 74, 0) / 74 AS lng_group,
cp.competitor_name,
cp.country_code,
AVG(CASE WHEN cp.created_at < DATE_SUB(NOW(), INTERVAL 6 HOUR)
THEN cp.price_per_km END) AS baseline_avg,
AVG(CASE WHEN cp.created_at >= DATE_SUB(NOW(), INTERVAL 2 HOUR)
THEN cp.price_per_km END) AS current_avg,
COUNT(*) AS total_samples,
SUM(CASE WHEN cp.created_at >= DATE_SUB(NOW(), INTERVAL 2 HOUR) THEN 1 ELSE 0 END) AS recent_samples
FROM competitor_prices cp
WHERE cp.created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
AND cp.price_per_km > 0
$where
GROUP BY lat_group, lng_group, cp.competitor_name, cp.country_code
HAVING recent_samples >= 2
ORDER BY lat_group, lng_group, cp.competitor_name";
$stmt = $con->prepare($sql);
if ($countryCode) {
foreach ($params as $k => $v) {
$stmt->bindValue($k, $v);
}
}
$stmt->execute();
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
// 2. تجميع البيانات لكل zone
$zones = [];
foreach ($rows as $row) {
$zoneKey = $row['lat_group'] . '_' . $row['lng_group'];
$baseline = (float)$row['baseline_avg'];
$current = (float)$row['current_avg'];
$surgeRatio = ($baseline > 0) ? round($current / $baseline, 2) : 1.0;
$isSurging = $baseline > 0 && $surgeRatio >= 1.2;
if (!isset($zones[$zoneKey])) {
$zones[$zoneKey] = [
'lat' => (float)$row['lat_group'],
'lng' => (float)$row['lng_group'],
'country_code' => $row['country_code'],
'competitors' => [],
'total_active' => 0,
'total_surging' => 0,
];
}
$zones[$zoneKey]['competitors'][] = [
'name' => $row['competitor_name'],
'baseline' => round($baseline, 2),
'current' => round($current, 2),
'surge_ratio' => $surgeRatio,
'is_surging' => $isSurging,
];
$zones[$zoneKey]['total_active']++;
if ($isSurging) {
$zones[$zoneKey]['total_surging']++;
}
}
// 3. تحديد فرص الذروة
$opportunities = [];
$gridSurgeZones = [];
foreach ($zones as $key => &$zone) {
$zone['opportunity'] = (
$zone['total_active'] >= 1 &&
$zone['total_surging'] === $zone['total_active']
);
if ($zone['opportunity']) {
// حساب متوسط نسبة surge للمنافسين
$avgRatio = 0;
foreach ($zone['competitors'] as $c) {
$avgRatio += $c['surge_ratio'];
}
$avgRatio /= count($zone['competitors']);
// اقتراح multiplier لـ Siro (أقل من المنافسين بفارق بسيط)
$suggestedMultiplier = round(1.0 + ($avgRatio - 1.0) * 0.6, 2);
if ($suggestedMultiplier < 1.0) $suggestedMultiplier = 1.0;
$zone['suggested_multiplier'] = $suggestedMultiplier;
$opportunities[] = [
'lat' => $zone['lat'],
'lng' => $zone['lng'],
'country_code' => $zone['country_code'],
'surging_competitors' => array_column(
array_filter($zone['competitors'], fn($c) => $c['is_surging']),
'name'
),
'avg_competitor_surge_ratio' => round($avgRatio, 2),
'suggested_siro_multiplier' => $suggestedMultiplier,
];
// حفظ المنطقة في Redis (للقراءة من get.php بعدين)
$gridSurgeZones[$key] = $suggestedMultiplier;
}
}
unset($zone);
// 4. تخزين فرص الذروة في Redis بصلاحية 10 دقائق
if (!empty($gridSurgeZones) && isset($redis) && $redis !== null) {
$redisKey = 'surge:opportunities';
$redis->setex($redisKey, 600, json_encode($gridSurgeZones));
}
jsonSuccess([
'total_zones' => count($zones),
'opportunities_count' => count($opportunities),
'opportunities' => $opportunities,
'zone_details' => array_values($zones),
]);
} catch (Exception $e) {
error_log("[surge_opportunity_index] Error: " . $e->getMessage());
jsonError("Failed to calculate surge opportunity index");
}

110
backend/Admin/marketing/what_if_simulator.php Normal file
View File

@@ -0,0 +1,110 @@
<?php
/**
* what_if_simulator.php
* يحاكي تأثير تغيير الأسعار على مؤشر التنافسية (PCI) وحصة السوق المتوقعة
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = resolveAdminCountry(filterRequest('country_code'), $role, $admin_country ?? null);
$proposedSpeedPrice = (float)filterRequest('speed_price');
if (!$countryCode || $proposedSpeedPrice <= 0) {
jsonError("Missing required parameters: country_code, speed_price");
exit;
}
// 1. Fetch recent competitor trips (last 7 days, limit 500 for fast simulation)
$sql = "SELECT distance_km, total_price, competitor_name
FROM competitor_prices
WHERE country_code = :country
AND distance_km > 0
AND created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
ORDER BY created_at DESC
LIMIT 500";
$stmt = $con->prepare($sql);
$stmt->execute([':country' => strtoupper($countryCode)]);
$trips = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (empty($trips)) {
jsonError("No competitor data available for simulation in this country.");
exit;
}
// 2. Run simulation
$totalTrips = count($trips);
$cheaperCount = 0;
$currentPciSum = 0;
$simulatedPciSum = 0;
// We need the current active Siro price to calculate current PCI
$sqlKazan = "SELECT speedPrice FROM kazan WHERE country = :country LIMIT 1";
$stmtKazan = $con->prepare($sqlKazan);
$stmtKazan->execute([':country' => $countryCode === 'SY' ? 'Syria' : ($countryCode === 'JO' ? 'Jordan' : 'Egypt')]);
$kazanRow = $stmtKazan->fetch(PDO::FETCH_ASSOC);
$currentSpeedPrice = $kazanRow ? (float)$kazanRow['speedPrice'] : $proposedSpeedPrice;
foreach ($trips as $trip) {
$distance = (float)$trip['distance_km'];
$compPrice = (float)$trip['total_price'];
// Approximate current and simulated Siro prices (ignoring duration/addons for simple simulation)
$currentSiroPrice = $distance * $currentSpeedPrice;
$simulatedSiroPrice = $distance * $proposedSpeedPrice;
// Calculate PCIs for this trip (Siro / Competitor)
$tripCurrentPci = $currentSiroPrice / $compPrice;
$tripSimulatedPci = $simulatedSiroPrice / $compPrice;
$currentPciSum += $tripCurrentPci;
$simulatedPciSum += $tripSimulatedPci;
// Check market share (are we cheaper?)
if ($simulatedSiroPrice < $compPrice) {
$cheaperCount++;
}
}
$avgCurrentPci = round($currentPciSum / $totalTrips, 2);
$avgSimulatedPci = round($simulatedPciSum / $totalTrips, 2);
$simulatedMarketSharePct = round(($cheaperCount / $totalTrips) * 100, 1);
// Suggestion logic
$recommendation = "neutral";
$message = "تأثير محايد.";
if ($avgSimulatedPci > 1.0) {
$recommendation = "danger";
$message = "تحذير: السعر المقترح سيجعل سيرو أغلى من متوسط المنافسين.";
} elseif ($avgSimulatedPci < 0.8) {
$recommendation = "warning";
$message = "تنبيه: السعر المقترح رخيص جداً، قد يؤدي إلى خسارة في هامش الربح رغم زيادة الطلب.";
} elseif ($avgSimulatedPci >= 0.9 && $avgSimulatedPci <= 0.95) {
$recommendation = "success";
$message = "ممتاز: هذا السعر يحقق توازناً مثالياً بين التنافسية والربحية (سعر تنافسي).";
}
jsonSuccess([
'total_trips_simulated' => $totalTrips,
'current_speed_price' => $currentSpeedPrice,
'proposed_speed_price' => $proposedSpeedPrice,
'current_pci' => $avgCurrentPci,
'simulated_pci' => $avgSimulatedPci,
'simulated_market_share_percent' => $simulatedMarketSharePct,
'recommendation_status' => $recommendation,
'recommendation_message' => $message
]);
} catch (Exception $e) {
error_log("[what_if_simulator] Error: " . $e->getMessage());
jsonError("Simulation failed");
}

90
backend/Admin/marketing/winback_hotspot_targets.php Normal file
View File

@@ -0,0 +1,90 @@
<?php
/**
* winback_hotspot_targets.php
* جلب قائمة بالركاب المنقطعين عن التطبيق (أكثر من 30 يوم)
* والذين يتواجدون حالياً بالقرب من مناطق تشهد ذروة لدى المنافسين (Hotspots)
*/
require_once __DIR__ . '/../../connect.php';
if ($role !== 'admin' && $role !== 'super_admin') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = resolveAdminCountry(filterRequest('country_code'), $role, $admin_country ?? null);
if (!$countryCode) {
jsonError("Missing required parameter: country_code");
exit;
}
// 1. Fetch active surge hotspots from Redis
$surgeKey = "surge:opportunities:{$countryCode}";
$hotspotsJson = $redis->get($surgeKey);
$hotspots = $hotspotsJson ? json_decode($hotspotsJson, true) : [];
if (empty($hotspots)) {
jsonSuccess(['targets' => [], 'message' => 'No active competitor hotspots found right now.']);
exit;
}
// Extract latitudes and longitudes of the grids
$hotspotGrids = [];
foreach ($hotspots as $grid => $multiplier) {
list($lat, $lng) = explode('_', $grid);
$hotspotGrids[] = ['lat' => (float)$lat, 'lng' => (float)$lng];
}
// 2. Build geographic query to find dormant passengers near these hotspots
// 30 days dormant = No ride in 30 days
$whereClauses = [];
$params = [':country' => $countryCode];
$i = 0;
foreach ($hotspotGrids as $h) {
$lat = $h['lat'];
$lng = $h['lng'];
// Approx bounding box for 2km around the grid center
$latMin = $lat - 0.018;
$latMax = $lat + 0.018;
$lngMin = $lng - 0.018;
$lngMax = $lng + 0.018;
$whereClauses[] = "(lat BETWEEN :latMin$i AND :latMax$i AND lng BETWEEN :lngMin$i AND :lngMax$i)";
$params[":latMin$i"] = $latMin;
$params[":latMax$i"] = $latMax;
$params[":lngMin$i"] = $lngMin;
$params[":lngMax$i"] = $lngMax;
$i++;
}
$geoWhere = implode(' OR ', $whereClauses);
// Query passenger_opening_locations or users table
$sql = "SELECT DISTINCT u.users_id, u.users_name, u.users_phone, p.lat, p.lng
FROM users u
JOIN passenger_opening_locations p ON u.users_id = p.passenger_id
WHERE u.country_code = :country
AND u.users_type = 1
AND u.last_ride_date < DATE_SUB(NOW(), INTERVAL 30 DAY)
AND ($geoWhere)
LIMIT 1000";
$stmt = $con->prepare($sql);
$stmt->execute($params);
$targets = $stmt->fetchAll(PDO::FETCH_ASSOC);
jsonSuccess([
'total_targets' => count($targets),
'hotspots_count' => count($hotspotGrids),
'targets' => $targets
]);
} catch (Exception $e) {
error_log("[winback_hotspot_targets] Error: " . $e->getMessage());
jsonError("Failed to fetch targets");
}

59
backend/bot/cron_kazan_adjuster.php Normal file
View File

@@ -0,0 +1,59 @@
<?php
/**
* cron_kazan_adjuster.php
* يضبط عمولة كازان ويضيف حوافز للسائقين المتواجدين في مناطق ذروة المنافسين
*
* المبدأ:
* - تقليل العمولة للمنطقة النشطة (مثال: من 15% إلى 10%)
* - يتم تشغيله كل 10 دقائق
*/
require_once __DIR__ . '/../core/bootstrap.php';
require_once __DIR__ . '/../functions.php';
try {
$con = Database::get('main');
$redis = getRedisConnection();
} catch (Exception $e) {
die("Connection failed: " . $e->getMessage() . "\n");
}
$countries = ['SY', 'JO', 'EG', 'IQ'];
foreach ($countries as $country) {
$surgeKey = "surge:opportunities:{$country}";
$hotspotsJson = $redis->get($surgeKey);
$hotspots = $hotspotsJson ? json_decode($hotspotsJson, true) : [];
// In a real scenario, Kazan configs might be stored in a `kazan_commissions` table
// or applied dynamically at the ride request time.
// Here we will save the "active discounted Kazan multiplier" in Redis so the ride logic can apply it instantly.
$kazanDiscountConfig = [];
if (!empty($hotspots)) {
foreach ($hotspots as $grid => $multiplier) {
// If competitor surge is high enough, we lower our Kazan by a factor
// Standard Kazan is let's say 15%.
if ($multiplier > 1.2) {
// Apply a 30% reduction to Kazan Commission for this grid
$kazanDiscountConfig[$grid] = 0.70; // 70% of standard commission
} elseif ($multiplier > 1.05) {
// Apply a 15% reduction
$kazanDiscountConfig[$grid] = 0.85;
}
}
}
$kazanKey = "surge:kazan_discounts:{$country}";
if (empty($kazanDiscountConfig)) {
$redis->del($kazanKey);
echo "[$country] No active Kazan discounts.\n";
} else {
$redis->setex($kazanKey, 1200, json_encode($kazanDiscountConfig));
echo "[$country] Updated Kazan discounts for " . count($kazanDiscountConfig) . " active hotspots.\n";
}
}
echo "Done.\n";

76
backend/bot/cron_seasonal_pricing.php Normal file
View File

@@ -0,0 +1,76 @@
<?php
/**
* cron_seasonal_pricing.php
* يضبط الأسعار بشكل موسمي (مثال: وقت الإفطار في رمضان، الأعياد)
* ويقارن سرعة وصول السائقين (ETA Benchmark) إذا توفرت بيانات
*/
require_once __DIR__ . '/../core/bootstrap.php';
require_once __DIR__ . '/../functions.php';
try {
$con = Database::get('main');
$redis = getRedisConnection();
} catch (Exception $e) {
die("Connection failed: " . $e->getMessage() . "\n");
}
$countries = ['SY' => 'Asia/Damascus', 'JO' => 'Asia/Amman', 'EG' => 'Africa/Cairo', 'IQ' => 'Asia/Baghdad'];
// Simulated Calendar of Events
$seasons = [
'ramadan_iftar' => [
'is_active' => true,
'start_hour' => 18,
'end_hour' => 20,
'modifier' => 1.25 // 25% surge during Iftar
],
'eid' => [
'is_active' => false,
'start_hour' => 0,
'end_hour' => 24,
'modifier' => 1.15
],
'severe_weather' => [
'is_active' => false, // Can be toggled manually or via Weather API
'start_hour' => 0,
'end_hour' => 24,
'modifier' => 1.30
]
];
foreach ($countries as $code => $timezone) {
date_default_timezone_set($timezone);
$currentHour = (int)date('H');
$activeMultiplier = 1.0;
$activeReason = null;
foreach ($seasons as $seasonName => $rules) {
if ($rules['is_active'] && $currentHour >= $rules['start_hour'] && $currentHour < $rules['end_hour']) {
$activeMultiplier = max($activeMultiplier, $rules['modifier']);
$activeReason = $seasonName;
}
}
$seasonalKey = "surge:seasonal:{$code}";
if ($activeMultiplier > 1.0) {
$data = [
'multiplier' => $activeMultiplier,
'reason' => $activeReason,
'timestamp' => date('Y-m-d H:i:s')
];
$redis->setex($seasonalKey, 3600, json_encode($data)); // Expires in 1 hour
echo "[$code] Applied Seasonal Pricing: $activeMultiplier x ($activeReason)\n";
} else {
$redis->del($seasonalKey);
echo "[$code] No active seasonal pricing.\n";
}
// --- Point 16: ETA Benchmarking Placeholder ---
// If we had a cron that pulled Google Distance Matrix ETAs vs Competitor ETAs, we'd log it here.
// echo "[$code] ETA Benchmark recorded.\n";
}
echo "Done.\n";

144
backend/bot/cron_surge_opportunity.php Normal file
View File

@@ -0,0 +1,144 @@
<?php
/**
* cron_surge_opportunity.php
* مؤشر فرصة الذروة للعمل في الخلفية كـ Cron Job
*
* المنطق:
* 1. يحسب baseline و current لكل منافس في كل grid.
* 2. يحدد المناطق التي تشهد surge شامل من المنافسين.
* 3. يحفظ المناطق والمضاعف المقترح (multiplier) في Redis.
*/
// Allow script to run indefinitely
set_time_limit(0);
ini_set('memory_limit', '256M');
// Mock request to satisfy connect.php dependencies if any
$_SERVER['REQUEST_METHOD'] = 'POST';
require_once __DIR__ . '/../core/bootstrap.php';
require_once __DIR__ . '/../functions.php';
try {
$con = Database::get('main');
} catch (Exception $e) {
die("Database connection failed: " . $e->getMessage() . "\n");
}
echo "[".date('Y-m-d H:i:s')."] Starting cron_surge_opportunity...\n";
try {
// 1. حساب الـ baseline و current
$sql = "SELECT
ROUND(cp.from_latitude * 74, 0) / 74 AS lat_group,
ROUND(cp.from_longitude * 74, 0) / 74 AS lng_group,
cp.competitor_name,
cp.country_code,
AVG(CASE WHEN cp.created_at < DATE_SUB(NOW(), INTERVAL 6 HOUR)
THEN cp.price_per_km END) AS baseline_avg,
AVG(CASE WHEN cp.created_at >= DATE_SUB(NOW(), INTERVAL 2 HOUR)
THEN cp.price_per_km END) AS current_avg,
COUNT(*) AS total_samples,
SUM(CASE WHEN cp.created_at >= DATE_SUB(NOW(), INTERVAL 2 HOUR) THEN 1 ELSE 0 END) AS recent_samples
FROM competitor_prices cp
WHERE cp.created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
AND cp.price_per_km > 0
GROUP BY lat_group, lng_group, cp.competitor_name, cp.country_code
HAVING recent_samples >= 2
ORDER BY lat_group, lng_group, cp.competitor_name";
$stmt = $con->prepare($sql);
$stmt->execute();
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
// 2. تجميع البيانات لكل zone
$zones = [];
foreach ($rows as $row) {
$zoneKey = $row['lat_group'] . '_' . $row['lng_group'];
$baseline = (float)$row['baseline_avg'];
$current = (float)$row['current_avg'];
$surgeRatio = ($baseline > 0) ? round($current / $baseline, 2) : 1.0;
$isSurging = $baseline > 0 && $surgeRatio >= 1.2;
if (!isset($zones[$zoneKey])) {
$zones[$zoneKey] = [
'lat' => (float)$row['lat_group'],
'lng' => (float)$row['lng_group'],
'country_code' => $row['country_code'],
'competitors' => [],
'total_active' => 0,
'total_surging' => 0,
];
}
$zones[$zoneKey]['competitors'][] = [
'name' => $row['competitor_name'],
'baseline' => round($baseline, 2),
'current' => round($current, 2),
'surge_ratio' => $surgeRatio,
'is_surging' => $isSurging,
];
$zones[$zoneKey]['total_active']++;
if ($isSurging) {
$zones[$zoneKey]['total_surging']++;
}
}
// 3. تحديد فرص الذروة
$opportunities = [];
$gridSurgeZones = [];
foreach ($zones as $key => &$zone) {
$zone['opportunity'] = (
$zone['total_active'] >= 1 &&
$zone['total_surging'] === $zone['total_active']
);
if ($zone['opportunity']) {
$avgRatio = 0;
foreach ($zone['competitors'] as $c) {
$avgRatio += $c['surge_ratio'];
}
$avgRatio /= count($zone['competitors']);
$suggestedMultiplier = round(1.0 + ($avgRatio - 1.0) * 0.6, 2);
if ($suggestedMultiplier < 1.0) $suggestedMultiplier = 1.0;
$zone['suggested_multiplier'] = $suggestedMultiplier;
$opportunities[] = [
'lat' => $zone['lat'],
'lng' => $zone['lng'],
'country_code' => $zone['country_code'],
'avg_competitor_surge_ratio' => round($avgRatio, 2),
'suggested_siro_multiplier' => $suggestedMultiplier,
];
// حفظ المنطقة مع المضاعف المقترح في Redis (للقراءة من get.php بعدين)
$gridSurgeZones[$key] = $suggestedMultiplier;
}
}
unset($zone);
// 4. تخزين فرص الذروة في Redis بصلاحية 10 دقائق (600 ثانية)
if (!empty($gridSurgeZones) && isset($redis) && $redis !== null) {
$redisKey = 'surge:opportunities';
$redis->setex($redisKey, 600, json_encode($gridSurgeZones));
echo "[".date('Y-m-d H:i:s')."] Successfully stored ".count($gridSurgeZones)." surge zones in Redis.\n";
} else {
if (!isset($redis) || $redis === null) {
echo "[".date('Y-m-d H:i:s')."] Error: Redis connection not available.\n";
} else {
// مسح الكي في حال لم يعد هناك أي ذروة
$redis->del('surge:opportunities');
echo "[".date('Y-m-d H:i:s')."] No active surge opportunities found. Cleared Redis key.\n";
}
}
echo "[".date('Y-m-d H:i:s')."] cron_surge_opportunity completed successfully.\n";
} catch (Exception $e) {
echo "[".date('Y-m-d H:i:s')."] Error: " . $e->getMessage() . "\n";
}

111
backend/bot/cron_weekly_health_report.php Normal file
View File

@@ -0,0 +1,111 @@
<?php
/**
* cron_weekly_health_report.php
* يجري تشغيله في نهاية الأسبوع (يوم الأحد ليلاً) لتلخيص صحة السوق التنافسية.
*/
set_time_limit(0);
ini_set('memory_limit', '256M');
$_SERVER['REQUEST_METHOD'] = 'POST';
require_once __DIR__ . '/../core/bootstrap.php';
require_once __DIR__ . '/../functions.php';
try {
$con = Database::get('main');
} catch (Exception $e) {
die("Database connection failed: " . $e->getMessage() . "\n");
}
echo "[".date('Y-m-d H:i:s')."] Starting Weekly Market Health Report...\n";
try {
$countries = ['SY', 'JO', 'EG', 'IQ']; // Countries we operate in or monitor
foreach ($countries as $countryCode) {
// 1. Calculate Average PCI and Market Share
$sql = "SELECT distance_km, total_price
FROM competitor_prices
WHERE country_code = :country
AND distance_km > 0
AND created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)";
$stmt = $con->prepare($sql);
$stmt->execute([':country' => $countryCode]);
$trips = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (empty($trips)) {
continue; // Skip if no data for this country
}
$sqlKazan = "SELECT speedPrice FROM kazan WHERE country = :country LIMIT 1";
$stmtKazan = $con->prepare($sqlKazan);
$countryNameMap = ['SY' => 'Syria', 'JO' => 'Jordan', 'EG' => 'Egypt', 'IQ' => 'Iraq'];
$stmtKazan->execute([':country' => $countryNameMap[$countryCode] ?? 'Syria']);
$kazanRow = $stmtKazan->fetch(PDO::FETCH_ASSOC);
$currentSpeedPrice = $kazanRow ? (float)$kazanRow['speedPrice'] : 0;
$pciSum = 0;
$cheaperCount = 0;
$totalTrips = count($trips);
foreach ($trips as $trip) {
$compPrice = (float)$trip['total_price'];
$siroPrice = (float)$trip['distance_km'] * $currentSpeedPrice;
if ($compPrice > 0) {
$pciSum += ($siroPrice / $compPrice);
if ($siroPrice < $compPrice) {
$cheaperCount++;
}
}
}
$averagePci = round($pciSum / $totalTrips, 2);
$marketSharePct = round(($cheaperCount / $totalTrips) * 100, 2);
// 2. Count Anomalies (Last 7 Days)
$sqlAnomalies = "SELECT COUNT(*) as count FROM price_anomalies
WHERE country_code = :country
AND created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)";
$stmtAnomalies = $con->prepare($sqlAnomalies);
$stmtAnomalies->execute([':country' => $countryCode]);
$anomaliesCount = (int)$stmtAnomalies->fetchColumn();
// 3. Automated Campaigns / Surge Tracking (If applicable in logs)
$sqlCampaigns = "SELECT COUNT(*) as count FROM marketing_campaigns_log
WHERE JSON_EXTRACT(target_criteria, '$.country_code') = :country
AND sent_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)";
$stmtCampaigns = $con->prepare($sqlCampaigns);
$stmtCampaigns->execute([':country' => $countryCode]);
$campaignsCount = (int)$stmtCampaigns->fetchColumn();
// 4. Save to Database
$reportData = [
'total_competitor_samples' => $totalTrips,
'automated_campaigns_sent' => $campaignsCount,
'current_speed_price' => $currentSpeedPrice
];
$sqlInsert = "INSERT INTO market_health_reports
(report_date, country_code, average_pci, market_share_percent, total_anomalies, total_surge_opportunities, report_data_json)
VALUES (CURDATE(), :country, :pci, :market_share, :anomalies, :surge, :report_data)";
$stmtInsert = $con->prepare($sqlInsert);
$stmtInsert->execute([
':country' => $countryCode,
':pci' => $averagePci,
':market_share' => $marketSharePct,
':anomalies' => $anomaliesCount,
':surge' => 0, // Placeholder for actual surge count if tracked in DB
':report_data' => json_encode($reportData)
]);
echo "[".date('Y-m-d H:i:s')."] Report generated for $countryCode. PCI: $averagePci, Share: $marketSharePct%\n";
}
echo "[".date('Y-m-d H:i:s')."] cron_weekly_health_report completed successfully.\n";
} catch (Exception $e) {
echo "[".date('Y-m-d H:i:s')."] Error: " . $e->getMessage() . "\n";
}

52
backend/ride/heatmap/get_surge_heatmap.php Normal file
View File

@@ -0,0 +1,52 @@
<?php
/**
* get_surge_heatmap.php
* يزود تطبيق الكابتن بأماكن الذروة وفرص الطلب الحالية
*/
require_once __DIR__ . '/../../connect.php';
// Authentication happens in connect.php (JWT check)
if (!isset($user_id) || $role !== 'driver') {
http_response_code(403);
echo json_encode(['status' => 'failure', 'message' => 'Unauthorized']);
exit;
}
try {
$countryCode = filterRequest('country_code');
if (!$countryCode) {
$countryCode = 'SY'; // Fallback
}
$surgeKey = "surge:opportunities:{$countryCode}";
$hotspotsJson = $redis->get($surgeKey);
$hotspots = $hotspotsJson ? json_decode($hotspotsJson, true) : [];
$driverHeatmap = [];
if (!empty($hotspots)) {
foreach ($hotspots as $grid => $multiplier) {
// Only show grids with a meaningful multiplier > 1.05
if ($multiplier > 1.05) {
list($lat, $lng) = explode('_', $grid);
$driverHeatmap[] = [
'lat' => (float)$lat,
'lng' => (float)$lng,
'surge_multiplier' => (float)$multiplier,
'radius_meters' => 1500 // 1.5km grid box
];
}
}
}
jsonSuccess([
'status' => 'success',
'message' => 'Surge heatmap data fetched',
'hotspots' => $driverHeatmap
]);
} catch (Exception $e) {
error_log("[get_surge_heatmap] Error: " . $e->getMessage());
jsonError("Failed to fetch heatmap");
}

122
backend/ride/pricing/auto_adapt.php Normal file
View File

@@ -0,0 +1,122 @@
<?php
/**
* auto_adapt.php
* Auto-Adaptive Pricing — تعديل أسعار kazan الأساسية تلقائياً
*
* المعادلة: سعر_الكيلو_الجديد = أقل_متوسط_سعر_منافس × 0.92
* الحماية: ما ينزل عن 85% من السعر الحالي ولا يزيد عن 115%
*
* التشغيل: cron job كل 30-60 دقيقة
* CLI: php backend/ride/pricing/auto_adapt.php
* HTTP: curl -X POST https://.../backend/ride/pricing/auto_adapt.php -H "X-Internal-Key: ..."
*/
require_once __DIR__ . '/../../core/bootstrap.php';
try {
$con = Database::get('main');
} catch (Exception $e) {
error_log("[AutoAdapt] DB connection failed: " . $e->getMessage());
exit(1);
}
$countries = [
'Syria' => 'SY',
'Jordan' => 'JO',
'Egypt' => 'EG',
'Iraq' => 'IQ'
];
$undercutFactor = 0.92;
$minFloorRatio = 0.85;
$maxCeilRatio = 1.15;
$kmColumns = [
'speedPrice', 'comfortPrice', 'ladyPrice', 'electricPrice',
'vanPrice', 'deliveryPrice', 'mishwarVipPrice', 'fixedPrice', 'awfarPrice'
];
$logEntries = [];
foreach ($countries as $country => $cc) {
// 1. متوسط سعر الكيلو لكل منافس (آخر 24 ساعة)
$sql = "SELECT competitor_name, AVG(price_per_km) AS avg_ppm
FROM competitor_prices
WHERE country_code = :cc
AND created_at >= DATE_SUB(NOW(), INTERVAL 24 HOUR)
AND price_per_km > 0
GROUP BY competitor_name
ORDER BY avg_ppm ASC";
$stmt = $con->prepare($sql);
$stmt->execute([':cc' => $cc]);
$competitorAvgs = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (empty($competitorAvgs)) {
error_log("[AutoAdapt] $country — لا توجد بيانات منافسين");
continue;
}
$lowestAvg = (float)$competitorAvgs[0]['avg_ppm'];
// 2. الأسعار الحالية من kazan
$kazanSql = "SELECT * FROM kazan WHERE country = :country LIMIT 1";
$stmtK = $con->prepare($kazanSql);
$stmtK->execute([':country' => $country]);
$kazanRow = $stmtK->fetch(PDO::FETCH_ASSOC);
if (!$kazanRow) {
error_log("[AutoAdapt] $country — لا يوجد صف في kazan");
continue;
}
$currentSpeed = (float)$kazanRow['speedPrice'];
$targetSpeed = $lowestAvg * $undercutFactor;
$minAllowed = $currentSpeed * $minFloorRatio;
$maxAllowed = $currentSpeed * $maxCeilRatio;
if ($targetSpeed < $minAllowed) {
$targetSpeed = $minAllowed;
} elseif ($targetSpeed > $maxAllowed) {
$targetSpeed = $maxAllowed;
}
$ratio = $targetSpeed / $currentSpeed;
$updates = [];
$params = [':country' => $country];
foreach ($kmColumns as $col) {
$oldVal = (float)($kazanRow[$col] ?? 0);
if ($oldVal > 0) {
$newVal = round($oldVal * $ratio, 2);
$updates[] = "`$col` = :$col";
$params[":$col"] = (string)$newVal;
}
}
if (empty($updates)) {
continue;
}
$updateSql = "UPDATE kazan SET " . implode(', ', $updates) . " WHERE country = :country";
$stmtU = $con->prepare($updateSql);
$stmtU->execute($params);
$logEntries[] = [
'country' => $country,
'code' => $cc,
'old_speed' => $currentSpeed,
'new_speed' => $targetSpeed,
'lowest_competitor' => $lowestAvg,
'ratio' => round($ratio, 4),
];
error_log("[AutoAdapt] ✅ $country ($cc): speedPrice $currentSpeed → $targetSpeed (ratio: $ratio)");
}
if (php_sapi_name() === 'cli') {
echo json_encode(['status' => 'success', 'updates' => $logEntries], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
echo json_encode(['status' => 'success', 'updates' => $logEntries]);
}

15
backend/ride/pricing/get.php
View File

@@ -124,6 +124,16 @@ function calculateDynamicPrice($country, $minFare, $distance, $duration, $kazanR
$demandCount = (int)$redis->get("demand:grid:" . $grid_id);
$availableDrivers = 0;
// Check competitor surge opportunities
$competitorSurgeMultiplier = 1.0;
$surgeOpsJson = $redis->get("surge:opportunities");
if ($surgeOpsJson) {
$surgeOps = json_decode($surgeOpsJson, true);
if (is_array($surgeOps) && isset($surgeOps[$grid_id])) {
$competitorSurgeMultiplier = (float)$surgeOps[$grid_id];
}
}
// Driver locations are handled by Location Redis (no prefix)
try {
if (isset($redisLocation) && $redisLocation !== null) {
@@ -139,6 +149,11 @@ function calculateDynamicPrice($country, $minFare, $distance, $duration, $kazanR
$surgeMultiplier = min(3.0, $surgeMultiplier); // Cap at 3.0
}
}
// Auto-Adaptive Pricing: Apply competitor surge if it's higher
if ($competitorSurgeMultiplier > $surgeMultiplier) {
$surgeMultiplier = $competitorSurgeMultiplier;
}
} catch (Exception $e) {}
}

17
backend/schema_primary.sql
View File

@@ -1925,3 +1925,20 @@ CREATE TABLE IF NOT EXISTS `driver_destinations` (
PRIMARY KEY (`id`),
KEY `idx_driver_date` (`driver_id`, `usage_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
--
-- Table structure for table `market_health_reports`
--
CREATE TABLE IF NOT EXISTS `market_health_reports` (
`id` int NOT NULL AUTO_INCREMENT,
`report_date` date NOT NULL,
`country_code` varchar(5) NOT NULL,
`average_pci` decimal(5,2) NOT NULL,
`market_share_percent` decimal(5,2) NOT NULL,
`total_anomalies` int NOT NULL DEFAULT 0,
`total_surge_opportunities` int NOT NULL DEFAULT 0,
`report_data_json` json DEFAULT NULL,
`created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_country_date` (`country_code`, `report_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;