feat: implement Pages CMS entity

admin/CACHE.md

@@ -21,6 +21,7 @@ Legend: `[ ]` not started, `[x]` implemented.
 | 5 | `products.slug.{slug}` | Single product record (with images, attributes, brand, category) | 30 min | Product saved / deleted |
 | 6 | `products.category.{category_id}` | Published products list for a category page | 15 min | Product saved / deleted |
 | 7 | `varieties.product.{product_id}` | All varieties for a product (price, inventory, status) | 15 min | Variety saved / deleted |
+| 9 | `pages.{slug}` | Single published page record | 1 hour | Page saved / deleted |
 
 ---
 

admin/IMPLEMENTATION.md

@@ -27,6 +27,7 @@ Catalog layer and platform basics.
 - [x] Banners (polymorphic images via `images` table)
 - [x] Sliders + Slides (each slide has one polymorphic image via `images` table)
 - [x] Menus + Menu Items (nested via `parent_id`; optional polymorphic image per item)
+- [x] Pages (CMS static pages; polymorphic image; SCHEDULED status with `published_at`)
 - [~] Addresses (model only, no resource yet)
 
 Sample data for manual admin testing lives in `TestSeeder` (`php artisan db:seed --class=TestSeeder`); `DatabaseSeeder` holds only necessary data.
@@ -62,7 +63,7 @@ Depend mostly on Images only.
 - [x] Banners
 - [x] Sliders + Slides
 - [x] Menus + Menu Items
-- [ ] Pages
+- [x] Pages
 - [ ] FAQs
 - [ ] Reviews
 - [ ] Wishlists

admin/app/Enums/PageStatusEnum.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+use App\Traits\HasOptions;
+
+enum PageStatusEnum: int
+{
+    use HasOptions;
+
+    case DELETED = 10;
+    case PUBLISHED = 20;
+    case DRAFT = 30;
+    case SCHEDULED = 40;
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::DELETED => 'Deleted',
+            self::PUBLISHED => 'Published',
+            self::DRAFT => 'Draft',
+            self::SCHEDULED => 'Scheduled',
+        };
+    }
+
+    public function color(): string
+    {
+        return match ($this) {
+            self::DELETED => 'danger',
+            self::PUBLISHED => 'success',
+            self::DRAFT => 'warning',
+            self::SCHEDULED => 'info',
+        };
+    }
+}

admin/app/Filament/Resources/PageResource.php

