Merge pull request #19 from techenby/amn/item-qr

Add QR Code Generation

Author: techenby

app/Actions/Inventory/GenerateItemQrCode.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Actions\Inventory;
+
+use App\Models\Item;
+use BaconQrCode\Renderer\Image\SvgImageBackEnd;
+use BaconQrCode\Renderer\ImageRenderer;
+use BaconQrCode\Renderer\RendererStyle\RendererStyle;
+use BaconQrCode\Writer;
+
+class GenerateItemQrCode
+{
+    public function handle(Item $item): array
+    {
+        $renderer = new ImageRenderer(
+            new RendererStyle(300),
+            new SvgImageBackEnd,
+        );
+
+        if ($item->children()->exists()) {
+            $url = route('inventory.index', ['parentId' => $item->id]);
+        } else {
+            $url = route('inventory.show', ['item' => $item]);
+        }
+
+        return [
+            'svg' => new Writer($renderer)->writeString($url),
+            'name' => $item->name,
+            'url' => $url,
+        ];
+    }
+}

app/Policies/ItemPolicy.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Policies;
+
+use App\Models\Item;
+use App\Models\User;
+
+class ItemPolicy
+{
+    public function viewAny(User $user): bool
+    {
+        return true;
+    }
+
+    public function view(User $user, Item $item): bool
+    {
+        return $item->team_id === $user->current_team_id;
+    }
+
+    public function create(User $user): bool
+    {
+        return true;
+    }
+
+    public function update(User $user, Item $item): bool
+    {
+        return $item->team_id === $user->current_team_id;
+    }
+
+    public function delete(User $user, Item $item): bool
+    {
+        return $item->team_id === $user->current_team_id;
+    }
+
+    public function restore(User $user, Item $item): bool
+    {
+        return $item->team_id === $user->current_team_id;
+    }
+
+    public function forceDelete(User $user, Item $item): bool
+    {
+        return $item->team_id === $user->current_team_id;
+    }
+}

composer.json

