feat: 實作機台日誌核心功能與 IoT 高併發處理架構

app/Models/Member/MemberGift.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Models\Member;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class MemberGift extends Model
+{
+    use HasFactory;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'member_id',
+        'gift_definition_id',
+        'status',
+        'claimed_at',
+        'expires_at',
+    ];
+
+    protected $casts = [
+        'claimed_at' => 'datetime',
+        'expires_at' => 'datetime',
+        'created_at' => 'datetime',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 禮品定義
+     */
+    public function giftDefinition(): BelongsTo
+    {
+        return $this->belongsTo(GiftDefinition::class);
+    }
+
+    /**
+     * 待領取的禮品
+     */
+    public function scopePending($query)
+    {
+        return $query->where('status', 'pending')
+            ->where(function ($q) {
+                $q->whereNull('expires_at')
+                    ->orWhere('expires_at', '>', now());
+            });
+    }
+}