major helpdesk updates

Modules/Helpdesk/Models/AutomationRule.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+final class AutomationRule extends Model
+{
+    protected $table = 'helpdesk_automation_rules';
+    protected $fillable = ['company_id','name','slug','match_sender','match_subject','match_mailbox','match_category_id','set_priority_id','set_category_id','set_team_id','set_project_id','set_status_id','set_agent_id','is_active','sort_order'];
+    protected $casts = ['company_id'=>'integer','match_category_id'=>'integer','set_priority_id'=>'integer','set_category_id'=>'integer','set_team_id'=>'integer','set_project_id'=>'integer','set_status_id'=>'integer','set_agent_id'=>'integer','is_active'=>'boolean','sort_order'=>'integer'];
+}

Modules/Helpdesk/Models/CannedResponse.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class CannedResponse extends Model
+{
+    protected $table = 'helpdesk_canned_responses';
+    protected $fillable = ['company_id','category_id','team_id','name','slug','visibility','subject','body','is_active','sort_order'];
+    protected $casts = ['company_id'=>'integer','category_id'=>'integer','team_id'=>'integer','is_active'=>'boolean','sort_order'=>'integer'];
+    public function category(): BelongsTo { return $this->belongsTo(Category::class, 'category_id'); }
+    public function team(): BelongsTo { return $this->belongsTo(Team::class, 'team_id'); }
+}

Modules/Helpdesk/Models/ChecklistItem.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class ChecklistItem extends Model
+{
+    protected $table = 'helpdesk_checklist_items';
+    protected $fillable = ['ticket_id','template_id','title','description','is_completed','completed_by','completed_at','sort_order'];
+    protected $casts = ['ticket_id'=>'integer','template_id'=>'integer','is_completed'=>'boolean','completed_by'=>'integer','completed_at'=>'datetime','sort_order'=>'integer'];
+    public function ticket(): BelongsTo { return $this->belongsTo(Ticket::class, 'ticket_id'); }
+}

Modules/Helpdesk/Models/ChecklistTemplate.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+final class ChecklistTemplate extends Model
+{
+    protected $table = 'helpdesk_checklist_templates';
+    protected $fillable = ['company_id','category_id','project_id','name','slug','items','is_active'];
+    protected $casts = ['company_id'=>'integer','category_id'=>'integer','project_id'=>'integer','items'=>'array','is_active'=>'boolean'];
+}

Modules/Helpdesk/Models/GitRepository.php

@@ -32,4 +32,10 @@ final class GitRepository extends Model
     {
         return $this->hasMany(GitCommit::class, 'repository_id')->latest('committed_at');
     }
+
+    /** @return HasMany<GitWebhookLog> */
+    public function webhookLogs(): HasMany
+    {
+        return $this->hasMany(GitWebhookLog::class, 'repository_id')->latest('received_at');
+    }
 }

Modules/Helpdesk/Models/GitWebhookLog.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class GitWebhookLog extends Model
+{
+    use HasFactory;
+
+    protected $table = 'helpdesk_git_webhook_logs';
+
+    /** @var list<string> */
+    protected $fillable = [
+        'repository_id',
+        'provider',
+        'delivery_id',
+        'event',
+        'status',
+        'message',
+        'commit_count',
+        'linked_count',
+        'ignored_count',
+        'payload',
+        'received_at',
+    ];
+
+    /** @var array<string, string> */
+    protected $casts = [
+        'repository_id' => 'integer',
+        'commit_count' => 'integer',
+        'linked_count' => 'integer',
+        'ignored_count' => 'integer',
+        'payload' => 'array',
+        'received_at' => 'datetime',
+    ];
+
+    /**
+     * Repository that received the provider webhook.
+     *
+     * @return BelongsTo<GitRepository, GitWebhookLog>
+     */
+    public function repository(): BelongsTo
+    {
+        return $this->belongsTo(GitRepository::class, 'repository_id');
+    }
+}

Modules/Helpdesk/Models/Product.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+final class Product extends Model
+{
+    protected $table = 'helpdesk_products';
+    protected $fillable = ['company_id','name','slug','type','version','release_channel','description','is_active'];
+    protected $casts = ['company_id'=>'integer','is_active'=>'boolean'];
+    public function tickets(): HasMany { return $this->hasMany(Ticket::class, 'product_id'); }
+}

Modules/Helpdesk/Models/SlaPolicy.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class SlaPolicy extends Model
+{
+    protected $table = 'helpdesk_sla_policies';
+    protected $fillable = ['company_id','priority_id','category_id','name','slug','first_response_minutes','resolution_minutes','business_hours_only','is_default','is_active'];
+    protected $casts = ['company_id'=>'integer','priority_id'=>'integer','category_id'=>'integer','first_response_minutes'=>'integer','resolution_minutes'=>'integer','business_hours_only'=>'boolean','is_default'=>'boolean','is_active'=>'boolean'];
+    public function priority(): BelongsTo { return $this->belongsTo(Priority::class, 'priority_id'); }
+    public function category(): BelongsTo { return $this->belongsTo(Category::class, 'category_id'); }
+}

Modules/Helpdesk/Models/Tag.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+
+final class Tag extends Model
+{
+    protected $table = 'helpdesk_tags';
+    protected $fillable = ['company_id','name','slug','color'];
+    protected $casts = ['company_id'=>'integer'];
+    public function tickets(): BelongsToMany { return $this->belongsToMany(Ticket::class, 'helpdesk_ticket_tag', 'tag_id', 'ticket_id'); }
+}

