Feature(Admin): Shop/Store

.github/workflows/phpstan.yml

@@ -28,4 +28,4 @@ jobs:
         uses: ramsey/composer-install@v3
 
       - name: Run PHPStan
-        run: ./vendor/bin/phpstan --error-format=github
+        run: ./vendor/bin/phpstan analyse --error-format=github

.github/workflows/run-tests.yml

@@ -2,9 +2,12 @@ name: run-tests
 
 on:
   push:
-    branches: [master]
-  pull_request:
-    branches: [master]
+    paths:
+      - '**.php'
+      - '.github/workflows/run-tests.yml'
+      - 'phpunit.xml.dist'
+      - 'composer.json'
+      - 'composer.lock'
 
 jobs:
   test:
@@ -17,10 +20,6 @@ jobs:
         php: [8.3]
         laravel: [11.*]
         stability: [prefer-lowest, prefer-stable]
-        include:
-          - laravel: 11.*
-            testbench: 9.*
-            carbon: ^2.63
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
 
@@ -32,7 +31,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+          extensions: dom, curl, libxml, mbstring, zip, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
           coverage: none
 
       - name: Setup problem matchers

app/Filament/Actions/RedeemDeclined.php

@@ -0,0 +1,44 @@
+<?php
+
+/*
+ * Copyright (c) 2025.
+ *
+ * Filename: RedeemDecline.php
+ * Project Name: ninshiki-backend
+ * Project Repository: https://github.com/ninshiki-project/Ninshiki-backend
+ *  License: MIT
+ *  GitHub: https://github.com/MarJose123
+ *  Written By: Marjose123
+ */
+
+namespace App\Filament\Actions;
+
+use App\Http\Controllers\Api\Enum\RedeemStatusEnum;
+use App\Mail\RedeemDeclinedMail;
+use App\Models\Redeem;
+use Bavix\Wallet\Internal\Exceptions\ExceptionInterface;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Mail;
+
+class RedeemDeclined
+{
+    /**
+     * @throws ExceptionInterface
+     */
+    public function handle(Redeem $record, array $data): void
+    {
+        // update the record status and other column
+        $record->status = RedeemStatusEnum::DECLINED;
+        $record->decline_reason_category = $data['category'];
+        $record->decline_reason = $data['description'];
+        $record->declined_at = Carbon::now();
+        $record->save();
+        $record->refresh();
+        // refund the user
+        $userWallet = $record->user->getWallet('ninshiki-wallet');
+        $userWallet->refund($record->product);
+        // send notification to the user who redeem the item
+        Mail::to($record->user->email)
+            ->send(new RedeemDeclinedMail($record));
+    }
+}

app/Filament/Pages/SettingsGroup.php

@@ -15,5 +15,5 @@ class SettingsGroup extends Page
 
     protected static string $view = 'filament.pages.settings-group';
 
-    protected static ?int $navigationSort = 4;
+    protected static ?int $navigationSort = 5;
 }

app/Filament/Pages/ShopGroup.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Filament\Pages;
+
+use App\Filament\Resources\ShopResource;
+use Filament\Pages\Page;
+
+class ShopGroup extends Page
+{
+    /**
+     * This page will be used only to group other settings pages/resources
+     */
+    protected static ?string $title = 'Store';
+
+    protected static ?string $navigationIcon = 'heroicon-o-building-storefront';
+
+    protected static string $view = 'filament.pages.settings-group';
+
+    protected static ?int $navigationSort = 4;
+
+    public function mount(): void
+    {
+        $this->redirect(ShopResource::getUrl('index'));
+    }
+}

app/Filament/Resources/DepartmentsResource.php

@@ -7,6 +7,8 @@
 use Filament\Forms;
 use Filament\Forms\Form;
 use Filament\Resources\Resource;
+use Filament\Support\Enums\Alignment;
+use Filament\Support\Enums\MaxWidth;
 use Filament\Tables;
 use Filament\Tables\Table;
 
