From 684b7585bbbe83d96451cbf462e9fde78f23a0ff Mon Sep 17 00:00:00 2001
From: kusowl <kushal.saha@outlook.com>
Date: Thu, 26 Feb 2026 19:03:41 +0530
Subject: [PATCH] feature: product creation and image upload

create image upload endpoint
create product creation endpoint
create get product categories endpoint
---
 backend/app/Actions/CreateProductAction.php   | 16 +++++++++
 backend/app/Actions/GetAllProductCategory.php | 19 ++++++++++
 backend/app/Actions/UploadImageAction.php     | 16 +++++++++
 backend/app/Data/ProductCategoryDTO.php       | 36 +++++++++++++++++++
 backend/app/Data/ProductImageDTO.php          | 26 ++++++++++++++
 backend/app/Data/UploadImageDTO.php           | 22 ++++++++++++
 .../Controllers/ProductCategoryController.php | 13 +++++++
 .../Http/Controllers/ProductController.php    | 23 ++++++++++++
 .../Controllers/ProductImagesController.php   | 30 ++++++++++++++++
 .../Http/Requests/CreateProductRequest.php    | 24 +++++++++++++
 .../app/Http/Requests/UploadImageRequest.php  | 29 +++++++++++++++
 backend/app/Models/Product.php                | 28 +++++++++++++++
 backend/app/Models/ProductCategory.php        | 10 ++++++
 backend/app/Models/ProductImage.php           | 19 ++++++++++
 ...073616_create_product_categories_table.php | 29 +++++++++++++++
 ...026_02_26_073626_create_products_table.php | 33 +++++++++++++++++
 ..._26_080304_create_product_images_table.php | 24 +++++++++++++
 .../seeders/ProductCategorySeeder.php         | 28 +++++++++++++++
 backend/routes/api.php                        |  6 ++++
 19 files changed, 431 insertions(+)
 create mode 100644 backend/app/Actions/CreateProductAction.php
 create mode 100644 backend/app/Actions/GetAllProductCategory.php
 create mode 100644 backend/app/Actions/UploadImageAction.php
 create mode 100644 backend/app/Data/ProductCategoryDTO.php
 create mode 100644 backend/app/Data/ProductImageDTO.php
 create mode 100644 backend/app/Data/UploadImageDTO.php
 create mode 100644 backend/app/Http/Controllers/ProductCategoryController.php
 create mode 100644 backend/app/Http/Controllers/ProductController.php
 create mode 100644 backend/app/Http/Controllers/ProductImagesController.php
 create mode 100644 backend/app/Http/Requests/CreateProductRequest.php
 create mode 100644 backend/app/Http/Requests/UploadImageRequest.php
 create mode 100644 backend/app/Models/Product.php
 create mode 100644 backend/app/Models/ProductCategory.php
 create mode 100644 backend/app/Models/ProductImage.php
 create mode 100644 backend/database/migrations/2026_02_26_073616_create_product_categories_table.php
 create mode 100644 backend/database/migrations/2026_02_26_073626_create_products_table.php
 create mode 100644 backend/database/migrations/2026_02_26_080304_create_product_images_table.php
 create mode 100644 backend/database/seeders/ProductCategorySeeder.php

