wip on elections

app/Events/CountryCodeNotFound.php

@@ -6,7 +6,6 @@
 
 use App\Models\Election;
 use Illuminate\Broadcasting\InteractsWithSockets;
-use Illuminate\Broadcasting\PrivateChannel;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 

app/Http/Controllers/Api/V1/NomenclatureController.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\CountryResource;
+use App\Http\Resources\CountyResource;
+use App\Http\Resources\Nomenclature\ElectionResource;
+use App\Models\Country;
+use App\Models\County;
+use App\Models\Election;
+use Illuminate\Http\JsonResponse;
+
+class NomenclatureController extends Controller
+{
+    public function elections(): JsonResponse
+    {
+        return response()->json(
+            ElectionResource::collection(
+                Election::query()
+                    ->orderBy('is_live', 'desc')
+                    ->get()
+            )
+        );
+    }
+
+    public function counties(): JsonResponse
+    {
+        return response()->json(
+            CountyResource::collection(
+                County::with(['localities' => function ($query) {
+                    $query->whereNull('parent_id');
+                }])->get()
+            )
+        );
+    }
+
+    public function county(County $county): JsonResponse
+    {
+        return response()->json(
+            new CountyResource(
+                $county->load('localities')
+            )
+        );
+    }
+
+    public function countries(): JsonResponse
+    {
+        return response()->json(
+            CountryResource::collection(
+                Country::all()
+            )
+        );
+    }
+}

app/Http/Controllers/Api/V1/TurnoutController.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Models\Election;
+
+class TurnoutController extends Controller
+{
+    public function turnout(Election $election)
+    {
+        dd($election);
+    }
+}

app/Http/Resources/CountryResource.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CountryResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+        ];
+    }
+}

app/Http/Resources/CountyResource.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Resources;
+
+use App\Models\County;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CountyResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        /* @var County $this */
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'code' => $this->code,
+            'localities' => LocationResource::collection(($this->whenLoaded('localities'))),
+        ];
+    }
+}

app/Http/Resources/LocationResource.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class LocationResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+        ];
+    }
+}

app/Http/Resources/Nomenclature/ElectionResource.php

@@ -1,7 +1,10 @@
 <?php
 
+declare(strict_types=1);
+
 namespace App\Http\Resources\Nomenclature;
 
+use App\Models\Election;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
@@ -14,14 +17,15 @@ class ElectionResource extends JsonResource
      */
     public function toArray(Request $request): array
     {
+        /* @var Election $this */
         return [
             'id' => $this->id,
             'title' => $this->title,
             'subtitle' => $this->subtitle,
+            'type' => $this->type->getLabel(),
             'is_live' => $this->is_live,
             'slug' => $this->slug,
             'created_at' => $this->created_at,
         ];
     }
-
 }

app/Providers/AppServiceProvider.php

@@ -5,9 +5,11 @@
 namespace App\Providers;
 
 use App\Models\ScheduledJob;
+use Dedoc\Scramble\Scramble;
 use Illuminate\Console\Scheduling\Schedule;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\QueryException;
+use Illuminate\Routing\Route;
 use Illuminate\Support\Number;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
@@ -42,6 +44,10 @@ public function boot(): void
         $this->resolveSchedule();
 
         $this->setSeoDefaults();
+
+        Scramble::routes(function (Route $route) {
+            return Str::startsWith($route->uri, 'api/');
+        });
     }
 
     protected function registerStrMacros(): void

composer.json

@@ -12,6 +12,7 @@
         "andreiio/blade-remix-icon": "^3.5",
         "archtechx/laravel-seo": "^0.10.1",
         "blade-ui-kit/blade-icons": "^1.7",
+        "dedoc/scramble": "^0.11.25",
         "filament/filament": "^3.2",
         "filament/spatie-laravel-media-library-plugin": "^3.2",
         "haydenpierce/class-finder": "^0.5.3",