add apis

app/Modules/Province/Controllers/ProvinceController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Modules\Province\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\System\Location\Province;
+use Illuminate\Http\Request;
+
+class ProvinceController extends Controller
+{
+    /**
+     * LIST provinces (etraplar)
+     */
+    public function index(Request $request)
+    {
+        $request->validate([
+            'groupBy' => ['nullable', 'string', 'in:region'],
+        ]);
+
+        $provinces = Province::query()
+            ->where('active', true)
+            ->get()
+            ->map(fn ($branch) => [
+                'id' => $branch->id,
+                'name' => $branch->name,
+                'region' => $branch->region,
+            ]);
+
+        if ($request->filled('groupBy')) {
+            $provinces = $provinces->groupBy('region');
+        }
+
+        return response()->json($provinces);
+    }
+}