feat(api): organisation email branding and shared mail layout

- Add email branding columns to organisations table (logo, color, reply-to, sender name, footer)
- Create MailBrandingService for resolving per-org branding with defaults
- Create CrewliMailable abstract base class with branded from/reply-to
- Create shared Blade layout (mail.layouts.crewli) with inline CSS
- Refactor Registration*Mail and InvitationMail to extend CrewliMailable
- Add config/crewli.php for platform-wide defaults (portal_url, app_url, logo)
- Add dev-only /mail-preview/{type} route for browser email previewing
- Update Organisation model, resource, and form requests with branding fields

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

api/app/Mail/CrewliMailable.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\Organisation;
+use App\Services\MailBrandingService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Mail\Mailable;
+use Illuminate\Queue\SerializesModels;
+
+abstract class CrewliMailable extends Mailable implements ShouldQueue
+{
+    use Queueable;
+    use SerializesModels;
+
+    protected Organisation $organisation;
+
+    public function __construct(Organisation $organisation)
+    {
+        $this->organisation = $organisation;
+    }
+
+    protected function buildBranding(): static
+    {
+        $branding = app(MailBrandingService::class)->getBranding($this->organisation);
+
+        $this->from(
+            config('mail.from.address'),
+            $branding['sender_name']
+        );
+
+        if ($branding['reply_to']) {
+            $this->replyTo($branding['reply_to']);
+        }
+
+        return $this->with('branding', $branding);
+    }
+}

api/app/Mail/InvitationMail.php

@@ -5,21 +5,18 @@ declare(strict_types=1);
 namespace App\Mail;
 
 use App\Models\UserInvitation;
-use Illuminate\Bus\Queueable;
-use Illuminate\Contracts\Queue\ShouldQueue;
-use Illuminate\Mail\Mailable;
 use Illuminate\Mail\Mailables\Content;
 use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
 
