sam-docs/projects/quotation/phase-3-implementation/table-mapping.md

Phase 3 테이블 매핑

구현일: 2025-12-19 정책 참조: PROJECT_DEVELOPMENT_POLICY.md

---

1. 단가 테이블 매핑

5130 테이블 → SAM 테이블

5130 테이블	SAM 테이블	상태	비고
price_screen	prices	✅ 통합	item_type_code='PRODUCT'
price_slat	prices	✅ 통합	item_type_code='PRODUCT'
price_motor	prices	✅ 통합	item_type_code='PRODUCT'
price_controller	prices	✅ 통합	item_type_code='PRODUCT'
price_parts	prices	✅ 통합	item_type_code='MATERIAL'

prices 테이블 구조

CREATE TABLE prices (
    id BIGINT PRIMARY KEY,
    tenant_id BIGINT NOT NULL,

    -- 품목 연결 (5130 분산 → SAM 통합)
    item_type_code VARCHAR(20) NOT NULL,  -- 'PRODUCT' / 'MATERIAL'
    item_id BIGINT NOT NULL,              -- products.id 또는 materials.id
    client_group_id BIGINT NULL,          -- 고객그룹별 단가 (NULL=기본가)

    -- 원가 정보
    purchase_price DECIMAL(15,4),         -- 매입단가
    processing_cost DECIMAL(15,4),        -- 가공비
    loss_rate DECIMAL(5,2),               -- LOSS율 (%)

    -- 판매가 정보
    margin_rate DECIMAL(5,2),             -- 마진율 (%)
    sales_price DECIMAL(15,4),            -- 판매단가 (★ 견적에서 사용)

    -- 적용 기간
    effective_from DATE NOT NULL,
    effective_to DATE NULL,

    -- 상태
    status ENUM('draft','active','inactive','finalized'),

    -- 감사
    created_at, updated_at, deleted_at
);

---

2. 수식 테이블 매핑

5130 → SAM 구조 비교

5130	SAM	비고
JS 하드코딩	quote_formula_categories	카테고리 분류
JS 하드코딩	quote_formulas	수식 정의
PHP 함수	quote_formula_ranges	범위별 조건
PHP 조건문	quote_formula_mappings	매핑 조건
-	quote_formula_items	품목 출력

quote_formulas 테이블 구조

CREATE TABLE quote_formulas (
    id BIGINT PRIMARY KEY,
    tenant_id BIGINT NOT NULL,
    category_id BIGINT NOT NULL,          -- FK: quote_formula_categories
    product_id BIGINT NULL,               -- 특정 제품용 (NULL=공통)

    -- 수식 정보
    name VARCHAR(200) NOT NULL,
    variable VARCHAR(50) NOT NULL,        -- 변수명 (W0, H0, M, K 등)
    type ENUM('input','calculation','range','mapping'),
    formula TEXT NULL,                    -- 계산식
    output_type ENUM('variable','item'),  -- 결과 유형

    -- 메타
    description TEXT,
    sort_order INT,
    is_active BOOLEAN DEFAULT TRUE,

    -- 감사
    created_at, updated_at, deleted_at
);

---

3. 품목 코드 매핑 로직

조회 흐름

quote_formula_items.item_code
        ↓
FormulaEvaluatorService::getItemPrice($itemCode)
        ↓
Price::getSalesPriceByItemCode($tenantId, $itemCode)
        ↓
    ┌───────────────────────────────────────┐
    │ 1. products 테이블 검색               │
    │    WHERE tenant_id = $tenantId        │
    │    AND code = $itemCode               │
    │    AND deleted_at IS NULL             │
    └───────────────────────────────────────┘
        ↓ (발견시)
    ┌───────────────────────────────────────┐
    │ Price::getCurrentPrice()              │
    │    item_type_code = 'PRODUCT'         │
    │    item_id = $product->id             │
    └───────────────────────────────────────┘
        ↓
    prices.sales_price 반환

품목 코드 규칙

분류	코드 형식 예시	설명
스크린 제품	KS-100-SC	스크린 주자재
철재 제품	KS-200-ST	철재(슬랫) 주자재
모터	MT-300K	모터 300K
케이스	PT-CASE-2438	케이스 2438mm
가이드레일	GR-65x80	가이드레일 65x80

---

4. 5130 수식 항목 → SAM 변수 매핑

기본 변수

5130 명칭	SAM 변수	수식 유형
오픈 가로	W0	input
오픈 세로	H0	input
제작 가로	W1	calculation
제작 세로	H1	calculation
면적	M	calculation
중량	K	calculation

항목별 변수

5130 항목	SAM 변수	수식 유형	비고
검사비	INSP_FEE	calculation	고정 1EA
주자재	MAT_PRICE	calculation	면적 × 단가
모터	MOTOR_SELECT	range	중량 기준 선택
제어기	CTRL_SELECT	mapping	설치유형별
케이스	CASE_SELECT	range	길이 기준 선택
가이드레일	GR_SELECT	range	길이 기준 선택
마구리	EDGE_QTY	calculation	날개치수/50

---

5. 신규 테이블 생성 불필요

정책 준수 확인

항목	상태	비고
기존 테이블 활용	✅	prices, quote_formulas 등
신규 테이블 생성	❌ 불필요	기존 구조 활용
컬럼 추가	❌ 불필요	기존 컬럼 활용
DB 마이그레이션	❌ 불필요	Seeder만 실행

---

참조

• README.md
• implementation.md
• Phase 1: db-structure.md
• PROJECT_DEVELOPMENT_POLICY.md