feat: Gemini AI (doc OCR + face match) + role-assignment endpoints

- GeminiService (integrations/gemini, @Global): extractDocument (OCR fields) + faceMatch; graceful if no GEMINI_API_KEY
- documents: face-match now real via Gemini; POST /admin/documents/:id/ocr extracts fields for CS auto-fill
- roles: PATCH /admin/users/:id/role (admin) + POST /platform/users/role (bootstrap via x-platform-secret)
- config: gemini + platform.secret; .env.example entries

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

apps/driver/lib/controller/firebase/bring_app_foreground.dart

@@ -0,0 +1,18 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+class AppLifecycleManager {
+  static const platform = MethodChannel('com.sefer_driver/app_lifecycle');
+
+  static Future<void> bringAppToForeground() async {
+    try {
+      debugPrint('Attempting to bring app to foreground');
+      await platform.invokeMethod('bringAppToForeground');
+      debugPrint('Method invocation completed');
+    } on PlatformException catch (e) {
+      debugPrint("Failed to bring app to foreground: '${e.message}'.");
+    } catch (e) {
+      debugPrint("Unexpected error: $e");
+    }
+  }
+}