Innojini Wowpress

상세 정보

API 데이터 구조

카테고리 구조

{
  "id": "cat-916c01a6",
  "slug": "스티커-사각스티커-01a6",
  "path": ["스티커", "사각스티커"],
  "displayName": "스티커 > 사각스티커",
  "productCount": 12,
  "keywords": ["스티커", "사각스티커", "가성비스티커", "사각", ...],
  "summary": "스티커 > 사각스티커 · 12개 상품",
  "pricing": {
    "templated": 0,
    "quoted": 0
  }
}

상품 구조

{
  "productId": 40007,
  "meta": {
    "name": "가성비스티커(사각)",
    "slug": "가성비스티커-사각-40007",
    "keywords": ["스티커", "사각스티커", "가성비스티커", "사각", ...],
    "useCases": ["sticker", "label"],
    "fileTypes": ["AI", "EPS", "JPG", "PNG", "CDR", "PSD", "SIT", "ZIP", "ALZ", "PDF"],
    "unit": "매"
  },
  "delivery": {
    "cutoffTime": null,
    "prepayRequired": true,
    "group": {"id": 1, "name": "명함,스티커 묶음"}
  },
  "options": {
    "orderQuantities": [{...}],
    "coverTypes": [{...}],
    "materialPapers": [{...}],
    "printOptions": [{...}],
    "jobOptions": [{...}],
    "sizes": [{...}],
    "outputFiles": [{...}]
  }
}

카테고리 매칭 예시

# 사용자 쿼리: "사각스티커 1000장 인쇄"
query = "사각스티커 1000장 인쇄"
keywords = extract_keywords(query)  # ["사각스티커", "1000"]

# 카테고리 검색
matched_category = search_by_keywords(["스티커", "사각"])
# 결과: cat-916c01a6 (스티커 > 사각스티커)

# 상품 목록
products = [
  "가성비스티커(사각)",  # productId: 40007
  "소량스티커(사각)",     # productId: 40009
  "탈부착스티커(사각)",   # productId: 40011
  ...
]

# 수량 옵션 확인
orderQuantities = [500, 1000, 2000, ...]
# 1000은 유효한 수량

옵션 구조 이해

orderQuantities (주문 수량)

# 일반 상품 (대량)
[500, 1000, 2000, 3000, 4000, 5000, 6000, 8000, 10000, ...]

# 소량 상품
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 200, 300]

pricingType (가격 유형)

Wowpress API 엔드포인트 및 구조

API Endpoints

Wowpress 주문 API 데이터 구조

제품 상세 JSON 구조

