← 포트폴리오 목록

제조 소모품 통합 레코드 관리 플랫폼

맞춤 구현 데모의 주문·발송 운영 흐름을 넘어, 거래처·품목·주문 레코드를 좌측 리스트와 우측 상세 패널로 통합 조회하는 마스터-디테일 관리 체계를 구축합니다.

레코드 위젯 컴포지션 패턴 설계상세 패널을 레코드 타입별 요약/연결/문서 탭 조합으로 구성하는 컴포지션 패턴 구현, 3종 레코드 재사용
증분 갱신 집계 뷰 아키텍처 구현Materialized View 3개로 일별·월별·거래처별 집계를 사전 계산, 필터 조합별 즉각 응답 구조 설계
범용 CSV 마이그레이션 파이프라인 구현컬럼 매핑을 업로드 시점 사용자 지정으로 설계해 소스 형식이 달라도 재사용 가능한 가져오기 도구 구축
서비스 타입Web
업종플랫폼
기술 스택
React 18TypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisRecharts
주요 기능
  • 통합 레코드 마스터-디테일 관리
  • 거래처별·품목별 통합 분석
  • 레거시 데이터 가져오기
  • 역할 기반 권한 관리 및 일괄 내보내기
Overview

프로젝트 개요

범위: 개발, 디자인, 기획

맞춤 구현 데모의 주문·발송 운영 흐름을 넘어, 거래처·품목·주문 레코드를 좌측 리스트와 우측 상세 패널로 통합 조회하는 마스터-디테일 관리 체계를 구축합니다.

작업 범위

  • 통합 레코드 마스터-디테일 관리: 거래처·품목·주문 레코드를 좌측 리스트에서 검색·필터링하고, 선택한 항목의 전체 상세(연결 주문, 최근 문서, 재고 현황)를 우측 패널에 모달 없이 인라인으로 표시합니다
  • 거래처별·품목별 통합 분석: 기간·거래처·품목 조건으로 주문량·출고량·매출액을 다각도로 집계하고 차트로 시각화하여 관리자가 판매 추이를 파악할 수 있습니다
  • 레거시 데이터 가져오기: 기존 관리 프로그램에서 내보낸 품목·단가·거래명세서 CSV 파일을 업로드하면 컬럼을 매핑해 검증 후 신규 시스템으로 일괄 가져옵니다
  • 역할 기반 권한 관리 및 일괄 내보내기: 담당자·관리자 등 역할별로 접근 가능한 메뉴와 데이터 범위를 제한하고, 조회 화면 어디서든 현재 필터 조건 그대로 엑셀로 일괄 내보낼 수 있습니다

주요 업무

  • 통합 레코드 마스터-디테일 관리 화면: 리스트 레일은 가상 스크롤로 대량 레코드를 처리하고, 상세 패널은 선택된 레코드 타입에 따라 요약 카드·연결 항목·문서 탭을 동적으로 구성합니다
  • 거래처별·품목별 통합 분석 화면: 집계는 PostgreSQL Materialized View로 일별·월별 단위를 미리 계산하고, 프론트엔드는 필터 조합을 URL 상태로 동기화해 분석 결과 링크를 공유할 수 있게 설계합니다
  • 레거시 데이터 가져오기 화면: 업로드된 CSV는 컬럼 매핑 UI에서 필드를 지정하고, 서버는 형식·필수값 검증 결과를 행 단위 리포트로 반환하며, 검증 통과 행만 트랜잭션으로 일괄 반영합니다
  • 역할 기반 권한 관리 및 일괄 내보내기 화면: 권한은 역할-메뉴-액션 3단 매핑 테이블로 설계하고, 엑셀 내보내기는 현재 리스트 필터·정렬 상태를 그대로 서버에 전달해 동일 조건의 파일을 생성합니다
제조 소모품 통합 레코드 관리 플랫폼
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

대량 거래처·품목 레코드를 좌측 리스트에서 끊김 없이 스크롤 처리하는 가상화 전략 설계

서로 다른 소스 프로그램에서 내보낸 CSV 컬럼 구조 차이를 흡수하는 범용 매핑 UI 설계

실시간 집계 대신 Materialized View 갱신 주기를 정하는 트레이드오프(신선도 vs 조회 속도) 설계

역할별 데이터 접근 범위를 라우트·API·엑셀 내보내기 3개 지점에서 일관되게 검증하는 구조 설계

구현 내용

핵심 기능 상세

핵심 기능 1

통합 레코드 마스터-디테일 관리

거래처·품목·주문 레코드를 좌측 리스트에서 검색·필터링하고, 선택한 항목의 전체 상세(연결 주문, 최근 문서, 재고 현황)를 우측 패널에 모달 없이 인라인으로 표시합니다.

  • react-window 기반 가상 스크롤로 거래처·품목 리스트 레일의 대량 레코드 렌더링 최적화
  • URL 쿼리 파라미터로 선택 레코드 상태를 동기화해 상세 패널 딥링크 공유 지원
  • 상세 패널은 레코드 타입별 위젯 컴포지션 패턴으로 요약/연결/문서 탭 조합 구성

모달 팝업 대신 리스트-상세 인라인 패널 구조로 재구성해, 여러 레코드를 오가며 비교·검토하는 업무 흐름에서 클릭 왕복을 줄이는 UI 아키텍처를 구현합니다.

통합 레코드 마스터-디테일 관리
통합 레코드 마스터-디테일 관리 실제 화면
핵심 기능 2

