feat(groups): implement product groups

database/migrations/2025_08_23_221543_create_pim_group_table.php

@@ -0,0 +1,44 @@
+<?php
+
+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('pim_group', function (Blueprint $table) {
+            $table->id();
+
+            // Add foreign key for tenant if it's configured in the catalogue config
+            if (config('eclipse-catalogue.tenancy.model')) {
+                $tenantClass = config('eclipse-catalogue.tenancy.model');
+                /** @var \Illuminate\Database\Eloquent\Model $tenant */
+                $tenant = new $tenantClass;
+                $table->foreignId(config('eclipse-catalogue.tenancy.foreign_key'))
+                    ->constrained($tenant->getTable(), $tenant->getKeyName())
+                    ->cascadeOnUpdate()
+                    ->cascadeOnDelete();
+            }
+
+            $table->string('code', 50)->nullable();
+            $table->string('name', 100);
+            $table->boolean('is_active')->default(true);
+            $table->boolean('is_browsable')->default(false);
+            $table->timestamps();
+
+            // Create unique index on code
+            if (config('eclipse-catalogue.tenancy.foreign_key')) {
+                $table->unique([config('eclipse-catalogue.tenancy.foreign_key'), 'code']);
+            } else {
+                $table->unique('code');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('pim_group');
+    }
+};

database/migrations/2025_08_23_223125_create_pim_group_has_product_table.php

@@ -0,0 +1,32 @@
+<?php
+
+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('pim_group_has_product', function (Blueprint $table) {
+            $table->foreignId('product_id')
+                ->constrained('catalogue_products', 'id')
+                ->cascadeOnUpdate()
+                ->cascadeOnDelete();
+
+            $table->foreignId('group_id')
+                ->constrained('pim_group', 'id')
+                ->cascadeOnUpdate()
+                ->cascadeOnDelete();
+
+            $table->integer('sort')->nullable();
+
+            $table->primary(['product_id', 'group_id']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('pim_group_has_product');
+    }
+};

database/seeders/CatalogueSeeder.php

@@ -13,6 +13,7 @@ public function run(): void
     {
         $this->call(CategorySeeder::class);
         $this->call(ProductTypeSeeder::class);
+        $this->call(GroupSeeder::class);
         $this->call(PropertySeeder::class);
         $this->call(ProductSeeder::class);
     }

database/seeders/GroupSeeder.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Eclipse\Catalogue\Seeders;
+
+use Eclipse\Catalogue\Models\Group;
+use Illuminate\Database\Seeder;
+
+class GroupSeeder extends Seeder
+{
+    public function run(): void
+    {
+        // Create different groups for each tenant
+        $tenantModel = config('eclipse-catalogue.tenancy.model');
+        $tenantFK = config('eclipse-catalogue.tenancy.foreign_key');
+        $sites = $tenantModel::all();
+
+        // Define various group options
+        $groupOptions = [
+            ['code' => 'featured', 'name' => 'Featured Products', 'is_browsable' => true],
+            ['code' => 'new-arrivals', 'name' => 'New Arrivals', 'is_browsable' => true],
+            ['code' => 'best-sellers', 'name' => 'Best Sellers', 'is_browsable' => true],
+            ['code' => 'sale', 'name' => 'Sale Items', 'is_browsable' => false],
+            ['code' => 'trending', 'name' => 'Trending Now', 'is_browsable' => true],
+            ['code' => 'staff-picks', 'name' => 'Staff Picks', 'is_browsable' => true],
+            ['code' => 'seasonal', 'name' => 'Seasonal Collection', 'is_browsable' => true],
+            ['code' => 'limited-edition', 'name' => 'Limited Edition', 'is_browsable' => true],
+            ['code' => 'clearance', 'name' => 'Clearance Items', 'is_browsable' => false],
+            ['code' => 'premium', 'name' => 'Premium Selection', 'is_browsable' => true],
+            ['code' => 'eco-friendly', 'name' => 'Eco-Friendly', 'is_browsable' => true],
+            ['code' => 'gift-guide', 'name' => 'Gift Guide', 'is_browsable' => true],
+        ];
+
+        foreach ($sites as $site) {
+            // Randomly select 4-6 groups for each tenant
+            $numGroups = rand(4, 6);
+            $selectedGroups = collect($groupOptions)->shuffle()->take($numGroups);
+
+            foreach ($selectedGroups as $groupData) {
+                Group::create([
+                    $tenantFK => $site->id,
+                    'code' => $groupData['code'],
+                    'name' => $groupData['name'],
+                    'is_active' => true,
+                    'is_browsable' => $groupData['is_browsable'],
+                ]);
+            }
+        }
+    }
+}

database/seeders/ProductSeeder.php

@@ -3,6 +3,7 @@
 namespace Eclipse\Catalogue\Seeders;
 
 use Eclipse\Catalogue\Models\Category;
+use Eclipse\Catalogue\Models\Group;
 use Eclipse\Catalogue\Models\Product;
 use Eclipse\Catalogue\Models\ProductData;
 use Eclipse\Catalogue\Models\ProductType;
@@ -17,6 +18,7 @@ public function run(): void
     {
         $this->ensureSampleImagesExist();
         $this->ensureProductTypesExist();
+        $this->ensureGroupsExist();
 
         $productTypes = ProductType::all();
 
@@ -33,7 +35,7 @@ public function run(): void
 
         $products = Product::query()->latest('id')->take(100)->get();
 
-        foreach ($products as $product) {
+        foreach ($products as $index => $product) {
             if ($tenantFK && $tenantModel && class_exists($tenantModel)) {
                 $tenants = $tenantModel::all();
                 foreach ($tenants as $tenant) {
@@ -50,6 +52,14 @@ public function run(): void
                         'has_free_delivery' => false,
                         'category_id' => $categoryId,
                     ]);
+
+                    // Get groups for this specific tenant
+                    $tenantGroups = Group::where($tenantFK, $tenant->id)->get();
+                    $groupsToAdd = $this->determineGroupsForProduct($index, $tenantGroups);
+
+                    foreach ($groupsToAdd as $group) {
+                        $group->addProduct($product);
+                    }
                 }
             } else {
                 $categoryId = Category::query()->inRandomOrder()->value('id');
@@ -60,10 +70,34 @@ public function run(): void
                     'has_free_delivery' => false,
                     'category_id' => $categoryId,
                 ]);
+
+                // For non-tenant scenarios, use all groups
+                $groups = Group::all();
+                $groupsToAdd = $this->determineGroupsForProduct($index, $groups);
+                foreach ($groupsToAdd as $group) {
+                    $group->addProduct($product);
+                }
             }
         }
     }
 
