gPdf 소개

HTML로 그린 배송 라벨에서 글로벌 엣지 PDF 엔진까지

gPdf는 물류 회사의 IT 부서에서 성장한 작은 엔지니어링 팀이 만든 JSON-PDF 생성 API입니다.

출발점

gPdf의 중요한 기술 결정은 모두 실제 운영 부하에서 나왔습니다. 대량의 크로스보더 라벨과 인보이스, 정밀한 벡터 바코드, 안정적인 페이지네이션, PDF/A, 전자 인보이스 컴플라이언스가 그 배경입니다.

물류 현장에서 시작

초기 버전은 실제 물류 운영 안에서 배송 라벨 출력 문제를 해결하기 위해 만들어졌습니다.

수백만 건의 문서

크로스보더 물량이 커지면서 중앙집중식 PDF 스택의 지연, 배포 복잡도, 비용 예측 문제가 드러났습니다.

엣지에서 실행되는 Rust

현재 엔진은 문서가 생성되고 소비되는 위치 가까이에서 실행되며, 리소스와 운영 부담을 크게 줄입니다.

물류 워크플로 안에서 만들어졌습니다

처음에는 HTML로 배송 라벨을 그리고 출력했습니다. 물량이 늘면서 PDF 생성을 PHP로 옮겼고, 더 복잡한 문서와 컴플라이언스 요구를 처리하기 위해 Java와 iText를 도입했습니다.

각 단계는 당장의 운영 문제를 해결했지만, 상용 라이선스 비용, 인프라 부담, 지연 시간, 여러 지역 배포의 복잡도라는 한계는 계속 반복되었습니다.

왜 PDF 생성 엔진을 다시 만들었는가

회사가 해외로 확장하면서 매일 처리하는 주문, 인보이스, 배송 라벨이 수백만 건에 이르렀습니다. 우리는 우리가 필요로 했던 렌더링 엔진을 직접 만들기로 했습니다.

Rust를 Cloudflare 글로벌 엣지 네트워크에서 네이티브로 실행하도록 선택했습니다. 브라우저 프로세스, Java 인프라, 중앙 렌더링 병목 없이 문서가 만들어지고 사용되는 곳 가까이에서 생성하기 위해서입니다.

디자인과 프로덕션을 같은 파일로 맞추기

또한 무료 비주얼 에디터 gPdf Studio를 개발했습니다. API가 사용하는 것과 정확히 같은 JSON을 만들기 때문에 디자이너와 개발자가 레이아웃을 수작업으로 옮기지 않고 같은 파일로 협업할 수 있습니다.

지금도 우리는 실무형 엔지니어링 팀으로서, 대량 크로스보더 문서 처리의 현실적인 문제에 집중합니다. 정밀한 벡터 바코드, 안정적인 페이지네이션, PDF/A, 전자 인보이스 컴플라이언스입니다.

왜 상용화했는가

엣지에서 구축한 것은 지연 시간과 확장성만 해결한 것이 아닙니다. 페이지당 비용 구조를 바꾸어 인프라 수준 가격을 가능하게 했습니다.

gPdf는 월 5달러로 10만 페이지부터 시작합니다. 물류, 이커머스, 컴플라이언스 중심 팀에게 대규모 문서 생성 비용은 예측 가능해야 합니다.

우리는 우리가 갖고 싶었던 엔진을 만들었고, 문서 생성이 더 이상 큰 비용 부담이 되지 않는 가격으로 공개했습니다.