Super Coffee Mario (슈퍼 커피 마리오)

---

1. 프로젝트 소개

• 프로젝트 명: Super Coffee Mario
• 배경: 이메일만으로 주문하고 조회할 수 있는 커피 주문 시스템입니다.

---

2. 상세 기능

1. 메인 페이지

• 주문하기, 주문 조회, 관리자 전용 페이지로 한 번에 이동할 수 있는 직관적인 UI

2. 이메일 기반 비회원 주문

• 별도의 가입 절차 없이 입력받은 이메일을 활용하여 고객의 주문 이력을 추적 및 통합 관리
• 이메일 형식과 필수 주문 정보의 누락을 방지하고 데이터 신뢰성을 확보

3. 주문 내역 조회

• 주문 시 사용했던 이메일 주소만 입력하면, 별도의 로그인 없이 주문 내역을 확인

4. 관리자 전용 페이지지

• 개별 고객의 주문 내역을 관리자가 한눈에 파악 가능

---

3. 개발 기간

• 2025년 12월 15일 ~ 2025년 12월 22일

---

4. 프로젝트 진행 단계

1. 프로젝트 설계

• 프로젝트 요구사항 분석 및 기획
• ERD 설계 및 협업 컨벤션 설정

2. 인프라 구축 및 도메인 설계

• 프로젝트 개발 환경 구축 및 엔티티 설계
• 핵심 도메인(주문, 상품) 및 API 기본 구조 수립

3. 핵심 로직 구현 및 관리자 기능 고도화

• 주문·상품 관리 핵심 API 구현
• 관리자 기능을 위한 데이터 연동 및 코드 리팩토링

4. 프론트엔드 UI 통합 및 서비스 고도화

• UI 구축 및 백엔드 API 실시간 연동
• 이메일 검증 로직 추가 및 사용자 경험(UX) 개선

5. 최종 고도화 및 서비스 출시 준비

• 상품 사진 데이터 연동을 통한 시각적 UI 강화
• 서비스를 위한 초기 데이터셋 구축 및 최종 테스트 완료

---

5. 팀원 소개

원수연(팀장)	김경재	김현진	송찬의
FE·BE	FE·BE	FE·BE	FE·BE

---

6. 개발 환경

분류	도구	용도
Design	Figma	홈페이지 디자인
Modeling	draw.io (diagrams.net)	데이터베이스 ERD 설계
IDE	IntelliJ IDEA, VS Code, Cursor	백엔드 및 프론트엔드 개발 환경
VCS	GitHub, Git	코드 버전 관리, 이슈 트래킹, 협업 관리
Management	GitHub, Notion	칸반 보드를 활용한 작업 단위(Issue) 관리 및 문서화
Testing	Postman, H2 Console	REST API 테스트 및 데이터 검증

---

7. 기술 스택

분류	기술 스택	상세 설명
Backend	Java 25, Spring Boot 4.0.0	최신 Java 런타임 및 Spring 환경 활용
Frontend	Next.js 16.0, React 19.2	최신 App Router 및 React 서버 컴포넌트 활용
Language	TypeScript 5.x	정적 타입을 통한 프론트엔드 코드 안정성 확보
Styling	Tailwind CSS 4.0	최신 v4 엔진 기반의 유틸리티 퍼스트 스타일링
ORM / DB	Spring Data JPA, H2	객체 중심 데이터 설계 및 인메모리 DB 활용
Build Tool	Gradle, NPM	백엔드 및 프론트엔드 의존성 관리

---

8. ERD

---

9. API

기능	HTTP	경로	담당
메인 페이지	-	/	김현진
주문 페이지 진입	GET	/items	김경재
주문하기	POST	/orders	송찬의
내 주문 확인	GET	/orders?email={email}	김현진
주문 상세	GET	/orders/{id}	송찬의
주문 수정	PUT	/orders/{id}	송찬의
주문 삭제	DELETE	/orders/{id}	김현진
관리자 페이지	GET	/admin/orders	원수연