diff --git a/backend/app/Actions/CreateProductAction.php b/backend/app/Actions/CreateProductAction.php
new file mode 100644
index 0000000..e9ec199
--- /dev/null
+++ b/backend/app/Actions/CreateProductAction.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Actions;
+
+use App\Data\UploadImageDTO;
+
+final readonly class CreateProductAction
+{
+    public function execute(UploadImageDTO $uploadImageDTO): void
+    {
+        $path = $uploadImageDTO->image->store('public/images');
+        $uploadImageDTO->product->images()->create([
+            'path' => $path,
+        ]);
+    }
+}
diff --git a/backend/app/Actions/GetAllProductCategory.php b/backend/app/Actions/GetAllProductCategory.php
new file mode 100644
index 0000000..24d12c3
--- /dev/null
+++ b/backend/app/Actions/GetAllProductCategory.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Actions;
+
+use App\Data\ProductCategoryDTO;
+use App\Models\ProductCategory;
+
+final readonly class GetAllProductCategory
+{
+    /**
+     * Execute the action.
+     */
+    public function execute(): array
+    {
+        return ProductCategory::all(columns: ['id', 'name', 'slug'])
+            ->map(fn ($category) => ProductCategoryDTO::fromModel($category))
+            ->toArray();
+    }
+}
diff --git a/backend/app/Actions/UploadImageAction.php b/backend/app/Actions/UploadImageAction.php
new file mode 100644
index 0000000..cd11381
--- /dev/null
+++ b/backend/app/Actions/UploadImageAction.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Actions;
+
+use App\Data\UploadImageDTO;
+
+final readonly class UploadImageAction
+{
+    public function execute(UploadImageDTO $uploadImageDTO): void
+    {
+        $path = $uploadImageDTO->image->store('public/images');
+        $uploadImageDTO->product->images()->create([
+            'path' => $path,
+        ]);
+    }
+}
diff --git a/backend/app/Data/ProductCategoryDTO.php b/backend/app/Data/ProductCategoryDTO.php
new file mode 100644
index 0000000..734a535
--- /dev/null
+++ b/backend/app/Data/ProductCategoryDTO.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Data;
+
+use App\Contracts\OutputDataTransferObject;
+use App\Models\ProductCategory;
+
+final readonly class ProductCategoryDTO implements OutputDataTransferObject
+{
+    public function __construct(
+        public int $id,
+        public string $name,
+        public string $slug,
+    ) {}
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'slug' => $this->slug,
+        ];
+    }
+
+    public static function fromModel(ProductCategory $category): self
+    {
+        return new self(
+            id: $category->id,
+            name: $category->name,
+            slug: $category->slug,
+        );
+    }
+}
diff --git a/backend/app/Data/ProductImageDTO.php b/backend/app/Data/ProductImageDTO.php
new file mode 100644
index 0000000..ac40a4e
--- /dev/null
+++ b/backend/app/Data/ProductImageDTO.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Data;
+
+use App\Contracts\OutputDataTransferObject;
+
+final readonly class ProductImageDTO implements OutputDataTransferObject
+{
+    public function __construct(
+        public ?int $id = null,
+        public ?string $path = null,
+        public ?int $productId = null,
+    ) {}
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'path' => $this->path,
+            'productId' => $this->productId,
+        ];
+    }
+}
diff --git a/backend/app/Data/UploadImageDTO.php b/backend/app/Data/UploadImageDTO.php
new file mode 100644
index 0000000..7a17477
--- /dev/null
+++ b/backend/app/Data/UploadImageDTO.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Data;
+
+use App\Models\Product;
+use Illuminate\Http\UploadedFile;
+
+readonly class UploadImageDTO
+{
+    public function __construct(
+        public UploadedFile $image,
+        public Product $product,
+    ) {}
+
+    public static function fromRequest(array $data): self
+    {
+        return new self(
+            image: $data['image'],
+            product: Product::find($data['product_id']),
+        );
+    }
+}
diff --git a/backend/app/Http/Controllers/ProductCategoryController.php b/backend/app/Http/Controllers/ProductCategoryController.php
new file mode 100644
index 0000000..f01b3f7
--- /dev/null
+++ b/backend/app/Http/Controllers/ProductCategoryController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Actions\GetAllProductCategory;
+
+class ProductCategoryController extends Controller
+{
+    public function index(GetAllProductCategory $action)
+    {
+        return $action->execute();
+    }
+}
diff --git a/backend/app/Http/Controllers/ProductController.php b/backend/app/Http/Controllers/ProductController.php
new file mode 100644
index 0000000..0693776
--- /dev/null
+++ b/backend/app/Http/Controllers/ProductController.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\CreateProductRequest;
+use App\Models\Product;
+use Illuminate\Http\Request;
+
+class ProductController extends Controller
+{
+    public function index() {}
+
+    public function store(CreateProductRequest $request)
+    {
+        return Product::create($request->validated());
+    }
+
+    public function show(Product $product) {}
+
+    public function update(Request $request, Product $product) {}
+
+    public function destroy(Product $product) {}
+}
diff --git a/backend/app/Http/Controllers/ProductImagesController.php b/backend/app/Http/Controllers/ProductImagesController.php
new file mode 100644
index 0000000..0ecd954
--- /dev/null
+++ b/backend/app/Http/Controllers/ProductImagesController.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Actions\UploadImageAction;
+use App\Data\UploadImageDTO;
+use App\Http\Requests\UploadImageRequest;
+use App\Models\ProductImages;
+
+class ProductImagesController extends Controller
+{
+    public function store(UploadImageRequest $request, UploadImageAction $action)
+    {
+        $action->execute(UploadImageDTO::fromRequest($request->validated()));
+
+        return response()->json(['message' => 'Image uploaded successfully']);
+    }
+
+    public function show(ProductImages $productImages)
+    {
+        return $productImages;
+    }
+
+    public function destroy(ProductImages $productImages)
+    {
+        $productImages->delete();
+
+        return response()->json();
+    }
+}
diff --git a/backend/app/Http/Requests/CreateProductRequest.php b/backend/app/Http/Requests/CreateProductRequest.php
new file mode 100644
index 0000000..3b7d11c
--- /dev/null
+++ b/backend/app/Http/Requests/CreateProductRequest.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class CreateProductRequest extends FormRequest
+{
+    public function rules(): array
+    {
+        return [
+            'title' => 'required|string|max:255',
+            'description' => 'required|string',
+            'product_category_id' => 'required|exists:product_categories,id',
+            'actual_price' => 'required|numeric|min:0',
+            'list_price' => 'required|numeric|min:0',
+        ];
+    }
+
+    public function authorize(): bool
+    {
+        return true;
+    }
+}
diff --git a/backend/app/Http/Requests/UploadImageRequest.php b/backend/app/Http/Requests/UploadImageRequest.php
new file mode 100644
index 0000000..c5b523a
--- /dev/null
+++ b/backend/app/Http/Requests/UploadImageRequest.php
@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UploadImageRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'image' => 'required|image|mimes:jpeg,png,jpg,gif,svg|max:2048',
+            'product_id' => 'required|exists:products,id',
+        ];
+    }
+}
diff --git a/backend/app/Models/Product.php b/backend/app/Models/Product.php
new file mode 100644
index 0000000..cf431ca
--- /dev/null
+++ b/backend/app/Models/Product.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class Product extends Model
+{
+    protected $fillable = [
+        'title',
+        'actual_price',
+        'list_price',
+        'description',
+        'product_category_id',
+    ];
+
+    public function productCategory(): BelongsTo
+    {
+        return $this->belongsTo(ProductCategory::class);
+    }
+
+    public function images(): HasMany
+    {
+        return $this->hasMany(ProductImage::class, 'product_id', 'id');
+    }
+}
diff --git a/backend/app/Models/ProductCategory.php b/backend/app/Models/ProductCategory.php
new file mode 100644
index 0000000..badd25d
--- /dev/null
+++ b/backend/app/Models/ProductCategory.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class ProductCategory extends Model
+{
+    //
+}
diff --git a/backend/app/Models/ProductImage.php b/backend/app/Models/ProductImage.php
new file mode 100644
index 0000000..b280e74
--- /dev/null
+++ b/backend/app/Models/ProductImage.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class ProductImage extends Model
+{
+    protected $fillable = [
+        'path',
+        'product_id',
+    ];
+
+    public function product(): BelongsTo
+    {
+        return $this->belongsTo(Product::class);
+    }
+}
diff --git a/backend/database/migrations/2026_02_26_073616_create_product_categories_table.php b/backend/database/migrations/2026_02_26_073616_create_product_categories_table.php
new file mode 100644
index 0000000..e6d3d22
--- /dev/null
+++ b/backend/database/migrations/2026_02_26_073616_create_product_categories_table.php
@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('product_categories', function (Blueprint $table) {
+            $table->id()->index();
+            $table->string('name')->unique();
+            $table->string('slug')->unique();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('product_categories');
+    }
+};
diff --git a/backend/database/migrations/2026_02_26_073626_create_products_table.php b/backend/database/migrations/2026_02_26_073626_create_products_table.php
new file mode 100644
index 0000000..6dc7a2f
--- /dev/null
+++ b/backend/database/migrations/2026_02_26_073626_create_products_table.php
@@ -0,0 +1,33 @@
+<?php
+
+use App\Models\ProductCategory;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('products', function (Blueprint $table) {
+            $table->id();
+            $table->string('title');
+            $table->text('description');
+            $table->decimal('actual_price', 10, 2);
+            $table->decimal('list_price', 10, 2);
+            $table->foreignIdFor(ProductCategory::class)->index();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('products');
+    }
+};
diff --git a/backend/database/migrations/2026_02_26_080304_create_product_images_table.php b/backend/database/migrations/2026_02_26_080304_create_product_images_table.php
new file mode 100644
index 0000000..42940e1
--- /dev/null
+++ b/backend/database/migrations/2026_02_26_080304_create_product_images_table.php
@@ -0,0 +1,24 @@
+<?php
+
+use App\Models\Product;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('product_images', function (Blueprint $table) {
+            $table->id()->index();
+            $table->string('path');
+            $table->foreignIdFor(Product::class)->index();
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('product_images');
+    }
+};
diff --git a/backend/database/seeders/ProductCategorySeeder.php b/backend/database/seeders/ProductCategorySeeder.php
new file mode 100644
index 0000000..822835b
--- /dev/null
+++ b/backend/database/seeders/ProductCategorySeeder.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\ProductCategory;
+use Illuminate\Database\Seeder;
+use Illuminate\Support\Str;
+
+class ProductCategorySeeder extends Seeder
+{
+    public function run(): void
+    {
+        $names = [
+            'Electronics', 'Clothing', 'Home', 'Books',
+            'Sports', 'Toys', 'Health', 'Beauty', 'Automotive',
+        ];
+
+        // Transform the flat names into an array of associative arrays
+        $categories = collect($names)->map(function ($name) {
+            return [
+                'name' => $name,
+                'slug' => Str::slug($name),
+            ];
+        })->toArray();
+
+        ProductCategory::upsert($categories, ['name'], ['slug']);
+    }
+}
diff --git a/backend/routes/api.php b/backend/routes/api.php
index 626d647..eec46f1 100644
--- a/backend/routes/api.php
+++ b/backend/routes/api.php
@@ -1,6 +1,9 @@
 <?php
 
 use App\Http\Controllers\AuthenticatedUserController;
+use App\Http\Controllers\ProductCategoryController;
+use App\Http\Controllers\ProductController;
+use App\Http\Controllers\ProductImagesController;
 use App\Http\Controllers\RegisteredUserController;
 use Illuminate\Support\Facades\Route;
 
@@ -11,4 +14,7 @@
 Route::middleware('auth:sanctum')->group(function () {
     Route::get('/user', [AuthenticatedUserController::class, 'show']);
     Route::post('/logout', [AuthenticatedUserController::class, 'destroy']);
+    Route::post('/upload/images', action: [ProductImagesController::class, 'store']);
+    Route::apiResource('products', ProductController::class);
 });
+Route::get('/categories', [ProductCategoryController::class, 'index']);