Add speaker invitations with portal page and programme host picker.

Speakers require email, get a personal holding page with programme and stage links, auto-invites when programme hosts are saved, and manual send for events without a schedule; also fix wallet copy on event create and anchor attendee comms. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-03 15:48:32 +00:00
parent 42d997a599
commit fec24da7bd
20 changed files with 1015 additions and 36 deletions
@@ -67,4 +67,25 @@ class ServiceMeetController extends Controller

        return response()->json(['registration' => $result]);
    }
+
+    public function verifySpeaker(Request $request, QrCode $event): JsonResponse
+    {
+        $validated = $request->validate([
+            'owner_ref' => ['required', 'string', 'max:64'],
+            'speaker_token' => ['required', 'string', 'max:128'],
+        ]);
+
+        $owner = User::query()->where('public_id', $validated['owner_ref'])->firstOrFail();
+        abort_unless($event->user_id === $owner->id, 403);
+        abort_unless($event->type === QrCode::TYPE_EVENT, 404);
+
+        $result = app(\App\Services\Events\EventSpeakerInviteService::class)
+            ->verifyToken($event, $validated['speaker_token']);
+
+        if (! $result) {
+            return response()->json(['message' => 'Speaker invite not found.'], 404);
+        }
+
+        return response()->json(['speaker' => $result]);
+    }
 }
@@ -4,6 +4,7 @@ namespace App\Http\Controllers\Events;

 use App\Http\Controllers\Controller;
 use App\Models\QrCode;
+use App\Services\Events\EventSpeakerInviteService;
 use App\Services\Events\EventSpeakerService;
 use App\Services\Qr\QrCodeManagerService;
 use Illuminate\Http\RedirectResponse;
@@ -14,6 +15,7 @@ class SpeakerController extends Controller
 {
    public function __construct(
        private readonly EventSpeakerService $speakers,
+        private readonly EventSpeakerInviteService $invites,
        private readonly QrCodeManagerService $manager,
    ) {}

@@ -40,11 +42,16 @@ class SpeakerController extends Controller
        $this->authorize('view', $event);
        abort_unless($event->type === QrCode::TYPE_EVENT, 404);

+        $roster = $this->invites->rosterWithInviteState($event);
+
        return view('events.speakers', [
            'qrCode' => $event,
-            'roster' => (array) ($event->content()['speakers'] ?? []),
+            'roster' => $roster,
            'programmeAssignments' => $this->speakers->programmeAssignments($event),
            'programme' => $this->speakers->linkedProgramme($event),
+            'canManualInvite' => collect($roster)->mapWithKeys(fn ($speaker) => [
+                $speaker['email'] => $this->invites->canSendManualInvite($event, $speaker),
+            ])->all(),
        ]);
    }

@@ -56,17 +63,39 @@ class SpeakerController extends Controller
        $validated = $request->validate([
            'speakers' => ['nullable', 'array'],
            'speakers.*.name' => ['nullable', 'string', 'max:120'],
-            'speakers.*.email' => ['nullable', 'email', 'max:190'],
+            'speakers.*.email' => ['required_with:speakers.*.name', 'email', 'max:190'],
            'speakers.*.role' => ['nullable', 'string', 'max:80'],
            'speakers.*.bio' => ['nullable', 'string', 'max:500'],
        ]);

-        $this->manager->update($event, [
-            'speakers' => $validated['speakers'] ?? [],
-        ]);
+        try {
+            $this->manager->update($event, [
+                'speakers' => $validated['speakers'] ?? [],
+            ]);
+        } catch (\RuntimeException $e) {
+            return back()->withInput()->with('error', $e->getMessage());
+        }

        return redirect()
            ->route('speakers.show', $event)
            ->with('success', 'Speaker roster saved.');
    }
+
+    public function sendInvite(Request $request, QrCode $event): RedirectResponse
+    {
+        $this->authorize('update', $event);
+        abort_unless($event->type === QrCode::TYPE_EVENT, 404);
+
+        $validated = $request->validate([
+            'email' => ['required', 'email', 'max:190'],
+        ]);
+
+        $sent = $this->invites->sendManualInvite($event, $event->user, $validated['email']);
+
+        if (! $sent) {
+            return back()->with('error', 'Could not send invitation. Check the email address or whether this speaker was already invited from the programme.');
+        }
+
+        return back()->with('success', 'Speaker invitation sent.');
+    }
 }
@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Http\Controllers\Events;
+
+use App\Http\Controllers\Controller;
+use App\Services\Events\EventProgrammeService;
+use App\Services\Events\EventSpeakerInviteService;
+use Illuminate\View\View;
+
+class SpeakerPortalController extends Controller
+{
+    public function __construct(
+        private readonly EventSpeakerInviteService $invites,
+        private readonly EventProgrammeService $programmes,
+    ) {}
+
+    public function show(string $shortCode, string $token): View
+    {
+        $resolved = $this->invites->resolvePortal($shortCode, $token);
+        abort_unless($resolved, 404);
+
+        $event = $resolved['event'];
+        $speaker = $resolved['speaker'];
+        $content = $event->content();
+        $programme = null;
+        $programmeSnapshot = null;
+
+        $programmeId = (int) ($content['programme_qr_id'] ?? 0);
+        if ($programmeId > 0) {
+            $programme = \App\Models\QrCode::query()
+                ->where('id', $programmeId)
+                ->where('type', \App\Models\QrCode::TYPE_ITINERARY)
+                ->first();
+            $programmeSnapshot = $this->programmes->snapshot($programme);
+        }
+
+        $token = (string) ($speaker['invite_token'] ?? '');
+        $virtualSessions = collect((array) ($content['virtual_sessions'] ?? []))
+            ->filter(fn ($session) => is_array($session) && trim((string) ($session['join_url'] ?? '')) !== '')
+            ->map(function (array $session) use ($event, $token) {
+                return [
+                    'title' => trim((string) ($session['title'] ?? 'Virtual session')),
+                    'type' => in_array($session['meet_room_type'] ?? '', ['webinar'], true) ? 'Webinar' : 'Conference',
+                    'scheduled_at' => $session['scheduled_at'] ?? null,
+                    'join_url' => $this->invites->speakerJoinUrl($event, $session, $token),
+                ];
+            })
+            ->values()
+            ->all();
+
+        return view('events.speaker-portal', [
+            'event' => $event,
+            'speaker' => $speaker,
+            'eventContent' => $content,
+            'programmeSnapshot' => $programmeSnapshot,
+            'assignments' => $this->invites->assignmentsForSpeaker($event, $speaker),
+            'virtualSessions' => $virtualSessions,
+        ]);
+    }
+}
@@ -254,6 +254,9 @@ class QrCodeController extends Controller
            'customDomainsEnabled' => app(\App\Services\CustomDomain\CustomDomainService::class)->enabled(),
            'customDomainServerIp' => config('customdomain.server_ip'),
            'itineraryOptions' => $itineraryOptions,
