sam-docs/projects/quotation/phase-2-mng-analysis/current-state.md

mng 견적 수식 관리 현재 상태

분석일: 2025-12-19 대상: mng 프로젝트 quote-formulas 기능

---

1. 데이터베이스 구조

테이블 목록 (5개)

마이그레이션: api/database/migrations/2025_12_04_133410_create_quote_formula_tables.php

테이블	설명	주요 컬럼
quote_formula_categories	수식 카테고리	code, name, sort_order
quote_formulas	수식 정의	variable, type, formula, output_type
quote_formula_ranges	범위별 값	min_value, max_value, condition_variable
quote_formula_mappings	매핑 값	source_variable, source_value, result_value
quote_formula_items	품목 출력	item_code, quantity_formula, unit_price_formula

ERD 관계

quote_formula_categories (1) ──< (N) quote_formulas
                                      │
                                      ├──< (N) quote_formula_ranges
                                      ├──< (N) quote_formula_mappings
                                      └──< (N) quote_formula_items

수식 유형 (type)

값	설명	사용 예시
input	입력값	W0 (가로), H0 (세로)
calculation	계산식	W1 = W0 + 50
range	범위별 조건	면적별 검사비
mapping	매핑 조건	설치유형별 값

출력 유형 (output_type)

값	설명
variable	변수로 저장 (다음 수식에서 참조 가능)
item	품목으로 출력 (견적서에 표시)

---

2. 모델 구조

파일 위치

mng/app/Models/Quote/
├── QuoteFormulaCategory.php   # 카테고리
├── QuoteFormula.php           # 수식 (메인)
├── QuoteFormulaRange.php      # 범위 규칙
├── QuoteFormulaMapping.php    # 매핑 규칙
└── QuoteFormulaItem.php       # 품목 출력

QuoteFormula 모델 상세

// 상수 정의
TYPE_INPUT = 'input'
TYPE_CALCULATION = 'calculation'
TYPE_RANGE = 'range'
TYPE_MAPPING = 'mapping'

OUTPUT_VARIABLE = 'variable'
OUTPUT_ITEM = 'item'

// Traits
use BelongsToTenant, SoftDeletes;

// 관계
category() → BelongsTo
ranges() → HasMany
mappings() → HasMany
items() → HasMany
creator() → BelongsTo (User)
updater() → BelongsTo (User)

// Scopes
scopeCommon() → 공통 수식 (product_id IS NULL)
scopeForProduct($productId) → 제품별 수식
scopeActive() → 활성 수식
scopeOrdered() → 정렬
scopeOfType($type) → 유형별 필터

---

3. 서비스 구조

QuoteFormulaService

파일: mng/app/Services/Quote/QuoteFormulaService.php

메서드	설명
getFormulas()	수식 목록 (페이지네이션, 필터)
getFormulasByCategory()	카테고리별 수식 (실행 순서용)
getFormulaById()	수식 상세 조회
createFormula()	수식 생성 (트랜잭션)
updateFormula()	수식 수정 (트랜잭션)
deleteFormula()	수식 삭제 (Soft Delete)
toggleActive()	활성/비활성 토글
duplicateFormula()	수식 복제
reorder()	순서 변경
isVariableExists()	변수명 중복 체크
getAvailableVariables()	사용 가능한 변수 목록
getFormulaStats()	수식 통계

FormulaEvaluatorService

파일: mng/app/Services/Quote/FormulaEvaluatorService.php

메서드	설명
validateFormula()	수식 문법 검증
evaluate()	단일 수식 평가
evaluateRange()	범위별 수식 평가
evaluateMapping()	매핑 수식 평가
executeAll()	전체 수식 실행 (카테고리 순서)
getErrors()	에러 목록 반환
getVariables()	현재 변수 상태
resetVariables()	변수 초기화

지원 함수

SUM, ROUND, CEIL, FLOOR, ABS, MIN, MAX, IF, AND, OR, NOT

---

4. 컨트롤러 구조

Web 컨트롤러

파일: mng/app/Http/Controllers/QuoteFormulaController.php

메서드	URL	설명
index()	/quote-formulas	수식 목록 화면
create()	/quote-formulas/create	수식 생성 화면
edit()	/quote-formulas/{id}/edit	수식 수정 화면
categories()	/quote-formulas/categories	카테고리 목록
simulator()	/quote-formulas/simulator	시뮬레이터

API 컨트롤러

파일: mng/app/Http/Controllers/Api/Admin/Quote/QuoteFormulaController.php

