Skip to content
@26-1-Capstone

26-1 Capstone

README.md

📚 NutriShare - 공동구매 쇼핑몰 프로젝트

📖 목차

🎯 프로젝트 소개

NutriShare는 생필품 등 상품을 공동구매로 모집하고, 장바구니·주문·결제·마이페이지까지 이어지는 흐름을 제공하는 쇼핑/공구 서비스입니다.
웹(React)과 모바일 앱이 동일한 백엔드 API(/api/v1)를 사용하는 구조입니다.

핵심 기능

  • 공동구매 모집·참여·목록/상세 조회
  • 장바구니 담기 및 주문/결제 시스템 (시뮬레이션 결제 플로우)
  • 공동구매 참여 기준 리뷰 작성 및 조회
  • JWT 기반 사용자 인증 (액세스 토큰 + 리프레시 재발급), 카카오·구글 OAuth 로그인
  • 관리자 물품 등록/삭제 및 이미지 관리 (AWS S3)
  • Android, iOS, 데스크탑(웹) 에서 이용 가능한 크로스플랫폼 구성

🏠 홈페이지

구분 URL / 설명
웹(React) 배포 https://react-navy-xi.vercel.app/
앱 Android | iOS TestFlight

📌 기능 구성도

🔍 펼치기

시스템 관점

flowchart LR
  subgraph client["클라이언트"]
    WEB["React 웹\n(Vite)"]
    AND["Android 앱"]
    IOS["iOS 앱"]
  end
  subgraph api["Spring Boot\nNutriShare API"]
    AUTH["인증·회원\nJWT / OAuth2"]
    CAT["상품·검색"]
    GB["공동구매"]
    CART["장바구니"]
    ORD["주문"]
    PAY["결제 확정"]
    MYP["마이페이지·리뷰"]
  end
  subgraph data["데이터·외부"]
    MYSQL[("MySQL")]
    REDIS[("Redis")]
    S3["AWS S3\n(상품 이미지 등)"]
    OAUTH["Kakao / Google"]
  end
  WEB --> api
  AND --> api
  IOS --> api
  AUTH --> OAUTH
  AUTH --> REDIS
  CAT --> MYSQL
  GB --> MYSQL
  CART --> MYSQL
  ORD --> MYSQL
  PAY --> MYSQL
  MYP --> MYSQL
  CAT --> S3
Loading
image

사용자 기능 흐름

회원가입/로그인 (OAuth 또는 개발자 로그인)
    ↓
상품 목록·검색·상세
    ↓
구매 방식 선택
    ├── 장바구니
    └── 공동구매 모집·참여
    ↓
체크아웃 · 주문 생성
    ↓
결제 확정 API
    ↓
마이페이지 (주문·참여·리뷰)
---

📌 API 명세서

🔍 펼치기

공통

항목 내용
Base URL http://3.36.139.67/api/v1
인증 Authorization: Bearer {accessToken}
응답 보통 data 필드에 실제 페이로드
쿠키 withCredentials: true (토큰 재발급 등)

인증·토큰

메서드 경로 설명
GET /auth/dev-login 개발용 즉시 로그인
POST /auth/reissue 액세스 토큰 재발급

사용자·프로필

메서드 경로 설명
GET /users/me 내 프로필
PUT /users/me 프로필·주소 수정
GET /users/me/orders 내 주문
GET /users/me/participations 내 공구 참여
POST /users/me/reviews 리뷰 작성

상품

메서드 경로 쿼리/비고
GET /products size 등
GET /products/search q, size
GET /products/{id} 상세

장바구니

메서드 경로 비고
GET /cart 조회
POST /cart productId, quantity
PUT /cart/{productId} quantity
DELETE /cart/{productId} 삭제

공동구매

메서드 경로 비고
GET /groups size 등
GET /groups/{id} 상세
POST /groups 모집 생성
POST /groups/{id}/join 참여

주문·결제

메서드 경로 비고
POST /orders 주문 생성
POST /payments/confirm 결제 확정

관리자·S3 등 웹에서 호출하지 않는 API는 백엔드 저장소·Swagger 기준으로 확인.

💻 코드

저장소 링크
백엔드 Backend
리액트(웹) web
Android android
iOS mobile

📱 App 설치

플랫폼 링크
Android APK / 스토어 링크 입력
iOS TestFlight

🎬 시연 동영상

🏆 작년 우수팀과의 비교표

항목 NutriShare 최우수 우수1 우수2 우수3
Code ✅ ✅ ✅ ✅ ✅
Doc ✅ ✅ ✅ ❌ ✅
영상 ✅ ✅ ✅ ❌ ✅
화면 W, A, I R R R R
AppStore/GooglePlay ✅ ❌ ❌ ❌ ❌

👥 팀원 소개

역할 이름 GitHub
백엔드 김준호 GitHub
웹 프론트엔드 박성훈 GitHub
Android 신한석 GitHub
iOS 최용주 GitHub

Copyright © 2026 NutriShare. All rights reserved.

Popular repositories Loading

  1. React React Public

    JavaScript

  2. Android Android Public

    Kotlin

  3. Spring Spring Public

    Java

  4. IOS IOS Public

    Swift

  5. tmp tmp Public

    Makefile

  6. .github .github Public

Repositories

Showing 6 of 6 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…