style: Laravel Pint 코드 포맷팅 적용

- PSR-12 스타일 가이드 준수 - 302개 파일 스타일 이슈 자동 수정 - 코드 로직 변경 없음 (포맷팅만)
2025-11-06 17:45:49 +09:00
parent 48e76432ee
commit cc206fdbed
294 changed files with 4476 additions and 2561 deletions
--- a/app/Swagger/v1/DepartmentApi.php
+++ b/app/Swagger/v1/DepartmentApi.php
@@ -21,6 +21,7 @@
 *   type="object",
 *   description="부서 상세",
 *   required={"id","name"},
+ *
 *   @OA\Property(property="id", type="integer", example=7),
 *   @OA\Property(property="tenant_id", type="integer", example=1),
 *   @OA\Property(property="code", type="string", nullable=true, example="OPS"),
@@ -37,6 +38,7 @@
 *   type="object",
 *   description="부서 요약",
 *   required={"id","name"},
+ *
 *   @OA\Property(property="id", type="integer", example=7),
 *   @OA\Property(property="code", type="string", nullable=true, example="OPS"),
 *   @OA\Property(property="name", type="string", example="운영팀"),
@@ -47,6 +49,7 @@
 * @OA\Schema(
 *   schema="DepartmentList",
 *   type="array",
+ *
 *   @OA\Items(ref="#/components/schemas/DepartmentBrief")
 * )
 *
@@ -54,6 +57,7 @@
 *   schema="DepartmentCreateRequest",
 *   type="object",
 *   required={"name"},
+ *
 *   @OA\Property(property="code", type="string", nullable=true, example="OPS"),
 *   @OA\Property(property="name", type="string", example="운영팀"),
 *   @OA\Property(property="description", type="string", nullable=true, example="서비스 운영 총괄"),
@@ -64,6 +68,7 @@
 * @OA\Schema(
 *   schema="DepartmentUpdateRequest",
 *   type="object",
+ *
 *   @OA\Property(property="code", type="string", nullable=true, example="OPS2"),
 *   @OA\Property(property="name", type="string", example="운영기획팀"),
 *   @OA\Property(property="description", type="string", nullable=true, example="운영 기획/성과 관리"),
@@ -75,6 +80,7 @@
 *   schema="DepartmentUserAttachRequest",
 *   type="object",
 *   required={"user_id"},
+ *
 *   @OA\Property(property="user_id", type="integer", example=12),
 *   @OA\Property(property="is_primary", type="integer", enum={0,1}, nullable=true, example=0),
 *   @OA\Property(property="joined_at", type="string", format="date-time", nullable=true, example="2025-08-21 10:00:00")
@@ -85,6 +91,7 @@
 *    type="object",
 *    description="부서원 요약",
 *    required={"id","name","email"},
+ *
 *    @OA\Property(property="id", type="integer", example=12),
 *    @OA\Property(property="name", type="string", example="홍길동"),
 *    @OA\Property(property="email", type="string", format="email", example="hong@example.com"),
@@ -96,6 +103,7 @@
 *   schema="DepartmentPermissionUpsertSingle",
 *   type="object",
 *   required={"permission_id"},
+ *
 *   @OA\Property(property="permission_id", type="integer", example=25),
 *   @OA\Property(property="is_allowed", type="integer", enum={0,1}, example=1, description="1=ALLOW, 0=DENY(차단)")
 * )
@@ -104,9 +112,11 @@
 *   schema="DepartmentPermissionUpsertMany",
 *   type="object",
 *   required={"items"},
+ *
 *   @OA\Property(
 *     property="items",
 *     type="array",
+ *
 *     @OA\Items(ref="#/components/schemas/DepartmentPermissionUpsertSingle")
 *   )
 * )
@@ -115,6 +125,7 @@
 *   schema="DepartmentPermissionRevokeSingle",
 *   type="object",
 *   required={"permission_id"},
