deliver-foodie

🍜 배달 및 포장 음식 주문 관리 플랫폼 프로젝트

프로젝트 개요

음식 배달 플랫폼 "Deliver Foodie"
사장님과 고객을 연결하는 배달 서비스 플랫폼으로, 편리한 주문과 효율적인 가게 관리를 제공합니다.
개발 기간: 2024.11.06 ~ 2024.11.18 (2주)

👥 팀원 소개 및 역할 분담

이름	포지션	담당 기능	GitHub
손예지	Team Leader	• 회원 인증/인가 시스템 구현 • 회원 /권한 관리 • API 문서화 • 프로젝트 일정 관리 및 조율	@github
신영한	Sub Leader	• 주문 시스템 구현 • 리뷰 기능 개발 • ERD 설계 및 데이터베이스 모델링	@github
손동필	Infra Leader	• 가게/메뉴 관리 시스템 구현 • Gemini AI 챗봇 서비스 연동 • AWS 인프라 설계 및 구축	@github

인프라 설계도

서비스 구성 및 실행방법

필수 요구사항

• Java 17
• PostgreSQL 15
• AWS 계정 (S3 사용)
• Gemini API Key

1. 프로젝트 클론

git clone https://github.com/3NFJ/deliver-foodie-backend.git
cd deliver-foodie-backend

2. 환경변수 설정 application.yml 파일 생성 및 설정

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/your_database
    username: your_username
    password: your_password

  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

aws:
  s3:
    access-key: your_aws_access_key
    secret-key: your_aws_secret_key
    bucket: your_bucket_name
    region: ap-northeast-2

jwt:
  secret: your_jwt_secret_key

ai:
  url: your_url
  key: your_gemini_api_key

3. Docker를 사용한 데이터베이스 설정

docker run --name postgres-container \
  -e POSTGRES_DB=your_database \
  -e POSTGRES_USER=your_username \
  -e POSTGRES_PASSWORD=your_password \
  -p 5432:5432 \
  -d postgres:15

5. 프로젝트 빌드

./gradlew clean build

5. 애플리케이션 실행

./gradlew bootRun

주요 기능

1. 회원 관리

• 회원가입 기능
  • 사용자는 회원가입 후 사용할 수 있다.
  • 회원가입시 닉네임, 이메일은 중복될 수 없다.
• 로그인, 로그아웃 기능
  • 로그인한 경우에만 사용할 수 있다.
  • 로그인은 JWT 기반으로 제공한다.
• 모든 기능은 역할 기반으로 권한이 부여된다. (고객/사장님/관리자)

2. 음식점 관리

   • 관리자 권한의 사용자만 음식점 등록하고 관리할 수 있다.
   • 관리자는 음식점 정보를 등록하고, 수정 및 삭제할 수 있다.
   • 모든 사용자는 음식점 목록을 조회할 수 있다.

3. 메뉴 관리

• 사장님 권한의 사용자는 가게의 메뉴를 등록할 수 있다.
• 메뉴 삭제 및 메뉴 숨기기 기능을 제공한다.
• 모든 사용자는 가게별 메뉴를 조회할 수 있다.

4. 주문 관리

   • 고객은 원하는 가게의 메뉴를 담아 주문할 수 있다.
   • 고객은 실시간 주문 상태를 확인할 수 있다.
   • 주문 확인 중인 주문은 취소할 수 없다.

5. 리뷰 관리

   • 고객 권한의 사용자는 리뷰를 등록할 수 있다.
   • 리뷰 등록/수정 (이미지 업로드)

6. AI 기반 사장님 메뉴 설명 등록

   • 사장님은 Gemini AI를 활용해 메뉴 설명을 제공받을 수 있다.
   • 제공 받은 메뉴 설명은 모아보기 기능을 통해 목록으로 제공한다.

7. 카테고리 기능

   • 관리자 권한의 사용자는 카테고리를 등록하고 관리할 수 있다.

8. 배송지 관리

   • 고객 사용자는 배송지를 등록하고 관리할 수 있다.
   • 배송지는 여러개 등록할 수 있으며, 기본 배송지를 선택할 수 있다.

ERD

기술 스택

Backend

Database

Infrastructure

Development Tools

API docs

📎 전체 API 명세서 보러가기

테이블 명세서

📎 테이블 명세서 보러가기

진행 일정 및 상세 정보 확인하기

📎 3NFJ 팀 시트