피드로 돌아가기
Sheet Generation API: Structured JSON In, Formatted Spreadsheet Out
Dev.toDev.to
Backend

단일 JSON 스키마 기반 다중 포맷 Spreadsheet 생성 API 설계

Sheet Generation API: Structured JSON In, Formatted Spreadsheet Out

Iteration Layer2026년 4월 30일9intermediate

Context

언어별 Spreadsheet 라이브러리의 파편화와 과도한 Boilerplate 코드로 인한 개발 생산성 저하 발생. XLSX와 CSV 등 포맷별로 상이한 구현 로직을 유지해야 하는 중복 코드 관리의 한계 직면.

Technical Solution

  • Positional Model 기반의 추상화 레이어를 도입하여 데이터 정의와 렌더링 로직을 완전히 분리한 구조 설계
  • 단일 JSON Payload로 XLSX, CSV, Markdown 등 다중 포맷을 동시 지원하는 다형성 렌더링 엔진 구현
  • Base Style과 Per-Cell Override 구조를 통한 스타일 정의 최적화 및 데이터 전송량 감소
  • ISO 4217 표준 기반 162종의 Currency Code 매핑 테이블을 통한 글로벌 포맷팅 자동화
  • Excel Native Date Format Code를 CSV/Markdown 스트링으로 변환하는 포맷팅 변환 계층 구축
  • Formula 처리 로직을 셀 값의 Prefix(=) 기반으로 처리하여 연산 기능을 추상화한 인터페이스 제공

- 포맷별 개별 라이브러리 도입 대신 추상화된 데이터 스키마를 통한 통합 인터페이스 검토 - 스타일 정의 시 기본값(Base)과 예외값(Override)을 분리하여 설정 데이터의 복잡도 제어 - 글로벌 서비스 설계 시 ISO 표준 코드 기반의 포맷팅 엔진을 구축하여 지역별 대응 최적화

원문 읽기