HeuJung
2ae1972a3b
공개 이슈 gnuboard/g7 이 지목한 병목은 "같은 일을 반복 실행한다" 축이다. 응답·행의 무게를 다룬 · 과 겹치지 않는다. 공통 계약 — 총 건수 상한과 페이지 이동 범위는 별개 결정이다. 묶으면 필요 없이 기능이 깎인다. 총 건수만 상한을 받고(파생 테이블 COUNT), "다음" 이동은 per_page + 1 실측으로 끝까지 열어 둔다. 계산이 불가능해지는 것은 마지막 페이지 번호 하나뿐이며 그 사실은 last_page: null 이 알린다. 최신순처럼 실제 컬럼으로 정렬하는 목록은 커서로 전환해 깊이와 무관하게 일정 속도로 이동한다. 관련도순은 계산값 정렬이라 커서 키로 쓸 수 없어 offset 을 유지한다. 계약의 입구는 표준 paginate 와 같은 폭이어야 한다. 관계·쿼리 빌더를 받지 못하면 그 좁은 만큼이 그대로 운영 500 이 되고, 실제로 관리자 알림 목록에서 그렇게 터졌다. 응답 조립도 컬렉션마다 손으로 하면 형태가 늘어나는 순간 없는 값을 부르거나 새 필드를 흘리므로, 형태 판정을 paginationMeta 한 곳에 모았다. 표준 paginate 응답은 필드 단위로 이전과 동일하다. 요청당 반복 비용 — 훅 구독마다 남기던 로그 400줄, 요청당 스무 번 넘던 설정 파일 재읽기, 이미 캐시된 목록의 DB 재조회를 없앴다. 권한 판정은 요청 스코프 메모를 두어 화면 요소마다 나가던 조회를 한 번으로 줄였고, 크로스 요청 캐시는 두지 않아 권한 변경이 종전처럼 다음 요청에 반영된다. 검색 질의는 활성 엔진이 만든다. 저장소가 구체 엔진을 지목하면 플러그인이 등록한 엔진은 호출될 기회 자체를 잃고 오류 없이 다른 방식으로 동작한다. 해석기를 두어 활성 엔진에 위임하고, 전문검색이 없는 DBMS 의 부분일치 폴백도 드라이버명 하드코딩 대신 선언형 config 로 옮겼다. 총 건수가 잘린 목록에서 순번을 역산하면 0 과 음수가 나온다. 지어내지 않고 null 을 돌려주며, 그 원칙을 last_page 와 동일하게 적용했다.
395 lines
15 KiB
PHP
395 lines
15 KiB
PHP
<?php
|
|
|
|
namespace App\Repositories;
|
|
|
|
use App\Contracts\Repositories\LanguagePackRepositoryInterface;
|
|
use App\Enums\LanguagePackScope;
|
|
use App\Enums\LanguagePackSourceType;
|
|
use App\Enums\LanguagePackStatus;
|
|
use App\Enums\TextDirection;
|
|
use App\Models\LanguagePack;
|
|
use App\Repositories\Concerns\HasMultipleSearchFilters;
|
|
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Support\Facades\DB;
|
|
|
|
/**
|
|
* 언어팩 Repository 구현체.
|
|
*/
|
|
class LanguagePackRepository implements LanguagePackRepositoryInterface
|
|
{
|
|
use HasMultipleSearchFilters;
|
|
|
|
/**
|
|
* 식별자로 언어팩을 조회합니다.
|
|
*
|
|
* @param string $identifier 언어팩 식별자
|
|
* @return LanguagePack|null 언어팩 또는 null
|
|
*/
|
|
public function findByIdentifier(string $identifier): ?LanguagePack
|
|
{
|
|
return LanguagePack::query()->where('identifier', $identifier)->first();
|
|
}
|
|
|
|
/**
|
|
* ID 로 언어팩을 조회합니다.
|
|
*
|
|
* @param int $id 언어팩 ID
|
|
* @return LanguagePack|null 언어팩 또는 null
|
|
*/
|
|
public function findById(int $id): ?LanguagePack
|
|
{
|
|
return LanguagePack::query()->find($id);
|
|
}
|
|
|
|
/**
|
|
* 모든 활성 언어팩을 조회합니다.
|
|
*
|
|
* @return Collection<int, LanguagePack> 활성 언어팩 컬렉션
|
|
*/
|
|
public function getActivePacks(): Collection
|
|
{
|
|
// audit:allow query-unbounded-get reason: 언어팩은 설치된 팩 × 로케일 수만큼만 존재한다 (사용량과 무관)
|
|
return LanguagePack::query()
|
|
->where('status', LanguagePackStatus::Active->value)
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* 특정 슬롯의 활성 언어팩을 조회합니다.
|
|
*
|
|
* @param string $scope 스코프
|
|
* @param string|null $targetIdentifier 대상 확장 식별자
|
|
* @param string $locale 로케일
|
|
* @param int|null $excludeId 결과에서 제외할 언어팩 id (재설치 시 자기 자신 제외용)
|
|
* @return LanguagePack|null 활성 언어팩 또는 null
|
|
*/
|
|
public function findActiveForSlot(
|
|
string $scope,
|
|
?string $targetIdentifier,
|
|
string $locale,
|
|
?int $excludeId = null
|
|
): ?LanguagePack {
|
|
$query = LanguagePack::query()
|
|
->where('scope', $scope)
|
|
->where('target_identifier', $targetIdentifier)
|
|
->where('locale', $locale)
|
|
->where('status', LanguagePackStatus::Active->value);
|
|
|
|
if ($excludeId !== null) {
|
|
$query->where('id', '!=', $excludeId);
|
|
}
|
|
|
|
return $query->first();
|
|
}
|
|
|
|
/**
|
|
* 특정 슬롯의 모든 후보 언어팩을 조회합니다 (벤더별).
|
|
*
|
|
* @param string $scope 스코프
|
|
* @param string|null $targetIdentifier 대상 확장 식별자
|
|
* @param string $locale 로케일
|
|
* @return Collection<int, LanguagePack> 후보 언어팩 컬렉션
|
|
*/
|
|
public function getPacksForSlot(
|
|
string $scope,
|
|
?string $targetIdentifier,
|
|
string $locale
|
|
): Collection {
|
|
// audit:allow query-unbounded-get reason: 언어팩은 설치된 팩 × 로케일 수만큼만 존재한다 (사용량과 무관)
|
|
return LanguagePack::query()
|
|
->where('scope', $scope)
|
|
->where('target_identifier', $targetIdentifier)
|
|
->where('locale', $locale)
|
|
->orderByDesc('activated_at')
|
|
->orderByDesc('installed_at')
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* 활성 코어 언어팩이 있는 모든 로케일을 반환합니다.
|
|
*
|
|
* @return array<int, string> 로케일 문자열 배열
|
|
*/
|
|
public function getActiveCoreLocales(): array
|
|
{
|
|
// audit:allow query-unbounded-get reason: 언어팩은 설치된 팩 × 로케일 수만큼만 존재한다 (사용량과 무관)
|
|
return LanguagePack::query()
|
|
->where('scope', LanguagePackScope::Core->value)
|
|
->where('status', LanguagePackStatus::Active->value)
|
|
->pluck('locale')
|
|
->unique()
|
|
->values()
|
|
->all();
|
|
}
|
|
|
|
/**
|
|
* 페이지네이션 + 필터링된 언어팩 목록을 조회합니다.
|
|
*
|
|
* @param array<string, mixed> $filters 필터 (scope, target_identifier, locale, status, vendor)
|
|
* @param int $perPage 페이지당 건수
|
|
* @return LengthAwarePaginator 페이지네이션 결과
|
|
*/
|
|
public function paginate(array $filters = [], int $perPage = 20): LengthAwarePaginator
|
|
{
|
|
// audit:allow repository-paginate-column-pruning reason: 언어팩 정의 테이블 — 설치된 팩 수만큼만 존재하고 넓은 컬럼이 없다
|
|
return $this->buildFilteredQuery($filters)->paginate($perPage);
|
|
}
|
|
|
|
/**
|
|
* 필터링된 언어팩 컬렉션을 페이지네이션 없이 조회합니다.
|
|
*
|
|
* @param array<string, mixed> $filters 필터 (scope, target_identifier, locale, status, vendor, search)
|
|
* @return Collection<int, LanguagePack> 필터링된 언어팩 컬렉션
|
|
*/
|
|
public function getFilteredCollection(array $filters = []): Collection
|
|
{
|
|
return $this->buildFilteredQuery($filters)->get();
|
|
}
|
|
|
|
/**
|
|
* 공통 필터 쿼리 빌더 — `paginate()` 와 `getFilteredCollection()` 가 동일 로직을 공유합니다.
|
|
*
|
|
* `status=uninstalled` 필터는 가상 상태이므로 DB 쿼리에서 결과를 0건으로 강제합니다
|
|
* (실제 미설치 번들은 Service 계층에서 합쳐집니다).
|
|
*
|
|
* @param array<string, mixed> $filters 필터 조건
|
|
* @return Builder<LanguagePack> 정렬까지 적용된 쿼리 빌더
|
|
*/
|
|
private function buildFilteredQuery(array $filters): Builder
|
|
{
|
|
$query = LanguagePack::query();
|
|
|
|
if (! empty($filters['scope'])) {
|
|
$query->where('scope', $filters['scope']);
|
|
}
|
|
if (array_key_exists('target_identifier', $filters)) {
|
|
$query->where('target_identifier', $filters['target_identifier']);
|
|
}
|
|
if (! empty($filters['locale'])) {
|
|
$query->where('locale', $filters['locale']);
|
|
}
|
|
if (! empty($filters['status'])) {
|
|
if ($filters['status'] === LanguagePackStatus::Uninstalled->value) {
|
|
// 결과 없음 — 빈 whereIn 은 `0 = 1` 로 컴파일된다(raw 불필요)
|
|
$query->whereIn($query->getModel()->getKeyName(), []);
|
|
} else {
|
|
$query->where('status', $filters['status']);
|
|
}
|
|
}
|
|
if (! empty($filters['vendor'])) {
|
|
$query->where('vendor', $filters['vendor']);
|
|
}
|
|
if (! empty($filters['search'])) {
|
|
$this->applyOrSearchAcrossFields(
|
|
$query,
|
|
(string) $filters['search'],
|
|
['identifier', 'vendor', 'locale_native_name', 'locale_name']
|
|
);
|
|
}
|
|
if (! empty($filters['exclude_protected'])) {
|
|
$query->where('is_protected', false);
|
|
}
|
|
|
|
// 정렬은 안정 키만 사용 (scope/target_identifier/locale).
|
|
// status 우선 정렬은 설치/활성화 직후 항목이 페이지 위치를 이탈해
|
|
// 사용자가 다시 찾아야 하는 회귀를 만들어 제거함 (#263 의 active-first UX 폐기).
|
|
return $query
|
|
->orderBy('scope')
|
|
->orderBy('target_identifier')
|
|
->orderBy('locale')
|
|
// 전순서 보장 — 위 세 컬럼 조합이 유니크하더라도 정렬 계약을 키로 닫아 둔다
|
|
->orderBy('id');
|
|
}
|
|
|
|
/**
|
|
* 언어팩을 생성합니다.
|
|
*
|
|
* @param array<string, mixed> $data 생성 데이터
|
|
* @return LanguagePack 생성된 언어팩
|
|
*/
|
|
public function create(array $data): LanguagePack
|
|
{
|
|
return LanguagePack::query()->create($data);
|
|
}
|
|
|
|
/**
|
|
* 언어팩을 갱신합니다.
|
|
*
|
|
* @param LanguagePack $pack 대상 언어팩
|
|
* @param array<string, mixed> $data 갱신 데이터
|
|
* @return LanguagePack 갱신된 언어팩
|
|
*/
|
|
public function update(LanguagePack $pack, array $data): LanguagePack
|
|
{
|
|
$pack->fill($data);
|
|
$pack->save();
|
|
|
|
return $pack->fresh() ?? $pack;
|
|
}
|
|
|
|
/**
|
|
* 언어팩을 삭제합니다.
|
|
*
|
|
* @param LanguagePack $pack 대상 언어팩
|
|
* @return bool 삭제 성공 여부
|
|
*/
|
|
public function delete(LanguagePack $pack): bool
|
|
{
|
|
return (bool) $pack->delete();
|
|
}
|
|
|
|
/**
|
|
* 특정 확장(scope, target_identifier)에 연결된 언어팩 전체를 조회합니다.
|
|
*
|
|
* @param string $scope 스코프
|
|
* @param string $targetIdentifier 대상 확장 식별자
|
|
* @return Collection<int, LanguagePack> 언어팩 컬렉션
|
|
*/
|
|
public function getPacksForTarget(string $scope, string $targetIdentifier): Collection
|
|
{
|
|
// audit:allow query-unbounded-get reason: 언어팩은 설치된 팩 × 로케일 수만큼만 존재한다 (사용량과 무관)
|
|
return LanguagePack::query()
|
|
->where('scope', $scope)
|
|
->where('target_identifier', $targetIdentifier)
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* 특정 로케일에 속하는 모든 언어팩을 조회합니다.
|
|
*
|
|
* @param string $locale 로케일
|
|
* @return Collection<int, LanguagePack> 언어팩 컬렉션
|
|
*/
|
|
public function getPacksForLocale(string $locale): Collection
|
|
{
|
|
// audit:allow query-unbounded-get reason: 언어팩은 설치된 팩 × 로케일 수만큼만 존재한다 (사용량과 무관)
|
|
return LanguagePack::query()->where('locale', $locale)->get();
|
|
}
|
|
|
|
/**
|
|
* 번들 manifest 로부터 가상 LanguagePack 인스턴스를 합성합니다 (DB 미저장).
|
|
*
|
|
* Model 인스턴스 생성 책임을 Repository 가 보유 — Service 는 본 메서드를 호출만 합니다.
|
|
* exists=false 로 표시되어 영속성 동작에서 제외되며, `bundled_identifier` 가상 속성을
|
|
* 함께 채워 Resource 가 행 액션에 노출할 수 있게 합니다.
|
|
*
|
|
* @param array<string, mixed> $manifest 번들 manifest 데이터
|
|
* @param string $bundledIdentifier `lang-packs/_bundled/{이 값}` 디렉토리명
|
|
* @return LanguagePack 가상 LanguagePack 인스턴스 (DB 미저장)
|
|
*/
|
|
public function buildVirtualFromManifest(array $manifest, string $bundledIdentifier): LanguagePack
|
|
{
|
|
$pack = new LanguagePack;
|
|
$pack->id = null;
|
|
$pack->identifier = (string) $manifest['identifier'];
|
|
$pack->vendor = (string) ($manifest['vendor'] ?? '');
|
|
$pack->scope = (string) ($manifest['scope'] ?? 'core');
|
|
$pack->target_identifier = $manifest['target_identifier'] ?? null;
|
|
$pack->locale = (string) ($manifest['locale'] ?? '');
|
|
$pack->locale_name = (string) ($manifest['locale_name'] ?? ($manifest['locale'] ?? ''));
|
|
$pack->locale_native_name = (string) ($manifest['locale_native_name'] ?? ($manifest['locale'] ?? ''));
|
|
$pack->text_direction = (string) ($manifest['text_direction'] ?? 'ltr');
|
|
$pack->version = (string) ($manifest['version'] ?? '0.0.0');
|
|
$pack->license = $manifest['license'] ?? null;
|
|
$pack->description = is_array($manifest['description'] ?? null) ? $manifest['description'] : null;
|
|
$pack->status = LanguagePackStatus::Uninstalled->value;
|
|
$pack->is_protected = false; // lang-packs/_bundled/ 패키지는 사용자가 install/uninstall 자유 (요구사항 #3)
|
|
$pack->manifest = $manifest;
|
|
$pack->source_type = LanguagePackSourceType::Bundled->value;
|
|
$pack->source_url = $bundledIdentifier;
|
|
|
|
$pack->setAttribute('bundled_identifier', $bundledIdentifier);
|
|
$pack->exists = false;
|
|
|
|
return $pack;
|
|
}
|
|
|
|
/**
|
|
* 코어/번들 확장의 lang/{ko,en}/ 디렉토리로부터 가상 보호 LanguagePack 인스턴스를 합성합니다.
|
|
*
|
|
* `built_in` 가상 행은 DB 행이 없는 상태로 항상 active+protected 표시되며, 사용자가
|
|
* install/uninstall/activate/deactivate 할 수 없습니다 (요구사항 #1, #2).
|
|
*
|
|
* @param string $scope 스코프 (core/module/plugin/template)
|
|
* @param string|null $targetIdentifier 대상 확장 식별자 (core 일 때 null)
|
|
* @param string $locale 로케일 (예: 'ko', 'en')
|
|
* @param string $vendor 벤더 (확장 manifest.vendor 또는 'g7')
|
|
* @param string $version 버전
|
|
* @param string $langPathRelative lang 디렉토리 상대 경로
|
|
* @return LanguagePack 가상 LanguagePack 인스턴스
|
|
*/
|
|
public function buildVirtualBuiltInPack(
|
|
string $scope,
|
|
?string $targetIdentifier,
|
|
string $locale,
|
|
string $vendor,
|
|
string $version,
|
|
string $langPathRelative,
|
|
): LanguagePack {
|
|
$identifier = $targetIdentifier !== null
|
|
? sprintf('%s-%s-%s-%s', $vendor, $scope, $targetIdentifier, $locale)
|
|
: sprintf('%s-%s-%s', $vendor, $scope, $locale);
|
|
|
|
$nativeName = match ($locale) {
|
|
'ko' => '한국어',
|
|
'en' => 'English',
|
|
default => strtoupper($locale),
|
|
};
|
|
|
|
$pack = new LanguagePack;
|
|
$pack->id = null;
|
|
$pack->identifier = $identifier;
|
|
$pack->vendor = $vendor;
|
|
$pack->scope = $scope;
|
|
$pack->target_identifier = $targetIdentifier;
|
|
$pack->locale = $locale;
|
|
$pack->locale_name = strtoupper($locale);
|
|
$pack->locale_native_name = $nativeName;
|
|
$pack->text_direction = TextDirection::Ltr->value;
|
|
$pack->version = $version;
|
|
$pack->status = LanguagePackStatus::Active->value;
|
|
$pack->is_protected = true;
|
|
$pack->source_type = LanguagePackSourceType::BuiltIn->value;
|
|
$pack->source_url = $langPathRelative;
|
|
$pack->manifest = [
|
|
'identifier' => $identifier,
|
|
'vendor' => $vendor,
|
|
'scope' => $scope,
|
|
'target_identifier' => $targetIdentifier,
|
|
'locale' => $locale,
|
|
'version' => $version,
|
|
'built_in' => true,
|
|
];
|
|
|
|
$pack->exists = false;
|
|
|
|
return $pack;
|
|
}
|
|
|
|
/**
|
|
* 호스트 확장(modules/plugins/templates)의 status + version 행을 조회합니다.
|
|
*
|
|
* @param string $scope 스코프 (module/plugin/template). 그 외는 null 반환.
|
|
* @param string $identifier 호스트 확장 식별자
|
|
* @return object|null `{status, version}` 객체 또는 null
|
|
*/
|
|
public function findHostExtensionRow(string $scope, string $identifier): ?object
|
|
{
|
|
$tableMap = [
|
|
LanguagePackScope::Module->value => 'modules',
|
|
LanguagePackScope::Plugin->value => 'plugins',
|
|
LanguagePackScope::Template->value => 'templates',
|
|
];
|
|
$table = $tableMap[$scope] ?? null;
|
|
if (! $table) {
|
|
return null;
|
|
}
|
|
|
|
return DB::table($table)
|
|
->where('identifier', $identifier)
|
|
->first(['status', 'version']);
|
|
}
|
|
}
|