kent
bf8036a64b
- DB 연결: 로컬/Docker 환경 오버라이딩 설정 (.env) - 테넌트 위젯: redirect 버그 수정 (TenantSelectorWidget) - 통계 위젯: 사용자/제품/자재/주문 카드 추가 (StatsOverviewWidget) - 리소스 한국어화: Product, Material 모델 레이블 추가 - 대시보드: 위젯 등록 및 캐시 최적화 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
278 lines
11 KiB
PHP
278 lines
11 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\V1\Design;
|
|
|
|
use App\Helpers\ApiResponse;
|
|
use App\Http\Controllers\Controller;
|
|
use App\Services\ModelFormulaService;
|
|
use App\Http\Requests\Api\V1\Design\ModelFormulaFormRequest;
|
|
use App\Http\Requests\Api\V1\ModelFormula\IndexModelFormulaRequest;
|
|
|
|
/**
|
|
* @OA\Tag(name="Model Formulas", description="Model formula management APIs")
|
|
*/
|
|
class ModelFormulaController extends Controller
|
|
{
|
|
public function __construct(
|
|
protected ModelFormulaService $service
|
|
) {}
|
|
|
|
/**
|
|
* @OA\Get(
|
|
* path="/v1/design/models/{modelId}/formulas",
|
|
* summary="Get model formulas",
|
|
* description="Retrieve all formulas for a specific model",
|
|
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
|
|
* tags={"Model Formulas"},
|
|
* @OA\Parameter(
|
|
* name="modelId",
|
|
* description="Model ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="page",
|
|
* description="Page number for pagination",
|
|
* in="query",
|
|
* required=false,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="per_page",
|
|
* description="Items per page",
|
|
* in="query",
|
|
* required=false,
|
|
* @OA\Schema(type="integer", example=20)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="search",
|
|
* description="Search by formula name or target parameter",
|
|
* in="query",
|
|
* required=false,
|
|
* @OA\Schema(type="string", example="calculate_area")
|
|
* ),
|
|
* @OA\Response(
|
|
* response=200,
|
|
* description="Model formulas retrieved successfully",
|
|
* @OA\JsonContent(
|
|
* allOf={
|
|
* @OA\Schema(ref="#/components/schemas/ApiResponse"),
|
|
* @OA\Schema(
|
|
* @OA\Property(
|
|
* property="data",
|
|
* @OA\Property(
|
|
* property="data",
|
|
* type="array",
|
|
* @OA\Items(ref="#/components/schemas/ModelFormulaResource")
|
|
* ),
|
|
* @OA\Property(property="current_page", type="integer", example=1),
|
|
* @OA\Property(property="last_page", type="integer", example=2),
|
|
* @OA\Property(property="per_page", type="integer", example=20),
|
|
* @OA\Property(property="total", type="integer", example=25)
|
|
* )
|
|
* )
|
|
* }
|
|
* )
|
|
* ),
|
|
* @OA\Response(ref="#/components/responses/ErrorResponse", response=400),
|
|
* @OA\Response(ref="#/components/responses/UnauthorizedResponse", response=401),
|
|
* @OA\Response(ref="#/components/responses/NotFoundResponse", response=404)
|
|
* )
|
|
*/
|
|
public function index(IndexModelFormulaRequest $request, int $modelId)
|
|
{
|
|
return ApiResponse::handle(function () use ($request, $modelId) {
|
|
return $this->service->getModelFormulas($modelId, $request->validated());
|
|
}, __('message.fetched'));
|
|
}
|
|
|
|
/**
|
|
* @OA\Post(
|
|
* path="/v1/design/models/{modelId}/formulas",
|
|
* summary="Create model formula",
|
|
* description="Create a new formula for a specific model",
|
|
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
|
|
* tags={"Model Formulas"},
|
|
* @OA\Parameter(
|
|
* name="modelId",
|
|
* description="Model ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\RequestBody(
|
|
* required=true,
|
|
* @OA\JsonContent(ref="#/components/schemas/CreateModelFormulaRequest")
|
|
* ),
|
|
* @OA\Response(
|
|
* response=201,
|
|
* description="Model formula created successfully",
|
|
* @OA\JsonContent(
|
|
* allOf={
|
|
* @OA\Schema(ref="#/components/schemas/ApiResponse"),
|
|
* @OA\Schema(
|
|
* @OA\Property(property="data", ref="#/components/schemas/ModelFormulaResource")
|
|
* )
|
|
* }
|
|
* )
|
|
* ),
|
|
* @OA\Response(ref="#/components/responses/ValidationErrorResponse", response=422),
|
|
* @OA\Response(ref="#/components/responses/ErrorResponse", response=400),
|
|
* @OA\Response(ref="#/components/responses/UnauthorizedResponse", response=401)
|
|
* )
|
|
*/
|
|
public function store(ModelFormulaFormRequest $request, int $modelId)
|
|
{
|
|
return ApiResponse::handle(function () use ($request, $modelId) {
|
|
return $this->service->createFormula($modelId, $request->validated());
|
|
}, __('message.created'));
|
|
}
|
|
|
|
/**
|
|
* @OA\Put(
|
|
* path="/v1/design/models/{modelId}/formulas/{formulaId}",
|
|
* summary="Update model formula",
|
|
* description="Update a specific model formula",
|
|
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
|
|
* tags={"Model Formulas"},
|
|
* @OA\Parameter(
|
|
* name="modelId",
|
|
* description="Model ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="formulaId",
|
|
* description="Formula ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\RequestBody(
|
|
* required=true,
|
|
* @OA\JsonContent(ref="#/components/schemas/UpdateModelFormulaRequest")
|
|
* ),
|
|
* @OA\Response(
|
|
* response=200,
|
|
* description="Model formula updated successfully",
|
|
* @OA\JsonContent(
|
|
* allOf={
|
|
* @OA\Schema(ref="#/components/schemas/ApiResponse"),
|
|
* @OA\Schema(
|
|
* @OA\Property(property="data", ref="#/components/schemas/ModelFormulaResource")
|
|
* )
|
|
* }
|
|
* )
|
|
* ),
|
|
* @OA\Response(ref="#/components/responses/ValidationErrorResponse", response=422),
|
|
* @OA\Response(ref="#/components/responses/ErrorResponse", response=400),
|
|
* @OA\Response(ref="#/components/responses/UnauthorizedResponse", response=401),
|
|
* @OA\Response(ref="#/components/responses/NotFoundResponse", response=404)
|
|
* )
|
|
*/
|
|
public function update(ModelFormulaFormRequest $request, int $modelId, int $formulaId)
|
|
{
|
|
return ApiResponse::handle(function () use ($request, $modelId, $formulaId) {
|
|
return $this->service->updateFormula($modelId, $formulaId, $request->validated());
|
|
}, __('message.updated'));
|
|
}
|
|
|
|
/**
|
|
* @OA\Delete(
|
|
* path="/v1/design/models/{modelId}/formulas/{formulaId}",
|
|
* summary="Delete model formula",
|
|
* description="Delete a specific model formula",
|
|
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
|
|
* tags={"Model Formulas"},
|
|
* @OA\Parameter(
|
|
* name="modelId",
|
|
* description="Model ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="formulaId",
|
|
* description="Formula ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Response(
|
|
* response=200,
|
|
* description="Model formula deleted successfully",
|
|
* @OA\JsonContent(ref="#/components/schemas/ApiResponse")
|
|
* ),
|
|
* @OA\Response(ref="#/components/responses/ErrorResponse", response=400),
|
|
* @OA\Response(ref="#/components/responses/UnauthorizedResponse", response=401),
|
|
* @OA\Response(ref="#/components/responses/NotFoundResponse", response=404)
|
|
* )
|
|
*/
|
|
public function destroy(int $modelId, int $formulaId)
|
|
{
|
|
return ApiResponse::handle(function () use ($modelId, $formulaId) {
|
|
$this->service->deleteFormula($modelId, $formulaId);
|
|
return null;
|
|
}, __('message.deleted'));
|
|
}
|
|
|
|
/**
|
|
* @OA\Post(
|
|
* path="/v1/design/models/{modelId}/formulas/{formulaId}/validate",
|
|
* summary="Validate model formula",
|
|
* description="Validate formula expression and dependencies",
|
|
* security={{"ApiKeyAuth": {}}, {"BearerAuth": {}}},
|
|
* tags={"Model Formulas"},
|
|
* @OA\Parameter(
|
|
* name="modelId",
|
|
* description="Model ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Parameter(
|
|
* name="formulaId",
|
|
* description="Formula ID",
|
|
* in="path",
|
|
* required=true,
|
|
* @OA\Schema(type="integer", example=1)
|
|
* ),
|
|
* @OA\Response(
|
|
* response=200,
|
|
* description="Formula validation result",
|
|
* @OA\JsonContent(
|
|
* allOf={
|
|
* @OA\Schema(ref="#/components/schemas/ApiResponse"),
|
|
* @OA\Schema(
|
|
* @OA\Property(
|
|
* property="data",
|
|
* @OA\Property(property="is_valid", type="boolean", example=true),
|
|
* @OA\Property(
|
|
* property="validation_errors",
|
|
* type="array",
|
|
* @OA\Items(type="string", example="Unknown variable: unknown_var")
|
|
* ),
|
|
* @OA\Property(
|
|
* property="dependency_chain",
|
|
* type="array",
|
|
* @OA\Items(type="string", example="W0")
|
|
* )
|
|
* )
|
|
* )
|
|
* }
|
|
* )
|
|
* ),
|
|
* @OA\Response(ref="#/components/responses/ErrorResponse", response=400),
|
|
* @OA\Response(ref="#/components/responses/UnauthorizedResponse", response=401),
|
|
* @OA\Response(ref="#/components/responses/NotFoundResponse", response=404)
|
|
* )
|
|
*/
|
|
public function validate(int $modelId, int $formulaId)
|
|
{
|
|
return ApiResponse::handle(function () use ($modelId, $formulaId) {
|
|
return $this->service->validateFormula($modelId, $formulaId);
|
|
}, __('message.formula.validated'));
|
|
}
|
|
} |