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/DesignModelApi.php
+++ b/app/Swagger/v1/DesignModelApi.php
@@ -17,6 +17,7 @@
 *   schema="DesignModel",
 *   type="object",
 *   required={"id","tenant_id","code","name"},
+ *
 *   @OA\Property(property="id", type="integer", example=101),
 *   @OA\Property(property="tenant_id", type="integer", example=1),
 *   @OA\Property(property="code", type="string", example="KSS01"),
@@ -34,6 +35,7 @@
 *   schema="DesignModelPagination",
 *   type="object",
 *   description="라라벨 LengthAwarePaginator",
+ *
 *   @OA\Property(property="current_page", type="integer", example=1),
 *   @OA\Property(property="data", type="array", @OA\Items(ref="#/components/schemas/DesignModel")),
 *   @OA\Property(property="first_page_url", type="string", example="/api/v1/design/models?page=1"),
@@ -58,6 +60,7 @@
 *   schema="ModelVersion",
 *   type="object",
 *   required={"id","tenant_id","model_id","version_no","status"},
+ *
 *   @OA\Property(property="id", type="integer", example=201),
 *   @OA\Property(property="tenant_id", type="integer", example=1),
 *   @OA\Property(property="model_id", type="integer", example=101),
@@ -76,6 +79,7 @@
 *   schema="BomTemplate",
 *   type="object",
 *   required={"id","tenant_id","model_version_id","name"},
+ *
 *   @OA\Property(property="id", type="integer", example=301),
 *   @OA\Property(property="tenant_id", type="integer", example=1),
 *   @OA\Property(property="model_version_id", type="integer", example=201),
@@ -92,6 +96,7 @@
 *   schema="BomTemplateItem",
 *   type="object",
 *   required={"id","tenant_id","bom_template_id","ref_type","ref_id","qty"},
+ *
 *   @OA\Property(property="id", type="integer", example=401),
 *   @OA\Property(property="tenant_id", type="integer", example=1),
 *   @OA\Property(property="bom_template_id", type="integer", example=301),
@@ -110,12 +115,15 @@
 *   schema="BomTemplateItemReplaceRequest",
 *   type="object",
 *   required={"items"},
+ *
 *   @OA\Property(
 *     property="items",
 *     type="array",
+ *
 *     @OA\Items(
 *       type="object",
 *       required={"ref_type","ref_id","qty"},
+ *
 *       @OA\Property(property="ref_type", type="string", enum={"MATERIAL","PRODUCT"}, example="MATERIAL"),
 *       @OA\Property(property="ref_id", type="integer", example=101),
 *       @OA\Property(property="qty", type="number", format="double", example=2),
@@ -140,18 +148,23 @@ class DesignModelApi
     *   summary="모델 목록",
     *   description="모델(설계 상위) 목록을 페이징으로 조회합니다.",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="q", in="query", description="검색어(code/name/description like)", @OA\Schema(type="string")),
     *   @OA\Parameter(ref="#/components/parameters/Page"),
     *   @OA\Parameter(ref="#/components/parameters/Size"),
+     *
     *   @OA\Response(
     *     response=200, description="조회 성공",
+     *
     *     @OA\JsonContent(
     *       allOf={
+     *
     *         @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *         @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/DesignModelPagination"))
     *       }
     *     )
     *   ),
+     *
     *   @OA\Response(response=401, description="인증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=500, description="서버 에러", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -165,10 +178,13 @@ public function index() {}
     *   summary="모델 생성",
     *   description="모델(설계 상위)을 생성합니다.",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\RequestBody(
     *     required=true,
+     *
     *     @OA\JsonContent(
     *       required={"code","name"},
+     *
     *       @OA\Property(property="code", type="string", maxLength=100, example="KSS01"),
     *       @OA\Property(property="name", type="string", maxLength=200, example="KSS 표준 모델"),
     *       @OA\Property(property="category_id", type="integer", nullable=true, example=12),
@@ -177,10 +193,13 @@ public function index() {}
     *       @OA\Property(property="is_active", type="boolean", example=true)
     *     )
     *   ),
+     *
     *   @OA\Response(response=200, description="등록 성공", @OA\JsonContent(allOf={
+     *
     *     @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *     @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/DesignModel"))
     *   })),
+     *
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -193,11 +212,15 @@ public function store() {}
     *   summary="모델 상세",
     *   description="단일 모델을 조회합니다. (versions 포함 가능)",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="조회 성공", @OA\JsonContent(allOf={
+     *
     *     @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *     @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/DesignModel"))
     *   })),
+     *
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -209,10 +232,14 @@ public function show() {}
     *   tags={"Model"},
     *   summary="모델 수정",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\RequestBody(
     *     required=true,
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="code", type="string", maxLength=100, example="KSS01"),
     *       @OA\Property(property="name", type="string", maxLength=200, example="KSS 표준 모델(개정)"),
     *       @OA\Property(property="category_id", type="integer", nullable=true, example=12),
@@ -221,6 +248,7 @@ public function show() {}
     *       @OA\Property(property="is_active", type="boolean", example=true)
     *     )
     *   ),
