feat: Implement Cart, Checkout, and Order Management Controllers

- Added CartController for managing cart operations including adding, updating, removing, and clearing items.
- Introduced CheckoutController to handle checkout processes, including subscription management and coupon application.
- Created OrderController for managing user orders, including listing and storing orders.
- Developed ShopController for product management, including filtering and retrieving product details.
- Seeded initial shop data with attributes, categories, vendors, and products for testing.

Author: dipaksarkar

composer.json

@@ -28,6 +28,7 @@
     "barryvdh/laravel-dompdf": "^3.1",
     "creativeorange/gravatar": "^1.0",
     "doctrine/dbal": "^3.4",
+    "flutterwavedev/flutterwave-v3": "^1.1",
     "gocardless/gocardless-pro": "^6.6",
     "illuminate/console": "^12.0",
     "illuminate/contracts": "^12.0",
@@ -46,6 +47,7 @@
     "laravel/sanctum": "^4.0",
     "league/csv": "^9.15",
     "league/iso3166": "^4.3",
+    "mercadopago/dx-php": "^3.5",
     "nesbot/carbon": "^3.0",
     "qirolab/laravel-themer": "^2.4",
     "razorpay/razorpay": "^2.9",
@@ -57,7 +59,9 @@
     "symfony/http-kernel": "^7.0",
     "symfony/polyfill-intl-icu": "^1.22.1",
     "twilio/sdk": "^7.16",
-    "vedmant/laravel-shortcodes": "^1.1"
+    "vedmant/laravel-shortcodes": "^1.1",
+    "xendit/xendit-php": "^7.0",
+    "yabacon/paystack-php": "^2.2"
   },
   "require-dev": {
     "mockery/mockery": "^1.6",

database/factories/CouponFactory.php

@@ -0,0 +1,193 @@
+<?php
+
+namespace Coderstm\Database\Factories;
+
+use Coderstm\Models\Coupon;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @template TModel of \Workbench\App\Coupon
+ *
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ */
+class CouponFactory extends Factory
+{
+    /**
+     * The name of the factory's corresponding model.
+     *
+     * @var class-string<TModel>
+     */
+    protected $model = Coupon::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => $this->faker->words(2, true) . ' Coupon',
+            'promotion_code' => strtoupper($this->faker->lexify('????') . $this->faker->numerify('##')),
+            'type' => $this->faker->randomElement(['product', 'plan']),
+            'discount_type' => $this->faker->randomElement(['percentage', 'fixed', 'override']),
+            'value' => $this->faker->randomFloat(2, 5, 50),
+            'active' => true,
+            'auto_apply' => $this->faker->boolean(30), // 30% chance of auto-apply
+            'max_redemptions' => $this->faker->boolean() ? $this->faker->numberBetween(10, 100) : null,
+            'expires_at' => $this->faker->boolean() ? $this->faker->dateTimeBetween('now', '+1 year') : null,
+            'duration' => $this->faker->randomElement(['forever', 'once', 'repeating']),
+            'duration_in_months' => $this->faker->boolean() ? $this->faker->numberBetween(1, 12) : null,
+        ];
+    }
+
+    public function active()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'active' => true,
+            ];
+        });
+    }
+
+    public function inactive()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'active' => false,
+            ];
+        });
+    }
+
+    public function percentage($value = null)
+    {
+        return $this->state(function (array $attributes) use ($value) {
+            return [
+                'discount_type' => 'percentage',
+                'value' => $value ?? $this->faker->randomFloat(2, 5, 50),
+            ];
+        });
+    }
+
+    public function fixedAmount($value = null)
+    {
+        return $this->state(function (array $attributes) use ($value) {
+            return [
+                'discount_type' => 'fixed',
+                'value' => $value ?? $this->faker->randomFloat(2, 10, 100),
+            ];
+        });
+    }
+
+    public function override($value = null)
+    {
+        return $this->state(function (array $attributes) use ($value) {
+            return [
+                'discount_type' => 'override',
+                'value' => $value ?? $this->faker->randomFloat(2, 5, 25),
+            ];
+        });
+    }
+
+    public function autoApply()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'auto_apply' => true,
+            ];
+        });
+    }
+
+    public function noAutoApply()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'auto_apply' => false,
+            ];
+        });
+    }
+
+    public function withExpiry($date = null)
+    {
+        return $this->state(function (array $attributes) use ($date) {
+            return [
+                'expires_at' => $date ?? $this->faker->dateTimeBetween('now', '+6 months'),
+            ];
+        });
+    }
+
+    public function withoutExpiry()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'expires_at' => null,
+            ];
+        });
+    }
+
+    public function withMaxRedemptions($max = null)
+    {
+        return $this->state(function (array $attributes) use ($max) {
+            return [
+                'max_redemptions' => $max ?? $this->faker->numberBetween(10, 100),
+            ];
+        });
+    }
+
+    public function unlimited()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'max_redemptions' => null,
+            ];
+        });
+    }
+
+    public function forProducts()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'type' => 'product',
+            ];
+        });
+    }
+
+    public function forPlans()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'type' => 'plan',
+            ];
+        });
+    }
+
+    public function forever()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'duration' => 'forever',
+                'duration_in_months' => null,
+            ];
+        });
+    }
+
+    public function once()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'duration' => 'once',
+                'duration_in_months' => null,
+            ];
+        });
+    }
+
+    public function repeating($months = null)
+    {
+        return $this->state(function (array $attributes) use ($months) {
+            return [
+                'duration' => 'repeating',
+                'duration_in_months' => $months ?? $this->faker->numberBetween(1, 12),
+            ];
+        });
+    }
+}