@@ -24,12 +26,14 @@ public static function form(Form $form): Form
             ->columns(1)
             ->schema([
                 Forms\Components\TextInput::make('name')
+                    ->unique(ignoreRecord: true)
                     ->required(),
-                Forms\Components\Select::make('department_head')
+                Forms\Components\Select::make('head')
+                    ->label('Department Head')
                     ->native(false)
                     ->searchable()
                     ->preload()
-                    ->relationship('departmentHead', 'name'),
+                    ->relationship('head', 'name'),
             ]);
     }
 
@@ -38,8 +42,10 @@ public static function table(Table $table): Table
         return $table
             ->columns([
                 Tables\Columns\TextColumn::make('name')
+                    ->label('Department Name')
                     ->searchable(),
-                Tables\Columns\TextColumn::make('department_head')
+                Tables\Columns\TextColumn::make('head.name')
+                    ->label('Department Head')
                     ->searchable(),
                 Tables\Columns\TextColumn::make('deleted_at')
                     ->dateTime()
@@ -58,7 +64,9 @@ public static function table(Table $table): Table
                 //
             ])
             ->actions([
-                Tables\Actions\EditAction::make(),
+                Tables\Actions\EditAction::make()
+                    ->modalWidth(MaxWidth::Medium)
+                    ->modalFooterActionsAlignment(Alignment::Right),
                 Tables\Actions\DeleteAction::make(),
             ])
             ->bulkActions([

app/Filament/Resources/ProductsResource.php

@@ -0,0 +1,190 @@
+<?php
+
+namespace App\Filament\Resources;
+
+use App\Filament\Resources\ProductsResource\Pages;
+use App\Models\Products;
+use App\Models\Scopes\ProductAvailableScope;
+use CloudinaryLabs\CloudinaryLaravel\CloudinaryEngine;
+use Filament\Forms;
+use Filament\Forms\Components\BaseFileUpload;
+use Filament\Forms\Form;
+use Filament\Notifications\Notification;
+use Filament\Resources\Resource;
+use Filament\Support\Enums\Alignment;
+use Filament\Support\Enums\MaxWidth;
+use Filament\Tables;
+use Filament\Tables\Table;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Str;
+use League\Flysystem\UnableToCheckFileExistence;
+use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
+
+class ProductsResource extends Resource
+{
+    protected static ?string $model = Products::class;
+
+    protected static ?string $navigationParentItem = 'Store';
+
+    protected static ?int $navigationSort = 2;
+
+    public static ?string $cloudinaryPublicId = null;
+
+    public static ?string $oldCloudinaryPublicId = null;
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->columns(2)
+            ->schema([
+                Forms\Components\FileUpload::make('image')
+                    ->image()
+                    ->disk('cloudinary')
+                    ->directory('products')
+                    ->visibility('private')
+                    ->maxSize(10240) // 10MB
+                    ->afterStateHydrated(static function (BaseFileUpload $component, string|array|null $state) {
+                        if (blank($state)) {
+                            $component->state([]);
+
+                            return;
+                        }
+                        $component->state([((string) Str::uuid()) => $state]);
+                    })
+                    ->afterStateUpdated(static function (BaseFileUpload $component, $state) {
+                        $component->state([(string) Str::uuid() => $state]);
+                    })
+                    ->getUploadedFileUsing(static function (BaseFileUpload $component, string $file): array {
+                        return [
+                            'name' => basename($file),
+                            'size' => 0,
+                            'type' => null,
+                            'url' => $file,
+                        ];
+                    })
+                    ->saveUploadedFileUsing((static function (BaseFileUpload $component, TemporaryUploadedFile $file, Forms\Set $set): ?string {
+                        try {
+                            if (! $file->exists()) {
+                                return null;
+                            }
+                        } catch (UnableToCheckFileExistence $exception) {
+                            return null;
+                        }
+
+                        $uploadedFile = $file->storeOnCloudinaryAs($component->getDirectory(), $component->getUploadedFileNameForStorage($file));
+                        self::$cloudinaryPublicId = $uploadedFile->getPublicId();
+
+                        return $uploadedFile->getSecurePath();
+                    }))
+                    ->reactive()
+                    ->columnSpanFull()
+                    ->required(),
+                Forms\Components\TextInput::make('name')
+                    ->required(),
+                Forms\Components\TextInput::make('price')
+                    ->required()
+                    ->numeric(),
+                Forms\Components\TextInput::make('stock')
+                    ->required()
+                    ->numeric()
+                    ->default(1),
+                Forms\Components\Textarea::make('description')
+                    ->columnSpanFull(),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->modifyQueryUsing(fn (Builder $query): Builder => $query->withoutGlobalScope(new ProductAvailableScope)->orderBy('created_at', 'desc'))
+            ->columns([
+                Tables\Columns\TextColumn::make('id')
+                    ->label('ID')
+                    ->toggleable(isToggledHiddenByDefault: true)
+                    ->searchable(),
+                Tables\Columns\ImageColumn::make('image'),
+                Tables\Columns\TextColumn::make('name')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make('price')
+                    ->money()
+                    ->formatStateUsing(fn ($state) => number_format($state, 2))
+                    ->sortable(),
+                Tables\Columns\TextColumn::make('stock')
+                    ->numeric()
+                    ->sortable(),
+                Tables\Columns\TextColumn::make('status')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make('deleted_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                Tables\Columns\TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                Tables\Columns\TextColumn::make('updated_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->filters([
+                //
+            ])
+            ->actions([
+                Tables\Actions\EditAction::make()
+                    ->mutateFormDataUsing(function (array $data): array {
+                        $data['cloudinary_id'] = self::$cloudinaryPublicId;
+
+                        return $data;
+                    })
+                    ->before(function (Products $record) {
+                        self::$oldCloudinaryPublicId = $record->cloudinary_id;
+                    })
+                    ->after(function (CloudinaryEngine $cloudinary) {
+                        // delete cloudinary id
+                        $cloudinary->destroy(self::$oldCloudinaryPublicId);
+                    })
+                    ->modalAlignment(Alignment::Center)
+                    ->modalWidth(MaxWidth::FitContent)
+                    ->modalFooterActionsAlignment(Alignment::Right),
+                Tables\Actions\DeleteAction::make()
+                    ->action(function (Products $record, Tables\Actions\DeleteAction $action, CloudinaryEngine $cloudinary) {
+                        // prevent deleting if the record is being used in other model
+                        if ($record->shop()->exists() || $record->redeems()->exists()) {
+                            Notification::make('stop')
+                                ->title('Unable to Delete')
+                                ->body('Product has existing record in Shop or Redeem')
+                                ->warning()
+                                ->send();
+
+                            return;
+                        }
+                        if ($record->cloudinary_id) {
+                            $cloudinary->destroy($record->cloudinary_id);
+                            $record->delete();
+                            $action->success();
+                        }
+                    }),
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make()
+                        ->action(fn (Collection $records) => $records->each(function (Model $record, CloudinaryEngine $cloudinary) {
+                            if ($record->cloudinary_id && (! $record->shop()->exists() || ! $record->redeems()->exists())) {
+                                $cloudinary->destroy($record->cloudinary_id);
+                                $record->delete();
+                            }
+                        })),
+                ]),
+            ]);
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ManageProducts::route('/'),
+        ];
+    }
+}

app/Filament/Resources/ProductsResource/Pages/ManageProducts.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Filament\Resources\ProductsResource\Pages;
+
+use App\Filament\Resources\ProductsResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ManageRecords;
+use Filament\Support\Enums\Alignment;
+use Filament\Support\Enums\MaxWidth;
+
+class ManageProducts extends ManageRecords
+{
+    protected static string $resource = ProductsResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\CreateAction::make()
+                ->mutateFormDataUsing(function (array $data): array {
+                    $resource = static::getResource();
+                    $data['cloudinary_id'] = $resource::$cloudinaryPublicId;
+
+                    return $data;
+                })
+                ->modalAlignment(Alignment::Center)
+                ->modalWidth(MaxWidth::FitContent)
+                ->modalFooterActionsAlignment(Alignment::Right)
+                ->createAnother(false),
+        ];
+    }
+}