{
  "prodno": 40007,
  "prodname": "가성비스티커(사각)",
  "unit": "매",
  "ctptime": null,
  "dlvyprepay": false,

  // 1. 커버 구성정보 (표지/내지/간지)
  "coverinfo": [
    {
      "covercd": 0,  // 0:통합, 1:표지, 2:내지, 3:간지
      "covername": "통합",
      "pagelist": [
        {
          "pagecd": 0,  // 0:양면, 1:전면, 2:후면
          "pagename": "양면",
          "pagecnt": {"min": null, "max": null, "interval": null}
        }
      ]
    }
  ],

  // 2. 수량정보 (주문 가능 수량)
  "ordqty": [
    {
      "jobpresetno": 1,  // 인쇠 프리셋 번호 (우선순위 1)
      "sizeno": 101,       // 규격 번호 (우선순위 2)
      "paperno": 201,      // 지류 번호 (우선순위 3)
      "optno": 301,         // 옵션 번호 (우선순위 4)
      "colorno": 401,       // 도수 번호 (우선순위 5)
      "ordqtylist": [500, 1000, 2000, 3000, ...]  // 주문 가능 수량 리스트
    }
  ],

  // 3. 규격정보 (사이즈, 도련, 컷사이즈)
  "sizeinfo": [
    {
      "sizeno": 101,
      "sizename": "90 x 50 mm",
      "width": 90,
      "height": 50,
      "cutsize": 100,
      "non_standard": false,

      // 비규격 입력 요구사항
      "req_width": {"type": "input", "unit": "mm", "min": 10, "max": 300},
      "req_height": {"type": "input", "unit": "mm", "min": 10, "max": 300},

      // 후가공 요구사항
      "req_awkjob": [
        {"unit": "mm", "min_area": 1000, "min_sum_wh": 100}
      ]
    }
  ],

  // 4. 지류정보 (용지 선택)
  "paperinfo": [
    {
      "paperno": 201,
      "papername": "모조 80g",
      "paptergroup": "일반 인쇄",
      "gram": 80,

      // 지류+가로크기 요구사항
      "req_width": {"type": "select", "options": ["평방지", "국전", "특별"]},
      "req_height": {"type": "input", "unit": "mm"},

      // 후가공 요구사항
      "req_awkjob": [
        {"colorno": 401, "jobname": "코팅", "type": "checkbox"}
      ],

      // 제약사항
      "rst_prsjob": [
        {"jobpresetno": 1, "jobname": "오프셋 디지털"}
      ]
    }
  ],

  // 5. 도수정보 (인쇄도수, 추가도수)
  "colorinfo": [
    {
      "covercd": 0,  // 통합
      "pagelist": [
        {
          "pagecd": 0,  // 양면
          "colorlist": [
            {"colorno": 401, "colorname": "단면4도", "pdfpage": 1}
          ]
        }
      ],

      // 추가도수 (도면별 선택 가능)
      "addtype": "select",  // select, checkbox
      "coloraddlist": [
        {"colorno": 402, "colorname": "코팅", "pdfpage": 1}
      ]
    }
  ],

  // 6. 인쇄정보 (인쇄방식, 작업번호)
  "prsjobinfo": [
    {
      "jobpresetno": 1,  // 인쇠 프리셋 번호
      "jobpreset": "일반합판",
      "prsjoblist": [
        {
          "jobno": 101,
          "jobname": "오프셋 디지털",
          "unit": "면"
        }
      ]
    }
  ],

  // 7. 후가공정보 (재단, 접지, 제본, 박 등)
  "awkjobinfo": [
    {
      "covercd": 0,  // 통합
      "type": "checkbox",  // radio, select, checkbox

      "joblist": [
        {
          "jobno": 501,
          "jobname": "재단",
          "unit": "회",
          "req_jobsize": {
            "type": "input",
            "unit": "mm",
            "req": "1cut 2 또는 2cut 4"
          }
        }
      ]
    }
  ],

  // 8. 배송정보 (무료배송, 배송방법, 배송지역)
  "deliverinfo": {
    "dlvyfree": [
      {
        "usrkd": "VIP",
        "mincost": 50000  // 5만원 이상 무료배송
      }
    ],

    "dlvymcdlist": [
      {
        "dlvymcd": "배쑝와쑝",
        "costinit": 3000,
        "dlvyloc": [
          {
            "sd": "서울",
            "sgglist": ["강남", "강동", "강서울", "관악", "광진", "구로", "금천"],
            "costadd": 0
          }
        ]
      }
    ],

    "dlvyloc": [
      {
        "sd": "서울",
        "sgglist": ["강남", "강동", "강서울", "관악", "광진", "구로", "금천"]
      }
    ]
  }
}

JSON Path 명칭 규칙

기준정보 설정 우선순위

1. jobpresetno (인쇠방식 프리셋)
2. sizeno (인쇄규격)
3. paperno (지류)
4. optno (옵션)
5. colorno (도수)

PDF 파일 요구사항 (인쇄용 PDF)

필수 조건

• 컬러 모드: CMYK (RGB 파일 변환 오류 방지)
• 폰트: 모든 폰트 임베드 (아웃라인, 트루타입 사용 금지)
• 트리밍: 트리밍 여부 있어야 함
• 도련: 도련 여부가 있어야 함 (100% black)
• 압축: 압축 없어야 함 (비율롤 금지)
• 폰트 크기: 7pt 이상 (본문 텍스트)

권장 사항

• 버전: PDF 1.4 이상
• 압축: 비손실 압축
• 투명 배경: 투명 배경 없음
• 레이어: 레이어를 사용하지 않고 투명하게 저장
• 페이지 단일: 단일 페이지 PDF (여러 페이지 시 병합 금지)

파일 검증

# PDF 검증 스크립 예시
def validate_printing_pdf(pdf_path):
    """인쇄용 PDF 표준 준수 확인"""
    import fitz

    doc = fitz.open(pdf_path)

    # 1. 컬러 모드 확인
    for page in doc:
        if "/Color" not in page.get_content_stream():
            return False, "RGB 감지 - CMYK로 변환 필요"

    # 2. 폰트 임베드 확인
    for page in doc:
        for font in page.get_fonts():
            if "subset" in font or font["flags"] & 4:  # 4 = embedded subset
                return False, "폰트 서브셋 임베드 필요"

    # 3. 트리밍 확인
    for page in doc:
        if page.get_cropbox() != page.rect:
            return False, "트리밍 영역 존재"

    # 4. 도련 여부 확인
    for page in doc:
        for img in page.get_images():
            if img.colorspace.name != "DeviceGray":
                return False, "그레이스케일이 아님 CMYK 필요"

    return True, "PDF 표준 준수"