+            'linkedEventSpeakers' => $qrCode->type === QrCode::TYPE_ITINERARY
+                ? app(\App\Services\Events\EventProgrammeService::class)->speakerOptionsForProgramme($qrCode)
+                : [],
        ]);
    }

@@ -82,6 +82,7 @@ class RedirectLegacyQrToLadillLink

        return $suffix === 'register'
            || str_starts_with($suffix, 'register/')
-            || str_starts_with($suffix, 'registered/');
+            || str_starts_with($suffix, 'registered/')
+            || str_starts_with($suffix, 'speaker/');
    }
 }
@@ -75,6 +75,26 @@ class EventEmailService
        );
    }

+    public function sendSpeakerInvite(
+        string $ownerPublicId,
+        string $to,
+        string $eventName,
+        string $portalUrl,
+        ?string $speakerName = null,
+    ): bool {
+        return $this->send(
+            $ownerPublicId,
+            $to,
+            'Speaker invitation — '.$eventName,
+            'mail.notifications.event-speaker-invite',
+            [
+                'eventName' => $eventName,
+                'portalUrl' => $portalUrl,
+                'speakerName' => $speakerName,
+            ],
+        );
+    }
+
    /** @param  array<string, mixed>  $viewData */
    private function send(string $ownerPublicId, string $to, string $subject, string $view, array $viewData): bool
    {
@@ -50,14 +50,59 @@ class EventProgrammeService
    public function hostsFromItems(array $items): array
    {
        return collect($items)
-            ->pluck('host')
-            ->filter(fn ($host) => is_string($host) && trim($host) !== '')
-            ->map(fn ($host) => trim($host))
+            ->flatMap(function ($item) {
+                if (! is_array($item)) {
+                    return [];
+                }
+
+                $email = strtolower(trim((string) ($item['host_speaker_email'] ?? '')));
+                if ($email !== '' && filter_var($email, FILTER_VALIDATE_EMAIL)) {
+                    return [$email];
+                }
+
+                $host = trim((string) ($item['host'] ?? ''));
+                if ($host !== '' && filter_var($host, FILTER_VALIDATE_EMAIL)) {
+                    return [$host];
+                }
+
+                if ($host !== '') {
+                    return [$host];
+                }
+
+                return [];
+            })
            ->unique()
            ->values()
            ->all();
    }

+    /** @return list<array{email: string, name: string}> */
+    public function speakerOptionsForProgramme(QrCode $programme): array
+    {
+        $options = [];
+
+        foreach ($this->eventsLinkedToProgramme($programme) as $event) {
+            foreach ((array) ($event->content()['speakers'] ?? []) as $speaker) {
+                if (! is_array($speaker)) {
+                    continue;
+                }
+
+                $email = trim((string) ($speaker['email'] ?? ''));
+                $name = trim((string) ($speaker['name'] ?? ''));
+                if ($email === '' || ! filter_var($email, FILTER_VALIDATE_EMAIL) || $name === '') {
+                    continue;
+                }
+
+                $options[strtolower($email)] = [
+                    'email' => $email,
+                    'name' => $name,
+                ];
+            }
+        }
+
+        return array_values($options);
+    }
+
    /** @return Collection<int, QrCode> */
    public function eventsLinkedToProgramme(QrCode $programme): Collection
    {
@@ -0,0 +1,322 @@
+<?php
+
+namespace App\Services\Events;
+
+use App\Models\QrCode;
+use App\Models\User;
+use Illuminate\Support\Str;
+
+class EventSpeakerInviteService
+{
+    public const SOURCE_PROGRAMME = 'programme';
+
+    public const SOURCE_MANUAL = 'manual';
+
+    public function __construct(
+        private readonly EventEmailService $email,
+        private readonly EventProgrammeService $programmes,
+        private readonly EventSpeakerService $speakers,
+    ) {}
+
+    /** @return list<array<string, mixed>> */
+    public function rosterWithInviteState(QrCode $event): array
+    {
+        return collect((array) ($event->content()['speakers'] ?? []))
+            ->map(fn ($speaker) => $this->normalizeSpeakerRow(is_array($speaker) ? $speaker : []))
+            ->filter(fn ($speaker) => ($speaker['name'] ?? '') !== '')
+            ->values()
+            ->all();
+    }
+
+    public function canSendManualInvite(QrCode $event, array $speaker): bool
+    {
+        if (($speaker['email'] ?? '') === '') {
+            return false;
+        }
+
+        if (! $this->speakers->linkedProgramme($event)) {
+            return true;
+        }
+
+        if (empty($speaker['invited_at'])) {
+            return true;
+        }
+
+        return ($speaker['invite_source'] ?? '') === self::SOURCE_MANUAL;
+    }
+
+    public function sendManualInvite(QrCode $event, User $owner, string $email): bool
+    {
+        $email = strtolower(trim($email));
+        $speakers = $this->rosterWithInviteState($event);
+        $index = collect($speakers)->search(fn ($row) => strcasecmp((string) ($row['email'] ?? ''), $email) === 0);
+
+        if ($index === false) {
+            return false;
+        }
+
+        $speaker = $speakers[$index];
+        if (! $this->canSendManualInvite($event, $speaker)) {
+            return false;
+        }
+
+        return $this->deliverInvite($event, $owner, $speaker, self::SOURCE_MANUAL);
+    }
+
+    public function inviteProgrammeHosts(QrCode $programme, User $owner): int
+    {
+        if ($programme->type !== QrCode::TYPE_ITINERARY) {
+            return 0;
+        }
+
+        $sent = 0;
+
+        foreach ($this->programmes->eventsLinkedToProgramme($programme) as $event) {
+            $sent += $this->inviteHostsForEvent($event->fresh(), $owner, $programme);
+        }
+
+        return $sent;
+    }
+
+    public function inviteHostsForEvent(QrCode $event, User $owner, ?QrCode $programme = null): int
+    {
+        $programme ??= $this->speakers->linkedProgramme($event);
+        if (! $programme) {
+            return 0;
+        }
+
+        $hostEmails = $this->hostSpeakerEmailsFromProgramme($programme);
+        if ($hostEmails === []) {
+            return 0;
+        }
+
+        $sent = 0;
+        $speakers = $this->rosterWithInviteState($event);
+
+        foreach ($speakers as $speaker) {
+            $email = strtolower((string) ($speaker['email'] ?? ''));
+            if ($email === '' || ! in_array($email, $hostEmails, true)) {
+                continue;
+            }
+
+            if (($speaker['invite_source'] ?? '') === self::SOURCE_PROGRAMME && ! empty($speaker['invited_at'])) {
+                continue;
+            }
+
+            if ($this->deliverInvite($event, $owner, $speaker, self::SOURCE_PROGRAMME)) {
+                $sent++;
+            }
+        }
+
+        return $sent;
+    }
+
+    /** @return array{event: QrCode, speaker: array<string, mixed>}|null */
+    public function resolvePortal(string $shortCode, string $token): ?array
+    {
+        $token = trim($token);
+        if ($token === '') {
+            return null;
+        }
+
+        $event = QrCode::query()
+            ->where('short_code', $shortCode)
+            ->where('type', QrCode::TYPE_EVENT)
+            ->where('is_active', true)
+            ->first();
+
+        if (! $event) {
+            return null;
+        }
+
+        foreach ($this->rosterWithInviteState($event) as $speaker) {
+            if (hash_equals((string) ($speaker['invite_token'] ?? ''), $token)) {
+                return ['event' => $event, 'speaker' => $speaker];
+            }
+        }
+
+        return null;
+    }
+
+    /** @return array<string, mixed>|null */
+    public function verifyToken(QrCode $event, string $token): ?array
+    {
+        $token = trim($token);
+        if ($token === '') {
+            return null;
+        }
+
+        foreach ($this->rosterWithInviteState($event) as $speaker) {
+            if (hash_equals((string) ($speaker['invite_token'] ?? ''), $token)) {
+                return [
+                    'email' => $speaker['email'],
+                    'name' => $speaker['name'],
+                    'role' => $speaker['role'] ?? '',
+                ];
+            }
+        }
+
+        return null;
+    }
+
+    public function portalUrl(QrCode $event, string $token): string
+    {
+        return route('qr.public.speaker.portal', [
+            'shortCode' => $event->short_code,
+            'token' => $token,
+        ]);
+    }
+
+    /** @param  array<string, mixed>  $session */
+    public function speakerJoinUrl(QrCode $event, array $session, string $token): ?string
+    {
+        $joinUrl = trim((string) ($session['join_url'] ?? ''));
+        if ($joinUrl === '') {
+            return null;
+        }
+
+        $separator = str_contains($joinUrl, '?') ? '&' : '?';
+
+        return $joinUrl.$separator.'speaker='.urlencode($token);
+    }
+
+    /** @return list<array{session: string, day: string, time: string, location: string}> */
+    public function assignmentsForSpeaker(QrCode $event, array $speaker): array
+    {
+        $programme = $this->speakers->linkedProgramme($event);
+        $snapshot = $this->programmes->snapshot($programme);
+        if (! $snapshot) {
+            return [];
+        }
+
+        $email = strtolower((string) ($speaker['email'] ?? ''));
+        $name = trim((string) ($speaker['name'] ?? ''));
+        $assignments = [];
+
+        foreach ((array) ($snapshot['days'] ?? []) as $day) {
+            $dayLabel = trim((string) ($day['date'] ?? $day['label'] ?? ''));
+            foreach ((array) ($day['items'] ?? []) as $item) {
+                if (! is_array($item)) {
+                    continue;
+                }
+
+                $hostEmail = strtolower(trim((string) ($item['host_speaker_email'] ?? '')));
+                $hostName = trim((string) ($item['host'] ?? ''));
+
+                $matches = ($email !== '' && $hostEmail === $email)
+                    || ($name !== '' && strcasecmp($hostName, $name) === 0);
+
+                if (! $matches) {
+                    continue;
+                }
+
+                $assignments[] = [
+                    'session' => trim((string) ($item['title'] ?? '')),
+                    'day' => $dayLabel,
+                    'time' => trim((string) ($item['time'] ?? '')),
+                    'location' => trim((string) ($item['location'] ?? '')),
+                ];
+            }
+        }
+
+        return $assignments;
+    }
+
+    /** @param  array<string, mixed>  $speaker */
+    private function deliverInvite(QrCode $event, User $owner, array $speaker, string $source): bool
+    {
+        $email = trim((string) ($speaker['email'] ?? ''));
+        if ($email === '') {
+            return false;
+        }
+
+        $token = (string) ($speaker['invite_token'] ?? '');
+        if ($token === '') {
+            $token = Str::random(48);
+        }
+
+        $eventName = (string) ($event->content()['name'] ?? $event->label);
+        $portalUrl = $this->portalUrl($event, $token);
+
+        $sent = $this->email->sendSpeakerInvite(
+            $owner->public_id,
+            $email,
+            $eventName,
+            $portalUrl,
+            $speaker['name'] ?? null,
+        );
+
+        if (! $sent) {
+            return false;
+        }
+
+        $this->persistSpeakerInviteMeta($event, $email, $token, $source);
+
+        return true;
+    }
+
+    private function persistSpeakerInviteMeta(QrCode $event, string $email, string $token, string $source): void
+    {
+        $email = strtolower(trim($email));
+        $content = $event->content();
+        $speakers = [];
+
+        foreach ((array) ($content['speakers'] ?? []) as $row) {
+            if (! is_array($row)) {
+                continue;
+            }
+
+            $rowEmail = strtolower(trim((string) ($row['email'] ?? '')));
+            if ($rowEmail === $email) {
+                $row['invite_token'] = $token;
+                $row['invited_at'] = now()->toIso8601String();
+                $row['invite_source'] = $source;
+            }
+
+            $speakers[] = $row;
+        }
+
+        $payload = (array) ($event->payload ?? []);
+        $payload['content'] = array_merge($content, ['speakers' => $speakers]);
+        $event->payload = $payload;
+        $event->save();
+    }
+
+    /** @return list<string> */
+    private function hostSpeakerEmailsFromProgramme(QrCode $programme): array
+    {
+        $emails = [];
+
+        foreach ((array) ($programme->content()['days'] ?? []) as $day) {
+            foreach ((array) ($day['items'] ?? []) as $item) {
+                if (! is_array($item)) {
+                    continue;
+                }
+
+                $email = strtolower(trim((string) ($item['host_speaker_email'] ?? '')));
+                if ($email !== '' && filter_var($email, FILTER_VALIDATE_EMAIL)) {
+                    $emails[] = $email;
+                }
+            }
+        }
+
+        return array_values(array_unique($emails));
+    }
+
+    /** @param  array<string, mixed>  $speaker */
+    private function normalizeSpeakerRow(array $speaker): array
+    {
+        $name = trim((string) ($speaker['name'] ?? ''));
+        $email = trim((string) ($speaker['email'] ?? ''));
+
+        return [
+            'name' => $name,
+            'email' => filter_var($email, FILTER_VALIDATE_EMAIL) ? $email : '',
+            'role' => trim((string) ($speaker['role'] ?? '')),
+            'bio' => trim((string) ($speaker['bio'] ?? '')),
+            'invite_token' => trim((string) ($speaker['invite_token'] ?? '')),
+            'invited_at' => $speaker['invited_at'] ?? null,
+            'invite_source' => $speaker['invite_source'] ?? null,
+        ];
+    }
+}
@@ -309,6 +309,8 @@ class QrCodeManagerService

        if ($qrCode->type === QrCode::TYPE_ITINERARY) {
            $this->meetSync->syncEventsForProgramme($qrCode->fresh(), $qrCode->user);
+            app(\App\Services\Events\EventSpeakerInviteService::class)
+                ->inviteProgrammeHosts($qrCode->fresh(), $qrCode->user);
        }

        return $qrCode->fresh(['document']);
@@ -51,7 +51,16 @@ class QrPayloadValidator
            $merged['destination_url'] = $merged['url'];
        }

-        return $this->validateForCreate($qrCode->type, $merged);
+        $result = $this->validateForCreate($qrCode->type, $merged);
+
+        if ($qrCode->type === QrCode::TYPE_EVENT && isset($result['content']['speakers'])) {
+            $result['content']['speakers'] = $this->mergeSpeakerInviteMeta(
+                (array) ($qrCode->content()['speakers'] ?? []),
+                $result['content']['speakers'],
+            );
+        }
+
+        return $result;
    }

    /** @param  array<string, mixed>  $input */
