HOMEGGU - 삼성 청년 SW 아카데미(SSAFY) 11기 2학기 자율 프로젝트

✅ 프로젝트 개요

기획 배경

• 최근 고물가와 친환경에 대한 관심이 맞물려 중고 가구 시장이 빠르게 성장하고 있지만, 이와 관련된 서비스가 아직 눈에 띄지 않는 실정입니다.
  
• 따라서 이러한 틈새시장을 공략하기 위해 중고 가구 거래 플랫폼 '홈꾸(HOMEGGU)'를 기획하게 되었습니다.

진행 기간

📅 2024.10.14 ~ 2024.11.18 (5주)

담당 역할

이름	역할	개발 내용
이규빈	팀장, BackEnd	- MSA 설계(Gateway, Discovery, FeignClient 등) - pay 서비스(머니 충전 및 송금, 사용내역 조회, 데이터 동시성 제어 등)
김태성	BackEnd
안해찬	BackEnd
최윤석	BackEnd, Infra
박선민	FrontEnd
장유진	FrontEnd

🛠 기술스택

FrontEnd
BackEnd
Database
Infra
Tools

🛠 개발 환경

FrontEnd

react : 18 / redux : 5.0.1 / next.js : 14.2.16 / tailwind CSS : 3.4.1 / shadcn-ui : 0.9.2 / three.js : 0.170.0 / stomp.js : 2.3.3

BackEnd

JDK17 / SpringBoot : 3.3.4 / JPA : 3.2.7 / Querydsl : 5.0.0 / JWT : 0.12.5 / RabbitMQ : 4.0.3 / FastAPI

Spring Cloud openfeign : 4.1.3 / Spring Cloud netflix-eureka-client : 4.1.3

Database

Mysql : 9.1.0 / MongoDB : 8.0.3 / Redis : 7.4.1

Infra

Ubuntu : 20.4.6 / Docker : 27.3.1 / NginX : 1.27.2 / Jenkins : 2.484

🏠 시스템 아키텍쳐

Next.js

• 다양한 렌더링 방식(SSR, SSG, CSR 등)을 활용하고 검색엔진 최적화(SEO)를 위해, 프론트엔드 서버로 Next.js를 선택했습니다.

MSA(Micro Service Architecture)

• 시스템의 유연성과 확장성을 도모하기 위해 아키텍처를 MSA로 설계했습니다. 이를 통해 각 서비스를 독립적으로 개발/배포할 수 있었습니다.
• 또한 장애 격리 효과도 기대해볼 수 있습니다. 예컨대 pay 서비스에 장애가 발생하더라도 user, goods 등 다른 서비스는 정상적으로 동작되도록 하고자 했습니다.

✅ 주요기능 소개

중고 가구 쇼핑

메인	상품 상세	구매

상품 등록 및 이미지 변환

상품 등록	이미지 변환 (2D to 3D)	변환 완료

• 판매자는 중고가구 상품 등록시 이미지를 첨부할 수 있고, 이는 백그라운드에서 3D로 변환됩니다.
• 사용자는 토스트 알림을 통해 변환 진행률을 확인할 수 있습니다 (중간 사진 좌측 하단). 이를 통해 변환 중 다른 작업을 할 수 있도록 하여 사용자 경험을 개선하였습니다.
• 변환이 완료되면 3D 모델 파일을 다운로드 받을 수 있고, 이를 다시 업로드하여 3D 가구배치에 활용할 수 있습니다.

3D 가구배치 시뮬레이션

벽/방 샘플	가구 샘플

빈 도면	배치 결과 (2D)	배치 결과 (3D)

• 사용자는 빈 도면에 벽이나 방 샘플을 배치해 본인 집과 유사한 환경을 만들 수 있습니다.
• 여기에 위에서 변환된 3D 가구 파일을 배치하여, 구매 전 미리 배치 결과를 시뮬레이션 해볼 수 있습니다.

맞춤형 상품 추천

회원가입시 설문조사	상품 추천

• 회원가입시 설문조사를 통해 사용자의 인테리어 취향 정보를 수집합니다(cold start). 이를 통해 새로운 취향 발견이 어려운 컨텐츠 기반 필터링의 한계를 보완합니다.
• 상품 조회시 누적된 데이터(구매, 조회, 좋아요 등)와 위 설문조사 결과를 종합하여, 사용자 맞춤형으로 추천상품을 보여줍니다.

채팅

채팅 시작 (구매자)	채팅 확인 (판매자)

• 구매자는 상품 상세 페이지에서 판매자에게 채팅을 보낼 수 있습니다.
• 판매자는 구매자들의 채팅을 모아서 확인해볼 수 있습니다.

머니 충전 및 송금

이용내역 조회	안전거래 확정

• 사용자의 계좌를 이용해 홈꾸머니를 충전하고, 이 머니를 판매자에게 보내는 방식으로 송금 기능을 구현했습니다. 이때 데이터 동시성 제어를 위해 비관적 락을 적용했습니다.
• 또한 구매자가 상품을 먼저 확인한 뒤 구매 확정을 해야만 비로소 판매자에게 입급되도록 하는 안전거래(에스크로) 기능을 구현했습니다.

📃 산출물

ERD

• MSA의 장점을 극대화하기 위해 각 서비스의 데이터베이스를 분리했습니다.
• 다른 서비스의 데이터가 필요한 경우 FeignClient을 활용하여 조회했습니다.

API 명세서

• 프론트엔드와 백엔드의 효율적인 의사소통을 위해, Notion으로 각 API의 주소와 요청/응답 형식을 관리했습니다.
• API 주소의 첫 부분에 서비스명을 명시해, Spring Cloud Gateway가 해당 서비스로 요청을 라우팅할 수 있도록 했습니다.

💯 프로젝트 회고

❤ 이규빈

• 팀장을 처음 맡은데다 5주라는 짧은 기간 내 프로젝트를 완성하기 쉽지 않았습니다. 그러나 우리의 목표였던 **"기술적 성장"**을 위해 팀원 모두 열심히 임해준 덕분에 의미 있는 프로젝트를 완성할 수 있었다고 생각합니다.
• MSA 설계 과정에서는 예상치 못한 에러들이 많이 발생해 어려움이 있었지만, 모놀리식 아키텍처와 비교했을 때 MSA의 장점인 유연성과 확장성을 체감할 수 있어 값진 경험이었습니다.
• 평소 시도해보고 싶었던 데이터 동시성 제어를 실제 프로젝트에 적용해볼 수 있어 좋았습니다. 추후 학습을 통해 Redis를 활용한 분산 락도 적용해보고자 합니다.

🧡 김태성

💛 안해찬

💚 최윤석

💙 박선민

💜 장유진