v7.0.0 release
This commit is contained in:
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', []);
|
||||
|
||||
+30
-9
@@ -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 {
|
||||
|
||||
Reference in new issue
Block a user