fix: Swagger 경로 파라미터 라우트 일치 수정

- ItemsBomApi: {code} → {id} (10개 경로)
- BomCalculationApi: snake_case → camelCase 파라미터
- PermissionApi: {id} → 구체적 파라미터명 (dept_id, role_id, user_id)
- FieldProfileApi: opt-groups → settings/options, 중복 Fields 엔드포인트 제거

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-21 14:17:44 +09:00
parent 1449683aae
commit 3f4541e632
4 changed files with 47 additions and 205 deletions

View File

@@ -222,14 +222,14 @@ class BomCalculationApi
{
/**
* @OA\Get(
* path="/api/v1/design/models/{model_id}/estimate-parameters",
* path="/api/v1/design/models/{modelId}/estimate-parameters",
* summary="견적 파라미터 조회",
* description="특정 모델의 견적 시 필요한 입력 파라미터 스키마를 조회합니다. BOM에 정의된 조건만 동적으로 추출하여 반환합니다.",
* tags={"BOM Calculation"},
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
*
* @OA\Parameter(
* name="model_id",
* name="modelId",
* in="path",
* required=true,
* description="모델 ID",
@@ -265,14 +265,14 @@ public function getEstimateParameters() {}
/**
* @OA\Post(
* path="/api/v1/design/bom-templates/{bom_template_id}/calculate-bom",
* path="/api/v1/design/bom-templates/{bomTemplateId}/calculate-bom",
* summary="BOM 계산 실행",
* description="입력된 파라미터를 기반으로 BOM 수량을 동적으로 계산합니다. 업체별 산출식을 적용하여 실시간 견적을 생성합니다.",
* tags={"BOM Calculation"},
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
*
* @OA\Parameter(
* name="bom_template_id",
* name="bomTemplateId",
* in="path",
* required=true,
* description="BOM 템플릿 ID",
@@ -306,14 +306,14 @@ public function calculateBom() {}
/**
* @OA\Get(
* path="/api/v1/design/companies/{company_name}/formulas",
* path="/api/v1/design/companies/{companyName}/formulas",
* summary="업체별 산출식 목록 조회",
* description="특정 업체의 등록된 산출식 목록을 조회합니다.",
* tags={"BOM Calculation"},
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
*
* @OA\Parameter(
* name="company_name",
* name="companyName",
* in="path",
* required=true,
* description="업체명",
@@ -340,14 +340,14 @@ public function getCompanyFormulas() {}
/**
* @OA\Post(
* path="/api/v1/design/companies/{company_name}/formulas/{formula_type}",
* path="/api/v1/design/companies/{companyName}/formulas/{formulaType}",
* summary="업체별 산출식 등록/수정",
* description="특정 업체의 산출식을 등록하거나 수정합니다. 기존 산출식이 있으면 새 버전으로 업데이트됩니다.",
* tags={"BOM Calculation"},
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
*
* @OA\Parameter(
* name="company_name",
* name="companyName",
* in="path",
* required=true,
* description="업체명",
@@ -356,7 +356,7 @@ public function getCompanyFormulas() {}
* ),
*
* @OA\Parameter(
* name="formula_type",
* name="formulaType",
* in="path",
* required=true,
* description="산출식 타입",