إنشاء لوحة تحكم احترافية باستخدام Filament v3 ولارافيل 11 في 2026

composer create-project laravel/laravel:^11.0 noqtashop
cd noqtashop

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=noqtashop
DB_USERNAME=postgres
DB_PASSWORD=secret
 
APP_NAME="NoqtaShop Admin"
APP_URL=http://localhost:8000

createdb noqtashop
php artisan migrate

composer require filament/filament:"^3.3" -W

php artisan filament:install --panels

php artisan make:filament-user

php artisan serve
npm install && npm run dev

php artisan make:model Category -m
php artisan make:model Product -m
php artisan make:model Order -m
php artisan make:model OrderItem -m

Schema::create('categories', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('slug')->unique();
    $table->text('description')->nullable();
    $table->boolean('is_visible')->default(true);
    $table->unsignedBigInteger('parent_id')->nullable();
    $table->foreign('parent_id')->references('id')->on('categories')->nullOnDelete();
    $table->timestamps();
});

Schema::create('products', function (Blueprint $table) {
    $table->id();
    $table->foreignId('category_id')->constrained()->cascadeOnDelete();
    $table->string('name');
    $table->string('slug')->unique();
    $table->text('description')->nullable();
    $table->decimal('price', 10, 2);
    $table->integer('stock')->default(0);
    $table->string('sku')->unique();
    $table->boolean('is_visible')->default(true);
    $table->boolean('is_featured')->default(false);
    $table->json('variants')->nullable();
    $table->string('image')->nullable();
    $table->timestamps();
});

Schema::create('orders', function (Blueprint $table) {
    $table->id();
    $table->string('number')->unique();
    $table->foreignId('user_id')->constrained()->cascadeOnDelete();
    $table->string('status')->default('pending');
    $table->decimal('total', 10, 2);
    $table->string('currency', 3)->default('USD');
    $table->text('notes')->nullable();
    $table->timestamps();
});
 
Schema::create('order_items', function (Blueprint $table) {
    $table->id();
    $table->foreignId('order_id')->constrained()->cascadeOnDelete();
    $table->foreignId('product_id')->constrained();
    $table->integer('quantity');
    $table->decimal('unit_price', 10, 2);
    $table->timestamps();
});

class Product extends Model
{
    protected $fillable = [
        'category_id', 'name', 'slug', 'description',
        'price', 'stock', 'sku', 'is_visible', 'is_featured',
        'variants', 'image',
    ];
 
    protected $casts = [
        'price' => 'decimal:2',
        'is_visible' => 'boolean',
        'is_featured' => 'boolean',
        'variants' => 'array',
    ];
 
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
}

php artisan migrate
php artisan tinker

\App\Models\Category::create(['name' => 'Apparel', 'slug' => 'apparel']);
\App\Models\Category::create(['name' => 'Electronics', 'slug' => 'electronics']);
\App\Models\Category::create(['name' => 'Books', 'slug' => 'books']);
exit

php artisan make:filament-resource Category --generate

public static function form(Form $form): Form
{
    return $form->schema([
        Forms\Components\TextInput::make('name')
            ->required()
            ->maxLength(255)
            ->live(onBlur: true)
            ->afterStateUpdated(fn (string $state, callable $set) =>
                $set('slug', Str::slug($state))
            ),
        Forms\Components\TextInput::make('slug')
            ->required()
            ->unique(ignoreRecord: true),
        Forms\Components\Textarea::make('description')
            ->rows(4),
        Forms\Components\Toggle::make('is_visible')
            ->label('Visible to customers')
            ->default(true),
        Forms\Components\Select::make('parent_id')
            ->label('Parent category')
            ->relationship('parent', 'name')
            ->searchable(),
    ]);
}

php artisan make:filament-resource Product --generate

