feat(horizon): integrate Laravel Horizon for queue management, add Horizon service provider, and update related configurations

Author: maartenbode

.cursor/rules/laravel-boost.mdc

@@ -15,6 +15,7 @@ This application is a Laravel application and its main Laravel ecosystems packag
 - inertiajs/inertia-laravel (INERTIA) - v2
 - laravel/fortify (FORTIFY) - v1
 - laravel/framework (LARAVEL) - v12
+- laravel/horizon (HORIZON) - v5
 - laravel/prompts (PROMPTS) - v0
 - laravel/wayfinder (WAYFINDER) - v0
 - larastan/larastan (LARASTAN) - v3

CLAUDE.md

@@ -496,6 +496,7 @@ This application is a Laravel application and its main Laravel ecosystems packag
 - inertiajs/inertia-laravel (INERTIA) - v2
 - laravel/fortify (FORTIFY) - v1
 - laravel/framework (LARAVEL) - v12
+- laravel/horizon (HORIZON) - v5
 - laravel/prompts (PROMPTS) - v0
 - laravel/wayfinder (WAYFINDER) - v0
 - larastan/larastan (LARASTAN) - v3
@@ -771,62 +772,6 @@ If your application uses the `<Form>` component from Inertia, you can use Wayfin
 
 </code-snippet>
 
-### Common Patterns & Gotchas
-
-#### Multiple Route Parameters
-When your route has multiple parameters (e.g., `organizations/{organization}/members/{member}`), you **must** pass them as an array to Wayfinder functions.
-
-<code-snippet name="Multiple Route Parameters" lang="typescript">
-// routes/web.php
-Route::patch('organizations/{organization}/members/{member}', [MemberController::class, 'update']);
-
-// ❌ WRONG - Will cause "Cannot read properties of undefined (reading 'toString')"
-update.url(organization, memberUuid)
-update.url(organization.slug, memberUuid)
-update.url(organization, { member: memberUuid })
-
-// ✅ CORRECT - Use array for multiple parameters
-update.url([organization.slug, memberUuid])
-
-// Also works with router methods
-router.patch(update.url([organization.slug, memberUuid]), { role: 'admin' })
-router.delete(destroy.url([organization.slug, memberUuid]))
-</code-snippet>
-
-#### Form Helper Availability
-Not all Wayfinder actions have the `.form()` helper method. When it's unavailable, use explicit `action` and `method` props instead.
-
-<code-snippet name="Form Helper Alternatives" lang="typescript">
-// ❌ WRONG - May cause "form is not a function" error
-<Form {...store.form(organization)}>
-<Form {...update.form([organization.slug])}>
-
-// ✅ CORRECT - Use explicit action and method props
-<Form action={store.url(organization.slug)} method="post">
-    <input name="email" type="email" />
-    <button type="submit">Add</button>
-</Form>
-
-<Form action={update.url([organization.slug])} method="patch">
-    <input name="name" defaultValue={organization.name} />
-    <button type="submit">Save</button>
-</Form>
-</code-snippet>
-
-#### Route Parameter Order
-Parameters must be passed in the same order as they appear in the route definition.
-
-<code-snippet name="Parameter Order Matters" lang="typescript">
-// routes/web.php
-Route::get('organizations/{organization}/packages/{package}', [PackageController::class, 'show']);
-
-// ✅ CORRECT - Parameters in route order: organization, then package
-show.url([organizationSlug, packageId])
-
-// ❌ WRONG - Parameters reversed
-show.url([packageId, organizationSlug]) // Will generate incorrect URL
-</code-snippet>
-
 
 === pint/core rules ===
 

app/Domains/Package/Contracts/Data/PackageData.php

@@ -22,6 +22,8 @@ public function __construct(
         public ?string $latestVersion,
         public CarbonInterface $updatedAt,
         public ?string $repositoryName,
+        public ?string $repositoryIdentifier,
+        public ?string $repositoryUuid,
     ) {}
 
     public static function fromModel(Package $package): self
