From 2545d2257b716e541035f0ff6e7321325f65d0cd Mon Sep 17 00:00:00 2001
From: DaveLee-b <76063864+DaveLee-b@users.noreply.github.com>
Date: Wed, 7 Jan 2026 12:52:01 +0900
Subject: [PATCH 1/4] Enhance README with table of contents and conventions

Add table of contents and update conventions section
---
 README.md | 360 ++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 269 insertions(+), 91 deletions(-)

diff --git a/README.md b/README.md
index 33308f6..aa49a36 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,32 @@
 ![Swagger UI](https://img.shields.io/badge/Swagger_UI-85EA2D?style=flat&logo=swagger&logoColor=black)
 <br><br>
 
+## 📑 Table of Contents
+
+- [ShoppingFourU](#shoppingfouru)
+- [👥 Team Member](#-team-member)
+- [🏛 Architecture](#-architecture)
+- [📌 Convention](#-convention)
+- [📡 API Documentation](#-api-documentation)
+- [🔥 Troubleshooting](#-troubleshooting)
+  - [불필요한 쿼리 생성 문제](#불필요한-쿼리-생성-문제)
+  - [JWT 필터 예외 처리 문제](#jwt-필터-예외-처리-문제)
+- [🚀 기본 프로젝트 이후 보완점](#-기본-프로젝트-이후-보완점)
+  - [Git · Slack 알림 & Bot 에러 연동](#-git--slack-알림--bot-에러-연동)
+  - [API 접근 제한 (Rate Limiting)](#-api-접근-제한-rate-limiting)
+  - [Domain Refactoring](#-domain-refactoring)
+    - [할인 · 멤버십 정책 모듈화](#-할인--멤버십-정책-모듈화)
+    - [주문 시 배송지 검증 강화](#-주문-시-배송지-검증-강화)
+  - [주문–결제 프로세스 리팩토링 & 동시성 제어](#-주문결제-프로세스-리팩토링--동시성-제어)
+  - [낙관적 락 (Optimistic Lock) 도입](#-낙관적-락-optimistic-lock-도입)
+  - [재고 예약 시스템 도입](#-재고-예약-시스템-도입)
+  - [찜 (Wishlist) 도메인 추가](#-찜-wishlist-도메인-추가)
+- [🧪 새로운 기술 도입 사항 및 선정 이유](#-새로운-기술-도입-사항-및-선정-이유)
+  - [상품 할인 시 이메일 알림 시스템 도입](#상품-할인-시-이메일-알림-시스템-도입)
+  - [OpenAI 기반 FAQ 챗봇 도입](#openai-기반-faq-챗봇-도입)
+  - [ELK + 모니터링 시스템 도입](#elk--모니터링-시스템-도입)
+
+
 # ShoppingFourU
 `ShoppingFourU` 는 온라인 쇼핑몰 운영에 필요한 기능들을 완전하게 구현한 E-commerce 플랫폼입니다.<br>
 회원 관리부터 상품 등록, 장바구니, 주문/결제까지 실제 서비스와 동일한 흐름을 제공하며<br>
@@ -35,100 +61,13 @@
 ## 🏛 Architecture
 
 📜 ERD 설계도
-<img width="1902" height="858" alt="image" src="https://github.com/user-attachments/assets/b8cd6585-15a3-4266-a9c0-eae0f79661f1" />
-<br>
-
-## 📌 Naming Rules
-
-| 항목        | 규칙           |
-| --------- | ------------ |
-| Package   | `kebab-case` |
-| Class     | `PascalCase` |
-| Constant  | `UPPERCASE`  |
-| Method    | `camelCase`  |
-| Variables | `camelCase`  |
-<br>
-
-
-## 📁 Commit Convention
-
-| Header       | 기능                   |
-| ------------ | -------------------- |
-| **Update**   | 변경 사항 업데이트           |
-| **feat**     | 새로운 기능 추가            |
-| **fix**      | 버그 수정                |
-| **docs**     | 문서 수정                |
-| **style**    | 코드 포맷팅               |
-| **refactor** | 코드 리팩토링              |
-| **test**     | 테스트 코드               |
-| **chore**    | 빌드 업무 수정, 패키지 매니저 수정 |
-| **comment**  | 주석 추가 및 변경           |
-| **remove**   | 파일, 폴더 삭제            |
-| **rename**   | 파일, 폴더명 수정           |
-<br>
-
-
-✔ 커밋 메시지 형식<br>
-
-[티켓 번호] 작업 유형: 작업 내용<br><br>
-
-✔ 예시<br>
-
-[TKT-15] feat: 로그인 시 잠금 검증 기능 추가<br>
-
-[TKT-17] chore: 라이브러리 추가<br>
-
-[TKT-23] feat: 인증/인가 기능 추가<br>
-<br>
-
-
-## 🐬 Git Flow
-
-<img width="1476" height="1038" alt="image" src="https://github.com/user-attachments/assets/4c56ca48-d36b-4132-a545-30960f410f0b" />
-
-- **main** : 출시 가능한 프로덕션 코드의 브랜치
-
-- **dev** : 다음 버전을 개발하는 브랜치
-
-- **feat** : 이슈 단위로 기능을 개발하는 브랜치  
-  - 브랜치 네이밍: `feat/#이슈번호/[topic]`
-
-- **fix** : 이슈 단위로 버그를 수정하는 브랜치  
-  - 브랜치 네이밍: `fix/#이슈번호/[topic]`
-
-*브랜치명은 Jira 작업을 생성하면 자동으로 생성됩니다.
-<br>
-<br>
-
-
-## 🧩 Issue Template
-
-✨이슈 설명
-<br><br>
-
-
-🔥투두리스트
-<br><br>
-
-
-🔖기타 사항
-<br><br>
+<img width="2398" height="1454" alt="basic-project-shopping_last_last_copy" src="https://github.com/user-attachments/assets/ad08aeba-4c13-4351-b23e-630429d8f662" />
 <br>
 
-## 🔀 PR Template
+## 📌 Convention
+자세한 컨벤션사항은 노션을 통해 확인 해주세요!
+https://vivid-thyme-ac6.notion.site/Commit-Convention-2e19e3e335cc80d7bf16c7377e4ddeac?source=copy_link
 
-📝요약(Summary)<br>
-이슈 번호 : #
-<br><br>
-
-
-🔨변경 사항(Changes)
-<br><br>
-
-
-😉리뷰 요구사항
-<br><br>
-<br>
 
 ## 📡 API Documentation
 
@@ -190,3 +129,242 @@ return header.substring(BEARER_PREFIX.length());
 예외를 던지지 않고 null 반환<br>
 - 이렇게 하면 Security에서 인증없이 통과시키고
 Controller 로직까지 정상적으로 전달됨
+
+## 🚀 기본 프로젝트 이후 보완점
+
+기본 프로젝트 구현 이후,  
+실제 운영 환경에서 발생할 수 있는 문제들을 가정하고 **안정성과 확장성**을 중심으로 구조를 보완했습니다.  
+단순 기능 구현을 넘어서 **운영 관점의 품질 개선**에 초점을 맞췄습니다.
+
+### 🔔 Git · Slack 알림 & Bot 에러 연동
+
+#### 도입 배경
+- 에러 발생 시 로그 확인이 늦어짐
+- PR, 배포 이벤트가 팀 전체에 공유되지 않음
+
+#### 개선 내용
+- GitHub 이벤트 → Slack **실시간 알림 연동**
+- PR 생성 / 머지 / 배포 알림 **자동화**
+- 주문 실패, 결제 오류 등 **중요 도메인 에러 Bot 알림**
+- 장애 상황에 대한 **즉각적인 팀 단위 대응 가능**
+
+#### 효과
+- 이슈 인지 시간 단축
+- 운영 중 발생하는 문제에 대한 가시성 확보
+
+---
+
+### 🚦 API 접근 제한 (Rate Limiting)
+
+#### 도입 배경
+- 무분별한 API 호출로 인한 서버 부하 및 서비스 품질 저하 우려
+
+#### 설계 목표
+
+**1차 방어**
+- Global Filter 기반 IP 단위 제한
+- 초당 100회 / 최대 10,000 IP 기준
+
+**2차 방어**
+- AOP 기반 Controller 단위 접근 제어
+- API 특성에 따라 IP / 사용자별 제한 정책 분리 적용
+
+#### Bucket4j 선택 이유
+- 메서드별로 서로 다른 제한 정책 적용 가능
+- Redis 사용이 제한적인 환경 고려
+- Caffeine 기반 캐시로 **경량 · 고성능 · 동시성 안정성 확보**
+
+---
+
+### 🧠 Domain Refactoring
+
+#### 1️⃣ 할인 · 멤버십 정책 모듈화
+
+**기존 문제**
+- 멤버십과 할인 구조가 1:1로 강하게 결합
+- 할인 로직이 복잡하여 다른 도메인 적용이 어려움
+
+**개선 사항**
+- 상품별 할인 구조 도입
+- 할인 조합 가능 구조 설계
+- 최대 할인 자동 계산 로직 추가
+- 할인 계산 로직을 별도 서비스로 분리
+
+**결과**
+- 할인 정책 확장성 증가
+- 다른 도메인에서도 재사용 가능한 구조 확보
+
+---
+
+#### 2️⃣ 주문 시 배송지 검증 강화
+
+**개선 내용**
+- 배송지 미입력 시  
+  → 유저의 기본 배송지 중 **가장 최근 주문에 사용된 배송지 자동 적용**
+- 주문 요청 시 전달된 배송지 ID가  
+  → **해당 유저 소유 배송지인지 검증 로직 추가**
+
+**효과**
+- 잘못된 배송 정보로 인한 주문 오류 방지
+- 사용자 경험 개선
+
+---
+
+### 💳 주문–결제 프로세스 리팩토링 & 동시성 제어
+
+#### 기존 문제점
+- 주문 / 결제 API가 분리된 트랜잭션 구조  
+  → 결제 성공 후 재고 차감 실패 시 롤백 불가
+- 재고 동시성 제어 부재  
+  → 초과 판매 가능성 존재
+
+#### 개선된 프로세스
+
+**주문 생성 API**
+- 상품 구매 가능 여부 확인
+- 주문 정보 저장  
+  👉 상태: `PENDING_PAYMENT`
+
+**결제 생성 API**
+- 외부 결제 모듈 호출
+- **(Transaction)**
+  - 결제 정보 저장
+  - 상품 재고 차감
+  - 주문 상태 변경 → `PAID`
+
+> 💡  
+> 외부 결제 API 호출은 트랜잭션에 포함하지 않고,  
+> DB 변경 로직만 원자적으로 묶어 **락 점유 및 성능 저하를 방지**
+
+---
+
+### 🔐 낙관적 락 (Optimistic Lock) 도입
+
+- 상품 엔티티에 `@Version` 필드 추가
+- 동시 재고 차감 시 커밋 시점에 충돌 감지
+- 충돌 발생 시 예외 처리 후 재시도 전략 적용
+
+**선택 이유**
+- 재고 충돌 빈도가 낮은 구조
+- 비관적 락보다 성능상 유리하다고 판단
+
+---
+
+### 📦 재고 예약 시스템 도입
+
+#### 도입 이유
+- 동시 주문 환경에서 초과 판매 방지
+- 결제 완료 전 구매 권한 선점 필요
+
+#### 프로세스
+
+**주문 생성 시**
+- 재고 차감
+- 재고 예약 정보 저장
+- 주문 상태: `PENDING_PAYMENT`
+
+**결제 성공 시**
+- 재고 예약 해제
+- 주문 상태 변경: `PAID`
+
+**결제 실패 / 예약 만료 시**
+- 예약 정보 삭제
+- 재고 복구
+
+#### 결과
+- 재고 동시성 문제 근본적 해결
+- 안정적인 주문–결제 흐름 확보
+
+---
+
+### ❤️ 찜 (Wishlist) 도메인 추가
+
+#### 도입 배경
+- 구매 전 탐색 단계에서의 **명확한 관심 데이터 확보**
+- 할인 알림 등 비동기 알림 기능의 기준 도메인 필요
+- 장바구니와 목적이 다른 **중·장기 관심 상품 관리 도메인 분리**
+
+#### 효과
+- 사용자 행동 데이터 정교화
+- 할인 알림, 추천 기능 등 확장 기반 확보
+- 도메인 책임 분리로 로직 명확성 향상
+
+
+
+##  새로운 기술 도입 사항 및 선정 이유
+
+
+### 상품 할인 시 이메일 알림 시스템 도입
+
+#### 도입 배경
+- 할인 및 이벤트 발생 시, 사용자가 사이트에 접속 중이 아니더라도  
+  정보를 전달받을 수 있도록 **사용자 편의성 향상**을 목표로 함
+
+#### 해결 목표
+- 찜한 상품 또는 장바구니에 담긴 상품에 할인 이벤트 발생 시  
+  이메일 알림을 통해 **기간이 짧은 이벤트를 놓치지 않도록 유도**
+- 찜 / 장바구니에 동시에 존재하는 상품에 대해  
+  **중복 메일 발송 방지 로직 적용**
+
+#### 이메일 선정 이유
+- 대부분의 사용자가 이메일을 보유하고 있어 접근성이 높음
+- 회원가입 시 이미 이메일 정보를 수집하므로  
+  추가 정보 입력이나 외부 서비스 참여를 요구하지 않아도 됨
+- Slack, Discord 등은 별도의 프로그램 사용 및 공간 참여가 필요하여  
+  사용자 알림 목적과 맞지 않아 제외
+- 카카오톡 채널의 경우
+  - 사업자 등록 필수
+  - 유료 메시지 발송
+  - 카카오 계정 관련 정보 추가 관리 필요  
+  → 운영 비용 및 복잡성 증가로 인해 제외
+
+### OpenAI 기반 FAQ 챗봇 도입
+
+#### 팀 방향성
+- 신규 AI 기능 확장보다는 **기존 서비스 내부 기능 강화**에 중점
+- FAQ 외 NOTICE, POLICY 챗봇도 검토하였으나  
+  팀 방향성과 일정 고려하여 **FAQ 챗봇 우선 개발** 결정
+
+#### 개발 방식
+- 강사님 제공 OpenAI 예제 코드 기반으로 개발
+- 기존 구조를 그대로 사용하지 않고
+  - 폴더 구조 세분화
+  - 일부 로직 수정 및 책임 분리
+
+#### 데이터 구성
+- 도메인별 자주 묻는 질문과 답변을 **JSON 파일로 정리**
+- 해당 데이터를 기반으로 **벡터 스토어(Vector Store) 연동**
+
+#### 기능 범위
+- FAQ JSON 데이터 기반 질의응답 제공
+- 서비스 담당 도메인 외 질문에 대해서는  
+  응답을 제한하여 **비의도적 답변 방지**
+
+### ELK + 모니터링 시스템 도입
+
+#### 도입 배경
+- 서비스 운영 단계에서 발생하는 에러 및 장애 원인을  
+  단순 코드 로그만으로 추적하는 데 한계 존재
+- 로그 수집 · 분석 · 시각화를 위해 **ELK 스택 도입**
+- 이후 서버가 간헐적으로 다운되는 현상 발생
+  - ELK 로그만으로는 원인 파악이 어려움
+- CPU / 메모리 사용량, 컨테이너 리소스 상태 등  
+  **시스템 전반의 상태를 함께 확인할 필요성 인지**
+- 이에 따라 **Prometheus + Grafana** 추가 도입
+
+#### 역할 분리 및 활용
+
+**ELK Stack**
+- 에러 로그 수집
+- 요청 흐름 및 장애 원인 추적
+
+**Prometheus + Grafana**
+- EC2 및 Docker 컨테이너 리소스 모니터링
+- CPU / 메모리 / 서비스 부하 상태 실시간 시각화
+
+#### 도입 효과
+- 로그와 메트릭을 분리하여 분석 가능
+- 서비스 장애 발생 시 원인 파악 속도 향상
+- 운영 관점에서 시스템 상태를 한눈에 파악 가능
+
+

From 7c6e1dca6b3f54f4d747a741e7d8882a7ed2a3c6 Mon Sep 17 00:00:00 2001
From: DaveLee-b <76063864+DaveLee-b@users.noreply.github.com>
Date: Wed, 7 Jan 2026 14:08:38 +0900
Subject: [PATCH 2/4] Update section header for new technology introduction

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index aa49a36..789d835 100644
--- a/README.md
+++ b/README.md
@@ -291,7 +291,7 @@ Controller 로직까지 정상적으로 전달됨
 
 
 
-##  새로운 기술 도입 사항 및 선정 이유
+###  🧪 새로운 기술 도입 사항 및 선정 이유
 
 
 ### 상품 할인 시 이메일 알림 시스템 도입

From fea5ad9d579bb8f2cfe1adf026d3a80a2d97138f Mon Sep 17 00:00:00 2001
From: DaveLee-b <76063864+DaveLee-b@users.noreply.github.com>
Date: Wed, 7 Jan 2026 14:26:19 +0900
Subject: [PATCH 3/4] Refactor README section titles and formatting

Updated section titles and improved formatting in README.
---
 README.md | 136 ++++++------------------------------------------------
 1 file changed, 15 insertions(+), 121 deletions(-)

diff --git a/README.md b/README.md
index 789d835..72720e7 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@
   - [낙관적 락 (Optimistic Lock) 도입](#-낙관적-락-optimistic-lock-도입)
   - [재고 예약 시스템 도입](#-재고-예약-시스템-도입)
   - [찜 (Wishlist) 도메인 추가](#-찜-wishlist-도메인-추가)
-- [🧪 새로운 기술 도입 사항 및 선정 이유](#-새로운-기술-도입-사항-및-선정-이유)
+- [🚀 새로운 기술 도입 사항 및 선정 이유](#-새로운-기술-도입-사항-및-선정-이유)
   - [상품 할인 시 이메일 알림 시스템 도입](#상품-할인-시-이메일-알림-시스템-도입)
   - [OpenAI 기반 FAQ 챗봇 도입](#openai-기반-faq-챗봇-도입)
   - [ELK + 모니터링 시스템 도입](#elk--모니터링-시스템-도입)
@@ -78,6 +78,7 @@ https://vivid-thyme-ac6.notion.site/Commit-Convention-2e19e3e335cc80d7bf16c7377e
 [📄 Swagger Documentation](http://shoppingfouru.ap-northeast-2.elasticbeanstalk.com/swagger-ui/index.html)
 <br><br><br>
 
+
 ## 🔥 Troubleshooting
 
 ### 불필요한 쿼리 생성 문제
@@ -94,7 +95,6 @@ https://vivid-thyme-ac6.notion.site/Commit-Convention-2e19e3e335cc80d7bf16c7377e
 - 쿼리 횟수 50% 감소 (2회 → 1회)
 <br>
 
----
 
 ### JWT 필터 예외 처리 문제
 
@@ -129,6 +129,7 @@ return header.substring(BEARER_PREFIX.length());
 예외를 던지지 않고 null 반환<br>
 - 이렇게 하면 Security에서 인증없이 통과시키고
 Controller 로직까지 정상적으로 전달됨
+<br><br>
 
 ## 🚀 기본 프로젝트 이후 보완점
 
@@ -136,29 +137,10 @@ Controller 로직까지 정상적으로 전달됨
 실제 운영 환경에서 발생할 수 있는 문제들을 가정하고 **안정성과 확장성**을 중심으로 구조를 보완했습니다.  
 단순 기능 구현을 넘어서 **운영 관점의 품질 개선**에 초점을 맞췄습니다.
 
-### 🔔 Git · Slack 알림 & Bot 에러 연동
-
-#### 도입 배경
-- 에러 발생 시 로그 확인이 늦어짐
-- PR, 배포 이벤트가 팀 전체에 공유되지 않음
-
-#### 개선 내용
-- GitHub 이벤트 → Slack **실시간 알림 연동**
-- PR 생성 / 머지 / 배포 알림 **자동화**
-- 주문 실패, 결제 오류 등 **중요 도메인 에러 Bot 알림**
-- 장애 상황에 대한 **즉각적인 팀 단위 대응 가능**
-
-#### 효과
-- 이슈 인지 시간 단축
-- 운영 중 발생하는 문제에 대한 가시성 확보
-
----
-
-### 🚦 API 접근 제한 (Rate Limiting)
+### 1. Git · Slack 알림 & Bot 에러 연동
 
-#### 도입 배경
-- 무분별한 API 호출로 인한 서버 부하 및 서비스 품질 저하 우려
 
+### 2. API 접근 제한 (Rate Limiting)
 #### 설계 목표
 
 **1차 방어**
@@ -174,50 +156,15 @@ Controller 로직까지 정상적으로 전달됨
 - Redis 사용이 제한적인 환경 고려
 - Caffeine 기반 캐시로 **경량 · 고성능 · 동시성 안정성 확보**
 
----
 
-### 🧠 Domain Refactoring
+### 3. Domain Refactoring
 
 #### 1️⃣ 할인 · 멤버십 정책 모듈화
 
-**기존 문제**
-- 멤버십과 할인 구조가 1:1로 강하게 결합
-- 할인 로직이 복잡하여 다른 도메인 적용이 어려움
-
-**개선 사항**
-- 상품별 할인 구조 도입
-- 할인 조합 가능 구조 설계
-- 최대 할인 자동 계산 로직 추가
-- 할인 계산 로직을 별도 서비스로 분리
-
-**결과**
-- 할인 정책 확장성 증가
-- 다른 도메인에서도 재사용 가능한 구조 확보
-
----
-
 #### 2️⃣ 주문 시 배송지 검증 강화
 
-**개선 내용**
-- 배송지 미입력 시  
-  → 유저의 기본 배송지 중 **가장 최근 주문에 사용된 배송지 자동 적용**
-- 주문 요청 시 전달된 배송지 ID가  
-  → **해당 유저 소유 배송지인지 검증 로직 추가**
-
-**효과**
-- 잘못된 배송 정보로 인한 주문 오류 방지
-- 사용자 경험 개선
-
----
-
-### 💳 주문–결제 프로세스 리팩토링 & 동시성 제어
-
-#### 기존 문제점
-- 주문 / 결제 API가 분리된 트랜잭션 구조  
-  → 결제 성공 후 재고 차감 실패 시 롤백 불가
-- 재고 동시성 제어 부재  
-  → 초과 판매 가능성 존재
 
+### 4. 주문–결제 프로세스 리팩토링 & 동시성 제어
 #### 개선된 프로세스
 
 **주문 생성 API**
@@ -236,21 +183,15 @@ Controller 로직까지 정상적으로 전달됨
 > 외부 결제 API 호출은 트랜잭션에 포함하지 않고,  
 > DB 변경 로직만 원자적으로 묶어 **락 점유 및 성능 저하를 방지**
 
----
 
-### 🔐 낙관적 락 (Optimistic Lock) 도입
+### 5. 낙관적 락 (Optimistic Lock) 도입
 
 - 상품 엔티티에 `@Version` 필드 추가
 - 동시 재고 차감 시 커밋 시점에 충돌 감지
 - 충돌 발생 시 예외 처리 후 재시도 전략 적용
 
-**선택 이유**
-- 재고 충돌 빈도가 낮은 구조
-- 비관적 락보다 성능상 유리하다고 판단
 
----
-
-### 📦 재고 예약 시스템 도입
+### 6. 재고 예약 시스템 도입
 
 #### 도입 이유
 - 동시 주문 환경에서 초과 판매 방지
@@ -271,40 +212,14 @@ Controller 로직까지 정상적으로 전달됨
 - 예약 정보 삭제
 - 재고 복구
 
-#### 결과
-- 재고 동시성 문제 근본적 해결
-- 안정적인 주문–결제 흐름 확보
-
----
-
-### ❤️ 찜 (Wishlist) 도메인 추가
-
-#### 도입 배경
-- 구매 전 탐색 단계에서의 **명확한 관심 데이터 확보**
-- 할인 알림 등 비동기 알림 기능의 기준 도메인 필요
-- 장바구니와 목적이 다른 **중·장기 관심 상품 관리 도메인 분리**
-
-#### 효과
-- 사용자 행동 데이터 정교화
-- 할인 알림, 추천 기능 등 확장 기반 확보
-- 도메인 책임 분리로 로직 명확성 향상
-
-
-
-###  🧪 새로운 기술 도입 사항 및 선정 이유
+### 7. 찜 (Wishlist) 도메인 추가
 
+<br>
 
-### 상품 할인 시 이메일 알림 시스템 도입
+##  🚀 새로운 기술 도입 사항 및 선정 이유
 
-#### 도입 배경
-- 할인 및 이벤트 발생 시, 사용자가 사이트에 접속 중이 아니더라도  
-  정보를 전달받을 수 있도록 **사용자 편의성 향상**을 목표로 함
+### 1. 상품 할인 시 이메일 알림 시스템 도입
 
-#### 해결 목표
-- 찜한 상품 또는 장바구니에 담긴 상품에 할인 이벤트 발생 시  
-  이메일 알림을 통해 **기간이 짧은 이벤트를 놓치지 않도록 유도**
-- 찜 / 장바구니에 동시에 존재하는 상품에 대해  
-  **중복 메일 발송 방지 로직 적용**
 
 #### 이메일 선정 이유
 - 대부분의 사용자가 이메일을 보유하고 있어 접근성이 높음
@@ -318,18 +233,7 @@ Controller 로직까지 정상적으로 전달됨
   - 카카오 계정 관련 정보 추가 관리 필요  
   → 운영 비용 및 복잡성 증가로 인해 제외
 
-### OpenAI 기반 FAQ 챗봇 도입
-
-#### 팀 방향성
-- 신규 AI 기능 확장보다는 **기존 서비스 내부 기능 강화**에 중점
-- FAQ 외 NOTICE, POLICY 챗봇도 검토하였으나  
-  팀 방향성과 일정 고려하여 **FAQ 챗봇 우선 개발** 결정
-
-#### 개발 방식
-- 강사님 제공 OpenAI 예제 코드 기반으로 개발
-- 기존 구조를 그대로 사용하지 않고
-  - 폴더 구조 세분화
-  - 일부 로직 수정 및 책임 분리
+### 2. OpenAI 기반 FAQ 챗봇 도입
 
 #### 데이터 구성
 - 도메인별 자주 묻는 질문과 답변을 **JSON 파일로 정리**
@@ -340,17 +244,7 @@ Controller 로직까지 정상적으로 전달됨
 - 서비스 담당 도메인 외 질문에 대해서는  
   응답을 제한하여 **비의도적 답변 방지**
 
-### ELK + 모니터링 시스템 도입
-
-#### 도입 배경
-- 서비스 운영 단계에서 발생하는 에러 및 장애 원인을  
-  단순 코드 로그만으로 추적하는 데 한계 존재
-- 로그 수집 · 분석 · 시각화를 위해 **ELK 스택 도입**
-- 이후 서버가 간헐적으로 다운되는 현상 발생
-  - ELK 로그만으로는 원인 파악이 어려움
-- CPU / 메모리 사용량, 컨테이너 리소스 상태 등  
-  **시스템 전반의 상태를 함께 확인할 필요성 인지**
-- 이에 따라 **Prometheus + Grafana** 추가 도입
+### 3. ELK + 모니터링 시스템 도입
 
 #### 역할 분리 및 활용
 

From 6ae6634e3e66d119d13bc4b1a9fdd5d20b37e9bf Mon Sep 17 00:00:00 2001
From: DaveLee-b <76063864+DaveLee-b@users.noreply.github.com>
Date: Wed, 7 Jan 2026 14:27:30 +0900
Subject: [PATCH 4/4] Fix formatting of table of contents in README.md

---
 README.md | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 72720e7..c43fa8e 100644
--- a/README.md
+++ b/README.md
@@ -23,22 +23,22 @@
 - [📌 Convention](#-convention)
 - [📡 API Documentation](#-api-documentation)
 - [🔥 Troubleshooting](#-troubleshooting)
-  - [불필요한 쿼리 생성 문제](#불필요한-쿼리-생성-문제)
-  - [JWT 필터 예외 처리 문제](#jwt-필터-예외-처리-문제)
+  - [불필요한 쿼리 생성 문제]
+  - [JWT 필터 예외 처리 문제]
 - [🚀 기본 프로젝트 이후 보완점](#-기본-프로젝트-이후-보완점)
-  - [Git · Slack 알림 & Bot 에러 연동](#-git--slack-알림--bot-에러-연동)
-  - [API 접근 제한 (Rate Limiting)](#-api-접근-제한-rate-limiting)
-  - [Domain Refactoring](#-domain-refactoring)
-    - [할인 · 멤버십 정책 모듈화](#-할인--멤버십-정책-모듈화)
-    - [주문 시 배송지 검증 강화](#-주문-시-배송지-검증-강화)
-  - [주문–결제 프로세스 리팩토링 & 동시성 제어](#-주문결제-프로세스-리팩토링--동시성-제어)
-  - [낙관적 락 (Optimistic Lock) 도입](#-낙관적-락-optimistic-lock-도입)
-  - [재고 예약 시스템 도입](#-재고-예약-시스템-도입)
-  - [찜 (Wishlist) 도메인 추가](#-찜-wishlist-도메인-추가)
+  - [Git · Slack 알림 & Bot 에러 연동]
+  - [API 접근 제한 (Rate Limiting)]
+  - [Domain Refactoring]
+    - [할인 · 멤버십 정책 모듈화]
+    - [주문 시 배송지 검증 강화]
+  - [주문–결제 프로세스 리팩토링 & 동시성 제어]
+  - [낙관적 락 (Optimistic Lock) 도입]
+  - [재고 예약 시스템 도입]
+  - [찜 (Wishlist) 도메인 추가]
 - [🚀 새로운 기술 도입 사항 및 선정 이유](#-새로운-기술-도입-사항-및-선정-이유)
-  - [상품 할인 시 이메일 알림 시스템 도입](#상품-할인-시-이메일-알림-시스템-도입)
-  - [OpenAI 기반 FAQ 챗봇 도입](#openai-기반-faq-챗봇-도입)
-  - [ELK + 모니터링 시스템 도입](#elk--모니터링-시스템-도입)
+  - [상품 할인 시 이메일 알림 시스템 도입]
+  - [OpenAI 기반 FAQ 챗봇 도입]
+  - [ELK + 모니터링 시스템 도입]
 
 
 # ShoppingFourU