feat: integrate dynamic geofence fetching, service area spatial boundaries, partner store profiles & editing with Leaflet maps, custom store portal icons, QR distribution charts with geographic/LGU filters, and optimize admin dashboards

app/Http/Controllers/Api/V1/Geo/FetchBoundaryController.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Geo;
+
+use App\Http\Controllers\Api\V1\ApiController;
+use App\Models\Tenant;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+
+class FetchBoundaryController extends ApiController
+{
+    public function __invoke(Request $request): JsonResponse
+    {
+        $request->validate([
+            'q' => ['required', 'string', 'max:100'],
+        ]);
+
+        $searchQuery = $request->string('q');
+        $user = $request->user();
+        $lguSuffix = '';
+
+        if ($user && $user->tenant_id) {
+            $tenant = $user->tenant ?: Tenant::find($user->tenant_id);
+            if ($tenant && $tenant->cityMunicipality) {
+                $lguSuffix = ', ' . $tenant->cityMunicipality->name;
+            }
+        }
+
+        $fullQuery = $searchQuery . $lguSuffix . ', Philippines';
+
+        // Cache lookup results to protect Nominatim API rate limits
+        $cacheKey = 'geo_boundary_' . md5(strtolower($fullQuery));
+
+        $results = Cache::remember($cacheKey, now()->addDays(7), function () use ($fullQuery) {
+            try {
+                $response = Http::withHeaders([
+                    'User-Agent' => 'Verde Waste Management App (admin@verde.local)',
+                ])->get('https://nominatim.openstreetmap.org/search', [
+                    'q' => $fullQuery,
+                    'format' => 'json',
+                    'polygon_geojson' => 1,
+                    'limit' => 5,
+                ]);
+
+                if ($response->successful()) {
+                    $data = $response->json() ?? [];
+                    return collect($data)
+                        ->filter(fn ($item) => isset($item['geojson']))
+                        ->map(fn ($item) => [
+                            'display_name' => $item['display_name'] ?? 'Unknown Location',
+                            'geojson' => $item['geojson'],
+                        ])
+                        ->values()
+                        ->all();
+                }
+            } catch (\Exception $e) {
+                Log::error('Nominatim boundary fetch failed: ' . $e->getMessage());
+            }
+
+            return [];
+        });
+
+        return $this->ok($results);
+    }
+}