HeuJung
0b6f329249
- 버전 이력 변경량(+N/-N 줄) 계산이 변경 영역 (줄 수)² 크기의 LCS 표를 만들어 큰 공통 레이아웃의 첫 편집기 저장이 PHP 기본 메모리 한도(128M) 서버에서 500 으로 끝났다. 두 행 DP 로 길이만 구하도록 바꿔 메모리가 줄 수에 비례하고 표시 숫자는 종전과 같다(참조 구현 동치·메모리 상한 회귀 테스트) - 확장 편집 모드 저장이 overlay 확장의 injections 를 비우던 결함: 서버가 주입 노드 출처 메타에 injection 순번을 싣고, 편집기는 그 순번(없으면 원본 노드 id) 으로 되돌리며, 되돌릴 수 없는 노드가 있으면 저장하지 않고 안내한다 - 서빙 캐시 키를 서버 현재 확장 캐시 버전으로만 조립해 저장·복원 두 번째부터 재로드·「최신 불러오기」가 옛 내용을 받던 결함 수정(요청 v 는 HTTP 캐시 우회용) - 409 충돌 안내가 errors 아래의 버전을 읽지 못해 「최신 버전: -1」 로 표시되던 결함을 세 저장 경로 공용 판독으로 수정 - 버전 저장 시 저장자를 기록하고, 복원 시에도 잠금 번호를 올린다 - 회귀 테스트(PHPUnit·Vitest), 트러블슈팅 사례 32~34, 규정·API 문서, ja 언어팩, 편집기 번들 재빌드, 이력 문서 동반
90 lines
3.5 KiB
PHP
90 lines
3.5 KiB
PHP
<?php
|
|
|
|
namespace App\Contracts\Repositories;
|
|
|
|
use App\Models\TemplateLayoutExtensionVersion;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Database\Eloquent\ModelNotFoundException;
|
|
|
|
interface LayoutExtensionVersionRepositoryInterface
|
|
{
|
|
/**
|
|
* 버전 저장 (자동 증가)
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param array $oldContent 이전 콘텐츠
|
|
* @param array|null $newContent 새 콘텐츠 (null이면 현재 확장 content 사용)
|
|
* @param int|null $createdBy 저장자 ID (null 이면 현재 인증 사용자)
|
|
* @return TemplateLayoutExtensionVersion 생성된 버전 모델
|
|
*/
|
|
public function saveVersion(int $extensionId, array $oldContent, ?array $newContent = null, ?int $createdBy = null): TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 특정 확장의 모든 버전 조회 (최신순)
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @return Collection 버전 컬렉션
|
|
*/
|
|
public function getVersions(int $extensionId, int $limit = 100): Collection;
|
|
|
|
/**
|
|
* 확장의 특정 버전 번호 조회 (본문 포함)
|
|
*
|
|
* 목록(getVersions)은 경량 조회라 `content` 를 담지 않고 건수 상한이 있다. 단건은 그
|
|
* 대체 경로이므로 반드시 전용 조회를 쓴다 — 목록 조회를 재사용하면 본문이 사라지고
|
|
* 상한 밖의 오래된 버전을 찾지 못한다.
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param int $version 버전 번호
|
|
* @return TemplateLayoutExtensionVersion|null 찾은 버전 모델 또는 null
|
|
*/
|
|
public function findVersionByNumber(int $extensionId, int $version): ?TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 확장 ID 목록의 현재(최신) 버전 번호 맵 조회
|
|
*
|
|
* 레이아웃 편집기 라우트 트리의 확장 노드 버전 배지 데이터
|
|
* 소스로, 버전 이력이 1건 이상인 확장만 포함된다(미저장 확장 = 원본 → 맵 제외).
|
|
*
|
|
* @param array<int> $extensionIds 확장 ID 목록
|
|
* @return array<int, int> 확장 ID → 최신 버전 번호
|
|
*/
|
|
public function getCurrentVersionsByExtensionIds(array $extensionIds): array;
|
|
|
|
/**
|
|
* 특정 버전 조회
|
|
*
|
|
* @param int $versionId 버전 ID
|
|
* @return TemplateLayoutExtensionVersion|null 찾은 버전 모델 또는 null
|
|
*/
|
|
public function getVersion(int $versionId): ?TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 다음 버전 번호 계산
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @return int 다음 버전 번호
|
|
*/
|
|
public function getNextVersion(int $extensionId): int;
|
|
|
|
/**
|
|
* JSON content 변경사항 카운트 계산 (라인 단위)
|
|
*
|
|
* @param array $oldContent 이전 콘텐츠
|
|
* @param array $newContent 새 콘텐츠
|
|
* @return array{added: int, removed: int, char_diff: int} 추가/삭제 라인 수 + 문자 수 변화
|
|
*/
|
|
public function calculateChanges(array $oldContent, array $newContent): array;
|
|
|
|
/**
|
|
* 버전 복원
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param int $versionId 복원할 버전 ID
|
|
* @return TemplateLayoutExtensionVersion 복원 후 생성된 새 버전 모델
|
|
*
|
|
* @throws ModelNotFoundException 버전을 찾을 수 없는 경우
|
|
*/
|
|
public function restoreVersion(int $extensionId, int $versionId): TemplateLayoutExtensionVersion;
|
|
}
|