Deck: create, index and show | Improve test coverage | Change logo and app name

Author: ebbbang

.env.example

@@ -1,4 +1,4 @@
-APP_NAME=Laravel
+APP_NAME="Flashcard Pro"
 APP_ENV=local
 APP_KEY=
 APP_DEBUG=true

app/Livewire/Auth/Login.php

@@ -25,6 +25,8 @@ class Login extends Component
 
     /**
      * Handle an incoming authentication request.
+     *
+     * @throws ValidationException
      */
     public function login(): void
     {

app/Livewire/Cards/Create.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Livewire\Cards;
+
+use Livewire\Component;
+
+class Create extends Component
+{
+    public function render()
+    {
+        return view('livewire.cards.create');
+    }
+}

app/Livewire/Decks/Create.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Livewire\Decks;
+
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Validation\Rule;
+use Livewire\Component;
+
+class Create extends Component
+{
+    public string $name = '';
+
+    protected function rules(): array
+    {
+        return [
+            'name' => [
+                'required',
+                'string',
+                'max:20',
+                Rule::unique('decks', 'name')->where('user_id', Auth::id()),
+            ],
+        ];
+    }
+
+    public function store(): void
+    {
+        $validated = $this->validate();
+
+        Auth::user()->decks()->create($validated);
+
+        $this->redirect(route('decks.index', absolute: false), navigate: true);
+    }
+}

app/Livewire/Decks/Index.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Livewire\Decks;
+
+use Illuminate\Contracts\Support\Renderable;
+use Illuminate\Support\Facades\Auth;
+use Livewire\Component;
+use Livewire\WithPagination;
+
+class Index extends Component
+{
+    use WithPagination;
+
+    public function render(): Renderable
+    {
+        return view('livewire.decks.index', [
+            'decks' => Auth::user()->decks()->latest('id')->paginate(),
+        ]);
+    }
+}

app/Livewire/Decks/Show.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Livewire\Decks;
+
+use App\Models\Deck;
+use Livewire\Component;
+
+class Show extends Component
+{
+    public Deck $deck;
+
+    public function mount(Deck $deck): void
+    {
+        $this->deck = $deck;
+    }
+}

app/Models/Deck.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Deck extends Model
+{
+    /** @use HasFactory<\Database\Factories\DeckFactory> */
+    use HasFactory;
+
+    protected $fillable = ['name'];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/User.php

@@ -4,6 +4,7 @@
 
 // use Illuminate\Contracts\Auth\MustVerifyEmail;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Illuminate\Support\Str;
@@ -58,4 +59,9 @@ public function initials(): string
             ->map(fn ($word) => Str::substr($word, 0, 1))
             ->implode('');
     }
+
+    public function decks(): HasMany
+    {
+        return $this->hasMany(Deck::class);
+    }
 }

app/Policies/DeckPolicy.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Deck;
+use App\Models\User;
+
+class DeckPolicy
+{
+    public function view(User $user, Deck $deck): bool
+    {
+        return $user->id === $deck->user_id;
+    }
+
+    public function create(User $user): bool
+    {
+        return true;
+    }
+}

database/factories/DeckFactory.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Deck>
+ */
+class DeckFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'user_id' => User::factory(),
+            'name' => $this->faker->unique()->words(2, true),
+        ];
+    }
+}