README.md

🍽️ Table-Now

실시간 식당 예약 및 방문 관리 시스템

📜 Notion으로 보기: Table-Now

---

📚 목차

• 🚀 프로젝트 소개
• 🎯 핵심 목표
• 📌 주요 기능
• 🛠️ 사용 기술
• 🏗️ 아키텍처
• 🧠 기술적 의사결정
• 🧯 트러블 슈팅
• 🗂️ API 명세서
• 🗂️ ERD
• 🧑‍💻 팀원 소개

---

🚀 프로젝트 소개

TableNow는 사용자가 식당을 예약하고 방문할 수 있도록 지원하는 실시간 예약 관리 시스템입니다.
고객, 사장님, 관리자 각각의 요구를 충족하는 다양한 기능을 제공합니다.

---

🎯 핵심 목표

✅ 안정적인 인증 및 보안 체계 구축

• Spring Security + JWT
• Redis: Refresh Token 저장, Access Token 블랙리스트 등록
• OAuth2.0 소셜 로그인 연동

✅ 고속 검색 및 캐싱 성능 강화

• Elasticsearch: 검색 기능 고도화
  • 역색인 → 빠른 검색 속도 보장
  • 형태소 분석, 유사도 기반 랭킹 → 효율적인 검색 엔진 구현
• Redis: 시간대별 인기 검색어 캐싱

✅ 동시성 제어 및 비동기 아키텍처 구현

• Redis 기반 분산 락(Redisson)
• Rabbit MQ 사용

---

📌 주요 기능

👤 사용자 / 고객 관리

• 회원 탈퇴, 프로필 이미지 등록 및 수정
• 프로필 및 가게 이미지 업로드

🏪 가게 운영 기능

• 가게 정보 등록/수정
• 음식 카테고리 등록 및 관리
• 사용자 평점 등록

📅 예약 및 알림

• 실시간 예약 등록
• 이벤트 신청 및 알림
• 빈자리 대기 등록 및 알림

💰 결제 및 정산

• 예약금 결제 처리
• 가게별 매출 정산 및 자동 집계

💬 실시간 채팅

• 예약자 ↔ 사장 1:1 채팅

---

🛠️ 사용 기술

Backend

Security

Etc

Test

DataBase & Caching

Infra

Collaborative Tool

---

🏗️ 아키텍처

---

🧠 기술적 의사결정

• 🔐 동시성 제어를 위한 DB Lock vs Redisson Lock 비교
• 🔎 RDBMS LIKE 검색 VS Elastic Search 의 키워드 검색
• 👤 소셜 로그인(Kakao, Naver)을 WebClient를 사용해서 구현한 이유
• 💬 1:1(예약자:가게) 채팅 기능 고도화를 위해 RabbitMQ Relay를 적용한 이유
• 🔒 기술적 의사 결정: Waitlist 등록 동시성 제어를 위한 락 방식 선택 배경
• 📗 Spring Batch와 Reddison Lock을 선택한 이유
• 📙 Redis + RabbitMQ 기반 이벤트 오픈 구조 도입

---

🧯 트러블 슈팅

• ⚠️ 데이터 정합성 오류: 데이터 변경 시 Redis + ES 반영
• ⚠️ 빈자리 알림 개선 : 스케줄러 → RabbitMQ
• ⚠️ RepositoryItemReader의 페이징 처리 방식에 따른 데이터 변경 시 페이지 밀림 현상
• ⚠️ WebSocket Handshake 시 Authorization 헤더가 누락되는 이유와 테스트 환경의 한계
• ⚠️ Redisson 락 적용 시 데이터 미반영 이슈와 self-invocation 문제

---

🗂️ API 명세서

[API 명세서 보러가기]

---

🗂️ ERD

[ERD 보러가기]

---

🧑‍💻 팀원 소개

👑 리더 최유리 가게 / 카테고리 GitHub

👑 부리더 김한나 인증 / 유저 / 채팅 GitHub

🫅 멤버 박성현 결제 / 정산 GitHub

🫅 멤버 박성호 알림 / 대기목록 GitHub

🫅 멤버 이채원 예약 / 이벤트 GitHub