@@ -354,7 +363,7 @@ class QrPayloadValidator
        return array_values($normalized);
    }

-    /** @return list<array{name: string, email: string, role: string, bio: string}> */
+    /** @return list<array{name: string, email: string, role: string, bio: string, invite_token?: string, invited_at?: string, invite_source?: string}> */
    private function normalizeSpeakers(mixed $speakers, array $input): array
    {
        $rows = is_array($speakers) ? $speakers : (array) ($input['speakers'] ?? []);
@@ -371,17 +380,57 @@ class QrPayloadValidator
            }

            $email = trim((string) ($speaker['email'] ?? ''));
-            $normalized[] = [
+            if ($email === '' || ! filter_var($email, FILTER_VALIDATE_EMAIL)) {
+                throw new RuntimeException('Each speaker must have a valid email address.');
+            }
+
+            $row = [
                'name' => mb_substr($name, 0, 120),
-                'email' => filter_var($email, FILTER_VALIDATE_EMAIL) ? $email : '',
+                'email' => $email,
                'role' => mb_substr(trim((string) ($speaker['role'] ?? '')), 0, 80),
                'bio' => mb_substr(trim((string) ($speaker['bio'] ?? '')), 0, 500),
            ];
+
+            foreach (['invite_token', 'invited_at', 'invite_source'] as $key) {
+                if (! empty($speaker[$key])) {
+                    $row[$key] = $speaker[$key];
+                }
+            }
+
+            $normalized[] = $row;
        }

        return array_values($normalized);
    }

