feat: FCM 관리자 페이지 추가

- FCM 토큰 관리 페이지 (목록, 활성화/비활성화, 삭제) - 테스트 발송 페이지 (대상 필터, 미리보기, 발송) - 발송 이력 페이지 (필터링, 결과 확인) - FcmSender 서비스 (HTTP v1, 배치 처리) - fcm_send_logs 테이블 마이그레이션 - google/auth 패키지 추가
2025-12-19 09:04:42 +09:00
parent 43e469b444
commit c073b82633
24 changed files with 1946 additions and 8 deletions
--- a/app/Models/PushDeviceToken.php
+++ b/app/Models/PushDeviceToken.php
@@ -0,0 +1,125 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\Tenants\Tenant;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PushDeviceToken extends Model
+{
+    use BelongsToTenant;
+    use SoftDeletes;
+
+    protected $fillable = [
+        'tenant_id',
+        'user_id',
+        'token',
+        'platform',
+        'device_name',
+        'app_version',
+        'is_active',
+        'last_used_at',
+        'last_error',
+        'last_error_at',
+    ];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'last_used_at' => 'datetime',
+        'last_error_at' => 'datetime',
+    ];
+
+    /**
+     * 플랫폼 상수
+     */
+    public const PLATFORM_IOS = 'ios';
+
+    public const PLATFORM_ANDROID = 'android';
+
+    public const PLATFORM_WEB = 'web';
+
+    /**
+     * 사용자 관계
+     */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    /**
+     * 테넌트 관계
+     */
+    public function tenant(): BelongsTo
+    {
+        return $this->belongsTo(Tenant::class, 'tenant_id');
+    }
+
+    /**
+     * Scope: 활성 토큰만
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true);
+    }
+
+    /**
+     * Scope: 플랫폼별 필터
+     */
+    public function scopePlatform($query, string $platform)
+    {
+        return $query->where('platform', $platform);
+    }
+
+    /**
+     * Scope: 특정 사용자의 토큰
+     */
+    public function scopeForUser($query, int $userId)
+    {
+        return $query->where('user_id', $userId);
+    }
+
+    /**
+     * Scope: 특정 테넌트의 토큰 (global scope 무시)
+     */
+    public function scopeForTenant($query, int $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    /**
+     * Scope: 에러가 있는 토큰
+     */
+    public function scopeHasError($query)
+    {
+        return $query->whereNotNull('last_error');
+    }
+
+    /**
+     * 에러 정보 기록
+     */
+    public function recordError(string $errorCode): void
+    {
+        $this->update([
+            'last_error' => $errorCode,
+            'last_error_at' => now(),
+        ]);
+    }
+
+    /**
+     * 토큰 비활성화 (에러와 함께)
+     */
+    public function deactivate(?string $errorCode = null): void
+    {
+        $data = ['is_active' => false];
+
+        if ($errorCode) {
+            $data['last_error'] = $errorCode;
+            $data['last_error_at'] = now();
+        }
+
+        $this->update($data);
+    }
+}