database/factories/Shop/CheckoutFactory.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace Coderstm\Database\Factories\Shop;
+
+use Coderstm\Models\Shop\Checkout;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+class CheckoutFactory extends Factory
+{
+    protected $model = Checkout::class;
+
+    public function definition()
+    {
+        return [
+            'token' => $this->faker->uuid(),
+            'email' => $this->faker->email(),
+            'first_name' => $this->faker->firstName(),
+            'last_name' => $this->faker->lastName(),
+            'phone_number' => $this->faker->phoneNumber(),
+            'currency' => 'USD',
+            'sub_total' => 0,
+            'tax_total' => 0,
+            'discount_total' => 0,
+            'grand_total' => 0,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ];
+    }
+
+    public function withUser($user = null)
+    {
+        return $this->state([
+            'user_id' => $user ? $user->id : \App\Models\User::factory()->create()->id,
+        ]);
+    }
+
+    public function withEmail($email = null)
+    {
+        return $this->state([
+            'email' => $email ?? $this->faker->email(),
+        ]);
+    }
+
+    public function withTotals($subTotal = 1000, $taxTotal = 100, $discountTotal = 0)
+    {
+        $grandTotal = $subTotal + $taxTotal - $discountTotal;
+
+        return $this->state([
+            'sub_total' => $subTotal,
+            'tax_total' => $taxTotal,
+            'discount_total' => $discountTotal,
+            'grand_total' => $grandTotal,
+        ]);
+    }
+
+    public function subscription()
+    {
+        return $this->state([
+            'type' => 'subscription',
+        ]);
+    }
+
+    public function standard()
+    {
+        return $this->state([
+            'type' => 'standard',
+        ]);
+    }
+
+    public function withCoupon($couponCode = null)
+    {
+        return $this->state([
+            'coupon_code' => $couponCode ?? 'TEST10',
+        ]);
+    }
+}

database/factories/Shop/Product/VariantFactory.php

@@ -29,4 +29,40 @@ public function definition()
             'out_of_stock_track_inventory' => rand(0, 1),
         ];
     }
+
+    public function isDefault()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'is_default' => true,
+            ];
+        });
+    }
+
+    public function taxable()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'taxable' => true,
+            ];
+        });
+    }
+
+    public function nonTaxable()
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'taxable' => false,
+            ];
+        });
+    }
+
+    public function forProduct($productId)
+    {
+        return $this->state(function (array $attributes) use ($productId) {
+            return [
+                'product_id' => $productId,
+            ];
+        });
+    }
 }

database/factories/Shop/ProductFactory.php

@@ -27,8 +27,8 @@ public function definition()
             'title' => fake()->sentence,
             'description' => fake()->paragraph,
             'has_variant' => rand(0, 1),
-            'category' => Category::inRandomOrder()->first()->toArray(),
-            'vendor' => Vendor::inRandomOrder()->first()->toArray(),
+            'category' => Category::inRandomOrder()->first()?->toArray(),
+            'vendor' => Vendor::inRandomOrder()->first()?->toArray(),
         ];
     }
 }

database/migrations/2021_09_11_193660_create_payment_methods_table.php

@@ -24,6 +24,7 @@ public function up()
             $table->string('name');
             $table->string('label')->nullable();
             $table->string('provider')->default('manual')->index();
+            $table->string('integration_via')->nullable();
             $table->string('link')->nullable();
             $table->string('logo')->nullable();
             $table->text('description')->nullable();
@@ -37,6 +38,7 @@ public function up()
             $table->decimal('transaction_fee', 10, 2)->default(0.00);
             $table->text('webhook')->nullable();
             $table->{$this->jsonable()}('options')->nullable();
+            $table->integer('order')->default(0);
 
             $table->timestamps();
             $table->softDeletes();

database/migrations/2022_07_24_092101_create_plans_table.php

@@ -29,7 +29,7 @@ public function up()
             $table->unsignedInteger('interval_count')->default(1);
             $table->double('price', 12, 2)->default(0.00);
             $table->unsignedInteger('trial_days')->nullable()->default(0);
-            $table->{$this->jsonable()}('options')->nullable();
+            $table->{$this->jsonable()}('metadata')->nullable();
             $table->timestamps();
             $table->softDeletes();
         });

database/migrations/2022_07_24_092102_create_coupons_table.php

@@ -17,14 +17,14 @@ public function up(): void
         Schema::create('coupons', function (Blueprint $table) {
             $table->id();
             $table->string('name')->nullable();
+            $table->string('type')->default('plan')->comment('Type of coupon: plan, product, or cart');
+            $table->enum('discount_type', ['percentage', 'fixed', 'override'])->default('percentage');
+            $table->double('value', 10, 2)->default(0);
             $table->string('promotion_code')->unique()->index();
-            $table->{$this->jsonable()}('applies_to')->nullable();
             $table->string('duration');
             $table->unsignedInteger('duration_in_months')->nullable();
             $table->unsignedInteger('max_redemptions')->nullable();
-            $table->unsignedBigInteger('amount_off')->nullable();
-            $table->unsignedSmallInteger('percent_off')->nullable();
-            $table->boolean('fixed')->default(false);
+            $table->boolean('auto_apply')->default(false);
             $table->boolean('active')->default(true)->index();
             $table->dateTime('expires_at')->nullable()->index();
             $table->timestamps();