+    /**
+     * @param  list<array<string, mixed>>  $previous
+     * @param  list<array<string, mixed>>  $current
+     * @return list<array<string, mixed>>
+     */
+    private function mergeSpeakerInviteMeta(array $previous, array $current): array
+    {
+        $byEmail = collect($previous)
+            ->filter(fn ($row) => is_array($row) && filled($row['email'] ?? null))
+            ->keyBy(fn ($row) => strtolower((string) $row['email']));
+
+        return collect($current)->map(function (array $speaker) use ($byEmail) {
+            $email = strtolower((string) ($speaker['email'] ?? ''));
+            $prev = $byEmail->get($email);
+            if (! $prev) {
+                return $speaker;
+            }
+
+            foreach (['invite_token', 'invited_at', 'invite_source'] as $key) {
+                if (! empty($prev[$key]) && empty($speaker[$key])) {
+                    $speaker[$key] = $prev[$key];
+                }
+            }
+
+            return $speaker;
+        })->values()->all();
+    }
+
    /** @param  array<int, array{price: float}>  $tiers */
    private function eventHasPaidTier(array $tiers): bool
    {
@@ -417,13 +466,24 @@ class QrPayloadValidator
                if ($itemTitle === '') {
                    continue;
                }
+                $hostSpeakerEmail = strtolower(trim((string) ($item['host_speaker_email'] ?? '')));
+                if ($hostSpeakerEmail !== '' && ! filter_var($hostSpeakerEmail, FILTER_VALIDATE_EMAIL)) {
+                    $hostSpeakerEmail = '';
+                }
+
+                $host = mb_substr(trim((string) ($item['host'] ?? '')), 0, 120);
+                if ($host === '' && $hostSpeakerEmail !== '') {
+                    $host = mb_substr(strtok($hostSpeakerEmail, '@') ?: $hostSpeakerEmail, 0, 120);
+                }
+
                $items[] = [
-                    'ref'         => 'day'.$dayIndex.'-item'.$itemIndex,
-                    'time'        => mb_substr(trim((string) ($item['time'] ?? '')), 0, 40),
-                    'title'       => mb_substr($itemTitle, 0, 140),
-                    'description' => mb_substr(trim((string) ($item['description'] ?? '')), 0, 400),
-                    'location'    => mb_substr(trim((string) ($item['location'] ?? '')), 0, 120),
-                    'host'        => mb_substr(trim((string) ($item['host'] ?? '')), 0, 120),
+                    'ref'                => 'day'.$dayIndex.'-item'.$itemIndex,
+                    'time'               => mb_substr(trim((string) ($item['time'] ?? '')), 0, 40),
+                    'title'              => mb_substr($itemTitle, 0, 140),
+                    'description'        => mb_substr(trim((string) ($item['description'] ?? '')), 0, 400),
+                    'location'           => mb_substr(trim((string) ($item['location'] ?? '')), 0, 120),
+                    'host'               => $host,
+                    'host_speaker_email' => $hostSpeakerEmail,
                ];
            }
            if (empty($items) && trim((string) ($day['label'] ?? '')) === '') {
@@ -34,7 +34,7 @@

        {{-- Mass comms --}}
        @if(!empty($commsModes))
-        <div class="rounded-2xl border border-indigo-100 bg-indigo-50/60 p-4"
+        <div id="comms" class="rounded-2xl border border-indigo-100 bg-indigo-50/60 p-4"
             x-data="{
                mode: @js($defaultCommsMode),
                preview: null,
@@ -66,7 +66,7 @@
            @include('qr-codes.partials.type-fields-create', ['accountEventDefaults' => $accountEventDefaults ?? []])

            <p class="rounded-xl bg-slate-50 px-3.5 py-2.5 text-xs leading-5 text-slate-500">
-                GHS {{ number_format($pricePerQr, 2) }} will be charged from your QR balance when you create this event.
+                GHS {{ number_format($pricePerQr, 2) }} will be charged from your wallet when you create this event.
            </p>

            <button type="submit" class="btn-primary w-full">Create event</button>
@@ -0,0 +1,107 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Speaker — {{ $eventContent['name'] ?? $event->label }}</title>
+    @include('partials.favicon')
+    @vite(['resources/css/app.css'])
+</head>
+<body class="min-h-screen bg-slate-50 text-slate-900 antialiased">
+@php
+    $eventName = $eventContent['name'] ?? $event->label;
+    $brandColor = $programmeSnapshot['brand_color'] ?? '#4f46e5';
+@endphp
+
+<div class="mx-auto max-w-lg px-4 py-8 sm:py-12">
+    <div class="text-center">
+        <p class="text-xs font-semibold uppercase tracking-wide text-indigo-600">Speaker access</p>
+        <h1 class="mt-1 text-2xl font-bold text-slate-900">{{ $eventName }}</h1>
+        <p class="mt-1 text-sm text-slate-600">Hi {{ $speaker['name'] }}@if(!empty($speaker['role'])) · {{ $speaker['role'] }}@endif</p>
+    </div>
+
+    @if(!empty($eventContent['starts_at']) || !empty($eventContent['location']))
+        <div class="mt-6 rounded-2xl border border-slate-200 bg-white p-4 text-sm text-slate-600">
+            @if(!empty($eventContent['starts_at']))
+                <p><span class="font-medium text-slate-800">When:</span> {{ $eventContent['starts_at'] }}</p>
+            @endif
+            @if(!empty($eventContent['location']))
+                <p class="mt-1"><span class="font-medium text-slate-800">Where:</span> {{ $eventContent['location'] }}</p>
+            @endif
+        </div>
+    @endif
+
+    @if(count($assignments))
+        <div class="mt-6 rounded-2xl border border-indigo-100 bg-indigo-50/50 p-4">
+            <h2 class="text-sm font-semibold text-indigo-950">Your sessions</h2>
+            <ul class="mt-3 space-y-2">
+                @foreach($assignments as $assignment)
+                    <li class="rounded-xl border border-white/80 bg-white px-3 py-2.5 text-sm">
+                        <p class="font-semibold text-slate-900">{{ $assignment['session'] ?: 'Session' }}</p>
+                        <p class="mt-0.5 text-xs text-slate-500">
+                            @if($assignment['time']){{ $assignment['time'] }}@endif
+                            @if($assignment['day']) · {{ $assignment['day'] }}@endif
+                            @if($assignment['location']) · {{ $assignment['location'] }}@endif
+                        </p>
+                    </li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    @if(count($virtualSessions))
+        <div class="mt-6 rounded-2xl border border-slate-200 bg-white p-4">
+            <h2 class="text-sm font-semibold text-slate-900">Join virtual stage</h2>
+            <p class="mt-1 text-xs text-slate-500">Use these links when it is time to go live. No attendee registration required — you will enter the speaker waiting area.</p>
+            <div class="mt-4 space-y-3">
+                @foreach($virtualSessions as $session)
+                    <a href="{{ $session['join_url'] }}"
+                       class="flex items-center justify-between gap-3 rounded-xl border border-indigo-100 bg-indigo-50/40 px-4 py-3 text-sm font-semibold text-indigo-800 transition hover:border-indigo-200 hover:bg-indigo-50">
+                        <span>
+                            {{ $session['title'] }}
+                            <span class="mt-0.5 block text-xs font-normal text-indigo-600/80">{{ $session['type'] }}</span>
+                        </span>
+                        <svg class="h-4 w-4 shrink-0" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" d="M13.5 4.5 21 12m0 0-7.5 7.5M21 12H3"/></svg>
+                    </a>
+                @endforeach
+            </div>
+        </div>
+    @endif
+
+    @if($programmeSnapshot)
+        <div class="mt-6 rounded-2xl border border-slate-200 bg-white p-4">
+            <h2 class="text-sm font-semibold text-slate-900">{{ $programmeSnapshot['title'] ?? 'Programme' }}</h2>
+            @if(!empty($programmeSnapshot['subtitle']))
+                <p class="mt-0.5 text-xs text-slate-500">{{ $programmeSnapshot['subtitle'] }}</p>
+            @endif
+            <div class="mt-4 space-y-4">
+                @foreach($programmeSnapshot['days'] ?? [] as $day)
+                    <div>
+                        <p class="text-xs font-semibold uppercase tracking-wide text-slate-500">{{ $day['label'] ?? 'Day' }}@if(!empty($day['date'])) · {{ $day['date'] }}@endif</p>
+                        <ul class="mt-2 divide-y divide-slate-100 rounded-xl border border-slate-100">
+                            @foreach($day['items'] ?? [] as $item)
+                                <li class="px-3 py-2.5 text-sm">
+                                    <div class="flex gap-2">
+                                        @if(!empty($item['time']))
+                                            <span class="shrink-0 text-xs font-medium text-slate-400">{{ $item['time'] }}</span>
+                                        @endif
+                                        <div class="min-w-0">
+                                            <p class="font-medium text-slate-900">{{ $item['title'] ?? '' }}</p>
+                                            @if(!empty($item['host']))
+                                                <p class="text-xs text-slate-500">{{ $item['host'] }}</p>
+                                            @endif
+                                        </div>
+                                    </div>
+                                </li>
+                            @endforeach
+                        </ul>
+                    </div>
+                @endforeach
+            </div>
+        </div>
+    @endif
+
+    <p class="mt-8 text-center text-xs text-slate-400">Bookmark this page — it has everything you need on event day.</p>
+</div>
+</body>
+</html>
@@ -22,11 +22,12 @@
        @if($programme)
            <div class="rounded-2xl border border-indigo-100 bg-indigo-50/60 px-4 py-3 text-sm text-indigo-950">
                Linked programme: <a href="{{ route('events.show', $programme) }}" class="font-semibold hover:underline">{{ $programme->label }}</a>.
-                Hosts assigned on programme sessions appear below and sync to virtual sessions.
+                Assign hosts from this speaker list on programme sessions — invitations are sent automatically when you save the programme.
            </div>
        @else
            <div class="rounded-2xl border border-slate-200 bg-slate-50 px-4 py-3 text-sm text-slate-600">
-                Attach a programme on the <a href="{{ route('events.show', $qrCode) }}" class="font-semibold text-indigo-600 hover:underline">event settings</a> page to pull session hosts into this roster.
+                Add speakers here first, then attach a programme on <a href="{{ route('events.show', $qrCode) }}" class="font-semibold text-indigo-600 hover:underline">event settings</a> to schedule sessions and auto-invite hosts.
+                Without a programme, use <strong>Send invitation</strong> below for each speaker.
            </div>
        @endif

@@ -42,7 +43,7 @@
            <div class="flex items-center justify-between gap-3">
                <div>
                    <h2 class="text-sm font-semibold text-slate-900">Event speaker roster</h2>
-                    <p class="mt-0.5 text-xs text-slate-500">Add keynote speakers, panelists, and hosts. Use email when you want to invite them to virtual sessions.</p>
+                    <p class="mt-0.5 text-xs text-slate-500">Every speaker needs an email. They are available when building the programme schedule.</p>
                </div>
                <button type="button" @click="addSpeaker()" class="text-xs font-semibold text-indigo-600 hover:text-indigo-800">+ Add speaker</button>
            </div>
@@ -51,9 +52,9 @@
                <template x-for="(speaker, index) in speakers" :key="index">
                    <div class="rounded-xl border border-slate-200 p-4 space-y-3">
                        <div class="grid gap-3 sm:grid-cols-2">
-                            <input type="text" :name="'speakers[' + index + '][name]'" x-model="speaker.name" placeholder="Name *"
+                            <input type="text" :name="'speakers[' + index + '][name]'" x-model="speaker.name" placeholder="Name *" required
                                   class="rounded-xl border border-slate-200 px-3 py-2 text-sm focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
-                            <input type="email" :name="'speakers[' + index + '][email]'" x-model="speaker.email" placeholder="Email (optional)"
+                            <input type="email" :name="'speakers[' + index + '][email]'" x-model="speaker.email" placeholder="Email *" required
                                   class="rounded-xl border border-slate-200 px-3 py-2 text-sm focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
                        </div>
                        <input type="text" :name="'speakers[' + index + '][role]'" x-model="speaker.role" placeholder="Role / session (optional)"
@@ -68,6 +69,44 @@
            <button type="submit" class="btn-primary w-full">Save speakers</button>
        </form>

+        @if(count($roster))
+            <div class="rounded-2xl border border-slate-200 bg-white p-6">
+                <h2 class="text-sm font-semibold text-slate-900">Invitations</h2>
+                <p class="mt-0.5 text-xs text-slate-500">Speakers assigned on the programme are emailed when the programme is saved. Send manually for events without a programme or speakers not yet on the schedule.</p>
+                <div class="mt-4 divide-y divide-slate-100">
+                    @foreach($roster as $speaker)
+                        @php
+                            $email = $speaker['email'] ?? '';
+                            $invited = ! empty($speaker['invited_at']);
+                            $showInvite = $email !== '' && ($canManualInvite[$email] ?? false);
+                        @endphp
+                        <div class="flex flex-wrap items-center justify-between gap-3 py-3 text-sm">
+                            <div>
+                                <p class="font-semibold text-slate-900">{{ $speaker['name'] }}</p>
+                                <p class="text-xs text-slate-500">{{ $email }}</p>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                @if($invited)
+                                    <span class="rounded-full bg-emerald-50 px-2.5 py-0.5 text-[11px] font-medium text-emerald-700">
+                                        Invited {{ ($speaker['invite_source'] ?? '') === 'programme' ? 'via programme' : '' }}
+                                    </span>
+                                @endif
+                                @if($showInvite)
+                                    <form method="POST" action="{{ route('speakers.invite', $qrCode) }}">
+                                        @csrf
+                                        <input type="hidden" name="email" value="{{ $email }}">
+                                        <button type="submit" class="btn-secondary btn-secondary-sm">Send invitation</button>
+                                    </form>
+                                @elseif($invited && ($speaker['invite_source'] ?? '') === 'programme')
+                                    <span class="text-[11px] text-slate-400">Auto-invited from programme</span>
+                                @endif
+                            </div>
+                        </div>
+                    @endforeach
+                </div>
+            </div>
+        @endif
+
        @if(count($programmeAssignments))
            <div class="rounded-2xl border border-slate-200 bg-white p-6">
                <h2 class="text-sm font-semibold text-slate-900">From programme schedule</h2>
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<body style="font-family: sans-serif; color: #1e293b; line-height: 1.5;">
+@if($speakerName)
+<p>Hi {{ $speakerName }},</p>
+@endif
+<p>You have been invited to speak at <strong>{{ $eventName }}</strong>.</p>
+<p>Your speaker page has the programme, your session times, and links to join the virtual stage when it is time:</p>
+<p><a href="{{ $portalUrl }}">Open your speaker page</a></p>
+<p style="color: #64748b; font-size: 13px;">No attendee registration is required — use the join links on that page to enter the speaker waiting area.</p>
+</body>
+</html>
@@ -667,19 +667,29 @@

    @elseif($qrCode->type === \App\Models\QrCode::TYPE_ITINERARY)
        @php
-            $itinDays = $c['days'] ?? [['label' => 'Day 1', 'date' => '', 'items' => [['time' => '', 'title' => '', 'description' => '', 'location' => '', 'host' => '']]]];
+            $itinDays = $c['days'] ?? [['label' => 'Day 1', 'date' => '', 'items' => [['time' => '', 'title' => '', 'description' => '', 'location' => '', 'host' => '', 'host_speaker_email' => '']]]];
            foreach ($itinDays as &$itinDay) {
                $itinDay['date'] = \App\Support\Qr\QrDateFormatter::forInput($itinDay['date'] ?? null);
+                foreach ($itinDay['items'] ?? [] as &$itinItem) {
+                    $itinItem['host_speaker_email'] = $itinItem['host_speaker_email'] ?? '';
+                }
+                unset($itinItem);
            }
            unset($itinDay);
+            $eventSpeakers = $linkedEventSpeakers ?? [];
        @endphp
        <div class="space-y-4"
             x-data="{
                days: {{ Illuminate\Support\Js::from($itinDays) }},
-                addDay() { this.days.push({ label: 'Day ' + (this.days.length + 1), date: '', items: [{ time: '', title: '', description: '', location: '', host: '' }] }); },
+                speakers: {{ Illuminate\Support\Js::from($eventSpeakers) }},
+                addDay() { this.days.push({ label: 'Day ' + (this.days.length + 1), date: '', items: [{ time: '', title: '', description: '', location: '', host: '', host_speaker_email: '' }] }); },
                removeDay(i) { this.days.splice(i, 1); },
-                addItem(d) { this.days[d].items.push({ time: '', title: '', description: '', location: '', host: '' }); },
-                removeItem(d, i) { this.days[d].items.splice(i, 1); }
+                addItem(d) { this.days[d].items.push({ time: '', title: '', description: '', location: '', host: '', host_speaker_email: '' }); },
+                removeItem(d, i) { this.days[d].items.splice(i, 1); },
+                onHostSpeakerChange(item) {
+                    const match = this.speakers.find(s => s.email === item.host_speaker_email);
+                    item.host = match ? match.name : item.host;
+                }
             }">
            <div class="grid gap-3">
                <input type="text" name="title" value="{{ $c['title'] ?? '' }}" placeholder="Itinerary title *"