인쇄 용어 사전 (한국어)

사용 워크플로우

워크플로우 1: 카탈로그 분석

# 모든 카테고리와 상품 파싱
python scripts/parse_catalog.py ref/wowpress/catalog/

# 출력: category_summary.json, product_summary.json

워크플로우 2: 상품 매칭

# 사용자 쿼리: "사각스티커 1000장"

# Step 1: 키워드 추출
keywords = extract_korean_keywords("사각스티커 1000장")
# ["사각스티커", "1000"]

# Step 2: 카테고리 검색
category = match_category(keywords)
# cat-916c01a6

# Step 3: 상품 목록
products = get_products(category)
# [40007, 40009, 40011, ...]

# Step 4: 수량 검증
is_valid_quantity(1000, products[40007].orderQuantities)
# True

워크플로우 3: 견적 생성

# 필수 옵션 추출
quote = {
  "productId": 40007,
  "productName": "가성비스티커(사각)",
  "quantity": 1000,
  "size": "90 x 50 mm",
  "material": "모조 80g",
  "print": "단면 4도",
  "finishing": ["재단"]
}

HuniPrinting 설계 시 WowPress 도메인 지식 활용

WowPress는 한국 인쇄 업계 실제 상품 구성 패턴의 종합 참조 소스입니다. HuniPrinting DB를 설계하거나 인쇄 옵션 로직을 구현할 때, WowPress를 통해 "실제 인쇄 업계에서는 어떤 옵션 조합이 가능한가", "어떤 제약이 존재하는가"를 파악하세요. 상세 도메인 지식 가이드: ref/wowpress/knowledge/db-mapping-guide.md

WowPress로 이해하는 인쇄 도메인 핵심 패턴

1. 옵션 선택 순서 의존성 (Selection Order Dependency)

WowPress는 옵션 선택에 명확한 우선순위가 있습니다:

1. jobpresetno (인쇄방식 프리셋) → 가장 먼저 결정
2. sizeno (규격)
3. paperno (지질)
4. optno (옵션)
5. colorno (도수)

→ 설계 시사점: HuniPrinting DB의 wb_recipe_option_bindings.sort_order가 이 순서를 반영해야 합니다.

2. req_* 패턴 (필수 연계 제약)

req_*는 "A를 선택하면 B도 반드시 선택해야 한다"는 패턴입니다:

• sizeinfo[].req_width/height → 비규격 사이즈 선택 시 가로/세로 치수 입력 필수
• paperinfo[].req_awkjob → 특정 지질 선택 시 후가공 필수
• paperinfo[].req_color → 특정 지질은 특정 도수만 가능
• colorinfo[].req_paper → 특정 도수 선택 시 지질 범위 제한

→ 설계 시사점: HuniPrinting의 wb_recipe_constraints (ECA 패턴)로 이 관계를 표현합니다.

3. rst_* 패턴 (불가 제약)

rst_*는 "A를 선택하면 B는 선택 불가"라는 패턴입니다:

• paperinfo[].rst_prsjob → 특정 지질은 특정 인쇄기 사용 불가
• paperinfo[].rst_awkjob → 특정 지질은 특정 후가공 불가
• awkjobinfo[].rst_awkjob → 후가공 상호 배제 (유광코팅 ↔ 무광코팅)
• colorinfo[].rst_prsjob → 특정 도수는 특정 인쇄기 불가

→ 설계 시사점: HuniPrinting의 wb_recipe_choice_restrictions (Allow/Exclude)로 표현합니다.

연관 스킬

• innojini-huni-db-schema: HuniPrinting DB 테이블 구조 + 설계 원칙
• innojini-printing-foundation: 인쇄 산업 공통 기술 지식 (조판 계산, CTP 판수, 접지 배열)
• innojini-mycom-printing-estimator: 옵셋 인쇄 조판/견적 통합 시스템

참조 문서

자세한 내용은 references/ 디렉토리를 확인하세요:

• api-structure.md: 완전한 API 문서
• category-mapping.md: 카테고리 계층 구조와 키워드 매핑
• quotation-workflow.md: 종단 간 견적 프로세스
• integration-guide.md: huni-estimator 시스템 통합 가이드

Version: 1.0.0 Last Updated: 2026-01-19