잠금 사양: 당신의 디지털 제품이 일관성 없어 보이는 이유

새벽 2시에 세 번째 거절 이메일이 도착했다. 플랫폼도 같고, 이유도 같았다. 'CSV 헤더가 잘못되었습니다(CSV header malformed).' 그 주에만 이미 24개의 파일을 업로드했다. 스물네 개나 되는 파일이었다. 메타데이터를 자동화하지 않고 '시간을 절약한다'는 생각으로 수동으로 스프레드시트에 다시 입력했기 때문이다. 그날 밤 나는 노트북을 덮고, 헤더, 키워드, 파일명에 얼마나 많은 시간을 태웠는지 계산했다. 스크립트가 처리해야 할 것들이었다. 그것은 2주 동안 30시간이 넘는 시간이었다. 그때서야 나는 패키징을 사후 고려 사항으로 취급하는 것을 멈췄다.

문제는 아트워크(art)가 아니다

아트를 만드는 것은 재미있는 부분이다. 그리고 제품이 지연되는 곳도 아니다. 제품은 네 가지 특정 지점에서 지연된다: 메타데이터, 중복 게시(double-posting), 문서를 제품처럼 보이게 바꾸는 것, 그리고 패키징이다. 이 모든 것이 창의성 문제가 아니라 규칙 문제입니다.

스톡 플랫폼들은 자비 없이 자신들의 사양을 강제한다. Adobe는 5개 열짜리 CSV를 원한다. Vecteezy는 4개 열을 원한다. Dreamstime은 15개를 원한다. 헤더를 단 하나의 문자만 잘못해도 전체 배치가 즉시 거절된다. 유예 기간도, 부분 가져오기도 없다. 제품 커버에 대해서도 마찬가지다: 실제 커버가 있는 zip 파일은 팔리지만, 아무것도 없는 파일은 그렇지 못하다. 이 비대칭성이 카탈로그를 일관성 없어 보이게 만드는 것이다. 어떤 제품들은 완성된 것처럼 보이고. 어떤 제품들은 숙제처럼 보인다.

잠금 사양이 좋은 의도를 능가한다

해결책은 규율이 아니다. 규율은 12일째에 실패한다. 해결책은 흔들릴 수 없는 사양이다.

내가 구축한 파이프라인은 각 플랫폼이 요구하는 정확한 헤더를 그리고 오직 그것만 작성한다. make_metadata.py라는 하나의 스크립트는 파일 폴더를 가져와 Adobe용 metadata.csv, Vecteezy용 vecteezy.csv, Dreamstime용 dreamstime.csv를 생성한다. 이 도구는 협상하지 않는다. 플랫폼이 요청한 열만 내보낸다.

두 번째 스크립트인 upload_tracker.py는 또 다른 조용한 문제점인 중복 게시(double-posting)를 해결합니다. 배치 작업을 두 번 실행하는 것은 계정이 플래그 지정될 가장 빠른 방법입니다. 이 트래커는 간단한 원장 역할을 합니다. 이미 무엇을 게시했는지 기억하기 때문에, 재실행 시 모든 것을 다시 제출하는 대신 보류 중인 항목을 보여줍니다.

python upload_tracker.py pending items.txt
python upload_tracker.py done "asset-001.jpg"
python upload_tracker.py status

이 세 가지 명령어가 바로 중복 게시 방지 시스템 전체입니다.

일관성은 렌더링 결정 사항

일관성이 없어 보이는 또 다른 부분은 시각적인 측면입니다. PDF 파일의 글꼴이 맞지 않습니다. 표지의 크기가 일정하지 않습니다. 썸네일은 그날 내보내기 대화 상자가 기본값으로 설정한 대로입니다.

두 개의 스크립트가 이 격차를 메워줍니다. md2pdf.py는 마크다운(Markdown) 파일을 제목, 표, 목록, 링크가 포함된 깔끔하고 스타일이 적용된 PDF로 변환합니다. 한 번의 명령어로 매번 일관된 모양을 만듭니다:

python md2pdf.py content.md product.pdf "내 제품 제목"

pack_product.py는 제품을 패키징합니다. 파일을 zip으로 압축하고, 1280x720 크기의 표지와 600x600 크기의 썸네일을 렌더링합니다. 모든 제품에 동일한 크기, 동일한 레이아웃 로직이 적용됩니다:

python pack_product.py my-product "내 제품" "짧은 부제목" 9