@@ -751,8 +761,22 @@
                                <div class="grid gap-2 sm:grid-cols-2">
                                    <input type="text" :name="'days['+d+'][items]['+i+'][location]'" x-model="item.location" placeholder="Location (optional)"
                                           class="rounded-lg border border-slate-200 px-2.5 py-1.5 text-xs focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
-                                    <input type="text" :name="'days['+d+'][items]['+i+'][host]'" x-model="item.host" placeholder="Host / speaker (optional)"
-                                           class="rounded-lg border border-slate-200 px-2.5 py-1.5 text-xs focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
+                                    <template x-if="speakers.length > 0">
+                                        <div class="space-y-1">
+                                            <select :name="'days['+d+'][items]['+i+'][host_speaker_email]'" x-model="item.host_speaker_email" @change="onHostSpeakerChange(item)"
+                                                    class="w-full rounded-lg border border-slate-200 px-2.5 py-1.5 text-xs focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
+                                                <option value="">Choose speaker host (optional)</option>
+                                                <template x-for="speaker in speakers" :key="speaker.email">
+                                                    <option :value="speaker.email" x-text="speaker.name + ' (' + speaker.email + ')'"></option>
+                                                </template>
+                                            </select>
+                                            <input type="hidden" :name="'days['+d+'][items]['+i+'][host]'" :value="item.host">
+                                        </div>
+                                    </template>
+                                    <template x-if="speakers.length === 0">
+                                        <input type="text" :name="'days['+d+'][items]['+i+'][host]'" x-model="item.host" placeholder="Host / speaker (optional)"
+                                               class="rounded-lg border border-slate-200 px-2.5 py-1.5 text-xs focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30">
+                                    </template>
                                </div>
                                <textarea :name="'days['+d+'][items]['+i+'][description]'" x-model="item.description" rows="1" placeholder="Details (optional)"
                                          class="w-full rounded-lg border border-slate-200 px-2.5 py-1.5 text-xs focus:border-indigo-400 focus:outline-none focus:ring-1 focus:ring-indigo-400/30"></textarea>
