Things I’ve Built

SAVEE

SAVEE

EAN테크놀로지 · 2024.07 ~ 현재 · Frontend Lead

건물 에너지 관리 시스템(BEMS) 관리자 웹을 개발했습니다. SSR과 prefetch로 초기 렌더링을 1.3초 줄이고, 평균 번들을 878KB에서 728KB로 줄였습니다.

담당: BEMS 관리자 웹 프론트엔드 리드 (모니터링·리포트, 성능 개선, 가상관제점 편집기)

기술 스택

TypeScript
Next.js
TanStack Query
React Context
Zustand
React Hook Form
Zod
styled-components
Highcharts
Socket.IO
REST API
GitHub Actions

프로젝트 소개

  • 건물의 에너지 사용량과 설비 상태를 조회·분석하는 BEMS 관리자 웹입니다. 사용자는 설비와 기간을 선택해 데이터를 비교하고, 리포트를 내려받아 운영 상태를 확인합니다.
  • Next.js 14, React Query, Zustand, Zod, Highcharts, socket.io를 사용했고, 프론트엔드 리드로 개발과 코드 리뷰를 맡고 있습니다.

초기 렌더링 1.3초 단축

  • 기존에는 CSR 구조라 첫 화면 그래프가 클라이언트에서 데이터를 받은 뒤에야 그려졌고, LCP가 3.5초 이상이었습니다.
  • 첫 화면 그래프의 초기 데이터를 서버에서 React Query로 prefetch하고 hydration으로 넘기도록 바꿔, 초기 렌더링을 1.3초 줄였습니다.
// page.tsx (Server Component)
export default async function DashboardPage({ params }) {
  const queryClient = new QueryClient();
  await queryClient.prefetchQuery({
    queryKey: ["dashboard", "chart", params.buildingId],
    queryFn: () => getDashboardChart(params.buildingId),
  });
  return (
    <HydrationBoundary state={dehydrate(queryClient)}>
      <DashboardChart />  {/* 같은 queryKey로 캐시를 바로 사용 */}
    </HydrationBoundary>
  );
}
서버 prefetch → 클라이언트 hydration (축약 예시, Next.js 14 App Router · React Query v5)

측정 방법: 같은 대시보드 페이지를 개선 전후 Lighthouse로 비교했습니다.

평균 번들 878KB → 728KB

  • bundle analyzer로 확인해 보니 차트와 PDF 생성 라이브러리가 대부분의 페이지 번들에 포함되어 있었습니다.
  • Highcharts는 dynamic import로 분리하고, 쓰지 않던 Highstock은 제거했습니다. jsPDF·html2canvas는 리포트를 만드는 시점에만 불러오도록 바꿨습니다.
  • 그 결과 76개 라우트의 평균 First Load JS가 878KB에서 728KB로, 가장 큰 라우트는 1.2MB에서 1.04MB로 줄었습니다.
                       개선 전        개선 후
평균 First Load JS      878KB    →    728KB   (76개 라우트)
최대 First Load JS      1.2MB    →    1.04MB

// 차트는 필요한 화면에서만 로드
const EnergyChart = dynamic(() => import("./Chart/EnergyChart"), { ssr: false });

// PDF 생성 라이브러리는 다운로드 시점에 로드
const { default: jsPDF } = await import("jspdf");
next build 결과 요약

측정 방법: next build 출력의 라우트별 First Load JS를 개선 전후로 비교해 평균을 냈습니다.

React Query 도입과 중복 요청 제거

  • useEffect로 흩어져 있던 데이터 요청을 React Query로 옮겼습니다. 설비 용도 → 설비 → 관제점 조회가 서로 의존하는데, 값이 준비되기 전에도 그래프 요청이 나가 진입 시 같은 요청이 2회 발생했습니다.
  • 상위 조회가 성공한 뒤에만 하위 조회가 실행되도록 enabled로 연결해 그래프 요청을 1회로 줄였고, 요청 상태에 따라 그래프·로딩·오류 화면을 구분해 표시했습니다.
  • 테이블이 다시 렌더링될 때 컬럼과 행 확장 설정을 매번 생성하던 부분은 메모이제이션하고, 표시용 데이터 가공 코드를 렌더링 로직에서 분리했습니다.
