Add ability to assign ticket to a user

Author: krekas

README.md

@@ -152,6 +152,7 @@ public function createCategory()
 |  status |`string` | `open`  |
 |  is_resolved |`boolean` | `false`  |
 |  is_locked |`boolean` | `false`  |
+| assigned_to_user_id | `integer` | `NULL` |
 |  created_at |`timestamp` | `NULL`  |
 |  updated_at |`timestamp` | `NULL`  |
 

database/migrations/create_tickets_table.php.stub

@@ -22,6 +22,7 @@ return new class extends Migration
             $table->string('status')->default('open');
             $table->boolean('is_resolved')->default(false);
             $table->boolean('is_locked')->default(false);
+            $table->foreignId('assigned_to_user_id')->nullable();
             $table->timestamps();
         });
     }

src/Concerns/InteractsWithTickets.php

@@ -3,6 +3,7 @@
 namespace Coderflex\LaravelTicket\Concerns;
 
 use Coderflex\LaravelTicket\Enums\Status;
+use Illuminate\Database\Eloquent\Model;
 
 trait InteractsWithTickets
 {
@@ -216,4 +217,19 @@ public function reopenAsUnresolved(): self
 
         return $this;
     }
+
+    /**
+     * Add new message on an existing ticket as a custom user
+     *
+     * @param  \Illuminate\Database\Eloquent\Model|int  $user
+     * @return self
+     */
+    public function assignTo(Model|int $user): self
+    {
+        $this->update([
+            'assigned_to_user_id' => $user,
+        ]);
+
+        return $this;
+    }
 }

src/Models/Ticket.php

@@ -22,6 +22,7 @@
  * @property string $status
  * @property bool $is_resolved
  * @property bool $is_locked
+ * @property int $assigned_to_user_id
  */
 class Ticket extends Model
 {
@@ -47,6 +48,16 @@ public function user(): BelongsTo
         return $this->belongsTo(User::class);
     }
 
+    /**
+     * Get Assigned To User RelationShip
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function assigned_to_user(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'assigned_to_user_id');
+    }
+
     /**
      * Get Messages RelationShip
      *

tests/Feature/TicketTest.php

@@ -1,6 +1,7 @@
 <?php
 
 use Coderflex\LaravelTicket\Models\Ticket;
+use Coderflex\LaravelTicket\Tests\Models\User;
 
 it('filters tickets by status', function () {
     Ticket::factory()
@@ -250,3 +251,13 @@
 
     $this->assertEquals(Ticket::count(), 0);
 });
+
+it('can assign ticket to a user', function () {
+    $ticket = Ticket::factory()->create();
+    $agentUser = User::factory()->create();
+
+    $ticket->assignTo($agentUser);
+
+    expect($ticket->assigned_to_user_id)
+        ->toBe($agentUser);
+});