v7.0.0-beta.4 release
This commit is contained in:
1 parent
05db17887d
commit
1db039ff34
1545 files changed
+136783
-11634
No files matched your search
@@ -0,0 +1,99 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Contracts\Extension\CacheInterface;
|
||||
use App\Extension\Cache\CoreCacheDriver;
|
||||
|
||||
/**
|
||||
* 확장 호환성 알림 dismiss 상태 관리 서비스.
|
||||
*
|
||||
* 자동 비활성화/재호환 알림을 사용자별로 dismiss 한 이력을 캐시에 저장하고 조회합니다.
|
||||
* Listener (대시보드 카드 알림 생성) 와 Controller (배너 데이터 소스) 가 모두 본 서비스를
|
||||
* 통해 동일한 dismiss SSoT 를 사용합니다 — Listener 가 도메인 헬퍼 역할을 겸하지 않도록
|
||||
* Service-Repository 패턴 보호.
|
||||
*
|
||||
* 캐시 키: `ext.compat_alert_dismissed.{userId}` (사용자별 분리, 30일 TTL)
|
||||
*
|
||||
* @since 7.0.0-beta.4
|
||||
*/
|
||||
class ExtensionCompatibilityAlertService
|
||||
{
|
||||
/**
|
||||
* 사용자별 dismiss 이력 캐시 키 prefix.
|
||||
*/
|
||||
private const DISMISS_CACHE_PREFIX = 'ext.compat_alert_dismissed.';
|
||||
|
||||
/**
|
||||
* dismiss 이력 보존 기간 (초).
|
||||
*/
|
||||
private const DISMISS_CACHE_TTL = 86400 * 30;
|
||||
|
||||
/**
|
||||
* @param CacheInterface $cache dismiss 이력 저장소 (사용자별 캐시)
|
||||
*/
|
||||
public function __construct(
|
||||
private readonly CacheInterface $cache,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 특정 사용자의 dismiss 된 알림 ID 목록을 조회합니다.
|
||||
*
|
||||
* 응답 데이터 소스 (배너/카드) 에서 본 메서드를 호출해 dismiss 된 항목을 제외합니다.
|
||||
*
|
||||
* @param int|null $userId 사용자 ID (null/0 이면 빈 배열)
|
||||
* @return array<int, string> dismiss 된 alertId 목록
|
||||
*/
|
||||
public function getDismissedAlertIds(?int $userId): array
|
||||
{
|
||||
if (! $userId) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$cached = $this->cache->get(self::DISMISS_CACHE_PREFIX.$userId, []);
|
||||
|
||||
if (! is_array($cached)) {
|
||||
return [];
|
||||
}
|
||||
|
||||
return array_values(array_filter($cached, 'is_string'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 알림을 사용자별로 dismiss 합니다.
|
||||
*
|
||||
* 자동 비활성화 알림 (DB 영속) 은 다른 관리자에게는 계속 표시되고,
|
||||
* 재호환 알림 (캐시 기반) 은 캐시 만료/감지 갱신 시 재노출됩니다.
|
||||
*
|
||||
* @param string $alertId 알림 ID (compat_{type}_{identifier} 또는 recover_{type}_{identifier})
|
||||
* @param int|null $userId 사용자 ID (null/0 이면 무시)
|
||||
*/
|
||||
public function dismissAlert(string $alertId, ?int $userId): void
|
||||
{
|
||||
if (! $userId) {
|
||||
return;
|
||||
}
|
||||
|
||||
$key = self::DISMISS_CACHE_PREFIX.$userId;
|
||||
$dismissed = $this->cache->get($key, []);
|
||||
|
||||
if (! is_array($dismissed)) {
|
||||
$dismissed = [];
|
||||
}
|
||||
|
||||
if (! in_array($alertId, $dismissed, true)) {
|
||||
$dismissed[] = $alertId;
|
||||
$this->cache->put($key, $dismissed, self::DISMISS_CACHE_TTL);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 컨테이너 바인딩 실패 시의 fallback 인스턴스 (CacheInterface 미바인딩 환경 보호).
|
||||
*
|
||||
* @return self
|
||||
*/
|
||||
public static function fallback(): self
|
||||
{
|
||||
return new self(new CoreCacheDriver(config('cache.default', 'array')));
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user