Files
ladill-queue/app/Models/ServiceQueue.php
T
isaaccladandCursor 0854b431bc
Deploy Ladill Queue / deploy (push) Successful in 2m17s
Add service-point routing so call-next cannot steal assigned tickets.
Counters gain destination/staff metadata; tickets can be pre-assigned to a
service point with assigned_only queues for healthcare while shared_pool
preserves generic bank/government behavior. Display and announcements expose
ticket, staff, and destination clearly for Care and public boards.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-17 17:21:56 +00:00

87 lines
2.5 KiB
PHP

<?php
namespace App\Models;
use App\Models\Concerns\BelongsToOwner;
use App\Models\Concerns\UsesUuidRouteKey;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Support\Str;
class ServiceQueue extends Model
{
use BelongsToOwner, SoftDeletes, UsesUuidRouteKey;
protected $table = 'queue_service_queues';
protected $fillable = [
'uuid', 'owner_ref', 'organization_id', 'branch_id', 'department_id',
'name', 'description', 'color', 'prefix', 'strategy',
'max_capacity', 'avg_service_seconds', 'operating_hours', 'priority_rules',
'settings', 'is_active', 'is_paused', 'ticket_sequence',
];
protected function casts(): array
{
return [
'operating_hours' => 'array',
'priority_rules' => 'array',
'settings' => 'array',
'is_active' => 'boolean',
'is_paused' => 'boolean',
];
}
protected static function booted(): void
{
static::creating(function (self $queue) {
$queue->uuid ??= (string) Str::uuid();
});
}
public function organization(): BelongsTo
{
return $this->belongsTo(Organization::class, 'organization_id');
}
public function branch(): BelongsTo
{
return $this->belongsTo(Branch::class, 'branch_id');
}
public function department(): BelongsTo
{
return $this->belongsTo(Department::class, 'department_id');
}
public function tickets(): HasMany
{
return $this->hasMany(Ticket::class, 'service_queue_id');
}
public function counters(): BelongsToMany
{
return $this->belongsToMany(Counter::class, 'queue_counter_service_queue', 'service_queue_id', 'counter_id')
->withPivot('priority');
}
/**
* shared_pool — any linked service point may pull unassigned waiting tickets.
* assigned_only — call-next only returns tickets pre-assigned to that service point.
*/
public function routingMode(): string
{
$mode = (string) data_get($this->settings, 'routing_mode', 'shared_pool');
return in_array($mode, ['shared_pool', 'assigned_only'], true) ? $mode : 'shared_pool';
}
public function usesAssignedOnlyRouting(): bool
{
return $this->routingMode() === 'assigned_only';
}
}