Modules/Helpdesk/Models/Ticket.php

@@ -8,6 +8,7 @@ use App\Models\User;
 use Illuminate\Database\Eloquent\Builder;
 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;
 
@@ -27,6 +28,8 @@ final class Ticket extends Model
     protected $fillable = [
         'reference', 'company_id', 'user_id', 'agent_id', 'status_id', 'priority_id', 'category_id', 'project_id', 'team_id',
         'subject', 'body', 'due_at', 'completed_at', 'last_activity_at', 'archived_at',
+        'sla_policy_id', 'product_id', 'first_response_at', 'sla_first_response_due_at', 'sla_resolution_due_at',
+        'sla_first_response_breached_at', 'sla_resolution_breached_at', 'public_replies_count', 'time_spent_minutes',
     ];
 
     /** @var array<string, string> */
@@ -37,6 +40,15 @@ final class Ticket extends Model
         'completed_at' => 'datetime',
         'last_activity_at' => 'datetime',
         'archived_at' => 'datetime',
+        'sla_policy_id' => 'integer',
+        'product_id' => 'integer',
+        'first_response_at' => 'datetime',
+        'sla_first_response_due_at' => 'datetime',
+        'sla_resolution_due_at' => 'datetime',
+        'sla_first_response_breached_at' => 'datetime',
+        'sla_resolution_breached_at' => 'datetime',
+        'public_replies_count' => 'integer',
+        'time_spent_minutes' => 'integer',
     ];
 
     /** @return BelongsTo<User, Ticket> */
@@ -89,6 +101,57 @@ final class Ticket extends Model
             ->oldest();
     }
 
+
+    /** @return BelongsTo<SlaPolicy, Ticket> */
+    public function slaPolicy(): BelongsTo
+    {
+        return $this->belongsTo(SlaPolicy::class, 'sla_policy_id');
+    }
+
+    /** @return BelongsTo<Product, Ticket> */
+    public function product(): BelongsTo
+    {
+        return $this->belongsTo(Product::class, 'product_id');
+    }
+
+    /** @return HasMany<TicketSlaEvent> */
+    public function slaEvents(): HasMany
+    {
+        return $this->hasMany(TicketSlaEvent::class, 'ticket_id')->latest();
+    }
+
+    /** @return HasMany<TicketRating> */
+    public function ratings(): HasMany
+    {
+        return $this->hasMany(TicketRating::class, 'ticket_id')->latest();
+    }
+
+    /** @return HasMany<ChecklistItem> */
+    public function checklistItems(): HasMany
+    {
+        return $this->hasMany(ChecklistItem::class, 'ticket_id')->orderBy('sort_order')->orderBy('id');
+    }
+
+    /** @return BelongsToMany<Tag> */
+    public function tags(): BelongsToMany
+    {
+        return $this->belongsToMany(Tag::class, 'helpdesk_ticket_tag', 'ticket_id', 'tag_id');
+    }
+
+    public function getSlaFirstResponseBreachedAttribute(): bool
+    {
+        return $this->first_response_at === null
+            && $this->sla_first_response_due_at !== null
+            && now()->greaterThan($this->sla_first_response_due_at);
+    }
+
+    public function getSlaResolutionBreachedAttribute(): bool
+    {
+        return $this->completed_at === null
+            && $this->sla_resolution_due_at !== null
+            && now()->greaterThan($this->sla_resolution_due_at);
+    }
+
     /** @return HasMany<GitCommit> */
     public function gitCommits(): HasMany
     {

Modules/Helpdesk/Models/TicketRating.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+final class TicketRating extends Model
+{
+    protected $table = 'helpdesk_ticket_ratings';
+    protected $fillable = ['ticket_id','agent_id','team_id','category_id','rating','token','comment','rated_at'];
+    protected $casts = ['ticket_id'=>'integer','agent_id'=>'integer','team_id'=>'integer','category_id'=>'integer','rating'=>'integer','rated_at'=>'datetime'];
+}

Modules/Helpdesk/Models/TicketSlaEvent.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+final class TicketSlaEvent extends Model
+{
+    protected $table = 'helpdesk_ticket_sla_events';
+    protected $fillable = ['ticket_id','sla_policy_id','event','due_at','occurred_at','breached','meta'];
+    protected $casts = ['ticket_id'=>'integer','sla_policy_id'=>'integer','due_at'=>'datetime','occurred_at'=>'datetime','breached'=>'boolean','meta'=>'array'];
+}

Modules/Helpdesk/Models/WorkflowLog.php

@@ -15,7 +15,14 @@ final class WorkflowLog extends Model
     protected $table = 'helpdesk_workflow_logs';
 
     /** @var list<string> */
-    protected $fillable = ['template_id', 'ticket_id', 'event', 'recipient', 'subject', 'status', 'error'];
+    protected $fillable = ['template_id', 'ticket_id', 'event', 'recipient', 'subject', 'status', 'tracking_token', 'first_opened_at', 'last_opened_at', 'opened_count', 'error'];
+
+    /** @var array<string, string> */
+    protected $casts = [
+        'first_opened_at' => 'datetime',
+        'last_opened_at' => 'datetime',
+        'opened_count' => 'integer',
+    ];
 
     /** @return BelongsTo<WorkflowTemplate, WorkflowLog> */
     public function template(): BelongsTo