HeuJung
057e002ad1
StorageInterface::url 의 public 하드코딩을 완화하고 core.storage.filter_url 훅을 신설해, 완전 공개 자산(상품·카테고리·리뷰·에디터 이미지)의 직접 URL 서빙을 옵트인으로 열었다. 미설정 시 기존 스트리밍 100% 보존. 디스크 결정은 확장 개별 설정 > 코어 전역 > 미설정 순이며, 서빙·삭제·이동은 행에 기록된 disk 를 따라 전환 전후 자산이 혼재해도 각자 실제 저장 위치를 향한다. 고아 disk(공급 플러그인 비활성화)는 스트리밍으로 폴백해 500 이 되지 않는다. 공개 이슈 (@lyg-kaban 건의) 대응.
826 lines
32 KiB
PHP
826 lines
32 KiB
PHP
<?php
|
|
|
|
namespace Modules\Sirsoft\Board\Http\Resources;
|
|
|
|
use App\Enums\PermissionType;
|
|
use App\Enums\UserStatus;
|
|
use App\Http\Resources\BaseApiResource;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Support\Facades\Auth;
|
|
use Modules\Sirsoft\Board\Enums\PostStatus;
|
|
use Modules\Sirsoft\Board\Enums\ReportReasonType;
|
|
use Modules\Sirsoft\Board\Enums\TriggerType;
|
|
use Modules\Sirsoft\Board\Repositories\Contracts\ReportRepositoryInterface;
|
|
use Modules\Sirsoft\Board\Support\BoardPermissionCacheKeys;
|
|
use Modules\Sirsoft\Board\Traits\ChecksBoardPermission;
|
|
use Modules\Sirsoft\Board\Traits\FormatsBoardDate;
|
|
|
|
/**
|
|
* 게시글 API 리소스
|
|
*
|
|
* 게시글 정보를 API 응답 형식으로 변환합니다.
|
|
*/
|
|
class PostResource extends BaseApiResource
|
|
{
|
|
use ChecksBoardPermission;
|
|
use FormatsBoardDate;
|
|
|
|
/**
|
|
* 리소스를 배열로 변환합니다. (상세 페이지용)
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return array<string, mixed> 변환된 배열 데이터
|
|
*/
|
|
public function toArray(Request $request): array
|
|
{
|
|
$slug = $this->getSlug($request);
|
|
|
|
return [
|
|
...$this->getCommonFields($request, $slug),
|
|
|
|
// 상세 전용: 필터링된 제목/내용 (삭제글·비밀글 권한 체크)
|
|
'title' => $this->getFilteredTitle($request, $slug),
|
|
'content' => $this->getFilteredContent($request, $slug),
|
|
|
|
// 상세 전용: 작성자 UUID
|
|
'user_id' => $this->user?->uuid,
|
|
|
|
// 상세 전용: 트리거 타입
|
|
'trigger_type' => $this->trigger_type,
|
|
|
|
// 상세 전용: 타임스탬프
|
|
'updated_at' => $this->formatDateTimeStringForUser($this->updated_at),
|
|
'deleted_at' => $this->deleted_at ? $this->formatDateTimeStringForUser($this->deleted_at) : null,
|
|
|
|
// 상세 전용: IP 주소 (admin.manage 권한 보유자만)
|
|
'ip_address' => $this->getIpAddressForResponse($slug),
|
|
|
|
// 상세 전용: 블라인드/복원 등 처리 이력 (admin.manage 권한 보유자만, 민감 필드 제외)
|
|
'action_logs' => $this->getActionLogsForResponse($slug),
|
|
|
|
// 상세 전용: 관계 데이터 (조건부 로딩)
|
|
'board' => $this->relationLoaded('board') ? $this->getBoardInfo() : null,
|
|
'navigation' => $this->navigation ?? null,
|
|
'parent' => $this->relationLoaded('parent') ? $this->getParentInfo() : null,
|
|
'comments' => $this->relationLoaded('comments') ? CommentResource::collection($this->comments) : null,
|
|
|
|
// 댓글이 상한에서 끊겼는지. 끊기지 않았으면 false 이고 총 건수는 실린 목록 길이와 같다.
|
|
// 조용히 잘라내면 사용자에게는 "댓글이 그만큼뿐" 으로 보이므로 사실을 함께 내보낸다.
|
|
'comments_truncated' => (bool) ($this->comments_truncated ?? false),
|
|
'comments_total' => $this->comments_total ?? ($this->relationLoaded('comments') ? $this->comments->count() : null),
|
|
'comments_total_is_exact' => (bool) ($this->comments_total_is_exact ?? true),
|
|
// 댓글 페이지네이션을 요청한 경우에만 실린다 (미요청 시 null — 기존 응답 형태 유지)
|
|
'comments_pagination' => $this->comments_pagination ?? null,
|
|
'attachments' => $this->getAttachmentsForResponse($request, $slug),
|
|
'replies' => $this->relationLoaded('replies') ? static::collection($this->replies) : null,
|
|
|
|
// 상세 전용: 신고 여부 (로그인 사용자 + board 관계 로드 시에만)
|
|
'is_already_reported' => $this->getIsAlreadyReported($request),
|
|
|
|
// 권한 정보 (is_owner + abilities) — 상세 페이지에서만 포함
|
|
...$this->resourceMeta($request),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 목록용 간략 정보를 배열로 변환합니다.
|
|
*
|
|
* 목록에서는 권한 정보(resourceMeta)를 포함하지 않습니다.
|
|
* 게시판 권한은 PostCollection의 컬렉션 레벨 abilities로 제공됩니다.
|
|
*
|
|
* 주의: 이 메서드는 toArray() 외부에서 수동 호출되므로
|
|
* $this->when() 대신 삼항 연산자를 사용해야 합니다.
|
|
*
|
|
* @param Request|null $request HTTP 요청
|
|
* @return array<string, mixed> 변환된 배열 데이터
|
|
*/
|
|
public function toListArray(?Request $request = null): array
|
|
{
|
|
$request = $request ?? request();
|
|
$slug = $this->getSlug($request);
|
|
|
|
return [
|
|
...$this->getCommonFields($request, $slug),
|
|
|
|
// 목록 전용: 게시판 슬러그
|
|
'slug' => $this->board_slug ?? null,
|
|
|
|
// 목록 전용: 필터링 없는 제목 (목록은 권한 체크 불필요)
|
|
'title' => $this->title,
|
|
|
|
// 목록 전용: 타임스탬프
|
|
'deleted_at' => $this->deleted_at ? $this->formatDateTimeStringForUser($this->deleted_at) : null,
|
|
|
|
// 목록 전용: 본문 요약 (DB SUBSTRING 우선, 없으면 content에서 추출)
|
|
// 블라인드·비밀글은 목록/검색 미리보기에 원문이 새지 않도록
|
|
// 권한과 무관하게 빈 문자열 반환 (본문 자체는 상세에서 권한자에게만 노출)
|
|
'content_preview' => $this->getMaskedContentPreviewForList(150),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 폼(글쓰기/글수정)용 경량 배열을 반환합니다.
|
|
*
|
|
* toArray()와 달리 권한 체크(resolveAbilities, IP, 신고 여부)를 생략하여
|
|
* 불필요한 DB 쿼리를 방지합니다. 폼에서 필요한 필드만 포함합니다.
|
|
*
|
|
* @param Request|null $request HTTP 요청
|
|
* @return array<string, mixed> 변환된 배열 데이터
|
|
*/
|
|
public function toFormArray(?Request $request = null): array
|
|
{
|
|
$request = $request ?? request();
|
|
$slug = $this->getSlug($request);
|
|
|
|
return [
|
|
'id' => $this->id,
|
|
'title' => $this->title,
|
|
'content' => $this->content,
|
|
'content_mode' => $this->content_mode ?? 'text',
|
|
'category' => $this->category,
|
|
'is_notice' => (bool) $this->is_notice,
|
|
'is_secret' => (bool) $this->is_secret,
|
|
'parent_id' => $this->parent_id,
|
|
|
|
// 작성자 정보
|
|
'author' => $this->getAuthorInfo(includeIsGuest: true),
|
|
|
|
// 타임스탬프
|
|
'created_at' => $this->formatCreatedAt($this->created_at),
|
|
'created_at_formatted' => $this->formatCreatedAtFormat(
|
|
$this->created_at,
|
|
g7_module_settings('sirsoft-board', 'display.date_display_format', 'standard')
|
|
),
|
|
|
|
// 첨부파일 (권한 체크 없이 직접 반환 — 폼 진입 시 이미 본인/관리자 검증 완료)
|
|
'attachments' => $this->relationLoaded('attachments')
|
|
? AttachmentResource::collection($this->attachments)
|
|
: null,
|
|
|
|
// 원글 정보 (답변글 수정 시)
|
|
'parent' => $this->relationLoaded('parent') ? $this->getParentInfoForForm() : null,
|
|
];
|
|
}
|
|
|
|
// =========================================================================
|
|
// 공통 필드 추출
|
|
// =========================================================================
|
|
|
|
/**
|
|
* toArray()와 toListArray()에서 공유하는 공통 필드를 반환합니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return array<string, mixed> 공통 필드 데이터
|
|
*/
|
|
private function getCommonFields(Request $request, ?string $slug): array
|
|
{
|
|
return [
|
|
'id' => $this->id,
|
|
'category' => $this->category,
|
|
|
|
// 작성자 정보
|
|
'author' => $this->getAuthorInfo(includeIsGuest: true),
|
|
|
|
// 게시글 속성
|
|
'is_notice' => (bool) $this->is_notice,
|
|
'is_secret' => (bool) $this->is_secret,
|
|
'content_mode' => $this->content_mode ?? 'text',
|
|
'is_new' => $this->isNew(),
|
|
'status' => $this->status?->value,
|
|
'status_label' => $this->status?->label(),
|
|
|
|
// 통계
|
|
'view_count' => $this->view_count,
|
|
'comment_count' => (int) ($this->comments_count ?? 0),
|
|
'reply_count' => (int) ($this->replies_count ?? 0),
|
|
'attachment_count' => (int) ($this->attachments_count ?? 0),
|
|
'has_attachment' => ((int) ($this->attachments_count ?? 0)) > 0,
|
|
|
|
// 썸네일 이미지 (첫 번째 이미지 첨부파일)
|
|
'thumbnail' => $this->getThumbnailUrlFromRelations(),
|
|
|
|
// 계층 구조
|
|
'parent_id' => $this->parent_id,
|
|
'depth' => $this->depth,
|
|
'is_reply' => $this->parent_id !== null,
|
|
|
|
// 타임스탬프
|
|
'created_at' => $this->formatCreatedAt($this->created_at),
|
|
'created_at_formatted' => $this->formatCreatedAtFormat(
|
|
$this->created_at,
|
|
g7_module_settings('sirsoft-board', 'display.date_display_format', 'standard')
|
|
),
|
|
|
|
// 소유권 정보
|
|
// is_author: 회원 글인 경우만 본인 여부 체크 (비회원 글은 세션 검증 불가하므로 항상 false)
|
|
'is_author' => $this->user_id !== null && $request->user()?->id === $this->user_id,
|
|
'is_guest_post' => $this->user_id === null,
|
|
];
|
|
}
|
|
|
|
// =========================================================================
|
|
// 헬퍼 메서드 - 데이터 추출
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 게시판 슬러그를 반환합니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return string|null 게시판 슬러그
|
|
*/
|
|
private function getSlug(Request $request): ?string
|
|
{
|
|
// route slug 우선 → board relation이 미로딩 시 lazy loading 방지
|
|
return $request->route('slug') ?? ($this->relationLoaded('board') ? $this->board?->slug : null);
|
|
}
|
|
|
|
/**
|
|
* 작성자 정보 배열을 반환합니다.
|
|
*
|
|
* 회원 상태별 정보:
|
|
* - active: 전체 정보 (이름, 이메일, 아바타, 상태)
|
|
* - inactive: 기본 정보 + "휴면" 상태
|
|
* - blocked: 기본 정보 + "차단" 상태
|
|
* - withdrawn: 익명화 ("탈퇴한 사용자")
|
|
*
|
|
* @param bool $includeIsGuest is_guest 필드 포함 여부
|
|
* @return array<string, mixed> 작성자 정보
|
|
*/
|
|
private function getAuthorInfo(bool $includeIsGuest = false): array
|
|
{
|
|
$isGuest = $this->user_id === null;
|
|
|
|
if ($this->user_id && $this->user) {
|
|
$userStatus = UserStatus::tryFrom($this->user->status);
|
|
$isWithdrawn = $userStatus === UserStatus::Withdrawn;
|
|
|
|
$author = [
|
|
'uuid' => $this->user->uuid,
|
|
'name' => $isWithdrawn ? __('user.withdrawn_user') : $this->user->name,
|
|
'email' => $isWithdrawn ? null : $this->user->email,
|
|
'avatar' => $isWithdrawn ? null : $this->user->getAvatarUrl(),
|
|
'status' => $this->user->status,
|
|
'status_label' => $userStatus?->label() ?? $this->user->status,
|
|
];
|
|
} else {
|
|
$author = [
|
|
'uuid' => null,
|
|
'name' => $this->author_name,
|
|
'email' => null,
|
|
'avatar' => null,
|
|
'status' => null,
|
|
'status_label' => null,
|
|
];
|
|
}
|
|
|
|
if ($includeIsGuest) {
|
|
$author['is_guest'] = $isGuest;
|
|
}
|
|
|
|
return $author;
|
|
}
|
|
|
|
/**
|
|
* 썸네일 이미지 URL을 반환합니다.
|
|
*
|
|
* @return string|null 썸네일 URL
|
|
*/
|
|
private function getThumbnailUrl(): ?string
|
|
{
|
|
$attachments = is_array($this->attachments) ? collect($this->attachments) : $this->attachments;
|
|
$firstImage = $attachments
|
|
?->filter(fn ($attachment) => str_starts_with($attachment?->mime_type ?? '', 'image/'))
|
|
?->first();
|
|
|
|
return $firstImage?->preview_url ?? null;
|
|
}
|
|
|
|
/**
|
|
* 썸네일 URL을 관계 로딩 상태에 따라 반환합니다.
|
|
*
|
|
* thumbnailAttachment(경량 hasOne) 우선, attachments(전체) fallback.
|
|
* 둘 다 미로딩 시 null 반환 (lazy loading 방지).
|
|
*
|
|
* @return string|null 썸네일 URL
|
|
*/
|
|
private function getThumbnailUrlFromRelations(): ?string
|
|
{
|
|
// 목록용 경량 관계 우선 — slug를 직접 전달하여 Board::find() N+1 방지
|
|
if ($this->relationLoaded('thumbnailAttachment') && $this->thumbnailAttachment) {
|
|
$attachment = $this->thumbnailAttachment;
|
|
$slug = request()->route('slug') ?? ($this->relationLoaded('board') ? $this->board?->slug : null);
|
|
|
|
if ($slug && $attachment->hash) {
|
|
return $attachment->previewUrlForSlug($slug);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
// 상세 페이지 등에서 attachments가 로딩된 경우 fallback
|
|
if ($this->relationLoaded('attachments')) {
|
|
return $this->getThumbnailUrl();
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* 게시판 정보 배열을 반환합니다.
|
|
*
|
|
* @return array<string, mixed> 게시판 정보
|
|
*/
|
|
private function getBoardInfo(): array
|
|
{
|
|
return [
|
|
'id' => $this->board->id,
|
|
'slug' => $this->board->slug,
|
|
'name' => $this->board->getLocalizedName(),
|
|
'type' => $this->board->type,
|
|
'use_comment' => $this->board->use_comment,
|
|
'use_reply' => $this->board->use_reply,
|
|
'use_report' => $this->board->use_report,
|
|
'show_view_count' => $this->board->show_view_count,
|
|
'max_reply_depth' => $this->board->max_reply_depth ?? g7_module_settings('sirsoft-board', 'basic_defaults.max_reply_depth', 5),
|
|
'max_comment_depth' => $this->board->max_comment_depth ?? g7_module_settings('sirsoft-board', 'basic_defaults.max_comment_depth', 10),
|
|
'report_types' => ReportReasonType::toArray(),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 부모 게시글 정보를 반환합니다.
|
|
*
|
|
* @return array<string, mixed>|null 부모 게시글 정보
|
|
*/
|
|
private function getParentInfo(): ?array
|
|
{
|
|
if (! $this->parent) {
|
|
return null;
|
|
}
|
|
|
|
$parentResource = new static($this->parent);
|
|
$parentData = $parentResource->toArray(request());
|
|
|
|
// parent에 slug 정보 추가 (board 정보가 없을 수 있으므로 현재 게시판의 slug 사용)
|
|
if (! isset($parentData['board'])) {
|
|
$parentData['slug'] = $this->board?->slug ?? null;
|
|
}
|
|
|
|
return $parentData;
|
|
}
|
|
|
|
/**
|
|
* 폼용 원글 정보를 반환합니다.
|
|
*
|
|
* getParentInfo()와 달리 toFormArray()를 사용하여
|
|
* 불필요한 권한 체크(resolveAbilities 등)를 생략합니다.
|
|
*
|
|
* @return array|null 원글 정보 또는 null
|
|
*/
|
|
private function getParentInfoForForm(): ?array
|
|
{
|
|
if (! $this->parent) {
|
|
return null;
|
|
}
|
|
|
|
$parentResource = new static($this->parent);
|
|
|
|
return $parentResource->toFormArray();
|
|
}
|
|
|
|
/**
|
|
* 본문 요약 텍스트를 반환합니다.
|
|
*
|
|
* HTML 모드: strip_tags로 태그 제거 후 평문 앞 N자 추출
|
|
* 텍스트 모드: 그대로 앞 N자 추출
|
|
*
|
|
* @param int $length 최대 길이
|
|
* @return string 본문 요약 텍스트
|
|
*/
|
|
private function getContentPreview(int $length = 150): string
|
|
{
|
|
if (empty($this->content)) {
|
|
return '';
|
|
}
|
|
|
|
$mode = $this->content_mode ?? 'text';
|
|
$plain = $mode === 'html'
|
|
? trim(preg_replace('/\s+/', ' ', html_entity_decode(strip_tags($this->content))))
|
|
: trim(preg_replace('/\s+/', ' ', $this->content));
|
|
|
|
$preview = mb_substr($plain, 0, $length);
|
|
|
|
return $preview.(mb_strlen($plain) > $length ? '...' : '');
|
|
}
|
|
|
|
/**
|
|
* 목록용 본문 요약을 반환합니다.
|
|
*
|
|
* DB SUBSTRING으로 가져온 content_preview_raw가 있으면 우선 사용하고,
|
|
* 없으면 content에서 추출합니다. (상세 페이지 등 content가 로딩된 경우)
|
|
*
|
|
* @param int $length 최대 길이
|
|
* @return string 본문 요약 텍스트
|
|
*/
|
|
private function getContentPreviewForList(int $length = 150): string
|
|
{
|
|
// DB SUBSTRING으로 가져온 raw가 있으면 우선 사용
|
|
$raw = $this->content_preview_raw ?? null;
|
|
if ($raw !== null) {
|
|
$mode = $this->content_mode ?? 'text';
|
|
$plain = $mode === 'html'
|
|
? trim(preg_replace('/\s+/', ' ', html_entity_decode(strip_tags($raw))))
|
|
: trim(preg_replace('/\s+/', ' ', $raw));
|
|
|
|
$preview = mb_substr($plain, 0, $length);
|
|
|
|
return $preview.(mb_strlen($plain) > $length ? '...' : '');
|
|
}
|
|
|
|
// fallback: content 전체가 로딩된 경우 (상세 페이지 등)
|
|
return $this->getContentPreview($length);
|
|
}
|
|
|
|
/**
|
|
* 목록/검색용 본문 요약을 권한 정책에 따라 마스킹하여 반환합니다.
|
|
*
|
|
* 블라인드·비밀글은 목록 미리보기에 원문이 새지 않도록
|
|
* 권한과 무관하게 빈 문자열을 반환합니다. 본문 자체는 상세 조회(getFilteredContent)
|
|
* 에서 권한자(작성자 본인·관리자)에게만 노출됩니다.
|
|
*
|
|
* @param int $length 최대 길이
|
|
* @return string 마스킹 적용된 본문 요약 (차단 시 빈 문자열)
|
|
*/
|
|
private function getMaskedContentPreviewForList(int $length = 150): string
|
|
{
|
|
if ($this->status === PostStatus::Blinded || $this->is_secret) {
|
|
return '';
|
|
}
|
|
|
|
return $this->getContentPreviewForList($length);
|
|
}
|
|
|
|
/**
|
|
* 현재 로그인 사용자가 이 게시글을 이미 신고했는지 반환합니다.
|
|
*
|
|
* 비로그인 또는 board 관계 미로드 시 false 반환.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return bool 이미 신고 여부
|
|
*/
|
|
private function getIsAlreadyReported(Request $request): bool
|
|
{
|
|
$user = $request->user();
|
|
if (! $user || ! $this->relationLoaded('board') || ! $this->board) {
|
|
return false;
|
|
}
|
|
|
|
return app(ReportRepositoryInterface::class)
|
|
->hasUserReported($user->id, $this->board->id, 'post', $this->id);
|
|
}
|
|
|
|
// =========================================================================
|
|
// 상세 페이지 전용: 조건부 필드 메서드
|
|
// =========================================================================
|
|
|
|
/**
|
|
* IP 주소를 권한에 따라 반환합니다. (admin.manage 권한 보유자만)
|
|
*
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return string|null IP 주소
|
|
*/
|
|
private function getIpAddressForResponse(?string $slug): ?string
|
|
{
|
|
if (! $slug || ! $this->checkBoardPermission($slug, 'admin.manage')) {
|
|
return null;
|
|
}
|
|
|
|
return $this->ip_address;
|
|
}
|
|
|
|
/**
|
|
* 처리 이력(action_logs)을 권한에 따라 반환합니다. (admin.manage 권한 보유자만)
|
|
*
|
|
* 블라인드/복원/삭제 사유·처리자명·처리일을 노출하되, 민감 필드(admin_id, ip_address)는
|
|
* 제외합니다. 비권한자에게는 null 을 반환하여 사유가 누출되지 않도록 합니다.
|
|
*
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return array<int, array<string, mixed>>|null 표시용 처리 이력 목록
|
|
*/
|
|
private function getActionLogsForResponse(?string $slug): ?array
|
|
{
|
|
if (! $slug || ! $this->checkBoardPermission($slug, 'admin.manage')) {
|
|
return null;
|
|
}
|
|
|
|
$logs = $this->action_logs ?? [];
|
|
|
|
return array_map(static fn (array $log): array => [
|
|
'action' => $log['action'] ?? null,
|
|
'reason' => $log['reason'] ?? null,
|
|
'admin_name' => $log['admin_name'] ?? null,
|
|
'created_at' => $log['created_at'] ?? null,
|
|
], $logs);
|
|
}
|
|
|
|
/**
|
|
* 첨부파일을 권한에 따라 반환합니다. (비밀글 열람 권한 체크)
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return mixed 첨부파일 리소스 컬렉션 또는 null
|
|
*/
|
|
private function getAttachmentsForResponse(Request $request, ?string $slug): mixed
|
|
{
|
|
if (! $this->relationLoaded('attachments')) {
|
|
return null;
|
|
}
|
|
|
|
// 삭제된 게시글: 관리 권한자가 아니면 첨부 목록 미노출.
|
|
// 단, 게시글 삭제로 함께 숨겨진(cascade) 첨부는 사용자가 직접 지운 것이 아니므로
|
|
// 글을 볼 수 있는 사람에게는 노출한다 (cascade 댓글 노출과 일관).
|
|
if ($this->deleted_at && ! $this->canViewDeletedContent($request, $slug)) {
|
|
$cascadeAttachments = $this->attachments->filter(
|
|
fn ($attachment) => $attachment->deleted_at !== null
|
|
&& $attachment->trigger_type === TriggerType::Cascade->value
|
|
)->values();
|
|
|
|
return AttachmentResource::collection($cascadeAttachments);
|
|
}
|
|
|
|
if ($this->is_secret && ! $this->canViewSecretContent($request, $slug)) {
|
|
return [];
|
|
}
|
|
|
|
return AttachmentResource::collection($this->attachments);
|
|
}
|
|
|
|
// =========================================================================
|
|
// 권한 관련 메서드
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 소유자 필드명을 반환합니다.
|
|
*
|
|
* @return string|null 소유자 필드명
|
|
*/
|
|
protected function ownerField(): ?string
|
|
{
|
|
return 'user_id';
|
|
}
|
|
|
|
/**
|
|
* 게시글 권한을 통합 can_* 키로 반환합니다.
|
|
*
|
|
* Admin/User 페이지별로 동일한 키를 사용하되,
|
|
* 실제 체크하는 permission identifier는 컨텍스트에 따라 다릅니다.
|
|
*
|
|
* 참고: 목록에서는 이 메서드가 호출되지 않습니다.
|
|
* 목록의 권한은 PostCollection::getBoardPermissions()에서 컬렉션 레벨로 제공됩니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return array<string, bool> 통합 권한 정보
|
|
*/
|
|
protected function resolveAbilities(Request $request): array
|
|
{
|
|
$slug = $this->getSlug($request);
|
|
if (! $slug) {
|
|
return [];
|
|
}
|
|
|
|
// 이 권한 맵은 게시글이 아니라 (게시판, 화면 종류, 사용자) 로만 정해진다.
|
|
// 상세 화면의 답글 트리는 같은 게시판의 게시글을 N개 직렬화하므로, 메모가 없으면
|
|
// 같은 답을 노드 수만큼 다시 만든다. 캐시는 요청 인스턴스에 두어 요청 단위로 격리된다.
|
|
$isAdminRequest = $this->isAdminRequest($request);
|
|
$cacheKey = $slug.'|'.($isAdminRequest ? 'admin' : 'user').'|'.(Auth::id() ?? 'guest');
|
|
$cache = $request->attributes->get(BoardPermissionCacheKeys::ABILITIES, []);
|
|
|
|
if (isset($cache[$cacheKey])) {
|
|
return $cache[$cacheKey];
|
|
}
|
|
|
|
$abilities = $this->buildAbilities($slug, $isAdminRequest);
|
|
|
|
$cache[$cacheKey] = $abilities;
|
|
$request->attributes->set(BoardPermissionCacheKeys::ABILITIES, $cache);
|
|
|
|
return $abilities;
|
|
}
|
|
|
|
/**
|
|
* 게시판 권한 맵을 실제로 해석합니다.
|
|
*
|
|
* @param string $slug 게시판 슬러그
|
|
* @param bool $isAdminRequest 관리자 화면 요청 여부
|
|
* @return array<string, bool> 통합 권한 정보
|
|
*/
|
|
private function buildAbilities(string $slug, bool $isAdminRequest): array
|
|
{
|
|
$permissionMap = $isAdminRequest
|
|
? [
|
|
'can_read' => "sirsoft-board.{$slug}.admin.posts.read",
|
|
'can_write' => "sirsoft-board.{$slug}.admin.posts.write",
|
|
'can_read_secret' => "sirsoft-board.{$slug}.admin.posts.read-secret",
|
|
'can_read_comments' => "sirsoft-board.{$slug}.admin.comments.read",
|
|
'can_write_comments' => "sirsoft-board.{$slug}.admin.comments.write",
|
|
'can_upload' => "sirsoft-board.{$slug}.admin.attachments.upload",
|
|
'can_download' => "sirsoft-board.{$slug}.admin.attachments.download",
|
|
'can_manage' => "sirsoft-board.{$slug}.admin.manage",
|
|
]
|
|
: [
|
|
'can_read' => "sirsoft-board.{$slug}.posts.read",
|
|
'can_write' => "sirsoft-board.{$slug}.posts.write",
|
|
'can_read_secret' => "sirsoft-board.{$slug}.posts.read-secret",
|
|
'can_read_comments' => "sirsoft-board.{$slug}.comments.read",
|
|
'can_write_comments' => "sirsoft-board.{$slug}.comments.write",
|
|
'can_upload' => "sirsoft-board.{$slug}.attachments.upload",
|
|
'can_download' => "sirsoft-board.{$slug}.attachments.download",
|
|
'can_manage' => "sirsoft-board.{$slug}.manager",
|
|
];
|
|
|
|
$abilities = collect($permissionMap)
|
|
->mapWithKeys(fn (string $identifier, string $key) => [
|
|
$key => $this->checkPermissionByIdentifier($identifier),
|
|
])
|
|
->toArray();
|
|
|
|
// 유저 상세 화면에서만: 관리자 게시판 화면 진입 게이트(Admin 타입 admin.manage).
|
|
// Admin 요청에서는 can_manage 가 이미 admin.manage 이므로 중복 노출 불필요.
|
|
if (! $isAdminRequest) {
|
|
$abilities['can_access_admin'] = $this->checkPermissionByIdentifier("sirsoft-board.{$slug}.admin.manage");
|
|
}
|
|
|
|
return $abilities;
|
|
}
|
|
|
|
/**
|
|
* Admin 요청 여부를 확인합니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return bool Admin 요청 여부
|
|
*/
|
|
private function isAdminRequest(Request $request): bool
|
|
{
|
|
$controller = $request->route()?->getController();
|
|
|
|
if (! $controller) {
|
|
return false;
|
|
}
|
|
|
|
return str_contains(get_class($controller), '\\Admin\\');
|
|
}
|
|
|
|
/**
|
|
* 비밀글 내용 열람 가능 여부를 확인합니다.
|
|
*
|
|
* 열람 가능 조건 (우선순위 순):
|
|
* 1. 작성자 본인 (회원 게시글)
|
|
* 2. 비밀번호 검증 완료 (회원/비회원 게시글, password_verified 플래그)
|
|
* 3. 게시판별 비밀글 읽기 권한 (posts.read-secret)
|
|
* 4. 게시판 관리자 권한 (Admin: admin.manage / User: manager)
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그 (getSlug 중복 호출 방지)
|
|
* @return bool 열람 가능 여부
|
|
*/
|
|
private function canViewSecretContent(Request $request, ?string $slug = null): bool
|
|
{
|
|
// 1. 작성자 본인 (회원 게시글)
|
|
$user = Auth::user();
|
|
if ($user && $this->user_id && $this->user_id === $user->id) {
|
|
return true;
|
|
}
|
|
|
|
// 2. 비밀번호 검증 완료
|
|
if ($this->password_verified === true) {
|
|
return true;
|
|
}
|
|
|
|
// 3-4. 게시판별 권한 체크
|
|
$slug = $slug ?? $this->getSlug($request);
|
|
if (! $slug) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->isAdminRequest($request)) {
|
|
return $this->checkBoardPermission($slug, 'admin.posts.read-secret')
|
|
|| $this->checkBoardPermission($slug, 'admin.manage');
|
|
}
|
|
|
|
return $this->checkBoardPermission($slug, 'posts.read-secret', PermissionType::User)
|
|
|| $this->checkBoardPermission($slug, 'manager', PermissionType::User);
|
|
}
|
|
|
|
// =========================================================================
|
|
// 콘텐츠 필터링 메서드 (상세 페이지 전용)
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 권한에 따라 필터링된 제목을 반환합니다.
|
|
*
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return string 필터링된 제목
|
|
*/
|
|
private function getFilteredTitle(Request $request, ?string $slug): string
|
|
{
|
|
// 삭제된 게시글: 관리 권한(manager/admin.manage)이 없으면 제목 숨김
|
|
if ($this->deleted_at && ! $this->canViewDeletedContent($request, $slug)) {
|
|
return __('sirsoft-board::messages.post.deleted_post_title');
|
|
}
|
|
|
|
return $this->title;
|
|
}
|
|
|
|
/**
|
|
* 권한에 따라 필터링된 내용을 반환합니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return string|null 필터링된 내용
|
|
*/
|
|
private function getFilteredContent(Request $request, ?string $slug): ?string
|
|
{
|
|
// 삭제된 게시글: 관리 권한(manager/admin.manage)이 없으면 내용 숨김
|
|
if ($this->deleted_at && ! $this->canViewDeletedContent($request, $slug)) {
|
|
return __('sirsoft-board::messages.post.deleted_post_content');
|
|
}
|
|
|
|
// 블라인드 게시글: 원문 열람 권한(관리자 또는 작성자 본인)이 없으면 content를 null로 반환
|
|
// - 목록 제목·블라인드 안내·사유 문구는 그대로 노출하되, 원문만 권한자 한정
|
|
// - null 반환 시 프론트의 '원글 보기' 버튼이 자동으로 미노출됨
|
|
if ($this->status === PostStatus::Blinded && ! $this->canViewBlindedContent($request, $slug)) {
|
|
return null;
|
|
}
|
|
|
|
// 비밀글: 권한 없으면 content를 null로 반환
|
|
// - is_secret = true인 경우에만 검증 필요
|
|
// - 일반글(is_secret = false)은 비밀번호 유무와 관계없이 공개
|
|
if ($this->is_secret && ! $this->canViewSecretContent($request, $slug)) {
|
|
return null;
|
|
}
|
|
|
|
return $this->content;
|
|
}
|
|
|
|
/**
|
|
* 블라인드 게시글 원문 열람 가능 여부를 확인합니다.
|
|
*
|
|
* 열람 가능 조건 (OR):
|
|
* 1. 작성자 본인 (회원 게시글 — 비회원 글은 본인 판정 불가)
|
|
* 2. 게시판 관리자 (Admin: admin.manage / User: manager)
|
|
*
|
|
* 비밀글(canViewSecretContent)과 달리 비밀번호 검증·posts.read-secret 은 인정하지 않습니다.
|
|
* (블라인드는 운영 제재이므로 비밀번호로 해제되지 않음)
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return bool 원문 열람 가능 여부
|
|
*/
|
|
private function canViewBlindedContent(Request $request, ?string $slug): bool
|
|
{
|
|
// 1. 작성자 본인 (회원 게시글)
|
|
$user = Auth::user();
|
|
if ($user && $this->user_id && $this->user_id === $user->id) {
|
|
return true;
|
|
}
|
|
|
|
// 2. 게시판 관리자 권한
|
|
if (! $slug) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->isAdminRequest($request)) {
|
|
return $this->checkBoardPermission($slug, 'admin.manage');
|
|
}
|
|
|
|
return $this->checkBoardPermission($slug, 'manager', PermissionType::User);
|
|
}
|
|
|
|
/**
|
|
* 삭제된 게시글 원문(제목/본문) 열람 가능 여부를 확인합니다.
|
|
*
|
|
* 열람 가능 조건: 게시판 관리자 (Admin: admin.manage / User: manager).
|
|
* 블라인드(canViewBlindedContent)와 달리 작성자 본인은 인정하지 않습니다.
|
|
* 삭제된 게시글은 상세 진입 가드(PostController::show)에서 이미 manager 만
|
|
* 허용하므로(작성자 본인은 404), 필터 권한도 동일하게 권한자 한정으로 맞춥니다.
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @param string|null $slug 게시판 슬러그
|
|
* @return bool 원문 열람 가능 여부
|
|
*/
|
|
private function canViewDeletedContent(Request $request, ?string $slug): bool
|
|
{
|
|
if (! $slug) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->isAdminRequest($request)) {
|
|
return $this->checkBoardPermission($slug, 'admin.manage');
|
|
}
|
|
|
|
return $this->checkBoardPermission($slug, 'manager', PermissionType::User)
|
|
|| $this->checkBoardPermission($slug, 'admin.manage');
|
|
}
|
|
}
|