HeuJung
face022073
관리자 "전체 재생성"을 큐(Full 모드)로 던지고 진행상황을 SEO 탭에서 확인한다. Reverb ON 이면 방송 채널 구독으로 실시간 갱신, OFF 면 상태 API 폴링으로 폴백한다. - SitemapProgress 진행상황 스토어(queued→running→writing→completed/failed, 캐시 TTL 3600, 방송 스로틀) + SitemapManager.getStatus 확장(progress + realtime_enabled) - GET /api/admin/seo/sitemap/status(core.settings.read) 신규 - 관리자 재생성을 항상 Full 모드로 큐잉 + 진행률 기록, Job 최종 실패 시 progress=failed 고정 - core.admin.seo.sitemap 방송 채널 인증(core.settings.read) - SEO 탭 진행상황 UI(상태 배지/단계/누적 URL/실시간·폴링 안내) + 폴링 분기 - 재생성 중 누적 URL 표기(replaceAllForContributor 삽입 건수 반환 — count 쿼리 없이 스트림 누적) - ja 언어팩 진행상황 UI 번역 동기화
63 lines
2.6 KiB
PHP
63 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace App\Contracts\Repositories;
|
|
|
|
use App\Models\SitemapUrl;
|
|
|
|
/**
|
|
* 사이트맵 URL 저장소 인터페이스
|
|
*
|
|
* sitemap_urls 테이블에 대한 리소스 단위 증분 갱신과 스트리밍 조회를 제공합니다.
|
|
* 리스너는 SitemapIndexer 를 경유해 이 저장소를 사용하며(직접 Model/DB 접근 금지),
|
|
* 전체 재생성/증분 파일 작성은 이 저장소의 스트림을 소비합니다.
|
|
*/
|
|
interface SitemapUrlRepositoryInterface
|
|
{
|
|
/**
|
|
* 한 리소스의 사이트맵 URL 행을 현재 상태로 대체합니다(멱등).
|
|
*
|
|
* (resource_type, resource_id) 로 기존 행을 제거한 뒤 전달된 항목을 삽입하므로,
|
|
* 같은 입력으로 여러 번 호출해도 테이블 내용이 동일합니다(loc 변경/슬러그 변경 흡수).
|
|
*
|
|
* @param string $type 리소스 유형
|
|
* @param string $id 리소스 PK (문자열)
|
|
* @param array<int, array{loc: string, contributor: string, lastmod?: mixed, changefreq?: ?string, priority?: ?float}> $entries URL 항목
|
|
*/
|
|
public function upsertForResource(string $type, string $id, array $entries): void;
|
|
|
|
/**
|
|
* 한 리소스의 사이트맵 URL 행을 모두 제거합니다(비공개/삭제 시).
|
|
*
|
|
* @param string $type 리소스 유형
|
|
* @param string $id 리소스 PK (문자열)
|
|
*/
|
|
public function removeForResource(string $type, string $id): void;
|
|
|
|
/**
|
|
* 공개(is_visible) URL 을 id 순으로 스트리밍합니다(유계 메모리).
|
|
*
|
|
* @param string|null $contributor 기여자 식별자로 스코핑 (null = 전체)
|
|
* @return iterable<int, SitemapUrl> URL 순회자
|
|
*/
|
|
public function streamVisible(?string $contributor = null): iterable;
|
|
|
|
/**
|
|
* 공개(is_visible) URL 총 개수를 반환합니다.
|
|
*
|
|
* @return int 공개 URL 수
|
|
*/
|
|
public function countVisible(): int;
|
|
|
|
/**
|
|
* 한 기여자의 모든 사이트맵 URL 행을 전량 대체합니다(전체 재생성).
|
|
*
|
|
* 기여자 스코프로 기존 행을 제거한 뒤 스트림을 청크 삽입하여
|
|
* 대용량에서도 메모리를 유계로 유지합니다.
|
|
*
|
|
* @param string $contributor 기여자 식별자
|
|
* @param iterable<int, array{loc: string, resource_type?: string, resource_id?: mixed, lastmod?: mixed, changefreq?: ?string, priority?: ?float}> $entries URL 항목 스트림
|
|
* @return int 삽입된 행 수 (진행상황 누적 URL 표기용 — count 쿼리 없이 스트림 누적)
|
|
*/
|
|
public function replaceAllForContributor(string $contributor, iterable $entries): int;
|
|
}
|