+    private function determineGroupsForProduct(int $productIndex, $groups): array
+    {
+        $groupsToAdd = [];
+
+        // Randomly assign 1-3 groups per product
+        $numGroupsToAdd = rand(1, min(3, $groups->count()));
+
+        // Get random groups for this product
+        $randomGroups = $groups->random($numGroupsToAdd);
+
+        foreach ($randomGroups as $group) {
+            $groupsToAdd[] = $group;
+        }
+
+        return $groupsToAdd;
+    }
+
     private function ensureSampleImagesExist(): void
     {
         Storage::disk('public')->makeDirectory('sample-products');
@@ -109,4 +143,13 @@ private function ensureProductTypesExist(): void
             $this->call(ProductTypeSeeder::class);
         }
     }
+
+    private function ensureGroupsExist(): void
+    {
+        $groups = Group::all();
+
+        if ($groups->isEmpty()) {
+            $this->call(GroupSeeder::class);
+        }
+    }
 }

resources/lang/en/group.php

@@ -0,0 +1,19 @@
+<?php
+
+return [
+    'title' => 'Groups',
+    'fields' => [
+        'code' => 'Code',
+        'name' => 'Name',
+        'is_active' => 'Active',
+        'is_browsable' => 'Browsable',
+    ],
+    'table' => [
+        'columns' => [
+            'products' => 'Products',
+        ],
+        'actions' => [
+            'sort_products' => 'Sort Products',
+        ],
+    ],
+];

resources/lang/sl/group.php

@@ -0,0 +1,19 @@
+<?php
+
+return [
+    'title' => 'Skupine',
+    'fields' => [
+        'code' => 'Koda',
+        'name' => 'Ime',
+        'is_active' => 'Aktivna',
+        'is_browsable' => 'Brskanje omogočeno',
+    ],
+    'table' => [
+        'columns' => [
+            'products' => 'Izdelki',
+        ],
+        'actions' => [
+            'sort_products' => 'Razvrsti izdelke',
+        ],
+    ],
+];

src/Factories/GroupFactory.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Eclipse\Catalogue\Factories;
+
+use Eclipse\Catalogue\Models\Group;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+class GroupFactory extends Factory
+{
+    protected $model = Group::class;
+
+    public function definition(): array
+    {
+        $tenantFK = config('eclipse-catalogue.tenancy.foreign_key', 'site_id');
+
+        return [
+            $tenantFK => null, // Will be set when creating
+            'code' => $this->faker->unique()->slug(2),
+            'name' => $this->faker->words(2, true),
+            'is_active' => true,
+            'is_browsable' => false,
+        ];
+    }
+
+    public function inactive(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'is_active' => false,
+        ]);
+    }
+
+    public function browsable(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'is_browsable' => true,
+        ]);
+    }
+
+    public function notBrowsable(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'is_browsable' => false,
+        ]);
+    }
+}