v7.0.0 release

app/Repositories/TemplateCustomTranslationRepository.php

@@ -0,0 +1,179 @@
+<?php
+
+namespace App\Repositories;
+
+use App\Contracts\Repositories\TemplateCustomTranslationRepositoryInterface;
+use App\Models\TemplateCustomTranslation;
+use Illuminate\Database\Eloquent\Collection;
+
+class TemplateCustomTranslationRepository implements TemplateCustomTranslationRepositoryInterface
+{
+    /**
+     * 특정 템플릿의 커스텀 다국어 키 목록 조회
+     *
+     * @param  int  $templateId  템플릿 ID
+     * @param  string|null  $layoutName  레이아웃 이름 필터 (null 이면 전체)
+     * @param  string|null  $status  상태 필터 (null 이면 전체)
+     * @return Collection<int, TemplateCustomTranslation> 커스텀 키 컬렉션
+     */
+    public function getByTemplateId(int $templateId, ?string $layoutName = null, ?string $status = null): Collection
+    {
+        return TemplateCustomTranslation::query()
+            ->where('template_id', $templateId)
+            ->when($layoutName !== null, fn ($query) => $query->where('layout_name', $layoutName))
+            ->when($status !== null, fn ($query) => $query->where('status', $status))
+            ->orderBy('translation_key')
+            ->get();
+    }
+
+    /**
+     * 특정 템플릿의 활성 커스텀 다국어 키 조회 (런타임 병합용)
+     *
+     * @param  int  $templateId  템플릿 ID
+     * @return Collection<int, TemplateCustomTranslation> 활성 커스텀 키 컬렉션
+     */
+    public function getActiveByTemplateId(int $templateId): Collection
+    {
+        return TemplateCustomTranslation::query()
+            ->where('template_id', $templateId)
+            ->active()
+            ->get();
+    }
+
+    /**
+     * 특정 템플릿 + 레이아웃의 커스텀 키 조회 (좀비 감지용)
+     *
+     * @param  int  $templateId  템플릿 ID
+     * @param  string  $layoutName  레이아웃 이름 (원본)
+     * @param  string|null  $status  상태 필터 (null 이면 전체)
+     * @return Collection<int, TemplateCustomTranslation> 커스텀 키 컬렉션
+     */
+    public function getByTemplateIdAndLayout(int $templateId, string $layoutName, ?string $status = null): Collection
+    {
+        return TemplateCustomTranslation::query()
+            ->where('template_id', $templateId)
+            ->where('layout_name', $layoutName)
+            ->when($status !== null, fn ($query) => $query->where('status', $status))
+            ->get();
+    }
+
+    /**
+     * 주어진 ID 목록의 상태를 일괄 변경합니다 (active ↔ orphaned 전이)
+     *
+     * @param  array<int, int>  $ids  대상 커스텀 키 ID 목록
+     * @param  string  $status  새 상태 (active|orphaned)
+     * @return int 변경된 행 수
+     */
+    public function updateStatus(array $ids, string $status): int
+    {
+        if ($ids === []) {
+            return 0;
+        }
+
+        return TemplateCustomTranslation::query()
+            ->whereIn('id', $ids)
+            ->update(['status' => $status]);
+    }
+
+    /**
+     * ID로 커스텀 다국어 키 조회
+     *
+     * @param  int  $id  커스텀 키 ID
+     * @return TemplateCustomTranslation|null 찾은 모델 또는 null
+     */
+    public function findById(int $id): ?TemplateCustomTranslation
+    {
+        return TemplateCustomTranslation::find($id);
+    }
+
+    /**
+     * 템플릿 + 키로 조회
+     *
+     * @param  int  $templateId  템플릿 ID
+     * @param  string  $translationKey  다국어 키
+     * @return TemplateCustomTranslation|null 찾은 모델 또는 null
+     */
+    public function findByKey(int $templateId, string $translationKey): ?TemplateCustomTranslation
+    {
+        return TemplateCustomTranslation::query()
+            ->where('template_id', $templateId)
+            ->where('translation_key', $translationKey)
+            ->first();
+    }
+
+    /**
+     * 특정 템플릿 + 레이아웃의 최대 seq 조회
+     *
+     * `custom.{layoutKey}.{seq}` 형식 키에서 seq 의 현재 최대값을 반환합니다.
+     *
+     * @param  int  $templateId  템플릿 ID
+     * @param  string  $layoutKey  키 네임스페이스 (레이아웃명 정규화)
+     * @return int 현재 최대 seq (없으면 0)
+     */
+    public function getMaxSeq(int $templateId, string $layoutKey): int
+    {
+        $prefix = "custom.{$layoutKey}.";
+
+        $keys = TemplateCustomTranslation::query()
+            ->where('template_id', $templateId)
+            ->where('translation_key', 'like', $prefix.'%')
+            ->pluck('translation_key');
+
+        $maxSeq = 0;
+        foreach ($keys as $key) {
+            $suffix = substr($key, strlen($prefix));
+            if (ctype_digit($suffix)) {
+                $maxSeq = max($maxSeq, (int) $suffix);
+            }
+        }
+
+        return $maxSeq;
+    }
+
+    /**
+     * 커스텀 다국어 키 생성
+     *
+     * @param  array<string, mixed>  $data  생성 데이터
+     * @return TemplateCustomTranslation 생성된 모델
+     */
+    public function create(array $data): TemplateCustomTranslation
+    {
+        return TemplateCustomTranslation::create($data);
+    }
+
+    /**
+     * 커스텀 다국어 키 값 수정 (lock_version 갱신 포함)
+     *
+     * @param  int  $id  커스텀 키 ID
+     * @param  array<string, mixed>  $data  수정 데이터
+     * @param  int  $newLockVersion  새 잠금 버전
+     * @return TemplateCustomTranslation 수정된 모델
+     */
+    public function update(int $id, array $data, int $newLockVersion): TemplateCustomTranslation
+    {
+        $model = TemplateCustomTranslation::findOrFail($id);
+
+        $model->fill($data);
+        $model->lock_version = $newLockVersion;
+        $model->save();
+
+        return $model->fresh();
+    }
+
+    /**
+     * 커스텀 다국어 키 삭제
+     *
+     * @param  int  $id  커스텀 키 ID
+     * @return bool 삭제 성공 여부
+     */
+    public function delete(int $id): bool
+    {
+        $model = TemplateCustomTranslation::find($id);
+
+        if ($model === null) {
+            return false;
+        }
+
+        return (bool) $model->delete();
+    }
+}