@@ -10,6 +10,7 @@
     "license": "MIT",
     "require": {
         "php": "^8.2",
+        "bacon/bacon-qr-code": "^3.0",
         "dedoc/scramble": "^0.13.14",
         "laravel/fortify": "^1.30",
         "laravel/framework": "^12.0",

composer.lock

@@ -1,3 +1,4 @@
+@teleport('body')
 <flux:modal name="item-form" class="md:w-96">
     <form wire:submit="save" class="space-y-6">
         <flux:heading size="lg">{{ $form->editingItem ? __('Edit Item') : __('Add Item') }}</flux:heading>
@@ -67,3 +68,4 @@
         </div>
     </form>
 </flux:modal>
+@endteleport

resources/views/pages/inventory/modals/item-form.blade.php

@@ -0,0 +1,16 @@
+@teleport('body')
+<flux:modal name="qr-code" class="md:w-96">
+    <div class="space-y-6">
+        <div class="space-y-1">
+            <flux:heading size="lg">{{ __('QR Code') }}</flux:heading>
+
+            <flux:text>{{ $qrCode['name'] ?? '' }}</flux:text>
+            <flux:link :href="$qrCode['url'] ?? ''">{{ $qrCode['url'] ?? '' }}</flux:link>
+        </div>
+
+        <div class="flex justify-center">
+            {!! $qrCode['svg'] ?? '' !!}
+        </div>
+    </div>
+</flux:modal>
+@endteleport

resources/views/pages/inventory/modals/qr-code.blade.php

@@ -55,7 +55,7 @@
             @forelse ($this->items as $item)
                 <flux:table.row :key="$item->id">
                     <flux:table.cell>
-                        <flux:link wire:click="navigateDown({{ $item->id }})" inset="top bottom" class="!flex !items-center gap-3">
+                        <flux:link wire:click="navigateDown({{ $item->id }})" as="button" inset="top bottom" class="!flex !items-center gap-3">
                             <flux:avatar size="xs" :icon="$item->type->getIcon()" :color="$item->type->getIconColor()" icon:variant="outline" />
                             <span>{{ $item->truncated_name }}</span>
                         </flux:link>
@@ -70,6 +70,7 @@
 
                             <flux:menu>
                                 <flux:menu.item wire:click="edit({{ $item->id }})" icon="pencil">{{ __('Edit') }}</flux:menu.item>
+                                <flux:menu.item wire:click="showQrCode({{ $item->id }})" icon="qr-code">{{ __('QR Code') }}</flux:menu.item>
                                 <flux:menu.item wire:click="delete({{ $item->id }})" variant="danger" icon="trash" wire:confirm="{{ __('Are you sure you want to delete this item?') }}">{{ __('Delete') }}</flux:menu.item>
                             </flux:menu>
                         </flux:dropdown>
@@ -85,7 +86,6 @@
         </flux:table.rows>
     </flux:table>
 
-    @teleport('body')
     @include('pages.inventory.modals.item-form')
-    @endteleport
+    @include('pages.inventory.modals.qr-code')
 </section>

resources/views/pages/inventory/⚡index/index.blade.php

@@ -1,9 +1,11 @@
 <?php
 
+use App\Actions\Inventory\GenerateItemQrCode;
 use App\Livewire\Forms\Inventory\ImportItemsForm;
 use App\Livewire\Forms\Inventory\ItemForm;
 use App\Livewire\Traits\WithSearching;
 use App\Livewire\Traits\WithSorting;
+use App\Models\Item;
 use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Collection as BaseCollection;
@@ -25,6 +27,8 @@
     public ItemForm $form;
     public ImportItemsForm $importForm;
 
+    public ?array $qrCode = null;
+
     #[Url]
     public ?int $parentId = null;
 
@@ -79,19 +83,22 @@ public function create(): void
 
     public function delete(int $id): void
     {
-        Auth::user()->currentTeam->items()
-            ->where('id', $id)
-            ->firstOrFail()
-            ->delete();
+        $item = Auth::user()->currentTeam->items()->findOrFail($id);
+
+        $this->authorize('delete', $item);
+
+        $item->delete();
 
         unset($this->items, $this->parentItems);
     }
 
     public function edit(int $id): void
     {
-        $this->form->load(
-            Auth::user()->currentTeam->items()->findOrFail($id)
-        );
+        $item = Auth::user()->currentTeam->items()->findOrFail($id);
+
+        $this->authorize('update', $item);
+
+        $this->form->load($item);
         $this->modal('item-form')->show();
     }
 
@@ -105,6 +112,13 @@ public function import(): void
 
     public function navigateDown(int $id): void
     {
+        $item = $this->items->firstWhere('id', $id);
+        if ($item !== null && $item->children_count === 0) {
+            $this->redirectRoute('inventory.show', ['item' => $item]);
+
+            return;
+        }
+
         $this->parentId = $id;
         unset($this->items, $this->parentItems, $this->breadcrumbs);
     }
@@ -118,13 +132,32 @@ public function navigateUp(): void
         }
     }
 
