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

Update: 2026-06-11 13:47:39

Browse Source
This commit is contained in:
Hamza-Ayed
2026-06-11 13:47:40 +03:00
parent 977adfe99d
commit c5170a88d2
516 changed files with 3654 additions and 3321 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
knowledge/AI_CONTEXT.md
View File

@@ -1,10 +1,10 @@
# AI_CONTEXT.md — Siro (Intaleq) Ride-Hailing Platform
# AI_CONTEXT.md — Siro (Siro) Ride-Hailing Platform
## Core Architecture
- **4 Flutter apps** (rider, driver, admin, service) + **PHP backend** + **MySQL** + **WebSocket**
- **State Management**: GetX (permanent controllers in AppBindings)
- **Maps**: Intaleq Maps (custom Flutter plugin) + Google Maps + Map SaaS + OSRM
- **Domain**: siromove.com | **API**: api.intaleq.xyz/intaleq_v3 | **Ride**: rides.intaleq.xyz | **Location**: location.intaleq.xyz | **Payment**: walletintaleq.intaleq.xyz
- **Maps**: Siro Maps (custom Flutter plugin) + Google Maps + Map SaaS + OSRM
- **Domain**: siromove.com | **API**: api.intaleq.xyz/siro_v3 | **Ride**: rides.intaleq.xyz | **Location**: location.intaleq.xyz | **Payment**: walletintaleq.intaleq.xyz
## Passenger Flow (siro_rider)
```
@@ -124,7 +124,7 @@ Splash → Auth → MapScreen → Go Online (location streaming)
|-----------|--------|-------------|
| RideLifecycleController | RideState enum (8 states) | CRUD, MapEngine, MapSocket, UiInteractions, NearbyDrivers |
| MapSocketController | connected/disconnected | WebSocket, RideLifecycle |
| MapEngineController | map ready/loading | IntaleqMaps, markers, polylines |
| MapEngineController | map ready/loading | SiroMaps, markers, polylines |
| LocationSearchController | idle/searching/result | Map SaaS API |
| NearbyDriversController | empty/populated | Location API |
| UiInteractionsController | sheet states | All ride widgets |

2
knowledge/PASSENGER_JOURNEY.md
View File

@@ -105,7 +105,7 @@ SplashScreen
- **Search Geocoding**: Map SaaS (`/api/geocoding/search`)
- **Routing**: Map SaaS (`/api/maps/route`) or OSRM (`routesy.intaleq.xyz`)
- **ETA Calculation**: Local algorithm in `RideLifecycleController.updateRemainingRoute()`
- **Map Rendering**: `IntaleqMaps` (custom Flutter map plugin)
- **Map Rendering**: `SiroMaps` (custom Flutter map plugin)
## Stage 4: Searching for Driver

8
knowledge/PROJECT_OVERVIEW.md
View File

@@ -1,8 +1,8 @@
# PROJECT_OVERVIEW — Siro (Intaleq) Ride-Hailing Platform
# PROJECT_OVERVIEW — Siro (Siro) Ride-Hailing Platform
## Business Purpose
Siro (Intaleq) is a multi-region ride-hailing platform connecting passengers with drivers (captains). It operates across Syria, Jordan, and Egypt. The platform supports multiple car types (Speed, Comfort, Family, Delivery, Electric, Van, Bike) with dynamic pricing via a "Kazan" percentage-based commission system.
Siro (Siro) is a multi-region ride-hailing platform connecting passengers with drivers (captains). It operates across Syria, Jordan, and Egypt. The platform supports multiple car types (Speed, Comfort, Family, Delivery, Electric, Van, Bike) with dynamic pricing via a "Kazan" percentage-based commission system.
### Core Ride-Hailing Workflow
1. Passenger requests ride → System searches nearby drivers → Driver accepts → Navigate to pickup → Ride begins → Ride completes → Payment processed → Rating submitted
@@ -103,7 +103,7 @@ Siro (Intaleq) is a multi-region ride-hailing platform connecting passengers wit
│ Backend Servers (PHP) │
│ ┌──────────┐ ┌──────────┐ ┌───────────────────┐ │
│ │ Main API │ │ Ride API │ │ Payment Server │ │
│ │ intaleq_v3│ │ rides. │ │ walletintaleq.xyz│ │
│ │ siro_v3│ │ rides. │ │ walletintaleq.xyz│ │
│ └──────────┘ └──────────┘ └───────────────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌───────────────────┐ │
│ │ Location │ │ Socket │ │ Map SaaS │ │
@@ -128,7 +128,7 @@ Siro (Intaleq) is a multi-region ride-hailing platform connecting passengers wit
| Backend | PHP (native, no framework) |
| Database | MySQL 8.0 with GIS (SPATIAL indexes, POINT columns) |
| Realtime | PHP WebSockets (Socket.IO compatible) |
| Maps | Google Maps (primary), Intaleq Maps (custom), OSRM routing |
| Maps | Google Maps (primary), Siro Maps (custom), OSRM routing |
| Payments | PayMob, custom wallet server |
| Auth | JWT, Firebase Auth, Google Sign-In, Apple Sign-In |
| Storage | GetStorage (local), FlutterSecureStorage |

6
knowledge/SYSTEM_ARCHITECTURE.md
View File

@@ -74,9 +74,9 @@
┌──────────────────────┴─────────────────────────────────────────────┐
│ SERVICE LAYER (PHP Backend) │
│ │
│ Main API: api.intaleq.xyz/intaleq_v3 │
│ Ride API: rides.intaleq.xyz/intaleq │
│ Location API: location.intaleq.xyz/intaleq/ride/location │
│ Main API: api.intaleq.xyz/siro_v3 │
│ Ride API: rides.intaleq.xyz/siro │
│ Location API: location.intaleq.xyz/siro/ride/location │
│ Payment API: walletintaleq.intaleq.xyz/v2/main │
│ Map SaaS: map-saas.intaleqapp.com/api │
│ OSRM Route: routec.intaleq.xyz / routesy.intaleq.xyz │