huni-printing-estimator

name: huni-printing-estimator description: | 후니프린팅 통합 관리 시스템: 자동 견적 + 외주 정산 자동화

🔹 견적/가격: "견적 계산", "가격 알려줘", "얼마야", "무선책자 100부" 🔹 조판/CTP: "CTP 몇 판?", "조판 어떻게?", "판수 계산" 🔹 옵션 검증: "이 옵션 가능해?", "박가공 선택하면?" 🔹 파일 가이드: "파일 어떻게 만들어?", "도련", "CMYK", "아웃라인" 🔹 후가공 파일: "박가공 파일", "칼선 레이어" 🔹 주문 시뮬레이터: "만들고 싶어요", "미리보기", "옵션 선택" 🔹 제품 프리뷰: "책 모양", "완성품 보여줘"

⭐ 정산 관리 (NEW): 🔹 정산 분석: "정산 분석", "비즈하우스 정산", "후지필름 정산" 🔹 매칭 검증: "데이터 매칭", "불일치 확인", "정산 대사" 🔹 금액 집계: "정산 금액", "VAT 계산", "총액" 🔹 정산서 생성: "정산서 만들어", "엑셀 출력"

지원 상품: 디지털인쇄, 스티커, 책자, 캘린더, 포스터, 아크릴, 굿즈, 파우치, 에코백 등 236개 MES상품 지원 외주사: 비즈하우스, 후지필름(롯데ON)

후니프린팅 통합 관리 시스템

용어 정리

⚠️ 기존 용어 "품목" → "상품", "품목모델" → "상품아이템"으로 통일

회사 정보

상품마스터 구조 (v251220)

카테고리 체계

MAP 시트 (상품 계획표)         MES품목 (운영 상품)
├─ ▶︎ 서브카테고리 헤더        ├─ 실제 운영 중인 상품만
├─ → 참조 링크                └─ 236개 고유 MES코드
├─ ★ 미출시/개발중
└─ 전체 상품 목록

12개 카테고리 현황

💡 MAP > MES 차이: 서브카테고리 헤더(▶︎), 참조링크(→), 미출시(★) 포함

공정 흐름

인쇄공정 → 내부공정1 → 내부공정2 → 외주공정 → 출고

인쇄공정 유형 (7종)

내부공정 유형

참조 파일

Part A: 견적 시스템

Quick Start

1. 가격 데이터 → assets/data/prices.toon (TOON 형식)
2. 가격 계산 → scripts/calculate_estimate.py
3. (책자) 조판 분석 → scripts/imposition_calculator.py

가격 데이터 (TOON)

가격 데이터는 assets/data/prices.toon에 TOON 형식으로 저장:

• 토큰 효율: JSON 대비 ~60% 절감
• 포함 데이터: 용지, 출력비, 제본비, 코팅, 후가공, 박가공, 포장, 할인율

# 수량 할인율 (prices.toon 발췌)
discount_tiers[6]{qty_min,qty_max,rate}:
  1,9,0
  10,49,0.03
  50,99,0.06
  100,499,0.10
  500,999,0.15
  1000,99999,0.20

가격 계산 공식

디지털인쇄

최종가 = (용지비 + 출력비 + 후가공비) × 수량 × (1 - 할인율)

책자 (중철, 무선, PUR)

최종가 = (내지비 + 표지비 + 제본비 + 후가공비) × 수량 × (1 - 할인율)

박가공 (엽서, 명함 등)

박가공비 = 동판비 + 박가공비

동판비: foil_copper_plate 테이블에서 (수량 × 면적mm) 조회
박가공비: 
  - 일반박 (금유광,은유광,동박,청박): foil_stamp_normal
  - 특수박 (먹유광,홀로그램,트윙클,적박): foil_stamp_special
  - 면적 150mm² 이하: price_base
  - 면적 150mm² 초과: price_large

수량 할인율

조판/CTP 가이드

CTP 판수 공식

CTP 판수 = 대지수 × 색상수 × 인쇄면수

대지 크기

파일 제작 가이드

핵심 체크리스트

□ CMYK 색상 모드
□ 300dpi 해상도
□ 도련 사방 3mm
□ 안전영역: 재단선에서 3mm 안쪽
□ 서체 아웃라인
□ PDF 출판품질

도련/안전영역

┌─────────────────────┐
│   도련 (3mm)         │ ← 잘려나감
│  ┌───────────────┐  │
│  │   재단선      │  │
│  │ ┌─────────┐  │  │
│  │ │안전영역 │  │  │ ← 중요 내용
│  │ └─────────┘  │  │
│  └───────────────┘  │
└─────────────────────┘

주문 시뮬레이터