결과물로 my-product.zip, my-product-cover.jpg, 그리고 my-product-thumb.jpg가 생성되며, 이는 _system 폴더에 저장됩니다. --dir을 사용하거나 PACK_ROOT 환경 변수를 사용하여 다른 위치를 지정할 수 있습니다. 스크립트를 수정할 필요가 없습니다.

의존성 목록은 의도적으로 작습니다. 전체 키트에는 단 두 개의 외부 패키지만 존재합니다. 표지를 위한 Pillow와 PDF 출력을 위한 reportlab입니다. make_metadata.py와 upload_tracker.py는 표준 라이브러리만 사용하므로 설치가 전혀 필요 없습니다.

카탈로그가 잡동사니 서랍이 되는 것을 막아주는 레이아웃

도구만으로는 일관성을 고칠 수 없습니다. 구조가 그래야 합니다. 이것이 키트가 가정하고 확장 가능한 레이아웃입니다:

project/
assets/ 원시 출력 (자산별 단일 파일)
output/ 제출 준비 파일 + metadata.csv
...

research/는 영구적으로 유지하세요. 귀하의 스크랩 로그와 메모가 미래 제품을 위한 원자재입니다. 저는 한때 '정리'하기 위해 제 것을 삭제한 적이 있습니다. 그런 실수를 반복하지 않겠습니다.

거의 아무것도 없는 환경에서도 작동하는 증명

이 전체 파이프라인은 1 vCPU, 2 GB RAM, 그리고 GPU가 없는 서버에서 39개 제품, 856 MB의 출력을 패키징했습니다. 그 뒤에 있는 상위 프로젝트는 대략 19,000줄의 파이프라인 코드이며, 스크립트가 강제하는 규칙을 만들어낸 300페이지 이상의 연구 자료를 기반으로 합니다.

이것은 당신이 이 키트를 절대 건드리지 않더라도 훔칠 가치가 있는 몇 가지 습관 덕분에 작동합니다:

• 한 번에 하나의 프로세스. 1코어 박스에서 이미지 작업을 병렬로 분산시키지 마세요.
• 항목 간 메모리 해제. 각 자산 처리 후에 gc.collect()를 호출하세요.
• 평균이 아닌 최대 RSS(Resident Set Size) 측정. resource.getrusage(RUSAGE_SELF).ru_maxrss가 실제 한계를 알려줍니다.
• 무거운 렌더링 단계의 경우 서브프로세스당 단일 파일 처리로, 메모리가 OS로 반환되게 하세요.
• 필요한 해상도에서 렌더링하세요. 60 dpi에서 미리보기를 검사하는 것이 300 dpi에서 렌더링하는 것보다 낫습니다.

이 중 어느 것도 영리하지 않습니다. 단지 2 GB 박스에서 살아남는 파이프라인과 파일 40에서 죽는 파이프라인의 차이에 불과합니다.

실제로 일관성을 고치는 방법

당신의 제품들이 일관성이 없어 보이는 이유는 그것들을 지배하는 규칙들이 당신의 머릿속에 존재하기 때문이며, 당신의 머리는 제품 30을 거치면서 피로해졌기 때문입니다. 그 규칙들을 스크립트로 옮기세요. 스크립트가 잘못된 헤더를 방출하는 것을 거부하게 하세요. 트래커가 중복 게시하는 것을 거부하게 하세요. 커버 렌더러가 서두르느라 900x400 이미지를 생성하는 것을 거부하게 하세요.

이것이 이 키트의 전체 주장입니다. 하나의 프롬프트 엔진을 39개의 완성된 제품으로 바꾼 네 가지 작동 스크립트가 핵심이며, '여기서 이렇게 할 수 있습니다'에서 끝나는 튜토리얼이 아닙니다. 이것은 1 vCPU와 2 GB RAM에서 실행되었던 동일한 패키징 레이어이며, 작업 일정을 잡고 실패를 재시도하는 오케스트레이터(orchestrator)와 모델 접근을 위한 로컬 LLM 프록시(local LLM proxy)라는 무료 스택 아래에 플러그인 됩니다.

만약 귀하의 카탈로그가 39명의 다른 사람이 만든 것처럼 보인다면, 해결책은 더 많은 노력이 아닙니다. 그것은 잠금 사양(locked spec)입니다.

키보기를 확인하세요

디지털 제품을 구축하시나요? 디지털 제품 판매자를 위한 무료 가이드 및 키트.