Things I’ve Built

NZT

NZT

EAN테크놀로지 · 2023.05 ~ 2025.04

탄소중립 관리 SaaS에서 GRESB 보고서 20개 이상 섹션의 입력을 담당했습니다. REST를 GraphQL로 전환하고, ko/en 다국어와 싱가포르 버전, Jest 테스트 환경을 도입했습니다.

담당: GRESB 보고서 입력 핵심 담당, REST → GraphQL 전환, 다국어·해외 버전, 테스트 환경 도입

기술 스택

TypeScript
Next.js
Apollo Client
GraphQL
React Query
Zustand
Emotion
Highcharts
i18next
GraphQL Codegen
Jest
Testing Library

프로젝트 소개

  • 건물의 탄소 배출량을 분석하고 ESG 보고서를 관리하는 탄소중립 관리 SaaS입니다. Next.js 13, Apollo Client(GraphQL), Zustand, Highcharts, i18next, Jest를 사용했습니다.

GRESB 보고서 입력

  • 글로벌 ESG 평가인 GRESB 보고서의 20개 이상 섹션에 대해 입력 폼과 API 연동을 맡았고, 수십 차례의 QA에 대응했습니다.
  • 리포트를 작성·수정·삭제하고 건물 데이터를 연결하는 기능을 개발했고, Excel 보고서 다운로드 요청에는 사용자가 선택한 언어를 반영했습니다.

REST → GraphQL 전환

  • 화면마다 필요한 필드가 달랐지만 REST 응답은 고정되어 있었습니다. GraphQL로 전환해 화면별로 필요한 필드만 요청하도록 바꾸고, Codegen으로 타입을 자동 생성했습니다.
# 목록 화면: 카드에 필요한 필드만
query BuildingList {
  buildings { id name totalEmission }
}

# 상세 화면: 상세에 필요한 필드만
query BuildingDetail($id: ID!) {
  building(id: $id) { id name address emissions { year scope1 scope2 } }
}

# Codegen으로 위 쿼리의 결과 타입을 자동 생성해 컴포넌트에서 사용
화면에 필요한 필드만 요청 (축약 예시)

다국어와 해외 버전, 테스트

  • words.json 사전으로 전 화면에 ko/en을 적용하고 싱가포르 버전을 출시했습니다. 화면에 표시되는 언어뿐 아니라 서버에 전달하는 값까지 함께 확인했습니다.
  • Jest와 Testing Library를 도입하고, 여러 화면에서 쓰는 버튼·카드 같은 공통 컴포넌트에 단위 테스트를 작성했습니다.

결과 및 경험

  • GRESB 보고서 입력을 완성하고 싱가포르 버전을 출시했으며, 팀에 Jest 테스트 환경을 도입했습니다.
  • 공통 UI는 작은 변경도 여러 화면에 영향을 줄 수 있어, 사용자 동작을 테스트로 확인하는 기준을 함께 마련했습니다.