feat(ticket): add refund transaction model

app/Domains/Purchase/Models/PurchaseItem.php

@@ -6,6 +6,7 @@ use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Variant;
 use App\Domains\Ticket\Models\Ticket;
+use App\Domains\Ticket\Models\TicketRefund;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -66,6 +67,12 @@ class PurchaseItem extends Model
         return $this->hasMany(Ticket::class, 'source_purchase_item_id');
     }
 
+    /** @return HasMany<TicketRefund, $this> */
+    public function ticketRefunds(): HasMany
+    {
+        return $this->hasMany(TicketRefund::class);
+    }
+
     /** @return BelongsTo<Attachment, $this> */
     public function imageAttachment(): BelongsTo
     {

app/Domains/Ticket/Models/Ticket.php

@@ -18,6 +18,7 @@ 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\Relations\HasOne;
 use Illuminate\Support\Collection;
 use Illuminate\Validation\ValidationException;
 
@@ -219,6 +220,12 @@ class Ticket extends Model
         return $this->belongsTo(PurchaseItem::class, 'source_purchase_item_id');
     }
 
+    /** @return HasOne<TicketRefund, $this> */
+    public function refund(): HasOne
+    {
+        return $this->hasOne(TicketRefund::class);
+    }
+
     /** @return BelongsTo<CatalogItem, $this> */
     public function sourceCatalogItem(): BelongsTo
     {
@@ -284,6 +291,14 @@ class Ticket extends Model
 
     public function getStatusLabelAttribute(): string
     {
+        if ($this->status === self::STATUS_REFUNDED && $this->relationLoaded('refund')) {
+            $refund = $this->getRelation('refund');
+
+            if ($refund instanceof TicketRefund) {
+                return $refund->typeLabel();
+            }
+        }
+
         return self::statusLabel($this->status);
     }
 

app/Domains/Ticket/Models/TicketRefund.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Domains\Ticket\Models;
+
+use App\Domains\Auth\Models\User;
+use App\Domains\Purchase\Models\PurchaseItem;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+#[Fillable([
+    'ticket_id',
+    'purchase_item_id',
+    'created_by_user_id',
+    'type',
+    'amount',
+])]
+class TicketRefund extends Model
+{
+    public const TYPE_PARTIAL = 'partial';
+
+    public const TYPE_TOTAL = 'total';
+
+    protected function casts(): array
+    {
+        return [
+            'ticket_id' => 'integer',
+            'purchase_item_id' => 'integer',
+            'created_by_user_id' => 'integer',
+            'amount' => 'decimal:2',
+        ];
+    }
+
+    /** @return list<string> */
+    public static function types(): array
+    {
+        return [self::TYPE_PARTIAL, self::TYPE_TOTAL];
+    }
+
+    public function typeLabel(): string
+    {
+        return match ($this->type) {
+            self::TYPE_PARTIAL => 'Reembolso parcial',
+            self::TYPE_TOTAL => 'Reembolso total',
+            default => 'Reembolsado',
+        };
+    }
+
+    /** @return BelongsTo<Ticket, $this> */
+    public function ticket(): BelongsTo
+    {
+        return $this->belongsTo(Ticket::class);
+    }
+
+    /** @return BelongsTo<PurchaseItem, $this> */
+    public function purchaseItem(): BelongsTo
+    {
+        return $this->belongsTo(PurchaseItem::class);
+    }
+
+    /** @return BelongsTo<User, $this> */
+    public function createdBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by_user_id')->withTrashed();
+    }
+}

database/migrations/2026_09_14_010000_create_ticket_refunds_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('ticket_refunds', function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('ticket_id')->unique()->constrained('tickets')->cascadeOnDelete();
+            $table->foreignId('purchase_item_id')->constrained('compra_items')->restrictOnDelete();
+            $table->foreignId('created_by_user_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->string('type', 16);
+            $table->decimal('amount', 10, 2);
+            $table->timestamps();
+
+            $table->index(['purchase_item_id', 'type']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('ticket_refunds');
+    }
+};