public static function form(Form $form): Form
{
    return $form->schema([
        Forms\Components\Section::make('Basic information')
            ->columns(2)
            ->schema([
                Forms\Components\TextInput::make('name')
                    ->required()
                    ->live(onBlur: true)
                    ->afterStateUpdated(fn ($state, callable $set) =>
                        $set('slug', Str::slug($state))
                    ),
                Forms\Components\TextInput::make('slug')
                    ->required()
                    ->unique(ignoreRecord: true),
                Forms\Components\Select::make('category_id')
                    ->relationship('category', 'name')
                    ->required()
                    ->searchable()
                    ->preload(),
                Forms\Components\TextInput::make('sku')
                    ->required()
                    ->unique(ignoreRecord: true),
            ]),
        Forms\Components\Section::make('Pricing and stock')
            ->columns(3)
            ->schema([
                Forms\Components\TextInput::make('price')
                    ->numeric()
                    ->prefix('$')
                    ->required(),
                Forms\Components\TextInput::make('stock')
                    ->numeric()
                    ->default(0),
                Forms\Components\Toggle::make('is_visible')
                    ->default(true),
            ]),
        Forms\Components\Section::make('Description')
            ->schema([
                Forms\Components\RichEditor::make('description')
                    ->columnSpanFull(),
            ]),
        Forms\Components\Section::make('Image')
            ->schema([
                Forms\Components\FileUpload::make('image')
                    ->image()
                    ->imageEditor()
                    ->directory('products')
                    ->columnSpanFull(),
            ]),
    ]);
}

public static function table(Table $table): Table
{
    return $table
        ->columns([
            Tables\Columns\ImageColumn::make('image')
                ->circular(),
            Tables\Columns\TextColumn::make('name')
                ->searchable()
                ->sortable(),
            Tables\Columns\TextColumn::make('category.name')
                ->label('Category')
                ->sortable(),
            Tables\Columns\TextColumn::make('price')
                ->money('USD')
                ->sortable(),
            Tables\Columns\TextColumn::make('stock')
                ->sortable()
                ->badge()
                ->color(fn (int $state): string => match (true) {
                    $state === 0 => 'danger',
                    $state < 10 => 'warning',
                    default => 'success',
                }),
            Tables\Columns\IconColumn::make('is_visible')
                ->boolean(),
        ])
        ->filters([
            Tables\Filters\SelectFilter::make('category')
                ->relationship('category', 'name'),
            Tables\Filters\TernaryFilter::make('is_visible'),
        ])
        ->actions([
            Tables\Actions\EditAction::make(),
            Tables\Actions\DeleteAction::make(),
        ])
        ->bulkActions([
            Tables\Actions\BulkActionGroup::make([
                Tables\Actions\DeleteBulkAction::make(),
            ]),
        ]);
}

php artisan make:filament-resource Order --generate

php artisan make:filament-relation-manager OrderResource items product_id

public function table(Table $table): Table
{
    return $table
        ->recordTitleAttribute('product.name')
        ->columns([
            Tables\Columns\TextColumn::make('product.name'),
            Tables\Columns\TextColumn::make('quantity'),
            Tables\Columns\TextColumn::make('unit_price')->money('USD'),
        ])
        ->headerActions([
            Tables\Actions\CreateAction::make()
                ->form([
                    Forms\Components\Select::make('product_id')
                        ->relationship('product', 'name')
                        ->required(),
                    Forms\Components\TextInput::make('quantity')
                        ->numeric()
                        ->required(),
                    Forms\Components\TextInput::make('unit_price')
                        ->numeric()
                        ->required(),
                ]),
        ])
        ->actions([
            Tables\Actions\EditAction::make(),
            Tables\Actions\DeleteAction::make(),
        ]);
}

public static function getRelations(): array
{
    return [
        RelationManagers\ItemsRelationManager::class,
    ];
}

php artisan make:filament-widget RevenueOverview --stats-overview

