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
parent 9909d9b4c1
commit 4d8414c96b
3198 changed files with 766859 additions and 0 deletions
@@ -0,0 +1,128 @@
+# bubble_head
+
+
+A flutter plugin to enable you launch a bubble while putting your application to background and upon clicking the bubble brings your application back to foreground
+
+## Getting Started
+### Add dependency
+
+```yaml
+    dependencies: 
+        bubble_head: ^0.0.4
+```
+
+
+### Add in android-manifest file (**../main/AndroidManifest.xml**)
+
+If you are unsure on where to do this, you can reference the example project AndroidManifest.xml file [here](example/android/app/src/main/AndroidManifest.xml)
+
+
+Add `SYSTEM_ALERT_WINDOW` permission in manifest
+```xml
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+```
+
+NOTE: For best UX practices, you should request for `SYSTEM_ALERT_WINDOW` permission on your application launch (if permission `status` is not granted)
+To request for permission, we advise the use of this [package](https://pub.dev/packages/permission_handler)
+
+
+Add `intent-filter` in activity tag
+
+```xml
+    <intent-filter>
+        <action android:name="intent.bring.app.to.foreground" />
+        <category android:name="android.intent.category.DEFAULT" />
+    </intent-filter>
+```
+
+Add `service` in application tag
+```xml
+    <service
+        android:name="com.dsaved.bubblehead.bubble.BubbleHeadService"
+        android:enabled="true"
+        android:exported="false"/>
+```
+
+### Note:  To set bubble icon, create `assets/images` folder path and add your png icon with name `icon.png` to the directory (ensure to import assets in your `pubspec.yaml` file)
+
+**GIF illustration**
+
+[![](example/assets/images/bubble_head_example.gif)](example/assets/images/bubble_head_example.gif "Bubble-head example")
+
+### Examples
+
+**To start bubble**
+[This puts your app in background and can be re-launched (brought to foreground) on tap of the bubble]
+
+```dart
+    Bubble _bubble = new Bubble();
+
+    Future<void> startBubbleHead() async {
+    
+        try {
+            await _bubble.startBubbleHead();
+        } on PlatformException {
+            print('Failed to call startBubbleHead');
+        }
+    }
+```
+
+**To stop/close bubble**
+
+```dart
+    Bubble _bubble = new Bubble();
+
+    Future<void> stopBubbleHead() async {
+    
+        try {
+            await _bubble.stopBubbleHead();
+        } on PlatformException {
+            print('Failed to call stopBubbleHead');
+        }
+    }
+```
+
+You can prevent the default action of putting your application in background when starting `bubble_head` by setting `sendAppToBackground` parameter when starting bubble head (if you choose to use another means of sending your application to background)
+
+```dart
+    Bubble _bubble = new Bubble();
+
+    Future<void> startBubbleHead() async {
+    
+        try {
+            // this will only display the bubble-head without sending the application to background
+            await _bubble.startBubbleHead(sendAppToBackground: false);
+        } on PlatformException {
+            print('Failed to call startBubbleHead');
+        }
+    }
+```
+
+
+**Other parameters**
+(You can choose to tweak **optional** parameters when initializing bubble)
+
+
+```dart
+    Bubble({
+        this.shouldBounce = true,
+        this.allowDragToClose = true,
+        this.showCloseButton = false,
+    });
+```
+```dart
+    Bubble().startBubbleHead(sendAppToBackground: true);
+```
+
+**Parameter Definition**
+- shouldBounce - Defaults to `True`
+(Adds animation to bubble-head)
+- allowDragToClose - Defaults to `True`
+(Enables dragging bubble to bottom screen to exit)
+- showCloseButton - Defaults to `False`
+(Adds a close button icon to the bubble-head)
+- sendAppToBackground - Defaults to `True`
+(Sends application to background)
+  
+## [Buy me a Coffee](https://www.buymeacoffee.com/dsaved)
+