feat(quote-formulas): 견적수식 관리 기능 구현
## 구현 내용 ### 모델 (5개) - QuoteFormulaCategory: 수식 카테고리 - QuoteFormula: 수식 정의 (input/calculation/range/mapping) - QuoteFormulaRange: 범위별 값 정의 - QuoteFormulaMapping: 매핑 테이블 - QuoteFormulaItem: 수식-품목 연결 ### 서비스 (3개) - QuoteFormulaCategoryService: 카테고리 CRUD - QuoteFormulaService: 수식 CRUD, 복제, 재정렬 - FormulaEvaluatorService: 수식 계산 엔진 - 지원 함수: SUM, ROUND, CEIL, FLOOR, ABS, MIN, MAX, IF, AND, OR, NOT ### API Controller (2개) - QuoteFormulaCategoryController: 카테고리 API (11개 엔드포인트) - QuoteFormulaController: 수식 API (16개 엔드포인트) ### FormRequest (4개) - Store/Update QuoteFormulaCategoryRequest - Store/Update QuoteFormulaRequest ### Blade Views (8개) - 수식 목록/추가/수정/시뮬레이터 - 카테고리 목록/추가/수정 - HTMX 테이블 partial ### 라우트 - API: 27개 엔드포인트 - Web: 7개 라우트
This commit is contained in:
311
app/Http/Controllers/Api/Admin/Quote/QuoteFormulaController.php
Normal file
311
app/Http/Controllers/Api/Admin/Quote/QuoteFormulaController.php
Normal file
@@ -0,0 +1,311 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\Admin\Quote;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Quote\StoreQuoteFormulaRequest;
|
||||
use App\Http\Requests\Quote\UpdateQuoteFormulaRequest;
|
||||
use App\Services\Quote\FormulaEvaluatorService;
|
||||
use App\Services\Quote\QuoteFormulaService;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\View\View;
|
||||
|
||||
class QuoteFormulaController extends Controller
|
||||
{
|
||||
public function __construct(
|
||||
private readonly QuoteFormulaService $formulaService,
|
||||
private readonly FormulaEvaluatorService $evaluatorService
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 수식 목록 (HTMX용)
|
||||
*/
|
||||
public function index(Request $request): View|JsonResponse
|
||||
{
|
||||
$filters = $request->only(['search', 'category_id', 'type', 'is_active', 'trashed', 'sort_by', 'sort_direction']);
|
||||
$formulas = $this->formulaService->getFormulas($filters, 15);
|
||||
|
||||
// HTMX 요청이면 HTML 파셜 반환
|
||||
if ($request->header('HX-Request')) {
|
||||
return view('quote-formulas.partials.table', compact('formulas'));
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'data' => $formulas,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 통계
|
||||
*/
|
||||
public function stats(): JsonResponse
|
||||
{
|
||||
$stats = $this->formulaService->getFormulaStats();
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'data' => $stats,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 상세 조회
|
||||
*/
|
||||
public function show(int $id): JsonResponse
|
||||
{
|
||||
$formula = $this->formulaService->getFormulaById($id, true);
|
||||
|
||||
if (! $formula) {
|
||||
return response()->json([
|
||||
'success' => false,
|
||||
'message' => '수식을 찾을 수 없습니다.',
|
||||
], 404);
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'data' => $formula,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 생성
|
||||
*/
|
||||
public function store(StoreQuoteFormulaRequest $request): JsonResponse
|
||||
{
|
||||
$validated = $request->validated();
|
||||
|
||||
// 변수명 중복 체크
|
||||
if ($this->formulaService->isVariableExists($validated['variable'])) {
|
||||
return response()->json([
|
||||
'success' => false,
|
||||
'message' => '이미 사용 중인 변수명입니다.',
|
||||
], 422);
|
||||
}
|
||||
|
||||
$formula = $this->formulaService->createFormula($validated);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 생성되었습니다.',
|
||||
'data' => $formula,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 수정
|
||||
*/
|
||||
public function update(UpdateQuoteFormulaRequest $request, int $id): JsonResponse
|
||||
{
|
||||
$validated = $request->validated();
|
||||
|
||||
// 변수명 중복 체크 (자신 제외)
|
||||
if (isset($validated['variable']) && $this->formulaService->isVariableExists($validated['variable'], $id)) {
|
||||
return response()->json([
|
||||
'success' => false,
|
||||
'message' => '이미 사용 중인 변수명입니다.',
|
||||
], 422);
|
||||
}
|
||||
|
||||
$this->formulaService->updateFormula($id, $validated);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 수정되었습니다.',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 삭제 (Soft Delete)
|
||||
*/
|
||||
public function destroy(int $id): JsonResponse
|
||||
{
|
||||
$this->formulaService->deleteFormula($id);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 삭제되었습니다.',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 복원
|
||||
*/
|
||||
public function restore(int $id): JsonResponse
|
||||
{
|
||||
$this->formulaService->restoreFormula($id);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 복원되었습니다.',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 영구 삭제
|
||||
*/
|
||||
public function forceDestroy(int $id): JsonResponse
|
||||
{
|
||||
$this->formulaService->forceDeleteFormula($id);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 영구 삭제되었습니다.',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 활성/비활성 토글
|
||||
*/
|
||||
public function toggleActive(int $id): JsonResponse
|
||||
{
|
||||
$formula = $this->formulaService->toggleActive($id);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => $formula->is_active ? '수식이 활성화되었습니다.' : '수식이 비활성화되었습니다.',
|
||||
'data' => ['is_active' => $formula->is_active],
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 카테고리별 수식 목록 (실행 순서)
|
||||
*/
|
||||
public function byCategory(int $categoryId): JsonResponse
|
||||
{
|
||||
$formulas = $this->formulaService->getFormulasByCategory($categoryId);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'data' => $formulas,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 순서 변경
|
||||
*/
|
||||
public function reorder(Request $request): JsonResponse
|
||||
{
|
||||
$validated = $request->validate([
|
||||
'formula_ids' => 'required|array',
|
||||
'formula_ids.*' => 'integer|exists:quote_formulas,id',
|
||||
]);
|
||||
|
||||
$this->formulaService->reorder($validated['formula_ids']);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '순서가 변경되었습니다.',
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 사용 가능한 변수 목록
|
||||
*/
|
||||
public function variables(): JsonResponse
|
||||
{
|
||||
$variables = $this->formulaService->getAvailableVariables();
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'data' => $variables,
|
||||
]);
|
||||
}
|
||||
|
||||
// =========================================================================
|
||||
// 수식 검증 및 테스트 API
|
||||
// =========================================================================
|
||||
|
||||
/**
|
||||
* 수식 문법 검증
|
||||
*/
|
||||
public function validate(Request $request): JsonResponse
|
||||
{
|
||||
$validated = $request->validate([
|
||||
'formula' => 'required|string|max:2000',
|
||||
]);
|
||||
|
||||
$result = $this->evaluatorService->validateFormula($validated['formula']);
|
||||
|
||||
return response()->json([
|
||||
'success' => $result['success'],
|
||||
'data' => $result,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 단일 수식 테스트 실행
|
||||
*/
|
||||
public function test(Request $request): JsonResponse
|
||||
{
|
||||
$validated = $request->validate([
|
||||
'formula' => 'required|string|max:2000',
|
||||
'variables' => 'nullable|array',
|
||||
]);
|
||||
|
||||
$this->evaluatorService->resetVariables();
|
||||
|
||||
$result = $this->evaluatorService->evaluate(
|
||||
$validated['formula'],
|
||||
$validated['variables'] ?? []
|
||||
);
|
||||
|
||||
$errors = $this->evaluatorService->getErrors();
|
||||
|
||||
return response()->json([
|
||||
'success' => empty($errors),
|
||||
'data' => [
|
||||
'result' => $result,
|
||||
'errors' => $errors,
|
||||
],
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 전체 수식 시뮬레이션
|
||||
*/
|
||||
public function simulate(Request $request): JsonResponse
|
||||
{
|
||||
$validated = $request->validate([
|
||||
'category_id' => 'nullable|integer|exists:quote_formula_categories,id',
|
||||
'input_variables' => 'required|array',
|
||||
]);
|
||||
|
||||
// 카테고리별 수식 조회
|
||||
$categoryId = $validated['category_id'] ?? null;
|
||||
$formulas = $categoryId
|
||||
? $this->formulaService->getFormulasByCategory($categoryId)
|
||||
: $this->formulaService->getAllActiveFormulas();
|
||||
|
||||
// 카테고리별로 그룹핑
|
||||
$formulasByCategory = $formulas->groupBy(fn ($f) => $f->category->code);
|
||||
|
||||
// 전체 실행
|
||||
$this->evaluatorService->resetVariables();
|
||||
$result = $this->evaluatorService->executeAll(
|
||||
$formulasByCategory,
|
||||
$validated['input_variables']
|
||||
);
|
||||
|
||||
return response()->json([
|
||||
'success' => empty($result['errors']),
|
||||
'data' => $result,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 수식 복제
|
||||
*/
|
||||
public function duplicate(int $id): JsonResponse
|
||||
{
|
||||
$formula = $this->formulaService->duplicateFormula($id);
|
||||
|
||||
return response()->json([
|
||||
'success' => true,
|
||||
'message' => '수식이 복제되었습니다.',
|
||||
'data' => $formula,
|
||||
]);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user