class RevenueOverview extends BaseWidget
{
    protected function getStats(): array
    {
        return [
            Stat::make('Total revenue', '$' . number_format(Order::sum('total'), 2))
                ->description('All time')
                ->descriptionIcon('heroicon-m-arrow-trending-up')
                ->color('success'),
            Stat::make('Orders this month', Order::whereMonth('created_at', now()->month)->count())
                ->description('Created in current month')
                ->color('primary'),
            Stat::make('Active products', Product::where('is_visible', true)->count())
                ->color('warning'),
        ];
    }
}

php artisan make:filament-widget SalesChart --chart

protected function getData(): array
{
    $data = Trend::model(Order::class)
        ->between(start: now()->subDays(30), end: now())
        ->perDay()
        ->sum('total');
 
    return [
        'datasets' => [
            [
                'label' => 'Daily revenue',
                'data' => $data->map(fn ($value) => $value->aggregate),
                'fill' => true,
            ],
        ],
        'labels' => $data->map(fn ($value) => $value->date),
    ];
}
 
protected function getType(): string
{
    return 'line';
}

composer require flowframe/laravel-trend

->widgets([
    Widgets\RevenueOverview::class,
    Widgets\SalesChart::class,
])

composer require spatie/laravel-permission
composer require bezhansalleh/filament-shield
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan migrate
php artisan shield:install admin

php artisan shield:generate --all

class User extends Authenticatable implements FilamentUser
{
    public function canAccessPanel(Panel $panel): bool
    {
        return $this->hasAnyRole(['super_admin', 'manager']);
    }
}

php artisan make:model Shop -m

Schema::create('shops', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('slug')->unique();
    $table->timestamps();
});
 
Schema::create('shop_user', function (Blueprint $table) {
    $table->foreignId('shop_id')->constrained()->cascadeOnDelete();
    $table->foreignId('user_id')->constrained()->cascadeOnDelete();
    $table->primary(['shop_id', 'user_id']);
});

return $panel
    ->id('admin')
    ->path('admin')
    ->tenant(Shop::class, slugAttribute: 'slug')
    ->tenantRegistration(RegisterShop::class);

class User extends Authenticatable implements FilamentUser, HasTenants
{
    public function getTenants(Panel $panel): Collection
    {
        return $this->shops;
    }
 
    public function canAccessTenant(Model $tenant): bool
    {
        return $this->shops()->whereKey($tenant)->exists();
    }
}

php artisan storage:link

Forms\Components\FileUpload::make('image')
    ->image()
    ->disk('s3')
    ->visibility('public')
    ->directory('products')

composer require spatie/laravel-backup
php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"

$schedule->command('backup:run')->dailyAt('02:00');
$schedule->command('backup:clean')->dailyAt('02:30');

git pull origin main
composer install --no-dev --optimize-autoloader
npm ci && npm run build
php artisan migrate --force
php artisan filament:cache-components
php artisan icons:cache
php artisan optimize
php artisan queue:restart

[program:noqtashop-worker]
command=php /srv/noqtashop/artisan queue:work --tries=3 --timeout=90
autostart=true
autorestart=true
user=deploy
numprocs=2

test('admin dashboard loads for authenticated users', function () {
    $user = User::factory()->create();
    $user->assignRole('super_admin');
 
    $this->actingAs($user)
        ->get('/admin')
        ->assertOk();
});

test('manager can create a product', function () {
    $manager = User::factory()->create();
    $manager->assignRole('manager');
 
    $this->actingAs($manager);
 
    Livewire::test(CreateProduct::class)
        ->fillForm([
            'name' => 'Demo Hoodie',
            'slug' => 'demo-hoodie',
            'sku' => 'DEMO-1',
            'price' => 49.99,
            'category_id' => Category::factory()->create()->id,
        ])
        ->call('create')
        ->assertHasNoFormErrors();
 
    $this->assertDatabaseHas('products', ['sku' => 'DEMO-1']);
});