+ *
 *   @OA\Property(property="permission_id", type="integer", example=25)
 * )
 *
@@ -122,14 +133,15 @@
 *   schema="DepartmentPermissionRevokeMany",
 *   type="object",
 *   required={"items"},
+ *
 *   @OA\Property(
 *     property="items",
 *     type="array",
+ *
 *     @OA\Items(ref="#/components/schemas/DepartmentPermissionRevokeSingle")
 *   )
 * )
 */
-
 class DepartmentApi
 {
    /**
@@ -139,12 +151,16 @@ class DepartmentApi
     *   description="테넌트 범위 내 부서 목록을 페이징으로 반환합니다. (q로 이름/코드 검색)",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="page", in="query", required=false, @OA\Schema(type="integer", example=1)),
     *   @OA\Parameter(name="per_page", in="query", required=false, @OA\Schema(type="integer", example=10)),
     *   @OA\Parameter(name="q", in="query", required=false, @OA\Schema(type="string", example="운영")),
     *   @OA\Parameter(name="is_active", in="query", required=false, @OA\Schema(type="integer", enum={0,1}, example=1)),
+     *
     *   @OA\Response(response=200, description="부서 목록 조회 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 목록 조회 성공"),
     *       @OA\Property(property="data", type="object",
@@ -155,6 +171,7 @@ class DepartmentApi
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -166,14 +183,19 @@ public function index() {}
     *   summary="부서 단건 조회",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\Response(response=200, description="부서 조회 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 조회 성공"),
     *       @OA\Property(property="data", ref="#/components/schemas/Department")
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -185,14 +207,19 @@ public function show() {}
     *   summary="부서 생성",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\RequestBody(required=true, @OA\JsonContent(ref="#/components/schemas/DepartmentCreateRequest")),
+     *
     *   @OA\Response(response=200, description="부서 생성 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 생성 성공"),
     *       @OA\Property(property="data", ref="#/components/schemas/Department")
     *     )
     *   ),
+     *
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -204,15 +231,21 @@ public function store() {}
     *   summary="부서 수정",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\RequestBody(required=true, @OA\JsonContent(ref="#/components/schemas/DepartmentUpdateRequest")),
+     *
     *   @OA\Response(response=200, description="부서 수정 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 수정 성공"),
     *       @OA\Property(property="data", ref="#/components/schemas/Department")
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -225,9 +258,13 @@ public function update() {}
     *   summary="부서 삭제(소프트)",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\Response(response=200, description="부서 삭제 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 삭제 성공"),
     *       @OA\Property(property="data", type="object",
@@ -236,6 +273,7 @@ public function update() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -248,11 +286,15 @@ public function destroy() {}
     *   description="해당 부서에 속한 사용자 목록을 페이징으로 반환합니다.",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
     *   @OA\Parameter(name="page", in="query", required=false, @OA\Schema(type="integer", example=1)),
     *   @OA\Parameter(name="per_page", in="query", required=false, @OA\Schema(type="integer", example=20)),
+     *
     *   @OA\Response(response=200, description="부서 사용자 목록 조회 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 사용자 목록 조회 성공"),
     *       @OA\Property(property="data", type="object",
@@ -263,6 +305,7 @@ public function destroy() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -274,10 +317,15 @@ public function users() {}
     *   summary="부서 사용자 배정(단건)",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\RequestBody(required=true, @OA\JsonContent(ref="#/components/schemas/DepartmentUserAttachRequest")),
+     *
     *   @OA\Response(response=200, description="부서 사용자 배정 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 사용자 배정 성공"),
     *       @OA\Property(property="data", type="object",
@@ -286,6 +334,7 @@ public function users() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=409, description="이미 배정됨", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=404, description="부서 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
@@ -299,10 +348,14 @@ public function attachUser() {}
     *   summary="부서 사용자 해제(단건)",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
     *   @OA\Parameter(name="user", in="path", required=true, @OA\Schema(type="integer", example=12)),
+     *
     *   @OA\Response(response=200, description="부서 사용자 해제 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 사용자 해제 성공"),
     *       @OA\Property(property="data", type="object",
@@ -311,6 +364,7 @@ public function attachUser() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -322,16 +376,23 @@ public function detachUser() {}
     *   summary="주부서 설정/해제",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
     *   @OA\Parameter(name="user", in="path", required=true, @OA\Schema(type="integer", example=12)),
+     *
     *   @OA\RequestBody(
     *     required=true,
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="is_primary", type="integer", enum={0,1}, example=1)
     *     )
     *   ),
+     *
     *   @OA\Response(response=200, description="주부서 설정 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="주부서 설정 성공"),
     *       @OA\Property(property="data", type="object",
@@ -341,6 +402,7 @@ public function detachUser() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="데이터 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -354,13 +416,17 @@ public function setPrimary() {}
     *   description="부서에 설정된 ALLOW/DENY 목록을 조회합니다. (is_allowed=1|0, menu_id 필터 지원)",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
     *   @OA\Parameter(name="menu_id", in="query", required=false, @OA\Schema(type="integer", example=101)),
     *   @OA\Parameter(name="is_allowed", in="query", required=false, @OA\Schema(type="integer", enum={0,1}, example=1)),
     *   @OA\Parameter(name="page", in="query", required=false, @OA\Schema(type="integer", example=1)),
     *   @OA\Parameter(name="per_page", in="query", required=false, @OA\Schema(type="integer", example=20)),
+     *
     *   @OA\Response(response=200, description="부서 권한 목록 조회 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 권한 목록 조회 성공"),
     *       @OA\Property(property="data", type="object",
@@ -368,7 +434,9 @@ public function setPrimary() {}
     *         @OA\Property(property="per_page", type="integer", example=20),
     *         @OA\Property(property="total", type="integer", example=3),
     *         @OA\Property(property="data", type="array",
+     *
     *           @OA\Items(type="object",
+     *
     *             @OA\Property(property="permission_id", type="integer", example=25),
     *             @OA\Property(property="permission_code", type="string", example="menu.101.read"),
     *             @OA\Property(property="is_allowed", type="integer", example=1),
@@ -380,6 +448,7 @@ public function setPrimary() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="부서 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -392,16 +461,23 @@ public function listPermissions() {}
     *   description="permission_id 기준으로 ALLOW(1) 또는 DENY(0) 처리합니다. 단건 또는 items 배열을 모두 지원합니다.",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\RequestBody(
     *     required=true,
+     *
     *     @OA\JsonContent(oneOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/DepartmentPermissionUpsertSingle"),
     *       @OA\Schema(ref="#/components/schemas/DepartmentPermissionUpsertMany")
     *     })
     *   ),
+     *
     *   @OA\Response(response=200, description="부서 권한 적용 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 권한 적용 성공"),
     *       @OA\Property(property="data", type="object",
@@ -411,6 +487,7 @@ public function listPermissions() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="부서 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -424,16 +501,23 @@ public function upsertPermission() {}
     *   description="지정 권한을 부서 매핑에서 제거합니다. 단건 또는 items 배열을 모두 지원합니다.",
     *   tags={"Department"},
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer", example=7)),
+     *
     *   @OA\RequestBody(
     *     required=true,
+     *
     *     @OA\JsonContent(oneOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/DepartmentPermissionRevokeSingle"),
     *       @OA\Schema(ref="#/components/schemas/DepartmentPermissionRevokeMany")
     *     })
     *   ),
+     *
     *   @OA\Response(response=200, description="부서 권한 해제 성공",
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="success", type="boolean", example=true),
     *       @OA\Property(property="message", type="string", example="부서 권한 해제 성공"),
     *       @OA\Property(property="data", type="object",
@@ -443,6 +527,7 @@ public function upsertPermission() {}
     *       )
     *     )
     *   ),
+     *
     *   @OA\Response(response=404, description="부서 없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )