1. 프로젝트 개요

  • 서비스명: Juseyo
  • 기간: 2025.05.02 ~ 2025.06.02
  • 팀 구성:

 

이름  역할  GitHub 
황지윤 PM GitHub
장지현 개발 팀장 GitHub
홍보람 팀원 GitHub
근하람 팀원 GitHub
이현석 팀원 GitHub

 

  • 한 줄 소개: 기업별 자산과 재고를 효율적으로 관리하고 요청·승인 프로세스를 자동화하는 재고 관리 플랫폼입니다.

🌟 주요 특징

  • 부서 및 역할(Role) 기반 권한 관리
  • 요청 → 승인 → 반납 흐름 구조
  • 실시간 상태 추적 및 Excel 입출력
  • SSE 기반 알림 & STOMP 기반 실시간 채팅
  • 사용자 맞춤 비품 추천 기능 구현

2. 사용 기술 스택

Frontend React, Next.js, TypeScript
Backend Spring Boot, Spring Security, MySQL
DevOps Docker, EC2, S3, NGINX, Terraform, GitHub Actions
Collab/Test Git, Discord, Swagger

3. 핵심 기능 요약

👥 회원 & 인증

  • 역할 기반 회원가입 (Admin, User, Initial Manager 등)
  • JWT 인증 및 Redis 기반 Refresh Token Rotation
  • 이메일 & 휴대폰 인증

📦 비품 관리

  • 비품 등록, 수정, 삭제, 조회
  • 요청 생성/승인/반려
  • 출고/입고 상태 추적, Excel 내보내기

💬 실시간 채팅

  • 1:1 / 고객센터 / 단체방
  • STOMP + SockJS + JWT 인증
  • Redis를 이용한 채팅방 상태 저장

🔔 실시간 알림

  • SSE 기반 실시간 알림
  • 역할 기반 이벤트 알림
  • 스케줄러 기반 반납일 초과 체크

🔍 검색 및 추천

  • 키워드/카테고리 기반 검색
  • 협업 필터링 알고리즘을 통한 비품 추천

4. 맡은 역할 및 기여 내용

비품 통계 및 분석 기능

  • 카테고리별 분석: 비품을 카테고리 단위로 분류하여 등록 수, 사용률 등 주요 지표를 시각화할 수 있도록 API 제공
  • 월별 출고량/입고량 집계: 월 단위로 입고/출고 이력을 분석해 통계 데이터를 리턴하는 기능 개발
  • 품목별 사용 빈도 통계: 가장 많이 사용된 비품 순위를 도출하여 관리자 대시보드에 제공
  • JPQL을 활용한 동적 쿼리 처리 생성
  • 통계 캐싱 최적화를 위한 Redis 사용
  • 관리 대시보드와 연동되는 데이터 API 설계

비품 관리 및 프로세스 흐름

  • 비품 구매 CRUD 기능 개발: 비품 구매, 수정, 삭제, 조회 API 구현 (Validation, 예외 처리 포함)
  • 상태 전이를 enum 기반 로직으로 설계하여 유지보수성 향상
  • 입출고 관리:
    • 반납 요청 처리: 사용자가 반납 요청 시 재고 상태 변경 및 요청 상태 기록
    • 입고 내역 관리: 반납 승인 시 입고 처리되며, 재고 복구 및 입고 이력 저장
    • 비품 구매 처리: 구매 시 자동 입고 등록 및 이력 연동 처리

관리자 페이지 생성 기능

  • 관리페이지 CRUD: 관리페이지(비품, 사용자, 요청 등)를 위한 API 개발
  • 공공데이터 포털의 사업자등록 상태조회 API를 활용한 사업자 등록번호의 유효성 및 실재 여부 검증
  • 프론트엔드와 협업하여 요청/승인/반려 기능과 통합

사용자 맞춤 비품 추천 기능

  • 협업 필터링 알고리즘 기반 추천 기능 구현
    • 유사 사용자의 요청 데이터를 분석하여 비슷한 품목 추천
    • 사용자 요청 이력 기반 유사도 계산 로직 설계
    • 개인화된 추천 리스트 제공 API 개발

프로젝트 전체 디자인 총괄

  • 색상, 컴포넌트, 레이아웃 정의
  • 공통 UI 컴포넌트 설계 및 반응형 대응
 

5. 어려웠던 점과 해결 방법

 

6. 프로젝트 결과 & 배운 점

7. 링크 및 자료

'Project' 카테고리의 다른 글

프로젝트 회고: Hakple – 학원생 커뮤니티 플랫폼  (1) 2025.05.01

티스토리툴바