118 lines
4.6 KiB
PHP
118 lines
4.6 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Resources;
|
|
|
|
use Illuminate\Http\Request;
|
|
|
|
class LayoutVersionResource extends BaseApiResource
|
|
{
|
|
/**
|
|
* content 원본 전체를 포함할지 여부 (단건 조회 전용).
|
|
*
|
|
* 목록(versions.index)은 버전이 많아(수백 건) content 전체를 다 실으면 페이로드가
|
|
* 비대해지므로 분해된 일부 키만 노출한다. 단건 조회(showVersion)는 버전 비교 diff 가
|
|
* content 전체(slots/extends 등 분해되지 않는 키 포함)를 필요로 하므로 full_content 를
|
|
* 추가 노출한다. withFullContent() 로 opt-in.
|
|
*/
|
|
private bool $includeFullContent = false;
|
|
|
|
/**
|
|
* content 원본 전체(full_content)를 응답에 포함하도록 표시합니다 (단건 조회용).
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function withFullContent(): static
|
|
{
|
|
$this->includeFullContent = true;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* 리소스를 배열로 변환
|
|
*
|
|
* @param Request $request 현재 요청
|
|
* @return array 버전 표시 필드 배열 (full_content 는 단건 조회 시에만 포함)
|
|
*/
|
|
public function toArray(Request $request): array
|
|
{
|
|
$content = $this->getValue('content', []);
|
|
|
|
$payload = [
|
|
'id' => $this->getValue('id'),
|
|
'layout_id' => $this->getValue('layout_id'),
|
|
'version' => $this->getValue('version'),
|
|
'endpoint' => $content['endpoint'] ?? null,
|
|
'components' => $content['components'] ?? [],
|
|
'data_sources' => $content['data_sources'] ?? [],
|
|
'metadata' => $content['metadata'] ?? [],
|
|
'changes_summary' => $this->formatChangesSummary($this->getValue('changes_summary', [])),
|
|
// 저장자 이름만 노출 (버전 히스토리 표시용) — created_by ID 는 보안상 제외 유지.
|
|
// creator 관계 미로딩(eager load 누락)/탈퇴 사용자 시 null.
|
|
'created_by_name' => $this->resolveCreatorName(),
|
|
|
|
...$this->formatTimestamps(),
|
|
...$this->resourceMeta($request),
|
|
];
|
|
|
|
// 단건 조회 시에만 content 원본 전체를 노출 — 버전 비교 diff 가 slots/extends 등
|
|
// 분해되지 않는 키까지 비교하려면 원본 전체가 필요하다. 목록에는 제외(비대화 회피).
|
|
if ($this->includeFullContent) {
|
|
$payload['full_content'] = is_array($content) ? $content : [];
|
|
}
|
|
|
|
return $payload;
|
|
}
|
|
|
|
/**
|
|
* 저장자 이름을 해석합니다.
|
|
*
|
|
* creator 관계(eager load)에서 이름만 추출합니다. 관계 미로딩 또는 탈퇴 사용자
|
|
* (created_by null)인 경우 null 을 반환합니다. created_by ID 자체는 노출하지 않습니다.
|
|
*
|
|
* @return string|null 저장자 이름 또는 null
|
|
*/
|
|
private function resolveCreatorName(): ?string
|
|
{
|
|
$creator = $this->whenLoaded('creator');
|
|
|
|
// whenLoaded 미로딩 시 MissingValue 반환 → 삼항으로 null 처리 (MissingValue 누출 방지).
|
|
return $creator instanceof \App\Models\User ? $creator->name : null;
|
|
}
|
|
|
|
/**
|
|
* changes_summary를 버전 목록 표시용 카운트로 노출합니다.
|
|
*
|
|
* changes_summary 는 추가/삭제 라인 수(added/removed 정수)와 문자 수 변화만 저장한다
|
|
* (라인 원문 미저장 — 적재 비대화 제거). 프론트는 added_count/removed_count
|
|
* 로 받으므로 키를 매핑한다. 구버전(라인 원문 배열을 담던 시절) 레코드는 정수가 아니라
|
|
* 배열일 수 있어 is_array 시 count() 로 보정한다. modified 는 라인 diff 에 대응 개념이
|
|
* 없어 노출하지 않는다.
|
|
*
|
|
* @param array $changesSummary 원본 changes_summary
|
|
* @return array{added_count: int, removed_count: int, char_diff: int}
|
|
*/
|
|
private function formatChangesSummary(array $changesSummary): array
|
|
{
|
|
return [
|
|
'added_count' => $this->countValue($changesSummary['added'] ?? 0),
|
|
'removed_count' => $this->countValue($changesSummary['removed'] ?? 0),
|
|
'char_diff' => $changesSummary['char_diff'] ?? 0,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* changes_summary 값을 정수 카운트로 정규화합니다.
|
|
*
|
|
* 신규 구조는 정수(라인 수), 구버전 레코드는 배열(라인/경로 원문)일 수 있어 양쪽을
|
|
* 카운트로 환산한다.
|
|
*
|
|
* @param mixed $value added/removed 원본 값 (정수 또는 배열)
|
|
* @return int 라인 수
|
|
*/
|
|
private function countValue(mixed $value): int
|
|
{
|
|
return is_array($value) ? count($value) : (int) $value;
|
|
}
|
|
}
|