v7.0.0-beta.1 release

app/Models/MailSendLog.php

@@ -0,0 +1,132 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\ExtensionOwnerType;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * 메일 발송 이력 모델
+ *
+ * @property int $id
+ * @property string $recipient_email
+ * @property string|null $recipient_name
+ * @property string|null $subject
+ * @property string|null $template_type
+ * @property ExtensionOwnerType $extension_type
+ * @property string $extension_identifier
+ * @property string|null $source
+ * @property string $status
+ * @property string|null $sender_email
+ * @property string|null $sender_name
+ * @property string|null $error_message
+ * @property \Carbon\Carbon $sent_at
+ */
+class MailSendLog extends Model
+{
+    use HasFactory;
+
+    /**
+     * @var string 테이블명
+     */
+    protected $table = 'mail_send_logs';
+
+    /**
+     * @var array<int, string> 대량 할당 가능 필드
+     */
+    protected $fillable = [
+        'sender_email',
+        'sender_name',
+        'recipient_email',
+        'recipient_name',
+        'subject',
+        'body',
+        'template_type',
+        'extension_type',
+        'extension_identifier',
+        'source',
+        'status',
+        'error_message',
+        'sent_at',
+    ];
+
+    /**
+     * 속성 캐스팅 정의
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'extension_type' => ExtensionOwnerType::class,
+            'sent_at' => 'datetime',
+        ];
+    }
+
+    /**
+     * 템플릿 유형별 필터 스코프
+     *
+     * @param Builder $query 쿼리 빌더
+     * @param string|null $templateType 템플릿 유형
+     * @return Builder
+     */
+    public function scopeByTemplateType(Builder $query, ?string $templateType): Builder
+    {
+        if ($templateType === null) {
+            return $query->whereNull('template_type');
+        }
+
+        return $query->where('template_type', $templateType);
+    }
+
+    /**
+     * 확장 타입/식별자별 필터 스코프
+     *
+     * @param Builder $query 쿼리 빌더
+     * @param ExtensionOwnerType|null $type 확장 타입
+     * @param string|null $identifier 확장 식별자
+     * @return Builder
+     */
+    public function scopeByExtension(Builder $query, ?ExtensionOwnerType $type = null, ?string $identifier = null): Builder
+    {
+        if ($type !== null) {
+            $query->where('extension_type', $type);
+        }
+
+        if ($identifier !== null) {
+            $query->where('extension_identifier', $identifier);
+        }
+
+        return $query;
+    }
+
+    /**
+     * 발송 출처별 필터 스코프
+     *
+     * @param Builder $query 쿼리 빌더
+     * @param string|null $source 발송 출처
+     * @return Builder
+     */
+    public function scopeBySource(Builder $query, ?string $source): Builder
+    {
+        if ($source === null) {
+            return $query->whereNull('source');
+        }
+
+        return $query->where('source', $source);
+    }
+
+    /**
+     * 상태별 필터 스코프
+     *
+     * @param Builder $query 쿼리 빌더
+     * @param string $status 상태값
+     * @return Builder
+     */
+    public function scopeByStatus(Builder $query, string $status): Builder
+    {
+        return $query->where('status', $status);
+    }
+}