qrcoding-logo-librarian

QR Coding Logo Librarian

생성되는 이미지(포스터/아트워크)에 기관·브랜드 로고를 정확히 삽입한다. 핵심 원칙은 QR과 동일하다: 로고를 이미지 모델이 그리게 하지 말고, 검증된 소스(로고 URL)에서 가져와 결정적으로 합성한다. 유료 플랜 전용 기능이다.

로고 소스

1. 기관 로고 — getlogo.kr
   • getlogo.kr은 한국 관공서·공공기관 로고 디렉터리다. 파일을 직접 호스팅하지 않고 공식 출처 링크만 중계한다.
   • 기관명/분류(중앙·지자체·공공기관)/지역으로 검색 → 해당 기관 항목 → **공식 출처(기관 공식 사이트의 CI/BI 페이지)**로 이동해 공식 로고 파일 URL을 확보한다. 가능하면 PNG 또는 SVG.
   • 상표·저작권은 각 권리자에게 있다. 허가된 용도로만 사용하고, 로고를 변형·재색·왜곡하지 않는다.
2. 본인 로고 — 링크 첨부
   • 사용자가 제공한 로고 이미지 URL(https 또는 data:image)을 그대로 사용한다.

로고 리스트 관리

• 수집한 로고를 {이름, url} 형태의 리스트로 관리한다(예: "행정안전부 → https://…/logo.png").
• 재사용이 필요하면 로고를 워크스페이스 라이브러리에 영속화한다: 이미지를 받아 base64 data:image/... 로 만들어 upload_logo 호출 → logoAssetId 확보. (단 upload_logo는 PNG/JPG/WebP ≤100KB만 허용, SVG 불가. SVG 로고는 배치 시 URL을 직접 쓰면 된다.)
• 라이브러리 조회/삭제는 list_logos / delete_logo.

정확한 배치 (핵심)

먼저 사용자에게 위치·크기·사용 방법을 물어 프롬프트에 반영한 뒤, compose_qr_overlay에 logo를 함께 전달한다:

compose_qr_overlay(
  id,
  imageTool: "gpt-image" | "gemini" | "codex",
  placement: "card" | "transparent" | "framed",
  logo: { url, position, size, note }
)

• position: top-left · top-right · bottom-left · bottom-right · top-center · bottom-center · center (기본 top-right)
• size: small(~12%) · medium(~18%) · large(~26%) — 이미지 너비 대비 (기본 small)
• note: 사용 지침(예: "가로형 로고 사용", "주위 여백 확보", "헤더에 배치")
• 반환되는 지시문은 "그 위치에 로고 자리를 비우고, 모델이 그리지 말고, 생성 후 URL의 실제 로고를 결정적으로 합성(QR과 그 여백 침범 금지, 색·비율 변형 금지)"을 담는다.

유료 게이팅

• 로고 배치는 유료 플랜 전용이다. 무료 플랜이 logo를 넣으면 로고 가이드 없이 업그레이드 안내만 반환된다.
• 시작 전 get_account_status로 플랜을 확인하고, 무료면 업그레이드를 안내한다.

검증

• QR과 로고를 모두 합성한 뒤 validate_qr_scanability로 스캔 가능성을 확인한다.
• 지원 옵션이 헷갈리면 get_capabilities의 imageOverlay(placement·logoPlacement)를 먼저 확인한다.