두손기획 인쇄 시스템 비즈니스 규칙

[핵심 규칙 1] 수량 표기

규칙 1-1: 전단지/리플렛 수량 표기

형식: X연 (Y매) 또는 X연 (Y,YYY매)

연수	매수 (A4 기준)	표기 예시
0.5연	2,000매	"0.5연 (2,000매)"
1연	4,000매	"1연 (4,000매)"
1.5연	6,000매	"1.5연 (6,000매)"
2연	8,000매	"2연 (8,000매)"

핵심 원칙:

• 연수는 소수점 허용 (0.5, 1.5 등)
• 매수는 천 단위 콤마 표시
• 매수는 계산하지 않고 DB에서 가져옴 (quantityTwo 또는 mesu 필드)
• number_format() 사용 시 정수/소수 구분 필수:

  // [O] 올바른 코드
  floor($quantity) == $quantity
      ? number_format($quantity)      // 정수: 1 -> "1"
      : number_format($quantity, 1)   // 소수: 0.5 -> "0.5"
  
  // [X] 잘못된 코드 - 0.5가 1로 반올림됨
  number_format($quantity)  // 0.5 -> "1"
  

규칙 1-2: 전단지/리플렛 외 제품 수량 표기

형식: 정수 + 단위

제품	단위	표기 예시
명함	매	"500매", "1,000매"
봉투	매	"500매", "1,000매"
스티커	매	"1,000매", "3,000매"
자석스티커	매	"500매"
상품권	매	"1,000매"
포스터	매	"100매", "500매"
카다록	부	"500부", "1,000부"
양식지	매/권	"500매", "10권"

핵심 원칙:

• 수량은 항상 정수 (소수점 없음)
• number_format(intval($quantity)) 사용
• 단위는 DB의 unit 필드에서 가져옴

---

[핵심 규칙 2] 규격/옵션 표기

규칙 2-1: 표기 형식

규격: 2줄로 표기 옵션: 품목에 따라 있는 경우에만 표기 (최대 2줄)

[규격 1줄]
[규격 2줄]
[옵션 1줄] (있는 경우)
[옵션 2줄] (있는 경우)

규칙 2-2: 품목별 옵션 유무

품목	옵션	옵션 종류
전단지(리플렛)	O	코팅(150g 이상만), 접지, 오시
명함	O	박, 넘버링, 미싱, 귀돌이, 오시
봉투	O	테이프
스티커	O	도무송
자석스티커	X	-
상품권	O	박, 넘버링, 미싱, 귀돌이, 오시 (명함과 동일)
포스터	O	코팅, 접지
카다록	O	제본방식, 코팅
양식지	X	-

규칙 2-3: 표기 예시

전단지 예시 (옵션 있음):

90g아트지(합판인쇄)
A4 (210x297mm)
단면컬러인쇄
유광코팅

명함 예시 (옵션 있음):

명함_소량
스노우화이트 250g
양면컬러인쇄
귀돌이

포스터 예시 (옵션 있음):

포스터 A2
150g스노우지
단면컬러인쇄
유광코팅

규칙 2-4: 적용 위치

• 장바구니 상품 목록
• 주문 페이지 상품 정보
• 주문 완료 페이지 상세
• 관리자 주문서
• 이메일 본문
• 견적서 상품 설명

---

[핵심 규칙 3] 이모지 사용 금지

모든 출력에서 이모지 사용 금지

// [X] 잘못된 표기
echo "✅ 주문이 완료되었습니다";
echo "📦 배송 준비중";
echo "🎉 감사합니다";

// [O] 올바른 표기
echo "주문이 완료되었습니다";
echo "배송 준비중";
echo "감사합니다";

적용 범위:

• 고객 화면 (장바구니, 주문, 주문완료)
• 관리자 화면
• 이메일 발송 본문
• 견적서/PDF
• 에러 메시지
• 시스템 알림

---

[수량 표기 적용 위치]

1. 장바구니 (cart.php)

파일: mlangprintauto/shop/cart.php 위치: 라인 556-574 (상품 목록 테이블)

// 전단지/리플렛
echo $yeon_display . '연 (' . number_format($mesu) . '매)';
// 기타 제품
echo number_format(intval($quantity)) . $unit;

2. 주문 페이지 (OnlineOrder_unified.php)

파일: mlangorder_printauto/OnlineOrder_unified.php 위치: 주문 상품 목록 섹션

// 전단지/리플렛: "0.5연 (2,000매)"
// 기타 제품: "500매"

3. 주문 완료 페이지

파일들:

• mlangorder_printauto/OrderComplete_universal.php
• mlangorder_printauto/OrderComplete_unified.php 위치: 주문 상세 정보 섹션

// Type_1 JSON에서 MY_amount, mesu 추출
$my_amount = $json_data['MY_amount'] ?? $order['MY_amount'];
$mesu = $json_data['mesu'] ?? $order['mesu'];

4. 관리자 주문 상세 (OrderFormOrderTree.php)

파일: mlangorder_printauto/OrderFormOrderTree.php 위치: 라인 1059-1076 (수량/단위 컬럼)

// 전단지/리플렛: 수량 칸에 "X연 (Y매)" 통합, 단위 칸은 '-'
// 기타 제품: 수량/단위 분리 표시

5. 관리자 목록 (admin.php)

파일: admin/mlangprintauto/admin.php 위치: 주문 목록 테이블

// OrderView 모드에서 수량 표시

6. 이메일 발송

파일들:

• mlangorder_printauto/ProcessOrder_unified.php (주문 확인 메일)
• 기타 메일 발송 스크립트

