feat: add banner migrations and models

Author: SlimDeluxe

database/migrations/2025_08_12_080000_create_banner_positions_table.php

@@ -0,0 +1,34 @@
+<?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('cms_banner_positions', function (Blueprint $table) {
+            $table->id();
+
+            if (config('eclipse-cms.tenancy.enabled')) {
+                $tenantClass = config('eclipse-cms.tenancy.model');
+                /** @var \Illuminate\Database\Eloquent\Model $tenant */
+                $tenant = new $tenantClass;
+                $table->foreignId(config('eclipse-cms.tenancy.foreign_key'))
+                    ->constrained($tenant->getTable(), $tenant->getKeyName())
+                    ->cascadeOnUpdate()
+                    ->cascadeOnDelete();
+            }
+
+            $table->string('name');
+            $table->string('code', 20)->nullable();
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('cms_banner_positions');
+    }
+};

database/migrations/2025_08_12_080025_create_banner_image_types_table.php

@@ -0,0 +1,25 @@
+<?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('cms_banner_image_types', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('position_id');
+            $table->string('name');
+            $table->string('code')->nullable();
+            $table->smallInteger('image_width')->nullable();
+            $table->smallInteger('image_height')->nullable();
+            $table->boolean('is_hidpi');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('cms_banner_image_types');
+    }
+};

database/migrations/2025_08_12_080200_create_banners_table.php

@@ -0,0 +1,30 @@
+<?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('cms_banners', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('position_id')
+                ->constrained('cms_banner_positions', 'id')
+                ->cascadeOnUpdate()
+                ->cascadeOnDelete();
+            $table->string('name');
+            $table->string('link')->nullable();
+            $table->boolean('is_active')->default(false);
+            $table->boolean('new_tab')->default(false);
+            $table->unsignedTinyInteger('sort')->default(0);
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('cms_banners');
+    }
+};

database/migrations/2025_08_12_090911_create_banner_images_table.php

@@ -0,0 +1,31 @@
+<?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('cms_banner_images', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('banner_id')
+                ->constrained('cms_banners', 'id')
+                ->cascadeOnUpdate()
+                ->cascadeOnDelete();
+            $table->foreignId('type_id')
+                ->constrained('cms_banner_image_types', 'id')
+                ->cascadeOnUpdate()
+                ->cascadeOnDelete();
+            $table->string('file');
+            $table->boolean('is_hidpi');
+            $table->smallInteger('image_width');
+            $table->smallInteger('image_height');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('cms_banner_images');
+    }
+};

src/Models/Banner.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Eclipse\Cms\Models;
+
+use Eclipse\Cms\Models\Banner\Position;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Banner extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'cms_banners';
+
+    protected $fillable = [
+        'position_id',
+    ];
+
+    public function position(): BelongsTo
+    {
+        return $this->belongsTo(Position::class, 'position_id');
+    }
+}

src/Models/Banner/Image.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Eclipse\Cms\Models\Banner;
+
+use Eclipse\Cms\Models\Banner;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property int $id Image ID
+ * @property int $banner_id Banner ID
+ * @property int $type_id Banner image type ID
+ * @property string $file Image file path
+ * @property bool $is_hidpi Whether the image is hidpi (x2)
+ * @property int $image_width Image width
+ * @property int $image_height Image height
+ */
+class Image extends Model
+{
+    public $timestamps = false;
+
+    protected $table = 'cms_banner_images';
+
+    protected $fillable = [
+        'banner_id',
+        'type_id',
+        'file',
+        'is_hidpi',
+        'image_width',
+        'image_height',
+    ];
+
+    public function banner(): BelongsTo
+    {
+        return $this->belongsTo(Banner::class, 'banner_id');
+    }
+
+    public function type(): BelongsTo
+    {
+        return $this->belongsTo(ImageType::class, 'type_id');
+    }
+
+    protected function casts(): array
+    {
+        return [
+            'is_hidpi' => 'boolean',
+        ];
+    }
+}

src/Models/Banner/ImageType.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Eclipse\Cms\Models\Banner;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * Type of banner image
+ *
+ * @property int $id Type ID
+ * @property int $position_id Position ID
+ * @property string $name Type name (e.g. Desktop, Mobile)
+ * @property string|null $code Optional type code (for programmatic use)
+ * @property int|null $image_width Optional image width (for upload validation)
+ * @property int|null $image_height Optional image height (for upload validation)
+ * @property bool $is_hidpi Whether to require hidpi images (x2) when uploading
+ */
+class ImageType extends Model
+{
+    public $timestamps = false;
+
+    protected $table = 'cms_banner_image_types';
+
+    protected $fillable = [
+        'name',
+        'position_id',
+        'code',
+        'image_width',
+        'image_height',
+        'is_hidpi',
+    ];
+
+    public function position(): BelongsTo
+    {
+        return $this->belongsTo(Position::class, 'position_id');
+    }
+
+    protected function casts(): array
+    {
+        return [
+            'is_hidpi' => 'boolean',
+        ];
+    }
+}

src/Models/Banner/Position.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Eclipse\Cms\Models\Banner;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * @property int $id Position ID
+ * @property string $name Position name
+ * @property string|null code Optional position code (for programmatic use)
+ */
+class Position extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'cms_banner_positions';
+
+    protected $fillable = [
+        'name',
+        'code',
+    ];
+}