용도별 상품 추천

제품 미리보기

옵션 완료 시 assets/templates/order-simulator.jsx를 React 아티팩트로 렌더링

Part B: 외주 정산 시스템 ⭐ NEW

지원 외주사

정산 워크플로우

1. 파일 업로드 → 외주사 + MES 파일
2. 시트 매핑 → 자동 감지
3. 데이터 매칭 → scripts/settlement_matcher.py
4. 불일치 검출 → 누락/수량차이
5. 금액 집계 → VAT 포함
6. 정산서 생성 → Excel 출력

비즈하우스 정산

파일 구조 (7개 시트)

매칭 로직

인화업체정산.상품IDX 
  → 중복시트.상품IDX 
  → 중복시트.작업번호 
  → 후니내역.작업번호

제외 조건 (중복시트 비고 컬럼)

• 9월정산 → 이전 정산 완료
• 취소 → 취소 주문
• 환불 → 환불 처리

금액 계산

총 정산금액 = (상품금액 + 배송비 + 제주도서 + 보정) × 1.1

상품금액 = Σ(인화업체정산.총공급가격)
배송비 = Σ(인화업체정산.배송비)
제주도서 = Σ(제주도서.기타운임)
보정 = Σ(보정.합계금액)
VAT = 소계 × 10%

분석 결과 예시 (2025.11)

📊 매칭 결과
├─ 총 건수:        10,530건
├─ 매칭 성공:      10,499건 (99.71%)
├─ 이전 정산 제외:     22건
├─ 매핑 테이블 없음:    5건
└─ 내부 데이터 없음:    4건

💰 정산 금액
├─ 상품 공급가격:     ₩226,049,380
├─ 일반 배송비:       ₩ 24,273,900
├─ 제주도서 (72건):    ₩    407,000
├─ 보정 금액 (66건):   ₩ 20,382,990
├─ 소계:              ₩271,113,270
├─ VAT (10%):         ₩ 27,111,327
└─ 총 정산금액:       ₩298,224,597

후지필름 정산

파일 구조 (1개 시트)

매칭 로직

후지필름.거래처주문번호 
  → 정규화 (S1 접미사 제거)
  → MES.주문번호

주문번호 정규화

# M2511032226540S1 → M2511032226540
import re
normalized = re.sub(r'S\d+$', '', order_id)

⚠️ 금액 데이터 없음

후지필름 파일의 생산단가/금액 컬럼이 비어있음 → 가격표 DB 연동 필요

분석 결과 예시 (2025.11)

📊 매칭 결과
├─ 총 건수:           57건
├─ 매칭 성공:         27건 (유니크 주문)
├─ 후지에만 존재:      2건
└─ MES에만 존재:       3건

📦 품목별 수량
├─ 포토북:            96건
├─ 레더스트랩키링:     20건
├─ 반칼팬시스티커:     12건
└─ 아크릴키링:         7건

⚠️ 금액: 가격표 연동 필요

불일치 유형

정산 자동화 도구

정산 요청 시 assets/templates/settlement-manager.jsx를 React 아티팩트로 렌더링:

기능:

• 📁 파일 업로드 (드래그앤드롭)
• 🔍 자동 시트 감지
• 📊 매칭 결과 대시보드
• ❌ 불일치 항목 테이블
• 💰 금액 집계 (VAT 포함)
• 📋 품목별 집계
• 📥 Excel 내보내기

참조 문서

상품/가격 데이터 (TOON)

가격 데이터 상세

견적/주문

정산

스크립트 사용법

견적 계산

python scripts/calculate_estimate.py \
  --product "무선책자" \
  --options '{"pages":100}' \
  --qty 50

CTP 판수

python scripts/imposition_calculator.py \
  --pages 100 --signature 16 --colors 4

정산 분석

python scripts/settlement_matcher.py \
  --partner bizhouse \
  --file "02__비즈하우스.xlsx"

대화 시나리오

견적 문의

고객: "무선책자 A5 100P 50부 얼마예요?"

Claude: "A5 100P 무선책자 견적:
📋 옵션: A5, 100P, 아트지 120g
💰 50부 기준: ₩XXX,XXX (VAT별도)

📄 파일 규격:
• 내지: 154×216mm
• 표지: 310×216mm (책등 7mm)"

정산 분석

담당자: "비즈하우스 정산 분석해줘"

Claude: "파일 업로드 후 분석할게요.

[분석 결과]
📊 매칭: 10,499건 (99.71%)
❌ 불일치: 9건 (확인 필요)
💰 총 정산금액: ₩298,224,597

[React 아티팩트: 정산 대시보드]

정산서 Excel 생성할까요?"