// 메일 본문에 수량 표기 시 동일한 규칙 적용

7. 견적서 시스템

파일들:

• mlangprintauto/quote/detail.php (관리자 상세)
• mlangprintauto/quote/public/view.php (고객용 공개)
• mlangprintauto/quote/api/generate_pdf.php (PDF 생성)
• mlangprintauto/quote/revise.php (견적 수정)
• mlangprintauto/quote/create.php (견적 생성)

// 전단지: "0.5연 (2,000매)" 한 줄 형식
// 기타: "500매" 정수 형식

---

[구현 패턴]

전단지/리플렛 수량 표시 함수

/**
 * 전단지/리플렛 수량 표시
 * @param float $yeon 연수 (0.5, 1, 1.5 등)
 * @param int $mesu 매수 (DB에서 가져온 값)
 * @return string "0.5연 (2,000매)" 형식
 */
function formatFlyerQuantity($yeon, $mesu) {
    // 연수: 정수/소수 구분
    $yeon_display = floor($yeon) == $yeon
        ? number_format($yeon)
        : number_format($yeon, 1);

    // 매수: 천 단위 콤마
    $mesu_display = number_format(intval($mesu));

    return $yeon_display . '연 (' . $mesu_display . '매)';
}

일반 제품 수량 표시 함수

/**
 * 일반 제품 수량 표시
 * @param int $quantity 수량
 * @param string $unit 단위 (매, 부, 권 등)
 * @return string "500매" 형식
 */
function formatProductQuantity($quantity, $unit) {
    return number_format(intval($quantity)) . $unit;
}

제품별 분기 처리

/**
 * 제품 유형에 따른 수량 표시
 */
function displayQuantity($product_type, $quantity, $unit, $mesu = null) {
    // 전단지/리플렛: 연 + 매수
    if (in_array($product_type, ['inserted', 'leaflet'])) {
        if ($mesu && $mesu > 0) {
            return formatFlyerQuantity($quantity, $mesu);
        }
        // mesu 없으면 연수만 표시
        $yeon_display = floor($quantity) == $quantity
            ? number_format($quantity)
            : number_format($quantity, 1);
        return $yeon_display . '연';
    }

    // 기타 제품: 정수 + 단위
    return formatProductQuantity($quantity, $unit);
}

---

[제품별 단위 매핑]

product_type	제품명	unit 값	비고
inserted	전단지	연	매수는 별도 표시
leaflet	리플렛	연	매수는 별도 표시
namecard	명함	매	정수만
envelope	봉투	매	정수만
sticker	스티커	매	정수만
msticker	자석스티커	매	정수만
merchandisebond	상품권	매	정수만
littleprint	포스터	매	정수만
cadarok	카다록	부	정수만
ncrflambeau	양식지	매/권	정수만

---

[주의사항]

1. 전단지 코팅 옵션 제한

// 전단지(리플렛) 150g 미만 용지는 코팅 옵션 비활성화
// [X] 80g, 90g, 100g, 120g -> 코팅 선택 불가
// [O] 150g, 180g, 200g 이상 -> 코팅 선택 가능

if ($paper_weight < 150) {
    // 코팅 체크박스 disabled 처리
    echo '<input type="checkbox" disabled> 코팅';
} else {
    echo '<input type="checkbox" name="coating"> 코팅';
}

2. 매수(mesu)는 계산하지 않음

// [X] 잘못된 방식 - 직접 계산
$mesu = $yeon * 4000;  // 절대 금지!

// [O] 올바른 방식 - DB에서 가져옴
$mesu = $item['mesu'];  // shop_temp.mesu
$mesu = $json_data['quantityTwo'];  // Type_1 JSON
$mesu = $order['mesu'];  // mlangorder_printauto.mesu

3. 전단지 0.5연 number_format() 주의

// 전단지만 0.5연이 있음 (다른 제품은 모두 정수)
// [X] 0.5가 1로 반올림됨
number_format(0.5)  // 결과: "1"

// [O] 전단지 연수 표시 시 소수점 처리 필수
number_format(0.5, 1)  // 결과: "0.5"

4. 데이터 흐름

[1] add_to_basket.php: MY_amountRight에서 mesu 추출 -> shop_temp.mesu 저장
[2] cart.php: shop_temp.mesu 읽어서 표시
[3] ProcessOrder_unified.php: mesu -> Type_1.quantityTwo로 복사
[4] OrderComplete*.php: Type_1 JSON에서 추출하여 표시
[5] OrderFormOrderTree.php: Type_1 JSON에서 추출하여 표시
[6] 견적서: sourceData['mesu'] 사용

---

[검증 체크리스트]

수량 표기 관련 코드 수정 시 다음을 확인:

• 전단지/리플렛은 "X연 (Y매)" 형식인가?
• 기타 제품은 정수 + 단위 형식인가?
• number_format() 소수점 처리가 올바른가?
• mesu는 DB에서 가져오고 있는가? (계산 아님)
• 규격은 2줄, 옵션은 2줄로 표기되는가?
• 이모지가 사용되지 않았는가?
• 모든 적용 위치에서 일관된 형식인가?
  • 장바구니
  • 주문 페이지
  • 주문 완료 페이지
  • 관리자 페이지
  • 이메일
  • 견적서

---

[관련 문서]

• CLAUDE.md - 프로젝트 전체 규칙
• CLAUDE_DOCS/03_PRODUCTS/FLYER_QUANTITY_SYSTEM.md - 전단지 연/매수 상세
• 업로드다운로드251118.md - 파일 업로드 시스템

---

Last Updated: 2025-12-29 적용 범위: 두손기획 인쇄 시스템 전체