feat: Add record track management (#6)

* Prepare tracks

* Update tracks

* Finalize track management

* Finalize track management

* Small formatting

Author: chrisvanlier2005

app/Http/Controllers/TrackController.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\Tracks\StoreTrackRequest;
+use App\Http\Requests\Tracks\UpdateTrackRequest;
+use App\Models\Record;
+use App\Models\Track;
+use Illuminate\Contracts\View\View;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Http\RedirectResponse;
+
+final class TrackController extends Controller
+{
+    use AuthorizesRequests;
+
+    public function create(Record $record): View
+    {
+        $this->authorize('create', [Track::class, $record]);
+
+        return view('tracks.create', [
+            'record' => $record,
+        ]);
+    }
+
+    public function store(StoreTrackRequest $request, Record $record): RedirectResponse
+    {
+        $track = new Track();
+        $track->record()->associate($record);
+        $track->title = $request->validated('title');
+        $track->duration = $request->validated('duration');
+        $track->save();
+
+        return redirect()->route('records.show', $record);
+    }
+
+    public function edit(Track $track): View
+    {
+        $this->authorize('update', $track);
+
+        return view('tracks.edit', [
+            'track' => $track,
+        ]); 
+    }
+
+    public function update(UpdateTrackRequest $request, Track $track): RedirectResponse
+    {
+        $track->title = $request->validated('title');
+        $track->duration = $request->validated('duration');
+        $track->save();
+
+        return redirect()->route('records.show', $track->record);
+    }
+
+    public function destroy(Track $track): RedirectResponse
+    {
+        $this->authorize('delete', $track);
+
+        $track->delete();
+
+        return redirect()->route('records.show', $track->record);
+    }
+}

app/Http/Requests/Tracks/StoreTrackRequest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Requests\Tracks;
+
+use App\Models\Track;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class StoreTrackRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        /** @var \App\Models\Record $record */
+        $record = $this->route('record');
+
+        return $this->user()->can('create', [Track::class, $record]);
+    }
+
+    public function rules(): array
+    {
+        return [
+            'title' => ['required', 'string', 'max:255'],
+            'duration' => ['required', 'integer', 'min:1'],
+        ];
+    }
+}

app/Http/Requests/Tracks/UpdateTrackRequest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Requests\Tracks;
+
+use App\Models\Track;
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateTrackRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        /** @var \App\Models\Track $track */
+        $track = $this->route('track');
+
+        return $this->user()->can('update', $track);
+    }
+
+    public function rules(): array
+    {
+        return [
+            'title' => ['required', 'string', 'max:255'],
+            'duration' => ['required', 'integer', 'min:1'],
+        ];
+    }
+}

app/Models/Record.php

@@ -34,6 +34,7 @@
  * @property \Carbon\Carbon $created_at
  * @property \Carbon\Carbon $updated_at
  * @property-read \App\Models\User $user
+ * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Track> $tracks
  * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecordCategory> $recordCategories
  * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecordImage> $recordImages
  */
@@ -65,6 +66,16 @@ public function user(): BelongsTo
         return $this->belongsTo(User::class);
     }
 
+    /**
+     * Query the tracks.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany<\App\Models\Track, $this>
+     */
+    public function tracks(): HasMany
+    {
+        return $this->hasMany(Track::class);
+    }
+
     /**
      * Query the record images.
      *

app/Models/Taps/ApplyRecordFilters.php

@@ -15,7 +15,15 @@ public function __construct(
     public function __invoke(Builder $query): void
     {
         if ($this->filters->search !== null) {
-            $query->where('name', 'like', '%' . $this->filters->search . '%');
+            $query
+                ->where(function (Builder $query) {
+                    $query
+                        ->where('name', 'like', '%' . $this->filters->search . '%')
+                        ->orWhereHas('tracks', function (Builder $query) {
+                            $query->where('title', 'LIKE', "%{$this->filters->search}%");
+                        });
+                });
+
         }
     }
 }

app/Models/Track.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Str;
+
+/**
+ * @property-read int $id
+ * @property int $record_id
+ * @property string $title
+ * @property int $duration The tracks duration in seconds.
+ * @property \Illuminate\Support\Carbon $created_at
+ * @property \Illuminate\Support\Carbon $updated_at
+ * @property-read \App\Models\Record $record
+ */
+final class Track extends Model
+{
+    /** @use HasFactory<\Database\Factories\TrackFactory> */
+    use HasFactory;
+
+    /**
+     * Query the record.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo<\App\Models\Record, $this>
+     */
+    public function record(): BelongsTo
+    {
+        return $this->belongsTo(Record::class);
+    }
+
+    /**
+     * Get the track's duration formatted as `mm:ss`
+     *
+     * @return string
+     */
+    public function getFormattedDuration(): string
+    {
+        $minutes = floor($this->duration / 60);
+        $seconds = $this->duration - $minutes * 60;
+
+        $minutes = Str::padLeft($minutes, 2, '0');
+        $seconds = Str::padLeft($seconds, 2, '0');
+
+        return "{$minutes}:{$seconds}";
+    }
+}

app/Policies/TrackPolicy.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Record;
+use App\Models\Track;
+use App\Models\User;
+
+class TrackPolicy
+{
+    /**
+     * Determine whether the use can create a track.
+     *
+     * @param User $user
+     * @param Record $record
+     * @return bool
+     */
+    public function create(User $user, Record $record): bool
+    {
+        return $user->can('view', $record);
+    }
+
+    /**
+     * Determine whether the user can update the specified track.
+     *
+     * @param User $user
+     * @param Track $track
+     * @return bool
+     */
+    public function update(User $user, Track $track): bool
+    {
+        return $user->can('update', $track->record);
+    }
+
+    /**
+     * Determine whether the user can delete the specified track.
+     *
+     * @param User $user
+     * @param Track $track
+     * @return bool
+     */
+    public function delete(User $user, Track $track): bool
+    {
+        return $user->can('update', $track->record);
+    }
+}

database/factories/TrackFactory.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Track>
+ */
+class TrackFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}

database/migrations/2024_12_27_114432_create_tracks_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('tracks', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('record_id')->constrained()->cascadeOnDelete();
+            $table->string('title');
+            $table->integer('duration');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('tracks');
+    }
+};

resources/views/records/index.blade.php

@@ -18,7 +18,7 @@
                     type="text"
                     class="grow"
                     name="search"
-                    placeholder="Search ..."
+                    placeholder="Search for record, track name..."
                     value="{{ request()->query('search') }}"
                     maxlength="255"
                 >