@@ -49,6 +51,8 @@ public static function fromModel(Package $package): self
             latestVersion: $latestVersion?->version,
             updatedAt: $updatedAt,
             repositoryName: $package->repository?->name,
+            repositoryIdentifier: $package->repository?->repo_identifier,
+            repositoryUuid: $package->repository?->uuid,
         );
     }
 }

app/Domains/Repository/Actions/FindOrCreatePackageAction.php

@@ -20,7 +20,6 @@ public function handle(Repository $repository, string $packageName): Package
                     'organization_uuid' => $repository->organization_uuid,
                     'repository_uuid' => $repository->uuid,
                     'name' => $packageName,
-                    'description' => "Automatically synced from {$repository->name}",
                     'type' => 'library',
                     'visibility' => 'private',
                 ]);

app/Domains/Repository/Http/Controllers/RepositoryController.php

@@ -9,6 +9,7 @@
 use App\Domains\Repository\Contracts\Data\SyncLogData;
 use App\Domains\Repository\Contracts\Enums\GitProvider;
 use App\Domains\Repository\Http\Requests\StoreRepositoryRequest;
+use App\Domains\Repository\Jobs\SyncRepositoryJob;
 use App\Http\Controllers\Controller;
 use App\Models\Organization;
 use App\Models\Repository;
@@ -57,6 +58,8 @@ public function store(StoreRepositoryRequest $request, Organization $organizatio
             'default_branch' => $request->default_branch,
         ]);
 
+        SyncRepositoryJob::dispatch($repository);
+
         return redirect()
             ->route('organizations.repositories.index', $organization)
             ->with('success', 'Repository added successfully.');

app/Domains/Repository/Jobs/SyncRepositoryJob.php

@@ -16,13 +16,14 @@
 use App\Exceptions\ComposerMetadataException;
 use App\Models\Repository;
 use App\Models\RepositorySyncLog;
+use Illuminate\Contracts\Queue\ShouldBeUnique;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Queue\Queueable;
 use Illuminate\Support\Facades\Log;
 use Spatie\LaravelData\DataCollection;
 use Throwable;
 
-class SyncRepositoryJob implements ShouldQueue
+class SyncRepositoryJob implements ShouldBeUnique, ShouldQueue
 {
     use Queueable;
 
@@ -35,8 +36,11 @@ class SyncRepositoryJob implements ShouldQueue
      */
     public function __construct(
         public Repository $repository
-    ) {
-        //
+    ) {}
+
+    public function uniqueId(): string
+    {
+        return "sync-repository-{$this->repository->uuid}";
     }
 
     /**

app/Providers/HorizonServiceProvider.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\Facades\Gate;
+use Laravel\Horizon\Horizon;
+use Laravel\Horizon\HorizonApplicationServiceProvider;
+
+class HorizonServiceProvider extends HorizonApplicationServiceProvider
+{
+    /**
+     * Bootstrap any application services.
+     */
+    public function boot(): void
+    {
+        parent::boot();
+
+        // Horizon::routeSmsNotificationsTo('15556667777');
+        // Horizon::routeMailNotificationsTo('example@example.com');
+        // Horizon::routeSlackNotificationsTo('slack-webhook-url', '#channel');
+    }
+
+    /**
+     * Register the Horizon gate.
+     *
+     * This gate determines who can access Horizon in non-local environments.
+     */
+    protected function gate(): void
+    {
+        Gate::define('viewHorizon', function ($user = null) {
+            return in_array(optional($user)->email, [
+                //
+            ]);
+        });
+    }
+}

bootstrap/providers.php

@@ -3,4 +3,5 @@
 return [
     App\Providers\AppServiceProvider::class,
     App\Providers\FortifyServiceProvider::class,
+    App\Providers\HorizonServiceProvider::class,
 ];

composer.json

@@ -14,6 +14,7 @@
         "inertiajs/inertia-laravel": "^2.0",
         "laravel/fortify": "^1.30",
         "laravel/framework": "^12.0",
+        "laravel/horizon": "^5.40",
         "laravel/tinker": "^2.10.1",
         "laravel/wayfinder": "^0.1.9",
         "spatie/laravel-data": "^4.18",