-final class InvitationMail extends Mailable implements ShouldQueue
+final class InvitationMail extends CrewliMailable
 {
-    use Queueable;
-    use SerializesModels;
+    public UserInvitation $invitation;
 
-    public function __construct(
-        public readonly UserInvitation $invitation,
-    ) {}
+    public function __construct(UserInvitation $invitation)
+    {
+        parent::__construct($invitation->organisation);
+        $this->invitation = $invitation;
+    }
 
     public function envelope(): Envelope
     {
@@ -30,11 +27,12 @@ final class InvitationMail extends Mailable implements ShouldQueue
 
     public function content(): Content
     {
+        $this->buildBranding();
+
         return new Content(
-            markdown: 'emails.invitation',
+            view: 'mail.invitation',
             with: [
-                'acceptUrl' => config('app.frontend_app_url') . '/invitations/' . $this->invitation->token . '/accept',
-                'organisationName' => $this->invitation->organisation->name,
+                'acceptUrl' => config('crewli.app_url') . '/invitations/' . $this->invitation->token . '/accept',
                 'inviterName' => $this->invitation->invitedBy?->name ?? 'Een beheerder',
                 'role' => $this->invitation->role,
                 'expiresAt' => $this->invitation->expires_at,

api/app/Mail/RegistrationApprovedMail.php

@@ -6,22 +6,20 @@ namespace App\Mail;
 
 use App\Models\Event;
 use App\Models\Person;
-use Illuminate\Bus\Queueable;
-use Illuminate\Contracts\Queue\ShouldQueue;
-use Illuminate\Mail\Mailable;
 use Illuminate\Mail\Mailables\Content;
 use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
 
-final class RegistrationApprovedMail extends Mailable implements ShouldQueue
+final class RegistrationApprovedMail extends CrewliMailable
 {
-    use Queueable;
-    use SerializesModels;
+    public Person $person;
+    public Event $event;
 
-    public function __construct(
-        public readonly Person $person,
-        public readonly Event $event,
-    ) {}
+    public function __construct(Person $person, Event $event)
+    {
+        parent::__construct($event->organisation);
+        $this->person = $person;
+        $this->event = $event;
+    }
 
     public function envelope(): Envelope
     {
@@ -32,12 +30,14 @@ final class RegistrationApprovedMail extends Mailable implements ShouldQueue
 
     public function content(): Content
     {
+        $this->buildBranding();
+
         return new Content(
-            markdown: 'emails.registration-approved',
+            view: 'mail.registration-approved',
             with: [
-                'personName' => $this->person->first_name,
-                'eventName' => $this->event->name,
-                'portalUrl' => config('app.frontend_portal_url'),
+                'person' => $this->person,
+                'event' => $this->event,
+                'portalUrl' => config('crewli.portal_url'),
             ],
         );
     }

api/app/Mail/RegistrationConfirmationMail.php

@@ -6,22 +6,20 @@ namespace App\Mail;
 
 use App\Models\Event;
 use App\Models\Person;
-use Illuminate\Bus\Queueable;
-use Illuminate\Contracts\Queue\ShouldQueue;
-use Illuminate\Mail\Mailable;
 use Illuminate\Mail\Mailables\Content;
 use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
 
-final class RegistrationConfirmationMail extends Mailable implements ShouldQueue
+final class RegistrationConfirmationMail extends CrewliMailable
 {
-    use Queueable;
-    use SerializesModels;
+    public Person $person;
+    public Event $event;
 
-    public function __construct(
-        public readonly Person $person,
-        public readonly Event $event,
-    ) {}
+    public function __construct(Person $person, Event $event)
+    {
+        parent::__construct($event->organisation);
+        $this->person = $person;
+        $this->event = $event;
+    }
 
     public function envelope(): Envelope
     {
@@ -32,14 +30,14 @@ final class RegistrationConfirmationMail extends Mailable implements ShouldQueue
 
     public function content(): Content
     {
+        $this->buildBranding();
+
         return new Content(
-            markdown: 'emails.registration-confirmation',
+            view: 'mail.registration-confirmation',
             with: [
-                'personName' => $this->person->first_name,
-                'eventName' => $this->event->name,
-                'startDate' => $this->event->start_date->format('d-m-Y'),
-                'endDate' => $this->event->end_date->format('d-m-Y'),
-                'portalUrl' => config('app.frontend_portal_url'),
+                'person' => $this->person,
+                'event' => $this->event,
+                'portalUrl' => config('crewli.portal_url'),
             ],
         );
     }

api/app/Mail/RegistrationRejectedMail.php

@@ -6,23 +6,22 @@ namespace App\Mail;
 
 use App\Models\Event;
 use App\Models\Person;
-use Illuminate\Bus\Queueable;
-use Illuminate\Contracts\Queue\ShouldQueue;
-use Illuminate\Mail\Mailable;
 use Illuminate\Mail\Mailables\Content;
 use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
 
-final class RegistrationRejectedMail extends Mailable implements ShouldQueue
+final class RegistrationRejectedMail extends CrewliMailable
 {
-    use Queueable;
-    use SerializesModels;
+    public Person $person;
+    public Event $event;
+    public ?string $reason;
 
-    public function __construct(
-        public readonly Person $person,
-        public readonly Event $event,
-        public readonly ?string $reason = null,
-    ) {}
+    public function __construct(Person $person, Event $event, ?string $reason = null)
+    {
+        parent::__construct($event->organisation);
+        $this->person = $person;
+        $this->event = $event;
+        $this->reason = $reason;
+    }
 
     public function envelope(): Envelope
     {
@@ -33,11 +32,13 @@ final class RegistrationRejectedMail extends Mailable implements ShouldQueue
 
     public function content(): Content
     {
+        $this->buildBranding();
+
         return new Content(
-            markdown: 'emails.registration-rejected',
+            view: 'mail.registration-rejected',
             with: [
-                'personName' => $this->person->first_name,
-                'eventName' => $this->event->name,
+                'person' => $this->person,
+                'event' => $this->event,
                 'reason' => $this->reason,
             ],
         );