Add Care waiting-area TV displays with browser TTS voice.

Call-next and recall queue announcements for lobby screens without Ladill Queue.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Models/CareDisplayScreen.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\Concerns\BelongsToOwner;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Str;
+
+class CareDisplayScreen extends Model
+{
+    use BelongsToOwner, SoftDeletes;
+
+    protected $table = 'care_display_screens';
+
+    protected $fillable = [
+        'uuid', 'owner_ref', 'organization_id', 'branch_id',
+        'name', 'layout', 'access_token', 'service_queue_ids', 'settings', 'is_active', 'last_seen_at',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'service_queue_ids' => 'array',
+            'settings' => 'array',
+            'is_active' => 'boolean',
+            'last_seen_at' => 'datetime',
+        ];
+    }
+
+    protected static function booted(): void
+    {
+        static::creating(function (self $screen) {
+            $screen->uuid ??= (string) Str::uuid();
+            $screen->access_token ??= Str::random(48);
+        });
+    }
+
+    public function getRouteKeyName(): string
+    {
+        return 'uuid';
+    }
+
+    public function organization(): BelongsTo
+    {
+        return $this->belongsTo(Organization::class, 'organization_id');
+    }
+
+    public function branch(): BelongsTo
+    {
+        return $this->belongsTo(Branch::class, 'branch_id');
+    }
+}

app/Models/CareServicePoint.php

@@ -51,4 +51,12 @@ class CareServicePoint extends Model
     {
         return $this->hasMany(CareQueueTicket::class, 'service_point_id');
     }
+
+    /** Public display label (Room 4, Counter 2, etc.). Falls back to name. */
+    public function displayDestination(): string
+    {
+        $destination = trim((string) ($this->destination ?? ''));
+
+        return $destination !== '' ? $destination : (string) $this->name;
+    }
 }

app/Models/CareVoiceAnnouncement.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\Concerns\BelongsToOwner;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class CareVoiceAnnouncement extends Model
+{
+    use BelongsToOwner;
+
+    protected $table = 'care_voice_announcements';
+
+    protected $fillable = [
+        'owner_ref', 'organization_id', 'branch_id', 'ticket_id',
+        'locale', 'message', 'voice', 'volume', 'repeat_count', 'status', 'played_at',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'played_at' => 'datetime',
+        ];
+    }
+
+    public function ticket(): BelongsTo
+    {
+        return $this->belongsTo(CareQueueTicket::class, 'ticket_id');
+    }
+}