+    public function showQrCode(int $id): void
+    {
+        $item = Auth::user()->currentTeam->items()->findOrFail($id);
+
+        $this->authorize('view', $item);
+
+        $this->qrCode = resolve(GenerateItemQrCode::class)->handle($item);
+
+        $this->modal('qr-code')->show();
+    }
+
     public function removeMetadata(int $index): void
     {
+        if ($this->form->editingItem) {
+            $this->authorize('update', $this->form->editingItem);
+        }
+
         $this->form->removeMetadata($index);
     }
 
     public function removePhoto(): void
     {
+        if ($this->form->editingItem) {
+            $this->authorize('update', $this->form->editingItem);
+        }
+
         if ($this->form->photo) {
             $this->form->photo->delete();
             $this->form->photo = null;
@@ -136,6 +169,12 @@ public function removePhoto(): void
 
     public function save(): void
     {
+        if ($this->form->editingItem) {
+            $this->authorize('update', $this->form->editingItem);
+        } else {
+            $this->authorize('create', Item::class);
+        }
+
         $this->form->save();
         $this->modal('item-form')->close();
         unset($this->items, $this->parentItems);

resources/views/pages/inventory/⚡index/index.php

@@ -94,6 +94,7 @@
         $bedroom = Item::factory()->for($user->currentTeam)->location()->create(['name' => 'Bedroom']);
         $closet = Item::factory()->for($user->currentTeam)->bin()->childOf($bedroom)->create(['name' => 'Right Closet']);
         $tote = Item::factory()->for($user->currentTeam)->bin()->childOf($closet)->create(['name' => 'Game Tote']);
+        $game = Item::factory()->for($user->currentTeam)->bin()->childOf($tote)->create(['name' => 'Catan']);
 
         Livewire::actingAs($user)
             ->test('pages::inventory.index')
@@ -128,12 +129,25 @@
             ->assertSeeHtml('<span>Right Closet</span>')
             ->assertDontSeeHtml('<span>Game Tote</span>');
     });
+
+    test('clicking item without children redirects to show', function () {
+        $user = User::factory()->withTeam()->create();
+        $parent = Item::factory()->for($user->currentTeam)->location()->create(['name' => 'Bedroom']);
+        $child = Item::factory()->for($user->currentTeam)->childOf($parent)->bin()->create(['name' => 'Closet']);
+
+        Livewire::actingAs($user)
+            ->test('pages::inventory.index')
+            ->call('navigateDown', $parent->id)
+            ->call('navigateDown', $child->id)
+            ->assertRedirect(route('inventory.show', ['item' => $child]));
+    });
 });
 
 describe('can create and edit', function () {
     test('create pre-fills parent_id with current parentId', function () {
         $user = User::factory()->withTeam()->create();
         $parent = Item::factory()->for($user->currentTeam)->location()->create(['name' => 'Bedroom']);
+        Item::factory()->for($user->currentTeam)->childOf($parent)->bin()->create(['name' => 'Tote']);
 
         Livewire::actingAs($user)
             ->test('pages::inventory.index')
@@ -498,7 +512,7 @@
 
         Livewire::actingAs($user)
             ->test('pages::inventory.index')
-            ->call('navigateDown', $parent->id)
+            ->set('parentId', $parent->id)
             ->set('importForm.file', amazonFixtureUpload())
             ->call('import')
             ->assertHasNoErrors();
@@ -536,3 +550,36 @@
             ->assertHasErrors('importForm.file');
     });
 });
+
+describe('can generate qr codes', function () {
+    test('can show qr code for an item', function () {
+        $user = User::factory()->withTeam()->create();
+        $item = Item::factory()->for($user->currentTeam)->create(['name' => 'Guitar']);
+
+        Livewire::actingAs($user)
+            ->test('pages::inventory.index')
+            ->call('showQrCode', $item->id)
+            ->assertSet('qrCode.name', 'Guitar')
+            ->assertNotSet('qrCode.svg', '');
+    });
+
+    test('qr code svg contains valid svg markup', function () {
+        $user = User::factory()->withTeam()->create();
+        $item = Item::factory()->for($user->currentTeam)->create();
+
+        $component = Livewire::actingAs($user)
+            ->test('pages::inventory.index')
+            ->call('showQrCode', $item->id);
+
+        expect($component->get('qrCode.svg'))->toContain('<svg');
+    });
+
+    test('cannot show qr code for an item from another team', function () {
+        $user = User::factory()->withTeam()->create();
+        $otherItem = Item::factory()->create();
+
+        Livewire::actingAs($user)
+            ->test('pages::inventory.index')
+            ->call('showQrCode', $otherItem->id);
+    })->throws(ModelNotFoundException::class);
+});