GOREON

나에게 맞는 전자기기를 더 빠르고 쉽게 찾아주는 AI 쇼핑몰

프로젝트 기간 : 2026.03.30 ~ 2026.04.30

주요 기능 & 화면

• 반응형 UI (데스크톱 / 태블릿 / 모바일 지원)
  다양한 기기 환경에 맞춰 최적화된 레이아웃을 제공합니다.

• AI 기반 상품 추천
  사용자의 선택을 바탕으로 맞춤형 상품을 추천합니다.

• 추천 상품 기록 조회
  AI가 추천해준 상품들을 다시 확인할 수 있습니다.

• 상품 검색 및 카테고리 탐색
  검색어 또는 카테고리를 통해 원하는 상품을 쉽게 찾을 수 있습니다.

• 장바구니 / 찜
  관심 있는 상품을 저장하고, 한 곳에서 관리할 수 있습니다.

• 주문 내역 조회
  이전에 주문한 상품들을 확인할 수 있습니다.

• 상품 상세 페이지
  상품의 상세 정보와 이미지를 확인할 수 있습니다.

• 리뷰
  상품에 대한 후기를 작성하고 다른 사용자의 리뷰도 확인할 수 있습니다.

팀원 소개

muteLJS

urusekai

leechan9715

kAzee0700

gwonsumin

기술 스택

폴더 구조

GOREON/
├─ frontend/                  # Vite + React 기반 프론트엔드
│  ├─ public/                 # 정적 파일
│  ├─ src/
│  │  ├─ assets/              # 이미지, 아이콘, 미디어 파일
│  │  ├─ components/          # 공통 UI 컴포넌트
│  │  ├─ pages/               # 라우트 단위 페이지
│  │  ├─ layouts/             # 레이아웃 컴포넌트
│  │  ├─ store/               # Redux store, slice
│  │  ├─ styles/              # 전역 스타일, 변수, 믹스인
│  │  ├─ utils/               # 유틸 함수 및 API 보조 로직
│  │  ├─ App.jsx              # 앱 라우팅 진입점
│  │  └─ main.jsx             # React 앱 마운트
│  └─ package.json
├─ backend/                   # Express + MongoDB 기반 백엔드
│  ├─ src/
│  │  ├─ config/              # DB 및 서버 설정
│  │  ├─ controllers/         # 요청 처리 로직
│  │  ├─ models/              # Mongoose 모델
│  │  ├─ routes/              # API 라우터
│  │  ├─ middleware/          # 인증, 에러 처리, 업로드 처리
│  │  ├─ utils/               # 백엔드 유틸 함수
│  │  ├─ app.js               # Express 앱 설정
│  │  └─ server.js            # 서버 실행 파일
│  └─ package.json
└─ README.md

배포

• Frontend : Vercel
  https://goreon.vercel.app/

• Backend : Render
  https://goreon-backend-bfs5.onrender.com

• Database : MongoDB Atlas

• Storage : Cloudflare R2

실행 방법

# frontend
cd frontend
npm install
npm run dev

# backend
cd backend
npm install
npm run dev

프론트엔드는 브라우저에서 http://localhost:3000으로 접속합니다.

환경 변수

배포 환경에서는 Vercel과 Render의 Environment Variables에 값을 등록합니다.
실제 키와 비밀값은 .env에만 보관하고 GitHub에는 업로드하지 않습니다.

# frontend
VITE_API_BASE_URL=

# backend
NODE_ENV=
CLIENT_ORIGIN=
MONGODB_URI=
MONGODB_DB_NAME=
JWT_SECRET=

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=

KAKAO_CLIENT_ID=
KAKAO_CLIENT_SECRET=
KAKAO_REDIRECT_URI=

NAVER_CLIENT_ID=
NAVER_CLIENT_SECRET=
NAVER_REDIRECT_URI=

R2_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_BUCKET_NAME=
R2_PUBLIC_BASE_URL=
R2_REVIEW_IMAGE_PREFIX=

OPENAI_API_KEY=
OPENAI_RECOMMENDATION_MODEL=