new helpdesk module

Modules/Helpdesk/Models/Ticket.php

@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * @property int $id
+ * @property string $reference
+ * @property string $subject
+ * @property string $body
+ */
+final class Ticket extends Model
+{
+    use HasFactory;
+    use SoftDeletes;
+
+    protected $table = 'helpdesk_tickets';
+
+    /** @var list<string> */
+    protected $fillable = [
+        'reference', 'user_id', 'agent_id', 'status_id', 'priority_id', 'category_id', 'project_id',
+        'subject', 'body', 'due_at', 'completed_at', 'last_activity_at', 'archived_at',
+    ];
+
+    /** @var array<string, string> */
+    protected $casts = [
+        'due_at' => 'datetime',
+        'completed_at' => 'datetime',
+        'last_activity_at' => 'datetime',
+        'archived_at' => 'datetime',
+    ];
+
+    /** @return BelongsTo<User, Ticket> */
+    public function owner(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'user_id');
+    }
+
+    /** @return BelongsTo<User, Ticket> */
+    public function agent(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'agent_id');
+    }
+
+    /** @return BelongsTo<Status, Ticket> */
+    public function status(): BelongsTo
+    {
+        return $this->belongsTo(Status::class, 'status_id');
+    }
+
+    /** @return BelongsTo<Priority, Ticket> */
+    public function priority(): BelongsTo
+    {
+        return $this->belongsTo(Priority::class, 'priority_id');
+    }
+
+    /** @return BelongsTo<Category, Ticket> */
+    public function category(): BelongsTo
+    {
+        return $this->belongsTo(Category::class, 'category_id');
+    }
+
+    /** @return BelongsTo<Project, Ticket> */
+    public function project(): BelongsTo
+    {
+        return $this->belongsTo(Project::class, 'project_id');
+    }
+
+    /** @return HasMany<Comment> */
+    public function comments(): HasMany
+    {
+        return $this->hasMany(Comment::class, 'ticket_id')->latest();
+    }
+
+    /** @return HasMany<Attachment> */
+    public function attachments(): HasMany
+    {
+        return $this->hasMany(Attachment::class, 'ticket_id')->latest();
+    }
+
+    /** @param Builder<Ticket> $query @return Builder<Ticket> */
+    public function scopeOpen(Builder $query): Builder
+    {
+        return $query->whereNull('completed_at');
+    }
+
+    /** @param Builder<Ticket> $query @return Builder<Ticket> */
+    public function scopeVisibleTo(Builder $query, User $user): Builder
+    {
+        if ((bool) ($user->helpdesk_admin ?? false)) {
+            return $query;
+        }
+
+        if ((bool) ($user->helpdesk_agent ?? false)) {
+            return $query->where(static function (Builder $subQuery) use ($user): void {
+                $subQuery->where('agent_id', $user->id)->orWhere('user_id', $user->id);
+            });
+        }
+
+        return $query->where('user_id', $user->id);
+    }
+}