Add PropController, StorePropRequest, UpdatePropRequest, PropResource, and PropableModels; define API routes for props management

app/Domains/Prop/Controllers/PropController.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Domains\Prop\Controllers;
+
+use App\Domains\Prop\Models\Prop;
+use App\Domains\Prop\Requests\StorePropRequest;
+use App\Domains\Prop\Requests\UpdatePropRequest;
+use App\Domains\Prop\Resources\PropResource;
+use App\Domains\Prop\Support\PropableModels;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Response;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+
+class PropController extends Controller
+{
+    public function index(string $propableType): JsonResponse
+    {
+        $modelClass = PropableModels::resolveOrFail($propableType);
+
+        return PropResource::collection(
+            Prop::query()->forModel($modelClass)->latest()->get()
+        )->response();
+    }
+
+    public function store(StorePropRequest $request, string $propableType): JsonResponse
+    {
+        $modelClass = PropableModels::resolveOrFail($propableType);
+
+        /** @var Prop $prop */
+        $prop = $modelClass::createProp($request->validated());
+
+        return PropResource::make($prop)->response()->setStatusCode(201);
+    }
+
+    public function show(string $propableType, Prop $prop): PropResource
+    {
+        $modelClass = PropableModels::resolveOrFail($propableType);
+        $prop = $this->resolveScopedProp($prop, $modelClass);
+
+        return PropResource::make($prop);
+    }
+
+    public function update(UpdatePropRequest $request, string $propableType, Prop $prop): PropResource
+    {
+        $modelClass = PropableModels::resolveOrFail($propableType);
+        $prop = $this->resolveScopedProp($prop, $modelClass);
+        $prop->update($request->validated());
+
+        return PropResource::make($prop);
+    }
+
+    public function destroy(string $propableType, Prop $prop): Response
+    {
+        $modelClass = PropableModels::resolveOrFail($propableType);
+        $prop = $this->resolveScopedProp($prop, $modelClass);
+        $prop->delete();
+
+        return response()->noContent();
+    }
+
+    protected function resolveScopedProp(Prop $prop, string $modelClass): Prop
+    {
+        if ($prop->propable_type !== $modelClass) {
+            throw new NotFoundHttpException('Prop not found for the given model type.');
+        }
+
+        return $prop;
+    }
+}

app/Domains/Prop/Requests/StorePropRequest.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Domains\Prop\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StorePropRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'codigo' => ['required', 'string', 'max:255', Rule::unique('props', 'codigo')],
+            'nombre' => ['required', 'string', 'max:255'],
+            'is_required' => ['sometimes', 'boolean'],
+            'data_type_id' => ['required', 'integer', 'exists:props_data_types,id'],
+        ];
+    }
+}

app/Domains/Prop/Requests/UpdatePropRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Prop\Requests;
+
+use App\Domains\Prop\Models\Prop;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdatePropRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        /** @var Prop|null $prop */
+        $prop = $this->route('prop');
+
+        return [
+            'codigo' => ['required', 'string', 'max:255', Rule::unique('props', 'codigo')->ignore($prop?->id)],
+            'nombre' => ['required', 'string', 'max:255'],
+            'is_required' => ['sometimes', 'boolean'],
+            'data_type_id' => ['required', 'integer', 'exists:props_data_types,id'],
+        ];
+    }
+}

app/Domains/Prop/Resources/PropResource.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Domains\Prop\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/**
+ * @mixin \App\Domains\Prop\Models\Prop
+ */
+class PropResource extends JsonResource
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'propable_type' => $this->propable_type,
+            'codigo' => $this->codigo,
+            'nombre' => $this->nombre,
+            'is_required' => $this->is_required,
+            'data_type_id' => $this->data_type_id,
+            'created_at' => $this->created_at,
+            'updated_at' => $this->updated_at,
+        ];
+    }
+}

app/Domains/Prop/Support/PropableModels.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Domains\Prop\Support;
+
+use App\Domains\Product\Models\Brand;
+use App\Domains\Product\Models\Category;
+use App\Domains\Product\Models\Product;
+use App\Domains\Prop\Concerns\Propable;
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Arr;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+
+class PropableModels
+{
+    /**
+     * @return array<string, class-string<Model>>
+     */
+    public static function map(): array
+    {
+        return [
+            'brand' => Brand::class,
+            'category' => Category::class,
+            'product' => Product::class,
+            'tenant' => Tenant::class,
+        ];
+    }
+
+    /**
+     * @return class-string<Model>
+     */
+    public static function resolveOrFail(string $alias): string
+    {
+        $modelClass = Arr::get(static::map(), $alias);
+
+        if (! is_string($modelClass) || ! is_subclass_of($modelClass, Model::class) || ! in_array(Propable::class, class_uses_recursive($modelClass), true)) {
+            throw new NotFoundHttpException('Propable model not found.');
+        }
+
+        return $modelClass;
+    }
+}

app/Domains/Prop/routes/api.php

@@ -0,0 +1,10 @@
+<?php
+
+use App\Domains\Prop\Controllers\PropController;
+use Illuminate\Support\Facades\Route;
+
+Route::apiResource('prop-models.props', PropController::class)
+    ->parameters([
+        'prop-models' => 'propableType',
+        'props' => 'prop',
+    ]);