개인 프로젝트 · 실무형 운영 MVP

Inventory Management MVP

엑셀 중심으로 관리하던 재고 업무를 웹으로 옮기고, 월별 업로드와 일일 수량 조정을 함께 운영할 수 있게 만든 중소기업용 재고관리 시스템입니다.

프론트엔드

React + Vite

백엔드

FastAPI

데이터 저장

SQLite + SQLAlchemy

운영 방식

Docker Compose

프로젝트 배경

이 프로젝트는 현장에서 실제로 쓰던 재고현황 엑셀과 월별 입출고 통계 파일을 기준으로 시작했습니다. 목표는 복잡한 ERP를 새로 만드는 것이 아니라, 기존 업무 방식은 유지하면서도 검색, 수정, 비교, 부족 판단을 더 빠르게 할 수 있는 운영 화면을 만드는 것이었습니다.

특히 월별 파일에는 이미 계산된 현재고가 들어 있고, 별도로 일일 출고 입력도 필요한 상황이어서 단순 입출고 합산만으로는 부족했습니다. 그래서 월 업로드 데이터를 기준점으로 두고, 이후 입력되는 일일 조정 내역이 현재고와 통계에 함께 반영되도록 구조를 설계했습니다.

핵심 구현 포인트

월별 업로드 미리보기와 선택 반영

외부 시스템에서 받은 XLSX 파일을 바로 덮어쓰지 않고, 업로드 미리보기와 선택 반영 단계를 먼저 두었습니다. 운영자가 항목별 차이를 확인한 뒤 반영할 수 있게 해 실수 가능성을 줄였습니다.

신코드·구코드 동시 관리

업무상 제품코드가 변경되는 상황을 고려해 현재 사용하는 신코드와 예전 구코드를 분리 저장했습니다. 검색과 매칭 로직에서도 두 코드를 함께 활용해 운영자가 제품을 더 쉽게 찾도록 구성했습니다.

현재고 보정과 일일 수량 조정

입고·출고뿐 아니라 실재고를 바로 맞추는 조정 기능도 함께 넣었습니다. 초기 세팅이나 실사 이후에는 절대값 기준으로 현재고를 맞춰야 하는 경우가 많기 때문에, 일반 입출고 기록과 구분된 조정 흐름이 필요했습니다.

부족 재고 판단 로직

최근 3개월 평균 출고량을 기준으로 현재고를 비교해 부족 여부를 판단하도록 만들었습니다. 단순히 이번 달 출고만 보는 대신, 반복 출고 패턴을 기준으로 생산주문이 필요한 품목을 미리 잡아내는 데 초점을 맞췄습니다.

운영 흐름

업로드

월별 XLSX 업로드

검토

미리보기와 비교 확인

반영

선택 반영 및 기준 재고 업데이트

조정

일일 입출고·실재고 조정

판단

부족 재고와 생산주문 판단

기술 구성

React Vite FastAPI SQLite SQLAlchemy openpyxl Docker Compose Tailwind CSS

배운 점

이번 프로젝트를 통해 실무형 도구는 기능을 많이 넣는 것보다, 기존 업무 흐름과 충돌하지 않으면서도 판단 속도를 높이는 구조가 중요하다는 점을 다시 확인했습니다. 엑셀을 완전히 없애기보다 업로드와 비교 중심으로 연결하고, 재고 판단 기준을 운영자 언어로 풀어내는 쪽이 실제 도입에 더 가까운 접근이었습니다.