Files
sam-manage/app/Http/Controllers/Api/Admin/Quote/QuoteFormulaController.php
hskwon dac02f120b 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개 라우트
2025-12-04 14:00:24 +09:00

312 lines
8.4 KiB
PHP

<?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,
]);
}
}