☕ Grids & Circles

Spring Boot와 Next.js 기반의 카페 주문 및 상품 관리 시스템

📖 프로젝트 소개

작은 로컬 카페 Grids & Circles 입니다. 고객들은 온라인 웹사이트를 통해 커피 원두 패키지를 주문합니다. 우리는 매일 전날 오후 2시부터 당일 오후 2시까지의 주문을 취합하여 배송하는 온라인 주문 플랫폼입니다.

🛠️ 기술 스택

👥 팀원 소개

도석환	안병선	김희영	이창중	박민형

🎯 핵심 기능 (MVP)

• 고객: 상품 조회, 장바구니 관리, 주문 생성, 이메일 기반 주문 내역 조회
• 관리자: 상품 CRUD, 일별 주문 통합 조회, 고객별 주문 검색, 배송 상태 관리
• 주문 시스템: 14시 기준 주문 취합, 배송 상태 추적(준비→배송중→완료), 주문 당시 가격 고정

📂프로젝트 구조

backend/
├── src/main/java/com/example/cafe
│   ├── domain
│   │   ├── item
│   │   │   ├── controller
│   │   │   ├── dto
│   │   │   ├── entity
│   │   │   ├── repository
│   │   │   └── service
│   │   └── order
│   │       ├── controller
│   │       ├── dto
│   │       ├── entity
│   │       ├── repository
│   │       └── service
│   └── global
│       └── config
└── src/main/resources

frontend/
├── app
│   ├── page.tsx
│   ├── orders
│   └── search
└── components
    └── ui

🗄️ ERD

🤝 협업 방식

🔀 Branch 전략

Issue 생성 → Branch 생성 → 개발 → Commit → Push → PR → Code Review → Merge

• 이슈 페이지 생성후 관련 브랜치 생성 후 작업
• 기능 단위로 브랜치 생성, 기능 완료 후 Pull Request
• 병합 전 반드시 팀원 리뷰 & 테스트
• 브랜치명 예시

유형	설명
feat/add-product	새로운 기능 추가
feat/add-login-api	새로운 기능(로그인) 추가
fix/delete-user	버그/수정사항 관련

📝 Commit Convention

• 형식 → 커밋 유형: 간단한 설명
• 커밋 유형은 영어 대문자로 작성

유형	설명	예시
feat	새로운 기능 추가	feat: 상품 목록 조회 API 구현
fix	버그 & 수정사항 관련	fix: 에러 수정
test	테스트 코드, 리팩토링 테스트 코드 추가	test: 테스트 코드 추가 및 수정
docs	문서 수정	docs: 문서 수정
refactor	코드 리팩토링	refactor: ItemService 로직 개선

🔍 Code Review 규칙

• 최소 1명 이상의 approve 필요
• 코드 컨벤션 준수 확인