v7.0.0 release

This commit is contained in:
HeuJung committed 2026-07-01 10:30:32 +09:00
1 parent 0e7fa04b03
commit c4ea9a6cd1
3582 files changed
+626189 -160151

No files matched your search

@@ -9,17 +9,17 @@ use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Validation\ValidationException;
use Modules\Sirsoft\Board\Exceptions\MenuAlreadyExistsException;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
use Modules\Sirsoft\Board\Http\Requests\StoreBoardRequest;
use Modules\Sirsoft\Board\Http\Requests\UpdateBoardRequest;
use Modules\Sirsoft\Board\Http\Resources\BoardCollection;
use Modules\Sirsoft\Board\Http\Resources\BoardResource;
use Modules\Sirsoft\Board\Http\Resources\PostResource;
use Modules\Sirsoft\Board\Http\Resources\BoardTypeResource;
use Modules\Sirsoft\Board\Http\Resources\PostResource;
use Modules\Sirsoft\Board\Services\BoardService;
use Modules\Sirsoft\Board\Services\BoardTypeService;
use Modules\Sirsoft\Board\Services\PostService;
use Modules\Sirsoft\Board\Traits\ChecksBoardPermission;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
/**
* 관리자용 게시판 관리 컨트롤러
@@ -29,6 +29,7 @@ use Modules\Sirsoft\Board\Traits\ChecksBoardPermission;
class BoardController extends AdminBaseController
{
use ChecksBoardPermission;
/**
* BoardController 생성자
*
@@ -47,6 +48,7 @@ class BoardController extends AdminBaseController
* @param Request $request HTTP 요청
* @return JsonResponse 게시판 목록 응답
*/
// audit:allow controller-base-request-injection reason: GET 목록 조회. all()로 필터·페이징 파라미터만 읽음 (검증 불필요)
public function index(Request $request): JsonResponse
{
try {
@@ -98,6 +100,7 @@ class BoardController extends AdminBaseController
* @param PostService $postService 게시글 서비스 (DI)
* @return JsonResponse 게시판 상세 정보 응답
*/
// audit:allow controller-base-request-injection reason: GET 슬러그 상세 조회. 경로 파라미터(slug)만 사용 (검증 불필요)
public function showBySlug(Request $request, string $slug, PostService $postService): JsonResponse
{
try {
@@ -195,6 +198,7 @@ class BoardController extends AdminBaseController
* @param Request $request HTTP 요청
* @return JsonResponse 삭제 성공 응답
*/
// audit:allow controller-base-request-injection reason: DELETE 단건 삭제. force_delete 불리언 플래그만 input()으로 읽음 (검증 불필요)
public function destroy(int $id, Request $request): JsonResponse
{
try {
@@ -217,6 +221,7 @@ class BoardController extends AdminBaseController
* @param Request $request HTTP 요청
* @return JsonResponse 폼 데이터 응답
*/
// audit:allow controller-base-request-injection reason: GET 폼 데이터 조회. board_id 존재 여부로 생성/수정 모드만 분기 (검증 불필요)
public function getFormData(Request $request): JsonResponse
{
try {
@@ -227,6 +232,8 @@ class BoardController extends AdminBaseController
$request->merge(['include_permissions' => true]);
$board = $this->boardService->getBoard($request->board_id);
// 폼 토글 초기값: 관리자 메뉴 등록 여부를 모델 속성으로 전달
$board->is_in_admin_menu = $this->boardService->isInAdminMenu($board);
$data = (new BoardResource($board))->toArray($request);
}
// 복사 모드
@@ -249,6 +256,7 @@ class BoardController extends AdminBaseController
$data['id'] = null;
$data['slug'] = null;
$data['is_active'] = true;
$data['add_to_menu'] = false;
// 로그인한 관리자를 게시판 관리자 기본값으로 지정
$currentUser = Auth::user();
@@ -270,8 +278,9 @@ class BoardController extends AdminBaseController
$data['categories'] = [];
$spamSecurity = g7_module_settings('sirsoft-board', 'spam_security', []);
$data['blocked_keywords'] = collect($spamSecurity['blocked_keywords'] ?? [])->join(',');
$data['allowed_extensions'] = collect($basicDefaults['allowed_extensions'] ?? [])->join(',');
// TagInput 입력과 일관되게 배열로 주입 (categories 와 동일 패턴)
$data['blocked_keywords'] = array_values($spamSecurity['blocked_keywords'] ?? []);
$data['allowed_extensions'] = array_values($basicDefaults['allowed_extensions'] ?? []);
// depth 필드는 reject(is_array)로 걸러지지 않지만 basic_defaults가 비어있을 수 있으므로 명시적 기본값 보장
$limits = config('sirsoft-board.limits', []);
@@ -7,8 +7,10 @@ use App\Helpers\ResponseHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use Exception;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Modules\Sirsoft\Board\Exceptions\BulkApplyAbortedException;
use Modules\Sirsoft\Board\Http\Requests\Admin\BulkApplySettingsRequest;
use Modules\Sirsoft\Board\Http\Requests\Admin\IndexBoardSettingsRequest;
use Modules\Sirsoft\Board\Http\Requests\Admin\ShowBoardSettingsRequest;
use Modules\Sirsoft\Board\Http\Requests\Admin\StoreBoardSettingsRequest;
use Modules\Sirsoft\Board\Services\BoardService;
use Modules\Sirsoft\Board\Services\BoardSettingsService;
@@ -23,8 +25,8 @@ class BoardSettingsController extends AdminBaseController
/**
* BoardSettingsController 생성자
*
* @param BoardSettingsService $settingsService 환경설정 서비스
* @param BoardService $boardService 게시판 서비스
* @param BoardSettingsService $settingsService 환경설정 서비스
* @param BoardService $boardService 게시판 서비스
*/
public function __construct(
private BoardSettingsService $settingsService,
@@ -34,9 +36,10 @@ class BoardSettingsController extends AdminBaseController
/**
* 모든 게시판 설정을 조회합니다.
*
* @param IndexBoardSettingsRequest $request 환경설정 조회 요청
* @return JsonResponse 설정 목록을 포함한 JSON 응답
*/
public function index(Request $request): JsonResponse
public function index(IndexBoardSettingsRequest $request): JsonResponse
{
try {
$settings = $this->settingsService->getAllSettings();
@@ -46,6 +49,10 @@ class BoardSettingsController extends AdminBaseController
'can_update' => PermissionHelper::check('sirsoft-board.settings.update', $request->user()),
];
$settings['_meta'] = [
'limits' => config('sirsoft-board.limits', []),
];
return ResponseHelper::moduleSuccess(
'sirsoft-board',
'messages.settings.fetch_success',
@@ -63,10 +70,11 @@ class BoardSettingsController extends AdminBaseController
/**
* 카테고리별 설정을 조회합니다.
*
* @param string $category 카테고리명
* @param ShowBoardSettingsRequest $request 카테고리별 설정 조회 요청
* @param string $category 카테고리명
* @return JsonResponse 카테고리 설정을 포함한 JSON 응답
*/
public function show(Request $request, string $category): JsonResponse
public function show(ShowBoardSettingsRequest $request, string $category): JsonResponse
{
try {
$settings = $this->settingsService->getSettings($category);
@@ -94,7 +102,7 @@ class BoardSettingsController extends AdminBaseController
/**
* 게시판 설정을 저장합니다.
*
* @param StoreBoardSettingsRequest $request 저장 요청 데이터
* @param StoreBoardSettingsRequest $request 저장 요청 데이터
* @return JsonResponse 저장 결과 JSON 응답
*/
public function store(StoreBoardSettingsRequest $request): JsonResponse
@@ -136,7 +144,7 @@ class BoardSettingsController extends AdminBaseController
/**
* 환경설정 기본값을 기존 게시판에 일괄 적용합니다.
*
* @param BulkApplySettingsRequest $request 일괄 적용 요청 데이터
* @param BulkApplySettingsRequest $request 일괄 적용 요청 데이터
* @return JsonResponse 일괄 적용 결과 JSON 응답
*/
public function bulkApply(BulkApplySettingsRequest $request): JsonResponse
@@ -157,10 +165,23 @@ class BoardSettingsController extends AdminBaseController
return ResponseHelper::moduleSuccess(
'sirsoft-board',
'messages.settings.bulk_apply_success',
['updated_count' => $updatedCount],
['updated_count' => $updatedCount, 'rolled_back' => false],
200,
['count' => $updatedCount]
);
} catch (BulkApplyAbortedException $e) {
// 일괄 적용 중 실패 → 전체 롤백됨 (의도된 정상 동작). HTTP 200 + rolled_back 플래그로
// 프론트 onSuccess 흐름에서 안내 처리. board=null 이면 컬럼 업데이트 실패(generic).
return ResponseHelper::moduleSuccess(
'sirsoft-board',
'messages.settings.bulk_apply_aborted',
[
'rolled_back' => true,
'board' => $e->boardInfo(),
'failed_at' => $e->failedAt,
'total' => $e->total,
]
);
} catch (Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-board',
@@ -0,0 +1,110 @@
<?php
namespace Modules\Sirsoft\Board\Http\Controllers\Admin;
use App\Helpers\ResponseHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use Illuminate\Http\JsonResponse;
use Modules\Sirsoft\Board\Http\Requests\Admin\DashboardRangeRequest;
use Modules\Sirsoft\Board\Http\Resources\PendingReportResource;
use Modules\Sirsoft\Board\Http\Resources\RecentPostResource;
use Modules\Sirsoft\Board\Services\BoardDashboardService;
/**
* 게시판 대시보드 컨트롤러
*
* 관리자 대시보드의 게시판 영역(오늘 현황/추세 그래프/최신글/미처리 신고) API를 제공합니다.
*/
class DashboardController extends AdminBaseController
{
/**
* 모듈 식별자
*/
private const MODULE = 'sirsoft-board';
/**
* 최신글/신고 카드 기본 표시 건수
*/
private const DEFAULT_RECENT_LIMIT = 5;
/**
* 추세 그래프 기본 표시 일수
*/
private const DEFAULT_GRAPH_DAYS = 7;
/**
* @param BoardDashboardService $dashboardService 대시보드 서비스
*/
public function __construct(
private readonly BoardDashboardService $dashboardService
) {}
/**
* 오늘 새 글/새 댓글 현황을 조회합니다.
*
* @return JsonResponse 오늘 집계
*/
public function overview(): JsonResponse
{
return ResponseHelper::moduleSuccess(
self::MODULE,
'messages.dashboard.fetch_success',
$this->dashboardService->getOverview(),
);
}
/**
* 7일 추세 그래프(막대 + 합계 + 변화율)를 조회합니다.
*
* @return JsonResponse 그래프 데이터
*/
public function postGraph(): JsonResponse
{
return ResponseHelper::moduleSuccess(
self::MODULE,
'messages.dashboard.fetch_success',
$this->dashboardService->getPostGraph(self::DEFAULT_GRAPH_DAYS),
);
}
/**
* 전체 게시판의 최신 게시글을 조회합니다.
*
* @param DashboardRangeRequest $request 조회 파라미터
* @return JsonResponse 최신 게시글 목록
*/
public function recentPosts(DashboardRangeRequest $request): JsonResponse
{
$limit = (int) ($request->validated('limit') ?? self::DEFAULT_RECENT_LIMIT);
$posts = $this->dashboardService->getRecentPosts($limit);
return ResponseHelper::moduleSuccess(
self::MODULE,
'messages.dashboard.fetch_success',
RecentPostResource::collection($posts),
);
}
/**
* 전체 게시판의 미처리 신고 목록과 총 건수를 조회합니다.
*
* @param DashboardRangeRequest $request 조회 파라미터
* @return JsonResponse 미처리 신고 목록 + 총 건수
*/
public function pendingReports(DashboardRangeRequest $request): JsonResponse
{
$limit = (int) ($request->validated('limit') ?? self::DEFAULT_RECENT_LIMIT);
$result = $this->dashboardService->getPendingReports($limit);
return ResponseHelper::moduleSuccess(
self::MODULE,
'messages.dashboard.fetch_success',
[
'items' => PendingReportResource::collection($result['items']),
'total' => $result['total'],
],
);
}
}
@@ -5,7 +5,10 @@ namespace Modules\Sirsoft\Board\Http\Controllers\Admin;
use App\Http\Controllers\Api\Base\AdminBaseController;
use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Modules\Sirsoft\Board\Exceptions\DeletedReportStatusChangeException;
use Modules\Sirsoft\Board\Http\Requests\Admin\IndexReportRequest;
use Modules\Sirsoft\Board\Http\Requests\Admin\ReportersRequest;
use Modules\Sirsoft\Board\Http\Requests\Admin\StatusCountsRequest;
use Modules\Sirsoft\Board\Http\Requests\BulkUpdateStatusRequest;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
use Modules\Sirsoft\Board\Http\Requests\UpdateStatusRequest;
@@ -40,10 +43,10 @@ class ReportController extends AdminBaseController
*
* 동일 대상(게시글/댓글)에 대한 신고는 그룹화하여 최초 신고만 목록에 표시합니다.
*
* @param Request $request HTTP 요청
* @param IndexReportRequest $request 신고 목록 조회 요청
* @return JsonResponse 신고 목록 응답
*/
public function index(Request $request): JsonResponse
public function index(IndexReportRequest $request): JsonResponse
{
try {
// 조회 권한 체크
@@ -125,10 +128,10 @@ class ReportController extends AdminBaseController
* 신고 케이스의 신고자 목록을 페이지네이션으로 반환합니다.
*
* @param int $id 신고 케이스 ID
* @param Request $request HTTP 요청
* @param ReportersRequest $request 신고자 목록 조회 요청
* @return JsonResponse 신고자 목록 응답
*/
public function reporters(int $id, Request $request): JsonResponse
public function reporters(int $id, ReportersRequest $request): JsonResponse
{
try {
if (! $this->checkModulePermission('reports', 'view')) {
@@ -173,33 +176,29 @@ class ReportController extends AdminBaseController
try {
$validated = $request->validated();
// 1케이스 구조: 케이스 ID 직접 사용 (expandGroupedReportIds 불필요)
$result = $this->reportService->bulkUpdateStatus(
[$id],
[
'status' => $validated['status'],
'process_note' => $validated['process_note'] ?? null,
]
);
// 단건 처리: 단건 전용 서비스 메서드 사용 (벌크 메서드 우회 금지)
// 전환 불가 상태(deleted 등)는 UpdateStatusRequest 검증에서 422로 선차단되며,
// 서비스의 deleted 가드가 2차 방어선으로 동작한다.
$this->reportService->updateReportStatus($id, [
'status' => $validated['status'],
'process_note' => $validated['process_note'] ?? null,
]);
// 케이스 재조회 (응답용)
$report = $this->reportService->getReport($id);
$report->reportableData = $this->reportService->buildReportableData($report);
// 수동 블라인드 복구 안내 메시지
$messageKey = 'sirsoft-board::messages.reports.status_updated';
if ($result['manual_blind_restored'] > 0) {
$messageKey = 'sirsoft-board::messages.reports.status_updated';
}
return $this->successWithResource(
$messageKey,
'sirsoft-board::messages.reports.status_updated',
new ReportResource($report)
);
} catch (ModelNotFoundException $e) {
return $this->notFound('sirsoft-board::messages.reports.error_404');
} catch (AccessDeniedHttpException $e) {
return $this->error('auth.scope_denied', 403);
} catch (DeletedReportStatusChangeException $e) {
// 영구삭제 신고의 상태 변경 시도 (서비스 직접 호출 방어선) — 422 반환
return $this->error('sirsoft-board::messages.reports.cannot_change_deleted_status', 422);
} catch (\Exception $e) {
return $this->error('sirsoft-board::messages.reports.status_update_failed', 500, $e->getMessage());
}
@@ -209,18 +208,15 @@ class ReportController extends AdminBaseController
* 선택된 신고들의 상태별 건수를 조회합니다.
* 일괄 처리 전 사용자에게 선택한 신고의 상태 분포를 보여주기 위한 API입니다.
*
* @param Request $request HTTP 요청 (ids 배열 필요)
* @param StatusCountsRequest $request 상태별 건수 조회 요청 (ids 배열 필요)
* @return JsonResponse 상태별 건수 응답
*/
public function getStatusCounts(Request $request): JsonResponse
public function getStatusCounts(StatusCountsRequest $request): JsonResponse
{
try {
$ids = $request->input('ids', []);
$targetStatus = $request->input('target_status');
if (empty($ids)) {
return $this->error('sirsoft-board::messages.reports.no_reports_selected', 422);
}
$validated = $request->validated();
$ids = $validated['ids'];
$targetStatus = $validated['target_status'] ?? null;
// 상태별 건수 집계
$statusCounts = $this->reportService->getStatusCountsByIds($ids, $targetStatus);
@@ -116,6 +116,9 @@ class AttachmentController extends PublicBaseController
$fileInfo['mime_type'],
(int) g7_core_settings('cache.layout_ttl', 86400)
);
} catch (\Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException $e) {
// 삭제글 첨부 등 권한 차단은 403 으로 응답
return $this->error('auth.scope_denied', 403);
} catch (BoardNotFoundException $e) {
return $this->notFound(__('sirsoft-board::messages.boards.not_found'));
} catch (\Exception $e) {
@@ -2,6 +2,7 @@
namespace Modules\Sirsoft\Board\Http\Controllers\User;
use App\Enums\PermissionType;
use App\Http\Controllers\Api\Base\PublicBaseController;
use App\Models\User;
use Illuminate\Database\Eloquent\ModelNotFoundException;
@@ -11,7 +12,7 @@ use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use App\Enums\PermissionType;
use Modules\Sirsoft\Board\Enums\PostStatus;
use Modules\Sirsoft\Board\Enums\SecretMode;
use Modules\Sirsoft\Board\Exceptions\BoardNotFoundException;
use Modules\Sirsoft\Board\Exceptions\PostNotFoundException;
@@ -21,6 +22,7 @@ use Modules\Sirsoft\Board\Http\Requests\User\VerifyGuestPasswordRequest;
use Modules\Sirsoft\Board\Http\Resources\BoardResource;
use Modules\Sirsoft\Board\Http\Resources\PostCollection;
use Modules\Sirsoft\Board\Http\Resources\PostResource;
use Modules\Sirsoft\Board\Models\Post;
use Modules\Sirsoft\Board\Services\BoardService;
use Modules\Sirsoft\Board\Services\CommentService;
use Modules\Sirsoft\Board\Services\PostService;
@@ -63,6 +65,7 @@ class PostController extends PublicBaseController
* @param string $slug 게시판 슬러그
* @return JsonResponse 게시글 목록 응답
*/
// audit:allow controller-base-request-injection reason: GET 목록 조회. all()/header() 로 필터·페이징 파라미터만 읽음 (검증 불필요)
public function index(Request $request, string $slug): JsonResponse
{
try {
@@ -87,6 +90,13 @@ class PostController extends PublicBaseController
// board 객체 전달로 Service/Repository의 중복 Board 조회 방지
$posts = $this->postService->getPosts($slug, $listParams['filters'], $listParams['perPage'], withTrashed: $withTrashed, context: 'user', board: $board);
// board 관계 수동 주입 (목록 Repository는 board를 eager load하지 않음)
// Post::isNew()가 게시판 new_display_hours 설정을 사용하려면 board 관계가 필요하다.
// 이미 조회한 단일 $board 인스턴스를 공유 주입하므로 추가 쿼리는 없다.
foreach ($posts as $post) {
$post->setRelation('board', $board);
}
// 일반 게시글 총 건수는 캐시에서 조회 (simplePaginate는 total 미제공)
$totalNormalPosts = $this->postService->getCachedNormalPostCount($slug, $board->id, $listParams['filters'], $withTrashed, 'user');
@@ -117,6 +127,7 @@ class PostController extends PublicBaseController
* @param string|int $id 게시글 ID
* @return JsonResponse 게시글 상세 정보 응답
*/
// audit:allow controller-base-request-injection reason: GET 상세 조회. 쿼리 파라미터만 read-only 참조 (검증 불필요)
public function show(Request $request, string $slug, string|int $id): JsonResponse
{
$id = (int) $id;
@@ -206,6 +217,7 @@ class PostController extends PublicBaseController
* @param string|int $id 게시글 ID
* @return JsonResponse 이전/다음 게시글 정보
*/
// audit:allow controller-base-request-injection reason: GET 이전/다음 글 조회. 경로 파라미터(slug/id)만 사용 (검증 불필요)
public function navigation(Request $request, string $slug, string|int $id): JsonResponse
{
$id = (int) $id;
@@ -223,6 +235,15 @@ class PostController extends PublicBaseController
return $this->success('sirsoft-board::messages.posts.fetch_success', $empty);
}
// navigation 판별용 메타(카테고리·부모 ID) 경량 조회
$meta = $this->postService->getPostNavigationMeta($id, $board->id);
// 답글(parent_id != null)은 원글 후보 쿼리에서 제외되므로 옆 글 없음으로 응답 (47-4)
// 답글 상세 상단의 원글 인용 블록이 원글 이동 안내를 담당한다.
if (($meta['parent_id'] ?? null) !== null) {
return $this->success('sirsoft-board::messages.posts.fetch_success', $empty);
}
// manager 권한 + del=1 시 삭제된 게시글 포함
$canViewDeleted = $this->checkBoardPermission($slug, 'manager', PermissionType::User);
$withTrashed = $canViewDeleted && $request->boolean('del');
@@ -231,6 +252,9 @@ class PostController extends PublicBaseController
$navigation = $this->postService->getAdjacentPosts($slug, $id, filters: [
'order_by' => $board->order_by instanceof \BackedEnum ? $board->order_by->value : $board->order_by,
'order_direction' => $board->order_direction instanceof \BackedEnum ? $board->order_direction->value : $board->order_direction,
// 현재 글과 동일 카테고리 글만 이전/다음 후보로 제한 (47-1).
// 미분류(null)면 getAdjacentPosts 의 when($category) 가 미적용 → 전체 원글 순회.
'category' => $meta['category'] ?? null,
], withTrashed: $withTrashed, board: $board);
} catch (\Throwable $e) {
// 내부 예외는 로그만 남기고 옆 글 없음으로 degrade
@@ -378,6 +402,7 @@ class PostController extends PublicBaseController
* @param string|int $id 게시글 ID
* @return JsonResponse 삭제 결과 응답
*/
// audit:allow controller-base-request-injection reason: DELETE 단건 삭제. force_delete 불리언 플래그만 input()으로 읽음 (검증 불필요)
public function destroy(Request $request, string $slug, string|int $id): JsonResponse
{
$id = (int) $id;
@@ -529,6 +554,7 @@ class PostController extends PublicBaseController
* @param string $slug 게시판 슬러그
* @return JsonResponse 폼 메타 데이터 응답
*/
// audit:allow controller-base-request-injection reason: GET 작성 폼 메타 조회. 경로 파라미터(slug)만 사용 (검증 불필요)
public function getFormMeta(Request $request, string $slug): JsonResponse
{
try {
@@ -557,7 +583,7 @@ class PostController extends PublicBaseController
// 회원 게시글이고 본인이 아닌 경우 권한 에러
if ($post->user_id && Auth::id() !== $post->user_id) {
if (! $this->checkBoardPermission($slug, 'admin.manage')) {
if (! $this->hasBoardManagePermission($slug)) {
return $this->error('sirsoft-board::messages.posts.no_permission', 403);
}
}
@@ -588,7 +614,9 @@ class PostController extends PublicBaseController
$metaData['attachments'] = $postData['attachments'] ?? [];
// 수정 시 원글 정보가 있으면 포함
if (! empty($postData['parent'])) {
// 단, 부모글이 블라인드/삭제 상태이면 원문(제목/본문) 노출을 차단
// — 답글 작성 후 부모가 블라인드/삭제된 경우, 답글 수정 폼에 부모 원문이 새지 않도록 함
if (! empty($postData['parent']) && ! $this->isParentBlindedOrDeleted($post)) {
$metaData['parent_post'] = $postData['parent'];
}
}
@@ -601,6 +629,12 @@ class PostController extends PublicBaseController
}
$parentPost = $this->postService->getPost($slug, $parentId, context: 'user');
// 블라인드/삭제된 부모글에는 답글 폼 진입 자체를 차단
// 제출 단계(ParentPostValidationRule)뿐 아니라 폼 진입 단계에서도 막아
// 부모글 원문(제목/본문)이 답글 폼에 노출되지 않도록 함
$this->assertParentReplyable($parentPost, $parentId);
$parentPostResource = new PostResource($parentPost);
$metaData['parent_post'] = $parentPostResource->toFormArray($request);
}
@@ -622,6 +656,7 @@ class PostController extends PublicBaseController
* @param string $slug 게시판 슬러그
* @return JsonResponse 폼 데이터 응답
*/
// audit:allow controller-base-request-injection reason: GET 수정 폼 데이터 조회. 경로 파라미터(slug) + 쿼리만 read-only 참조 (검증 불필요)
public function getFormData(Request $request, string $slug): JsonResponse
{
try {
@@ -639,7 +674,7 @@ class PostController extends PublicBaseController
// 회원 게시글이고 본인이 아니거나, 관리자도 아닌 경우 권한 에러
if ($post->user_id && Auth::id() !== $post->user_id) {
if (! $this->checkBoardPermission($slug, 'admin.manage')) {
if (! $this->hasBoardManagePermission($slug)) {
return $this->error('sirsoft-board::messages.posts.no_permission', 403);
}
}
@@ -686,6 +721,9 @@ class PostController extends PublicBaseController
}
$parentPost = $this->postService->getPost($slug, $parentId, context: 'user');
// 블라인드/삭제된 부모글에는 답글 폼 진입 자체를 차단
$this->assertParentReplyable($parentPost, $parentId);
$formData = [
'title' => 'Re: '.$parentPost->title,
'content' => '',
@@ -719,16 +757,81 @@ class PostController extends PublicBaseController
}
}
/**
* 사용자 페이지에서 게시판 관리 권한을 보유했는지 확인합니다.
*
* 관리자 페이지 권한(admin.manage)과 사용자 페이지 관리 권한(manager)을
* 모두 인정합니다. 사용자 페이지 화면은 manager 권한으로 can_manage 를
* 노출하므로, 실제 처리도 manager 를 인정해야 화면-서버 정합이 맞습니다.
*
* @param string $slug 게시판 슬러그
* @return bool 관리 권한 보유 여부
*/
private function hasBoardManagePermission(string $slug): bool
{
if (! Auth::check()) {
return false;
}
return $this->checkBoardPermission($slug, 'admin.manage')
|| $this->checkBoardPermission($slug, 'manager', PermissionType::User);
}
/**
* 부모 게시글이 답글 작성 가능한 상태인지 검증합니다.
*
* 블라인드/삭제된 부모글에는 답글 폼 진입 단계에서 차단하여,
* 부모글 원문(제목/본문)이 답글 폼에 노출되지 않도록 합니다.
* 차단은 PostNotFoundException(404)으로 처리하여 부모글의 존재 자체를 숨깁니다.
* (제출 단계 차단은 ParentPostValidationRule 이 별도로 수행)
*
* @param Post $parentPost 부모 게시글 모델
* @param int $parentId 부모 게시글 ID (예외 메시지용)
* @return void
*
* @throws PostNotFoundException 부모글이 블라인드/삭제 상태인 경우
*/
private function assertParentReplyable(Post $parentPost, int $parentId): void
{
if ($parentPost->status === PostStatus::Blinded
|| $parentPost->status === PostStatus::Deleted
|| $parentPost->deleted_at !== null) {
throw new PostNotFoundException($parentId);
}
}
/**
* 답글의 부모 게시글이 블라인드/삭제 상태인지 확인합니다.
*
* 답글 수정 폼에서 부모 원문 노출을 차단할지 판단하는 데 사용합니다.
* parent 관계가 로드되지 않았거나 부모가 없으면 false 를 반환합니다.
*
* @param Post $post 답글 게시글 모델
* @return bool 부모가 블라인드/삭제 상태인지 여부
*/
private function isParentBlindedOrDeleted(Post $post): bool
{
$parent = $post->parent;
if (! $parent) {
return false;
}
return $parent->status === PostStatus::Blinded
|| $parent->status === PostStatus::Deleted
|| $parent->deleted_at !== null;
}
/**
* 게시글 수정/삭제 권한을 확인합니다.
*
* 다음 조건 중 하나라도 만족하면 수정/삭제 가능:
* - 작성자 본인 (로그인 사용자의 user_id 일치)
* - 비회원 게시글인 경우 비밀번호 확인
* - 게시판 관리자 (admin.manage 권한)
* - 게시판 관리자 (admin.manage 또는 사용자 페이지 manager 권한)
* - 시스템 관리자 (Super Admin 역할)
*
* @param \Modules\Sirsoft\Board\Models\Post $post 게시글 모델
* @param Post $post 게시글 모델
* @param Request $request HTTP 요청
* @return bool 수정/삭제 가능 여부
*/
@@ -736,8 +839,8 @@ class PostController extends PublicBaseController
{
$slug = $post->board->slug;
// 1. 게시판 관리자 권한 확인 (admin.manage 권한)
if (Auth::check() && $this->checkBoardPermission($slug, 'admin.manage')) {
// 1. 게시판 관리 권한 확인 (admin.manage 또는 manager)
if ($this->hasBoardManagePermission($slug)) {
return true;
}
@@ -795,6 +898,7 @@ class PostController extends PublicBaseController
* @param User $user 사용자 모델 (Route Model Binding, uuid 기반)
* @return JsonResponse 게시글 목록 (페이지네이션)
*/
// audit:allow controller-base-request-injection reason: GET 사용자별 글 목록. per_page/sort 페이징 파라미터만 input()으로 읽음 (검증 불필요)
public function userPosts(Request $request, User $user): JsonResponse
{
try {