@@ -18,6 +18,9 @@ Route::middleware(['auth.service:events'])->prefix('service/v1')->group(function
    Route::post('/events/{event}/verify-registration', [\App\Http\Controllers\Api\V1\ServiceMeetController::class, 'verifyRegistration'])
        ->whereNumber('event')
        ->name('api.service.events.verify-registration');
+    Route::post('/events/{event}/verify-speaker', [\App\Http\Controllers\Api\V1\ServiceMeetController::class, 'verifySpeaker'])
+        ->whereNumber('event')
+        ->name('api.service.events.verify-speaker');
 });

 Route::middleware(['auth:sanctum', \App\Http\Middleware\SetActingAccount::class])->prefix('v1')->group(function () {
@@ -47,8 +47,9 @@ Route::get('/q/{shortCode}/event-logo', [QrScanController::class, 'eventLogo'])-
 Route::get('/q/{shortCode}/event-cover', [QrScanController::class, 'eventCover'])->name('qr.public.event.cover');
 Route::get('/q/{shortCode}/itinerary-cover', [QrScanController::class, 'itineraryCover'])->name('qr.public.itinerary.cover');
 Route::post('/q/{shortCode}/register', [EventRegistrationController::class, 'register'])->name('qr.public.event.register');
-Route::get('/q/{shortCode}/register/callback', [EventRegistrationController::class, 'callback'])->name('qr.public.event.callback');
-Route::get('/q/{shortCode}/registered/{ref}', [EventRegistrationController::class, 'confirmed'])->name('qr.public.event.confirmed');
+    Route::get('/q/{shortCode}/register/callback', [EventRegistrationController::class, 'callback'])->name('qr.public.event.callback');
+    Route::get('/q/{shortCode}/registered/{ref}', [EventRegistrationController::class, 'confirmed'])->name('qr.public.event.confirmed');
+    Route::get('/q/{shortCode}/speaker/{token}', [\App\Http\Controllers\Events\SpeakerPortalController::class, 'show'])->name('qr.public.speaker.portal');
 });

 Route::middleware(['auth', 'platform.session'])->group(function () {
@@ -95,6 +96,7 @@ Route::middleware(['auth', 'platform.session'])->group(function () {
    Route::get('/speakers', [SpeakerController::class, 'hub'])->name('speakers.index');
    Route::get('/events/{event}/speakers', [SpeakerController::class, 'index'])->name('speakers.show');
    Route::put('/events/{event}/speakers', [SpeakerController::class, 'update'])->name('speakers.update');
+    Route::post('/events/{event}/speakers/invite', [SpeakerController::class, 'sendInvite'])->name('speakers.invite');

    Route::get('/payouts', [PayoutsController::class, 'index'])->name('events.payouts');

@@ -0,0 +1,229 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\QrCode;
+use App\Models\User;
+use App\Services\Events\EventSpeakerInviteService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Http;
+use Tests\TestCase;
+
+class EventSpeakerInviteTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->withoutMiddleware(\App\Http\Middleware\EnsurePlatformSession::class);
+
+        config([
+            'smtp.platform_api_key' => 'test-smtp-key',
+            'smtp.platform_api_url' => 'https://ladill.test/api/smtp',
+            'events.service_api_keys.meet' => 'test-meet-key',
+        ]);
+
+        Http::fake([
+            config('billing.api_url').'/balance*' => Http::response(['balance_minor' => 50000]),
+            'https://ladill.test/api/smtp/messages/send' => Http::response(['success' => true]),
+        ]);
+    }
+
+    public function test_speaker_portal_page_renders_for_valid_token(): void
+    {
+        $owner = User::factory()->create(['public_id' => 'usr_sp_portal']);
+
+        $event = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'evt-sp-portal',
+            'type' => QrCode::TYPE_EVENT,
+            'label' => 'Speaker portal event',
+            'payload' => [
+                'content' => [
+                    'name' => 'Speaker portal event',
+                    'format' => 'virtual',
+                    'virtual_sessions' => [[
+                        'id' => 'vs-1',
+                        'title' => 'Opening keynote',
+                        'meet_room_type' => 'webinar',
+                        'join_url' => 'https://meet.test/r/room-uuid',
+                    ]],
+                    'speakers' => [[
+                        'name' => 'Jane Speaker',
+                        'email' => 'jane@example.com',
+                        'role' => 'Keynote',
+                        'bio' => '',
+                        'invite_token' => 'speaker-token-abc',
+                    ]],
+                ],
+                'style' => [],
+            ],
+            'is_active' => true,
+        ]);
+
+        $this->get(route('qr.public.speaker.portal', ['shortCode' => $event->short_code, 'token' => 'speaker-token-abc']))
+            ->assertOk()
+            ->assertSee('Jane Speaker', false)
+            ->assertSee('Opening keynote', false)
+            ->assertSee('speaker-token-abc', false);
+    }
+
+    public function test_manual_speaker_invite_sends_email_and_records_metadata(): void
+    {
+        $owner = User::factory()->create(['public_id' => 'usr_sp_manual']);
+
+        $event = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'evt-sp-manual',
+            'type' => QrCode::TYPE_EVENT,
+            'label' => 'Manual invite event',
+            'payload' => [
+                'content' => [
+                    'name' => 'Manual invite event',
+                    'speakers' => [[
+                        'name' => 'Alex Host',
+                        'email' => 'alex@example.com',
+                        'role' => 'Panelist',
+                        'bio' => '',
+                    ]],
+                ],
+                'style' => [],
+            ],
+            'is_active' => true,
+        ]);
+
+        $this->actingAs($owner)
+            ->from(route('speakers.show', $event))
+            ->post(route('speakers.invite', $event), ['email' => 'alex@example.com'])
+            ->assertRedirect(route('speakers.show', $event))
+            ->assertSessionHas('success');
+
+        Http::assertSent(fn ($request) => str_contains($request->url(), '/messages/send')
+            && $request['to'] === 'alex@example.com');
+
+        $event->refresh();
+        $speaker = $event->content()['speakers'][0];
+        $this->assertNotEmpty($speaker['invite_token']);
+        $this->assertNotEmpty($speaker['invited_at']);
+        $this->assertSame(EventSpeakerInviteService::SOURCE_MANUAL, $speaker['invite_source']);
+    }
+
+    public function test_programme_save_invites_assigned_speaker_hosts(): void
+    {
+        $owner = User::factory()->create(['public_id' => 'usr_sp_prog']);
+
+        $programme = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'itn-sp-prog',
+            'type' => QrCode::TYPE_ITINERARY,
+            'label' => 'Summit programme',
+            'payload' => [
+                'content' => [
+                    'title' => 'Summit programme',
+                    'days' => [[
+                        'label' => 'Day 1',
+                        'date' => '2026-07-01',
+                        'items' => [[
+                            'ref' => 'day0-item0',
+                            'time' => '09:00',
+                            'title' => 'Opening',
+                            'description' => '',
+                            'location' => '',
+                            'host' => 'Pat Speaker',
+                            'host_speaker_email' => 'pat@example.com',
+                        ]],
+                    ]],
+                ],
+                'style' => [],
+            ],
+            'is_active' => true,
+        ]);
+
+        $event = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'evt-sp-prog',
+            'type' => QrCode::TYPE_EVENT,
+            'label' => 'Summit',
+            'payload' => [
+                'content' => [
+                    'name' => 'Summit',
+                    'programme_qr_id' => $programme->id,
+                    'speakers' => [[
+                        'name' => 'Pat Speaker',
+                        'email' => 'pat@example.com',
+                        'role' => 'Host',
+                        'bio' => '',
+                    ]],
+                ],
+                'style' => [],
+            ],
+            'is_active' => true,
+        ]);
+
+        app(EventSpeakerInviteService::class)->inviteProgrammeHosts($programme, $owner);
+
+        Http::assertSent(fn ($request) => $request['to'] === 'pat@example.com');
+
+        $event->refresh();
+        $speaker = $event->content()['speakers'][0];
+        $this->assertSame(EventSpeakerInviteService::SOURCE_PROGRAMME, $speaker['invite_source']);
+    }
+
+    public function test_verify_speaker_api_returns_speaker_details(): void
+    {
+        $owner = User::factory()->create(['public_id' => 'usr_sp_api']);
+
+        $event = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'evt-sp-api',
+            'type' => QrCode::TYPE_EVENT,
+            'label' => 'API event',
+            'payload' => [
+                'content' => [
+                    'name' => 'API event',
+                    'speakers' => [[
+                        'name' => 'Sam Panel',
+                        'email' => 'sam@example.com',
+                        'role' => 'Panelist',
+                        'bio' => '',
+                        'invite_token' => 'verify-token-xyz',
+                    ]],
+                ],
+                'style' => [],
+            ],
+            'is_active' => true,
+        ]);
+
+        $this->withToken('test-meet-key')
+            ->postJson('/api/service/v1/events/'.$event->id.'/verify-speaker', [
+                'owner_ref' => $owner->public_id,
+                'speaker_token' => 'verify-token-xyz',
+            ])->assertOk()
+            ->assertJsonPath('speaker.email', 'sam@example.com')
+            ->assertJsonPath('speaker.name', 'Sam Panel');
+    }
+
+    public function test_speaker_roster_requires_email(): void
+    {
+        $owner = User::factory()->create(['public_id' => 'usr_sp_req_email']);
+
+        $event = QrCode::create([
+            'user_id' => $owner->id,
+            'short_code' => 'evt-sp-email-req',
+            'type' => QrCode::TYPE_EVENT,
+            'label' => 'Email required',
+            'payload' => ['content' => ['name' => 'Email required'], 'style' => []],
+            'is_active' => true,
+        ]);
+
+        $this->actingAs($owner)
+            ->from(route('speakers.show', $event))
+            ->put(route('speakers.update', $event), [
+                'speakers' => [
+                    ['name' => 'No Email Person', 'email' => '', 'role' => '', 'bio' => ''],
+                ],
+            ])
+            ->assertSessionHasErrors('speakers.0.email');
+    }
+}
@@ -30,7 +30,7 @@ class EventSpeakerManagementTest extends TestCase
            'short_code' => 'evt-speakers-1',
            'type' => QrCode::TYPE_EVENT,
            'label' => 'Leadership summit',
-            'payload' => ['content' => ['name' => 'Leadership summit', 'speakers' => [['name' => 'Ada Lovelace', 'email' => '', 'role' => 'Keynote', 'bio' => '']]], 'style' => []],
+            'payload' => ['content' => ['name' => 'Leadership summit', 'speakers' => [['name' => 'Ada Lovelace', 'email' => 'ada@example.com', 'role' => 'Keynote', 'bio' => '']]], 'style' => []],
            'is_active' => true,
        ]);

@@ -53,7 +53,7 @@ class EventSpeakerManagementTest extends TestCase
            'payload' => [
                'content' => [
                    'name' => 'Summit day',
-                    'speakers' => [['name' => 'Ada Lovelace', 'email' => '', 'role' => 'Keynote', 'bio' => '']],
+                    'speakers' => [['name' => 'Ada Lovelace', 'email' => 'ada@example.com', 'role' => 'Keynote', 'bio' => '']],
                ],
                'style' => [],
            ],