feat: FCM 실서비스 확장 - 대량 발송 및 무효 토큰 관리

- FcmSender.sendToMany() 추가 (chunk/rate limit 지원)
- FcmBatchResult 클래스 추가 (발송 결과 집계)
- fcm:send 명령어 추가 (대량 발송, dry-run 지원)
- fcm:prune-invalid 명령어 추가 (무효 토큰 정리)
- PushDeviceToken에 last_error, last_error_at 컬럼 추가
- 실패 토큰 자동 비활성화 (UNREGISTERED, NOT_FOUND, INVALID_ARGUMENT)
This commit is contained in:
2025-12-18 23:01:06 +09:00
parent 81a6dfab5a
commit 10a64fb0a5
9 changed files with 509 additions and 8 deletions

View File

@@ -21,11 +21,14 @@ class PushDeviceToken extends Model
'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',
];
/**
@@ -76,4 +79,46 @@ 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);
}
}