Files
tripz-llc/backend/pricing-engine/README.md
T
Hamza-AyedandClaude Opus 5 4d8414c96b feat: استيراد كود سيرو إلى تريبز (سيرو @ecfe7568) — بلا تعديل
قرار المالك 2026-07-27: باك إند سيرو PHP هو المعتمد، وتطبيقاته المجرّبة
ميدانياً تحل محل إعادة البناء المؤرشفة. سيرو نفسه لم يُمسّ.

الخريطة:
  backend · payment_server · loction_server · ride_server ·
  passenger_server · docker · dashboard · stress_test  → الجذر
  siro_rider  → apps/rider          siro_driver  → apps/driver
  siro_admin  → dashboards/admin    siro_service → dashboards/service
  android_bot → apps/android_bot    socialBot    → apps/socialBot

نُسخ المتعقَّب في git سيرو فقط عبر `git archive` (3,198 ملفاً / ~169 م.ب)
لا `cp -r` — فاستُثنيت مخلفات البناء تلقائياً. بلا أي تعديل محتوى عمداً:
كل ما يلي يصير فرقاً مقروءاً مقابل المصدر.

لم يُستورد وسببه: siromove.com (الموقع التسويقي يبقى marketing/ في تريبز،
سيرو فيه 8 ملفات) · docs و planning (تريبز له docs/ الخاص) · deploy.sh
(ليس نشراً على سيرفر بل `git add . && git push origin --all` — فخّ في
مستودع آخر) · transit_dashboard (بانتظار قرار مصير backend-transit و
dashboards/transit-web).

⚠️ لا يبني بعد — ثلاثة نواقص متوقعة ومقصودة:
1. `.env` و `lib/env/env.g.dart` غير متعقَّبين في سيرو (أسرار لكل مستأجر):
   كل تطبيق فلاتر يحتاج .env خاصاً ثم توليد env.g.dart بـ build_runner.
2. إعدادات Firebase (9 ملفات google-services.json و GoogleService-Info.plist)
   يستبعدها .gitignore تريبز — ولكل مستأجر مشروع Firebase خاص أصلاً.
3. apps/driver في سيرو يشير إلى `../../Intaleq/packages/get` خارج المستودع →
   يجب ضمّ الحزم داخله أسوة بـ apps/rider.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 05:14:13 +03:00

2.4 KiB
Raw Blame History

Siro Pricing Engine

Statistical analysis engine for competitor ride-hailing pricing data.

Architecture

MySQL (scraped_competitor_prices)
       ↓
Pricing Engine (Node.js/TypeScript)
       ↓
  ├─ Outlier Detection (MAD)
  ├─ Tier Clustering (K-Means on PPK)
  ├─ Multiple Linear Regression (Gaussian Elimination)
  ├─ Minimum Fare Detection
  ├─ Surge Pricing Analysis
  └─ Zone-Based Analysis
       ↓
MySQL (competitor_secret_formulas + competitor_surge_insights)
       ↓
PHP Backend reads formulas → adjusts Siro pricing

Quick Start

# Install
cd backend/pricing-engine
npm install

# Configure
cp .env.example .env
# Edit .env with your MySQL/Redis credentials

# Run migration once
mysql -u root siro < migrations/001_add_columns.sql

# Full analysis
npm run analyze

# TaxiF only
npm run analyze:taxif

CLI Commands

Command Description Schedule
npm run analyze Full analysis all competitors Every 3h
npm run analyze:taxif TaxiF deep dive On-demand
npm run cron:hourly Surge + zone quick check (3h window) Hourly
npm run cron:daily Full analysis (72h window) Daily 6am
npm run cron:weekly Full report (7d window) Weekly Mon 8am

Analysis Pipeline

  1. Fetch raw data from scraped_competitor_prices
  2. Clean: MAD-based outlier removal, extract base (non-surge) prices
  3. Cluster: K-Means on price_per_km → Economy / Standard / Premium tiers
  4. Regress: Multiple Linear Regression per tier: price = base + km·dist + min·dur
  5. Detect Min Fare: Knee-point detection on short rides
  6. Analyze Surge: Per-route price variation × time of day
  7. Zone Analysis: 2.5km grid pricing heatmap
  8. Save results to competitor_secret_formulas and competitor_surge_insights

Integration with PHP Backend

The PHP cron jobs (cron_ai_engine.php, cron_kazan_adjuster.php) read from competitor_secret_formulas instead of doing their own simplistic math. The workflow becomes:

Pricing Engine (Node.js) → writes formulas + surge insights → MySQL
                                                                    ↓
PHP (cron_ai_engine.php)  → reads formulas, adjusts kazan pricing
PHP (cron_kazan_adjuster) → reads surge insights, adjusts commissions
PHP (cron_gemini_advisor) → sends formulas to Gemini for TEXTUAL strategy only