1. [요구 사항 파악] _배달 앱 개발 프로젝트: Spring Boot로 백엔드 구축

두 번째 나의 프로젝트였던 KB 해커톤이 끝난지 약 세 달만에 시작된 세 번째 프로젝트이다.

세 달간 혼자서 매일 자바와 코딩 테스트 준비를 했지만 아직 많이 모자른 느낌이다.

하지만 그래도 지난 프로젝트보다는 코드 한줄 한줄의 의미를 더 많이 파악할 수 있기 때문에

희망을 가지고 열심히 부딪혀 보려고 한다!

---

이번 프로젝트에서는 Java Spring Boot를 활용해서 배달의 민족 같은 음식 배달 앱의 백엔드를 개발하게 되었다.

단순한 API 구현이 아니라 실제 서비스에서 동작하는 시스템을 만든다는 점에서 꽤 흥미롭고 도전적인 프로젝트일것 같다.

 

이 블로그를 통해 프로젝트 진행 과정에서 겪은 시행착오, 배운 점, 고민했던 부분들을 기록하려고 한다.

나중에 다시 돌아봤을 때, “아, 이때 이런 걸 고민했었지!” 하면서 성장한 모습을 볼 수 있는건 의미 있는 일이니깐!

---

1. 프로젝트 개요

이번 프로젝트의 핵심 목표는 Spring Boot를 활용한 음식 배달 서비스 백엔드 구축이다.

기능을 하나씩 구현하면서 어떤 점을 고려해야 하는지, 어떻게 효율적인 구조를 설계할 수 있을지 고민해볼 계획이다.

 

2. 프로젝트 요구사항 분석 - 무엇을 만들 것인가?

이번 포스팅에서는 배달 앱 백엔드 프로젝트의 요구사항을 분석하는 과정을 정리해보려고 한다.

개발을 시작하기 전에 명확한 요구사항을 정리하는 것이 얼마나 중요한지 다시금 깨닫는 시간이었다.

 

   2.1  프로젝트 목표

     • 배달의 민족과 유사한 음식 배달 서비스 백엔드 개발

     • Spring Boot + MySQL을 활용하여 서버 구축

     • RESTful API 설계 및 유저, 가게, 주문, 결제 기능 구현

 

 

3. 요구사항 분석 과정 - 핵심 기능 정의

프로젝트를 시작할 때 가장 먼저 해야 할 일은 어떤 기능이 필요한지 정리하는 것이다.

 

주어진 과제문서를 분석하면서

핵심적으로 구현해야 할 기능을 나눠봤다.

 

  1) 사용자 관련 기능 (회원 & 인증 시스템)

- 배경: 고객, 사장님, 관리자 등 다양한 사용자 유형이 존재

- 핵심 기능:

    • 회원가입 & 로그인 (JWT 인증)

    • 사용자 정보 조회 & 수정

    • 역할(Role) 기반 접근 제어

 

 정리: 배달 서비스이므로 고객과 사장님의 역할이 다름!

→ 따라서, “유저 권한(ROLE)” 에 따라 접근 가능한 API를 구분해야 한다.

 

  2) 가게 및 메뉴 관리 기능

- 배경: 배달 서비스의 핵심은 다양한 가게와 그 안의 메뉴들

- 핵심 기능:

    • 가게 목록 조회 & 상세 조회

    • 사장님이 자신의 가게를 추가/수정/삭제

     • 메뉴 추가 & 수정 & 삭제 기능

 

정리:

• 일반 고객은 가게 목록을 조회할 수 있지만,

• 사장님은 자신의 가게 & 메뉴만 수정 가능하도록 구현해야 한다.

 

 

3) 주문 및 결제 시스템

- 배경: 사용자가 원하는 메뉴를 장바구니에 담고 주문 & 결제까지 진행해야 함

- 핵심 기능:

   • 주문하기 & 주문 내역 조회

   • 사장님이 주문 상태 변경 (주문 접수, 요리 중, 배달 중, 완료 등)

   • 결제 기능 (결제 요청 & 결제 취소)

 

 정리:

• 주문이 들어오면 사장님이 주문을 수락하거나 거부할 수 있어야 함

• 주문 상태를 단계별로 변경할 수 있도록 관리 필요

• 결제 기능은 실제 결제 시스템과 연동하는 구조로 확장 가능하게 설계

 

 

4) 배달 및 리뷰 시스템

-  배경: 배달 주소를 관리하고, 고객이 리뷰를 남길 수 있어야 함

-  핵심 기능:

   • 배달 주소 관리 (추가, 수정, 삭제)

   • 고객이 가게 리뷰 작성 & 수정 & 삭제

   • 사장님이 리뷰에 답글 작성 가능

 

  정리:

• 리뷰 시스템은 단순 CRUD 구현이지만,

• 사장님은 자신의 가게 리뷰만 관리 가능해야 한다!

• 배달 정보는 고객이 여러 개 저장 가능하도록 설계

---

 4. 요구사항 분석을 통해 얻은 인사이트

 

  1) 역할(Role) 기반의 접근 제어 설계가 필수

→ 일반 고객, 사장님, 관리자 등 다양한 사용자 유형이 존재하기 때문에,

→ Spring Security + JWT 기반으로 API 접근을 구분해야 함.

 

  2) 주문의 “상태 관리”가 중요하다

→ 단순히 주문을 저장하는 게 아니라,

→ 주문이 “요리 중” → “배달 중” → “배달 완료” 단계로 변화하는 시스템을 설계해야 함.

 

  3) 결제 시스템의 확장성을 고려해야 한다

→ 현재 프로젝트에서는 단순한 결제 로직을 구현하지만,

→ 이후 실제 결제 서비스(PG사)와 연동할 가능성이 있으므로,

→ “결제 요청 → 승인 → 결제 완료” 같은 흐름을 미리 설계해야 함.

 

  4) ERD 설계가 중요하다

→ 테이블 간의 관계(1:N, N:M)를 미리 정리하지 않으면,

→ 나중에 데이터 처리 로직이 꼬일 가능성이 높음.

 

---

 5. 다음 단계 - API 설계 & 데이터 모델링

 

요구사항을 정리했으니, 다음으로 할 일은 API 설계 & 데이터베이스 모델링입니다.

 

✅ API 엔드포인트 정의 (Swagger 활용)

✅ ERD 기반으로 MySQL 테이블 구조 설계

✅ Spring Boot 프로젝트 기본 세팅 (Gradle, JPA 등)

---

마무리하며…

 

사실 개발을 할 때는 바로 코딩을 시작하고 싶은 마음이 들지만,

요구사항 분석을 제대로 하지 않으면 나중에 큰 혼란이 온다는 걸 다시 한 번 깨달았다.

이번 프로젝트에서는 처음부터 꼼꼼하게 기획 & 설계하고 개발을 진행하려고 한다!

 

다음 포스팅에서는 API 설계 & ERD 분석 과정을 정리할 예정이다.