// 설비 용도 목록
const { data: purposes, isSuccess: purposesSuccess } = useQueryEquipmentPurpose({ buildingId });

// 선택된 용도가 준비된 뒤에만 설비 목록 조회
const { data: equipments, isSuccess: equipmentsSuccess } = useQueryEquipmentOrSensorAPI({
  buildingId,
  purposeId: selectedPurpose || 0,
  enabled: !!selectedPurpose && purposesSuccess,
});

// 설비 → 관제점이 준비된 뒤 그래프는 한 번만 요청
const chart = useQueryChartAPI({
  pointIds,
  range,
  enabled: equipmentsSuccess && pointIds.length > 0,
});
상위 조회 성공 후에만 하위 조회 실행 (실제 코드 기반 축약, 그래프 부분은 예시)

리포트 다운로드와 진행 상태

  • 리포트 다운로드는 필요한 API가 모두 끝날 때까지 4초 이상 기다려야 했습니다. 리포트에 들어갈 데이터를 다운로드 전에 prefetchQuery로 미리 요청해 대기 시간을 3초 이내로 줄였습니다.
  • 리포트 생성 진행 상태는 폴링 대신 WebSocket으로 진행률을 받아 표시하고, 생성 중에도 취소할 수 있도록 했습니다.
// 리포트 화면 진입 시 리포트에 들어갈 데이터를 미리 받아 둔다
useEffect(() => {
  reportSections.forEach((section) =>
    queryClient.prefetchQuery({
      queryKey: ["report", section, filter],
      queryFn: () => getReportSection(section, filter),
    }),
  );
}, [filter]);

// 다운로드 버튼: 캐시에 있으면 즉시 사용
const data = await queryClient.ensureQueryData({ queryKey: ["report", section, filter], queryFn });
다운로드 전 데이터 미리 요청 (축약 예시)

측정 방법: 다운로드 버튼 클릭부터 파일 저장까지의 대기 시간을 개선 전후로 비교했습니다.

가상관제점 정의식 편집기와 접근성

  • 가상관제점 정의식 편집기를 전담했습니다. 정의식을 {관제점, 연산자} 배열로 규격화하고, Zod와 React Hook Form으로 항목 단위 검증을 적용했습니다. 긴 설비 등록 폼은 한 화면 안에서 단계별로 입력하도록 제안해 입력 부담을 줄였습니다.
  • 버튼·아이콘의 터치 영역과 색 대비를 개선해 Lighthouse 접근성 점수를 70점에서 90점으로 올렸습니다.
// "A + B × 0.5" 같은 정의식을 항목 배열로 규격화
const termSchema = z.object({
  pointId: z.number({ required_error: "관제점을 선택하세요" }),
  operator: z.enum(["+", "-", "*", "/"]).optional(), // 마지막 항목은 연산자 없음
});
const formulaSchema = z.object({ terms: z.array(termSchema).min(1) });

// React Hook Form useFieldArray로 항목 단위 추가·삭제·검증
const { fields, append, remove } = useFieldArray({ control, name: "terms" });
정의식 규격 (축약 예시)

측정 방법: 접근성 점수는 같은 화면을 Lighthouse 접근성 항목으로 개선 전후 비교했습니다.

결과 및 경험

  • 초기 렌더링 1.3초 단축, 평균 번들 150KB 감소, 리포트 대기 3초 이내, 진입 시 그래프 요청 2회 → 1회, 접근성 70 → 90점을 달성했습니다. GitHub Actions로 운영 배포 워크플로도 추가했습니다.
  • 여러 API를 사용하는 화면에서는 각 요청뿐 아니라 요청 사이의 의존 관계도 살펴야 했습니다. 렌더링 시점은 SSR로, 요청 순서는 enabled로, 코드 로딩은 dynamic import로 다루면서 문제마다 맞는 도구를 골랐습니다.