메서드	HTTP	URL	설명
index()	GET	/api/admin/quote-formulas/formulas	목록 (HTMX)
store()	POST	/api/admin/quote-formulas/formulas	생성
show()	GET	/api/admin/quote-formulas/formulas/{id}	상세
update()	PUT	/api/admin/quote-formulas/formulas/{id}	수정
destroy()	DELETE	/api/admin/quote-formulas/formulas/{id}	삭제
restore()	POST	/api/admin/quote-formulas/formulas/{id}/restore	복원
forceDestroy()	DELETE	/api/admin/quote-formulas/formulas/{id}/force	영구삭제
toggleActive()	POST	/api/admin/quote-formulas/formulas/{id}/toggle-active	토글
duplicate()	POST	/api/admin/quote-formulas/formulas/{id}/duplicate	복제
reorder()	POST	/api/admin/quote-formulas/formulas/reorder	순서변경
variables()	GET	/api/admin/quote-formulas/formulas/variables	변수목록
validate()	POST	/api/admin/quote-formulas/formulas/validate	수식검증
test()	POST	/api/admin/quote-formulas/formulas/test	수식테스트
simulate()	POST	/api/admin/quote-formulas/formulas/simulate	시뮬레이션
stats()	GET	/api/admin/quote-formulas/formulas/stats	통계

---

5. View 구조

mng/resources/views/quote-formulas/
├── index.blade.php              # 수식 목록 메인
├── create.blade.php             # 수식 생성 폼
├── edit.blade.php               # 수식 수정 폼
├── simulator.blade.php          # 시뮬레이터
├── categories/
│   ├── index.blade.php          # 카테고리 목록
│   ├── create.blade.php         # 카테고리 생성
│   ├── edit.blade.php           # 카테고리 수정
│   └── partials/
│       └── table.blade.php      # 카테고리 테이블 (HTMX)
└── partials/
    └── table.blade.php          # 수식 테이블 (HTMX)

UI 특징

• HTMX 기반: 페이지 새로고침 없이 데이터 갱신
• 필터링: 카테고리, 유형, 활성상태, 검색
• Soft Delete: 삭제/복원/영구삭제 지원
• 드래그 정렬: 순서 변경 기능

---

6. FormRequest

mng/app/Http/Requests/Quote/
├── StoreQuoteFormulaCategoryRequest.php
├── UpdateQuoteFormulaCategoryRequest.php
├── StoreQuoteFormulaRequest.php
└── UpdateQuoteFormulaRequest.php

---

7. 라우트 정의

Web Routes (routes/web.php)

Route::prefix('quote-formulas')->name('quote-formulas.')->group(function () {
    Route::get('/', [QuoteFormulaController::class, 'index'])->name('index');
    Route::get('/create', [QuoteFormulaController::class, 'create'])->name('create');
    Route::get('/{id}/edit', [QuoteFormulaController::class, 'edit'])->name('edit');
    Route::get('/categories', [QuoteFormulaController::class, 'categories'])->name('categories.index');
    Route::get('/categories/create', [QuoteFormulaController::class, 'createCategory'])->name('categories.create');
    Route::get('/categories/{id}/edit', [QuoteFormulaController::class, 'editCategory'])->name('categories.edit');
    Route::get('/simulator', [QuoteFormulaController::class, 'simulator'])->name('simulator');
});

API Routes (routes/api.php)

30+ 개의 API 엔드포인트 정의 (카테고리 CRUD + 수식 CRUD + 추가 기능)

---

8. 수식 실행 흐름

1. 입력값 수집 (W0, H0, 설치유형 등)
   ↓
2. 카테고리 순서대로 수식 조회
   ↓
3. 각 수식 실행
   ├─ TYPE_INPUT: 입력값 또는 기본값
   ├─ TYPE_CALCULATION: 수식 계산
   ├─ TYPE_RANGE: 범위 조건 평가
   └─ TYPE_MAPPING: 매핑 조건 평가
   ↓
4. 결과 저장
   ├─ OUTPUT_VARIABLE: 변수로 저장 (다음 수식에서 참조)
   └─ OUTPUT_ITEM: 품목 목록에 추가
   ↓
5. 최종 결과 반환
   ├─ variables: 계산된 변수 목록
   ├─ items: 품목 목록 (품명, 수량, 단가, 금액)
   └─ errors: 오류 목록

---

9. 현재 데이터 상태

⚠️ 주의: 테이블이 비어있음 (수식 데이터 미입력)

Phase 3에서 5130 분석 결과를 기반으로 수식 데이터를 입력해야 합니다.

---

참조

• README.md - 분석 요약
• issues.md - 문제점 및 개선사항