@@ -0,0 +1,177 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources;
+
+use AmidEsfahani\FilamentTinyEditor\TinyEditor;
+use App\Enums\PageStatusEnum;
+use App\Filament\Resources\PageResource\Pages\CreatePage;
+use App\Filament\Resources\PageResource\Pages\EditPage;
+use App\Filament\Resources\PageResource\Pages\ListPages;
+use App\Models\Page as PageModel;
+use Filament\Actions\BulkActionGroup;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\EditAction;
+use Filament\Forms\Components\DateTimePicker;
+use Filament\Forms\Components\FileUpload;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Toggle;
+use Filament\Resources\Resource;
+use Filament\Schemas\Components\Fieldset;
+use Filament\Schemas\Components\Utilities\Get;
+use Filament\Schemas\Components\Utilities\Set;
+use Filament\Schemas\Schema;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Table;
+use Illuminate\Support\Str;
+
+class PageResource extends Resource
+{
+    protected static ?string $model = PageModel::class;
+
+    protected static string | \UnitEnum | null $navigationGroup = 'Content';
+
+    protected static string | \BackedEnum | null $navigationIcon = 'heroicon-o-document-text';
+
+    protected static ?int $navigationSort = 6;
+
+    public static function form(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                TextInput::make('heading')
+                    ->required()
+                    ->maxLength(255)
+                    ->live(onBlur: true)
+                    ->afterStateUpdated(function (string $operation, ?string $state, Set $set): void {
+                        if ($operation === 'create') {
+                            $set('slug', Str::slug((string) $state));
+                        }
+                    })
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('The page title shown to visitors, e.g. "About Us".'),
+                TextInput::make('slug')
+                    ->disabled()
+                    ->dehydrated()
+                    ->required()
+                    ->maxLength(255)
+                    ->unique(PageModel::class, 'slug', ignoreRecord: true)
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('Auto-generated from the heading. Used as the URL path, e.g. /about-us.'),
+                TinyEditor::make('content')
+                    ->nullable()
+                    ->columnSpanFull()
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('The main body content of the page, edited with the rich text editor.'),
+                TextInput::make('title')
+                    ->maxLength(255)
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('SEO page title shown in the browser tab and search results. Leave blank to use the heading.'),
+                TextInput::make('description')
+                    ->maxLength(255)
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('Meta description shown in search engine results. Aim for 150-160 characters.'),
+                Toggle::make('no_index')
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('When enabled, search engines are instructed not to index this page.'),
+                TextInput::make('canonical')
+                    ->maxLength(255)
+                    ->url()
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('Canonical URL to prevent duplicate content issues. Leave blank unless this page should point to another URL.'),
+                Select::make('status')
+                    ->required()
+                    ->live()
+                    ->options(PageStatusEnum::options())
+                    ->default(PageStatusEnum::PUBLISHED->value)
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('Published: visible on the frontend. Draft: hidden. Scheduled: published on the date set below. Deleted: removed from listings.'),
+                DateTimePicker::make('published_at')
+                    ->nullable()
+                    ->required(fn (Get $get): bool => (int) $get('status') === PageStatusEnum::SCHEDULED->value)
+                    ->hidden(fn (Get $get): bool => (int) $get('status') !== PageStatusEnum::SCHEDULED->value)
+                    ->hintIcon('heroicon-o-information-circle')
+                    ->hintIconTooltip('The date and time this page will be made public. Only applies when status is Scheduled.'),
+                Fieldset::make('Image')
+                    ->relationship('image')
+                    ->schema([
+                        FileUpload::make('path')
+                            ->image()
+                            ->nullable()
+                            ->columnSpanFull(),
+                        TextInput::make('alt_text')
+                            ->nullable()
+                            ->maxLength(255),
+                    ])
+                    ->mutateRelationshipDataBeforeSaveUsing(function (array $data, PageModel $record): array {
+                        if (empty($data['path'])) {
+                            $record->image?->delete();
+                        }
+
+                        return $data;
+                    })
+                    ->columnSpanFull(),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('heading')
+                    ->limit(30)
+                    ->wrap()
+                    ->searchable(),
+                TextColumn::make('slug')
+                    ->limit(30)
+                    ->wrap()
+                    ->searchable(),
+                IconColumn::make('no_index')
+                    ->boolean(),
+                TextColumn::make('status')
+                    ->getStateUsing(fn (PageModel $record): string => $record->status->label())
+                    ->color(fn (PageModel $record): string => $record->status->color())
+                    ->sortable(),
+                TextColumn::make('published_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                TextColumn::make('updated_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->filters([
+                //
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+
+    public static function getRelations(): array
+    {
+        return [];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListPages::route('/'),
+            'create' => CreatePage::route('/create'),
+            'edit' => EditPage::route('/{record}/edit'),
+        ];
+    }
+}

admin/app/Filament/Resources/PageResource/Pages/CreatePage.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\PageResource\Pages;
+
+use App\Filament\Resources\PageResource;
+use Filament\Resources\Pages\CreateRecord;
+
+class CreatePage extends CreateRecord
+{
+    protected static string $resource = PageResource::class;
+
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+}

admin/app/Filament/Resources/PageResource/Pages/EditPage.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\PageResource\Pages;
+
+use App\Filament\Resources\PageResource;
+use Filament\Actions\DeleteAction;
+use Filament\Resources\Pages\EditRecord;
+
+class EditPage extends EditRecord
+{
+    protected static string $resource = PageResource::class;
+
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make(),
+        ];
+    }
+}

admin/app/Filament/Resources/PageResource/Pages/ListPages.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\PageResource\Pages;
+
+use App\Filament\Resources\PageResource;
+use Filament\Actions\CreateAction;
+use Filament\Resources\Pages\ListRecords;
+
+class ListPages extends ListRecords
+{
+    protected static string $resource = PageResource::class;
+
+    protected ?string $subheading = 'Manage static content pages such as About Us, Contact, and FAQ.';
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            CreateAction::make(),
+        ];
+    }
+}

admin/app/Models/Page.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Enums\PageStatusEnum;
+use Carbon\Carbon;
+use Database\Factories\PageFactory;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\MorphOne;
+
+/**
+ * @property positive-int $id
+ * @property string $heading
+ * @property string $slug
+ * @property string|null $content
+ * @property string|null $title
+ * @property string|null $description
+ * @property bool $no_index
+ * @property string|null $canonical
+ * @property PageStatusEnum $status
+ * @property Carbon|null $published_at
+ * @property Image|null $image
+ */
+class Page extends Model
+{
+    /** @use HasFactory<PageFactory> */
+    use HasFactory;
+
+    protected $fillable = [
+        'heading',
+        'slug',
+        'content',
+        'title',
+        'description',
+        'no_index',
+        'canonical',
+        'status',
+        'published_at',
+    ];
+
+    protected $casts = [
+        'no_index' => 'boolean',
+        'status' => PageStatusEnum::class,
+        'published_at' => 'datetime',
+    ];
+
+    protected static function booted(): void
+    {
+        static::deleting(function (Page $page): void {
+            $page->image?->delete();
+        });
+    }
+
+    public function image(): MorphOne
+    {
+        return $this->morphOne(Image::class, 'imageable');
+    }
+}