+     *
     *   @OA\Response(response=200, description="수정 성공", @OA\JsonContent(ref="#/components/schemas/ApiResponse")) ,
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -233,7 +261,9 @@ public function update() {}
     *   tags={"Model"},
     *   summary="모델 삭제(soft)",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="삭제 성공", @OA\JsonContent(ref="#/components/schemas/ApiResponse")),
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -252,13 +282,18 @@ class ModelVersionApi
     *   tags={"ModelVersion"},
     *   summary="모델의 버전 목록",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="modelId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="조회 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", type="array", @OA\Items(ref="#/components/schemas/ModelVersion")))
     *     })
     *   ),
+     *
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -271,22 +306,30 @@ public function listVersions() {}
     *   summary="버전 DRAFT 생성",
     *   description="version_no 미지정 시 자동 증가",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="modelId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\RequestBody(
     *     required=false,
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="version_no", type="integer", nullable=true, example=1),
     *       @OA\Property(property="notes", type="string", nullable=true, example="초안 메모"),
     *       @OA\Property(property="effective_from", type="string", format="date-time", nullable=true),
     *         @OA\Property(property="effective_to", type="string", format="date-time", nullable=true)
     *     )
     *   ),
+     *
     *   @OA\Response(response=200, description="생성 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/ModelVersion"))
     *     })
     *   ),
+     *
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -298,13 +341,18 @@ public function createDraft() {}
     *   tags={"ModelVersion"},
     *   summary="버전 RELEASED 전환",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="versionId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="전환 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/ModelVersion"))
     *     })
     *   ),
+     *
     *   @OA\Response(response=409, description="상태 충돌", @OA\JsonContent(ref="#/components/schemas/ErrorResponse")),
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
@@ -323,13 +371,18 @@ class BomTemplateApi
     *   tags={"BomTemplate"},
     *   summary="모델버전의 BOM 템플릿 목록",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="versionId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="조회 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", type="array", @OA\Items(ref="#/components/schemas/BomTemplate")))
     *     })
     *   ),
+     *
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -342,21 +395,29 @@ public function listByVersion() {}
     *   summary="BOM 템플릿 upsert (name 기준)",
     *   description="is_primary=true 지정 시 동일 모델버전의 기존 대표 템플릿은 자동 해제",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="versionId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\RequestBody(
     *     required=false,
+     *
     *     @OA\JsonContent(
+     *
     *       @OA\Property(property="name", type="string", maxLength=100, example="Main"),
     *       @OA\Property(property="is_primary", type="boolean", example=true),
     *       @OA\Property(property="notes", type="string", nullable=true, example="표준 템플릿")
     *     )
     *   ),
+     *
     *   @OA\Response(response=200, description="저장 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/BomTemplate"))
     *     })
     *   ),
+     *
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -368,13 +429,18 @@ public function upsertTemplate() {}
     *   tags={"BomTemplate"},
     *   summary="BOM 템플릿 상세 (항목 포함)",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="templateId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\Response(response=200, description="조회 성공",
+     *
     *     @OA\JsonContent(allOf={
+     *
     *       @OA\Schema(ref="#/components/schemas/ApiResponse"),
     *       @OA\Schema(@OA\Property(property="data", ref="#/components/schemas/BomTemplate"))
     *     })
     *   ),
+     *
     *   @OA\Response(response=404, description="없음", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )
     */
@@ -387,8 +453,11 @@ public function show() {}
     *   summary="BOM 항목 일괄 치환",
     *   description="기존 항목을 모두 삭제 후 본문 items로 재삽입",
     *   security={{"ApiKeyAuth": {}},{"BearerAuth": {}}},
+     *
     *   @OA\Parameter(name="templateId", in="path", required=true, @OA\Schema(type="integer")),
+     *
     *   @OA\RequestBody(required=true, @OA\JsonContent(ref="#/components/schemas/BomTemplateItemReplaceRequest")),
+     *
     *   @OA\Response(response=200, description="저장 성공", @OA\JsonContent(ref="#/components/schemas/ApiResponse")),
     *   @OA\Response(response=422, description="검증 실패", @OA\JsonContent(ref="#/components/schemas/ErrorResponse"))
     * )