거래처별·품목별 통합 분석

기간·거래처·품목 조건으로 주문량·출고량·매출액을 다각도로 집계하고 차트로 시각화하여 관리자가 판매 추이를 파악할 수 있습니다.

  • PostgreSQL Materialized View 3개로 일별·월별·거래처별 집계 사전 계산 구조 설계
  • Recharts 기반 복합 차트(막대+선)로 주문량과 매출액을 동시 시각화
  • 필터 조합(기간/거래처/품목)을 URL 쿼리스트링으로 직렬화해 분석 뷰 공유 기능 구현

실시간 집계 대신 Materialized View 증분 갱신 방식을 도입해, 대량 주문 데이터에서도 필터 변경 시 즉각적인 차트 응답을 확보하는 집계 아키텍처를 구현합니다.

거래처별·품목별 통합 분석
거래처별·품목별 통합 분석 실제 화면
핵심 기능 3

레거시 데이터 가져오기

기존 관리 프로그램에서 내보낸 품목·단가·거래명세서 CSV 파일을 업로드하면 컬럼을 매핑해 검증 후 신규 시스템으로 일괄 가져옵니다.

  • csv-parse로 대용량 CSV 스트리밍 파싱, 헤더 자동 감지 및 컬럼 매핑 UI 연동
  • 행 단위 검증 결과(성공/경고/실패)를 리포트 테이블로 반환하는 검증 파이프라인 구현
  • 검증 통과 행만 PostgreSQL 트랜잭션으로 일괄 삽입, 실패 행은 재업로드 가능하도록 분리 처리

컬럼 매핑을 하드코딩하지 않고 업로드 시점에 사용자가 지정하는 구조로 설계해, 소스 프로그램의 CSV 형식이 달라도 재사용 가능한 범용 마이그레이션 도구를 구현합니다.

레거시 데이터 가져오기
레거시 데이터 가져오기 실제 화면
핵심 기능 4

역할 기반 권한 관리 및 일괄 내보내기

담당자·관리자 등 역할별로 접근 가능한 메뉴와 데이터 범위를 제한하고, 조회 화면 어디서든 현재 필터 조건 그대로 엑셀로 일괄 내보낼 수 있습니다.

  • 역할(role)-메뉴(menu)-액션(action) 3단 권한 매핑 테이블 설계, 라우트·API 양쪽에서 동일 정책 검증
  • exceljs로 서버 사이드 엑셀 생성, 현재 필터·정렬 상태를 쿼리 파라미터로 전달해 조건 일치 보장
  • 권한 없는 메뉴는 사이드바에서 자동 숨김 처리하는 동적 네비게이션 렌더링 구현

권한 검증을 프론트엔드 UI 숨김과 백엔드 API 미들웨어 이중으로 적용해, 화면 조작뿐 아니라 직접 API 호출도 역할 범위 밖 데이터에 접근할 수 없는 구조를 구현합니다.

역할 기반 권한 관리 및 일괄 내보내기
역할 기반 권한 관리 및 일괄 내보내기 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

마스터-디테일 데이터 모델 확장 설계 · 2026.09

거래처·품목·주문 레코드 조회 스키마 확장, 권한 매핑 테이블 3단 구조 설계 및 인덱스 정의

STEP 2

집계 분석 및 마이그레이션 API 개발 · 2026.09

Materialized View 3개 기반 집계 API, CSV 스트리밍 파싱·검증 파이프라인 구현

STEP 3

리스트-상세 UI 및 권한 관리 화면 개발 · 2026.09

React 가상 스크롤 리스트 레일, 인라인 상세 패널, 역할별 동적 네비게이션 구현

STEP 4

권한 검증 및 통합 테스트 · 2026.09

라우트·API 이중 권한 검증 적용, 엑셀 내보내기 조건 일치 테스트, 마이그레이션 리포트 검증

프로젝트 성과

주요 성과

레코드 위젯 컴포지션 패턴 설계상세 패널을 레코드 타입별 요약/연결/문서 탭 조합으로 구성하는 컴포지션 패턴 구현, 3종 레코드 재사용
증분 갱신 집계 뷰 아키텍처 구현Materialized View 3개로 일별·월별·거래처별 집계를 사전 계산, 필터 조합별 즉각 응답 구조 설계
범용 CSV 마이그레이션 파이프라인 구현컬럼 매핑을 업로드 시점 사용자 지정으로 설계해 소스 형식이 달라도 재사용 가능한 가져오기 도구 구축
이중 계층 권한 검증 체계 구축역할-메뉴-액션 3단 매핑을 프론트 UI 숨김과 백엔드 미들웨어 양쪽에 동일 적용하는 권한 구조 설계
Highlights

기술적 주안점

  • 모달 팝업 대신 리스트-상세 인라인 패널 구조로 재구성해, 여러 레코드를 오가며 비교·검토하는 업무 흐름에서 클릭 왕복을 줄이는 UI 아키텍처를 구현합니다
  • 실시간 집계 대신 Materialized View 증분 갱신 방식을 도입해, 대량 주문 데이터에서도 필터 변경 시 즉각적인 차트 응답을 확보하는 집계 아키텍처를 구현합니다
  • 컬럼 매핑을 하드코딩하지 않고 업로드 시점에 사용자가 지정하는 구조로 설계해, 소스 프로그램의 CSV 형식이 달라도 재사용 가능한 범용 마이그레이션 도구를 구현합니다

유사한 프로젝트를 기획하고 계신가요?

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기