[merge] 260207 main merge

README.md

@@ -1,2 +1,159 @@
-# permit-server
-https://www.instagram.com/permit_invites?utm_source=ig_web_button_share_sheet&igsh=ZDNlZDc0MzIxNw==
+# 🎫 Permit Seoul - 티켓 예매 서버
+
+**Permit Seoul**은 공연/페스티벌/행사 등을 위한 티켓 예매 서비스의 백엔드 서버입니다.
+
+[![Instagram](https://img.shields.io/badge/Instagram-E4405F?style=flat&logo=instagram&logoColor=white)](https://www.instagram.com/permit_invites)
+
+---
+
+## 📋 목차
+
+- [기술 스택](#-기술-스택)
+- [시스템 아키텍처](#-시스템-아키텍처)
+- [주요 기능](#-주요-기능)
+- [프로젝트 구조](#-프로젝트-구조)
+- [CI/CD](#cicd)
+
+---
+
+## 🛠 기술 스택
+
+### Backend
+| 구분 | 기술 |
+|------|------|
+| **Language** | Java 17 |
+| **Framework** | Spring Boot 3.2.1 |
+| **ORM** | Spring Data JPA |
+| **Security** | Spring Security, JWT, OAuth2 (Google, Kakao) |
+| **Database** | MySQL 8.x |
+| **Cache** | Redis |
+| **API Client** | Spring Cloud OpenFeign |
+
+### Infrastructure
+| 구분 | 기술 |
+|------|------|
+| **Cloud** | AWS EC2, S3 |
+| **Container** | Docker, Amazon Corretto 17 |
+| **CI/CD** | GitHub Actions |
+| **Logging** | Loki, Logstash, Discord Webhook |
+| **Resilience** | Resilience4j (Circuit Breaker) |
+
+### External Services
+| 구분 | 기술 |
+|------|------|
+| **Payment** | Toss Payments API |
+| **OAuth** | Google, Kakao 소셜 로그인 |
+| **Notification** | Email (SMTP), Notion API |
+| **QR Code** | ZXing |
+
+---
+
+## 🏗 시스템 아키텍처
+
+```
+┌─────────────┐     ┌─────────────┐     ┌────────────────────────┐
+│   Client    │────▶│   Nginx     │────▶│      Spring Boot       │
+│  (Frontend) │     │  (Reverse   │     │        Server          │
+└─────────────┘     │   Proxy)    │     └───────────┬────────────┘
+                    └─────────────┘                 │
+                                                    │
+    ┌─────────────│────────────│────────────────────│─────────────────│─────────────────│
+    │             │            │                    │                 │                 │                        
+┌───▼────┐  ┌─────▼────┐  ┌────▼─────┐      ┌───────▼───────┐  ┌──────▼───────┐  ┌──────▼───────┐
+│ MySQL  │  │  Redis   │  │  AWS S3  │      │ Toss Payments │  │    Google    │  │    Kakao     │
+│   DB   │  │  Cache   │  │ (Images) │      │      API      │  │    OAuth     │  │    OAuth     │
+└────────┘  └──────────┘  └──────────┘      └───────────────┘  └──────────────┘  └──────────────┘
+```
+
+---
+
+## ✨ 주요 기능
+
+### 🎟 티켓 예매 시스템
+- **실시간 재고 관리**: Redis 기반 동시성 제어
+- **예약 세션 관리**: 7분 TTL의 예약 세션으로 좌석 임시 확보
+- **좌석/티켓 유형 선택**: 다양한 티켓 타입 및 회차 지원
+
+### 💳 결제 시스템
+- **Toss Payments 연동**: 결제 승인 및 취소 API
+- **트랜잭션 분리 아키텍처**: 외부 API 호출을 DB 트랜잭션에서 분리하여 커넥션 효율성 향상
+- **Resilience4j Circuit Breaker**: 외부 API 장애 시 서킷 브레이커 적용
+- **환불 정책**: 행사 시작 3일 전까지 취소 가능
+
+### 👤 사용자 관리
+- **OAuth2 소셜 로그인**: Google, Kakao
+- **JWT 인증**: Access Token 기반 인증
+
+### 🎪 이벤트/행사 관리
+- **행사 CRUD**: 관리자 전용 행사 생성/수정/삭제
+- **타임테이블 관리**: Notion API 연동 타임테이블
+- **좌석 배치도**: 이벤트별 좌석 이미지 관리
+
+### 👥 게스트 관리 (Admin)
+- **QR 체크인**: ZXing 기반 QR 코드 생성 및 스캔
+- **게스트 초대**: 이메일 초대장 발송
+- **입장 관리**: 실시간 체크인/체크아웃
+
+### 🎁 쿠폰 시스템
+- **할인 쿠폰**: 이벤트별 쿠폰 발급 및 적용
+- **쿠폰 코드 생성**: 고유 쿠폰 코드 자동 생성
+
+---
+
+## 📁 프로젝트 구조
+
+```
+src/main/java/com/permitseoul/permitserver/
+├── PermitServerApplication.java
+├── domain/                          # 도메인별 모듈
+│   ├── admin/                       # 관리자 기능
+│   │   ├── coupon/                  # 쿠폰 관리
+│   │   ├── event/                   # 행사 관리
+│   │   ├── guest/                   # 게스트 관리
+│   │   ├── ticket/                  # 티켓 관리
+│   │   └── timetable/               # 타임테이블 관리
+│   ├── auth/                        # 인증/인가
+│   ├── coupon/                      # 쿠폰
+│   ├── event/                       # 행사
+│   ├── payment/                     # 결제
+│   ├── reservation/                 # 예약
+│   ├── reservationsession/          # 예약 세션
+│   ├── ticket/                      # 티켓
+│   └── user/                        # 사용자
+└── global/                          # 공통 모듈
+    ├── aop/                         # AOP 설정
+    ├── config/                      # 설정 클래스
+    ├── exception/                   # 예외 처리
+    ├── external/                    # 외부 API 연동
+    ├── filter/                      # 필터
+    ├── redis/                       # Redis 설정
+    ├── response/                    # 응답 객체
+    └── util/                        # 유틸리티
+```
+
+---
+
+## CI/CD
+
+GitHub Actions를 통한 자동 배포 파이프라인:
+
+```
+main 브랜치 Push
+       ↓
+  GitHub Actions
+       ↓
+  ┌────────────────────────┐
+  │ 1. Checkout            │
+  │ 2. Set up JDK 17       │
+  │ 3. Build (Gradle)      │
+  │ 4. Docker Build & Push │
+  └────────────────────────┘
+       ↓
+  Docker Hub
+       ↓
+  EC2 SSH Deploy
+```
+
+### 워크플로우 파일
+- `CI-PROD.yml` / `CI_DEV.yml`: CI 파이프라인
+- `DOCKER-PROD-CD.yml` / `DOCKER-DEV-CD.yml`: CD 파이프라인

src/main/java/com/permitseoul/permitserver/domain/admin/guestticket/api/service/AdminGuestTicketService.java

@@ -18,12 +18,14 @@
 import com.permitseoul.permitserver.domain.event.core.exception.EventNotfoundException;
 import com.permitseoul.permitserver.global.response.code.ErrorCode;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 
 import java.util.List;
 
 @Service
 @RequiredArgsConstructor
+@Slf4j
 public class AdminGuestTicketService {
     private final AdminGuestRetriever adminGuestRetriever;
     private final GuestTicketEmailSender guestTicketEmailSender;
@@ -53,6 +55,9 @@ public void issueGuestTickets(final long eventId, final List<GuestTicketIssueReq
             throw new AdminGuestTicketApiException(ErrorCode.NOT_FOUND_EVENT);
         } catch (GuestTicketNotFoundException e) {
             throw new AdminGuestTicketApiException(ErrorCode.NOT_FOUND_GUEST_TICKET);
+        } catch (Exception e) {
+            log.error("[Guest Ticket Email] 발송 실패 - 이벤트아이디:{}, 수신자 정보 : {}", eventId, guestTicketList, e);
+            throw new AdminGuestTicketApiException(ErrorCode.INTERNAL_SERVER_ERROR);
         }
     }
 

src/main/java/com/permitseoul/permitserver/domain/admin/util/GuestTicketEmailSender.java

@@ -7,6 +7,7 @@
 import jakarta.mail.MessagingException;
 import jakarta.mail.internet.MimeMessage;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.core.io.ByteArrayResource;
 import org.springframework.core.io.InputStreamSource;
 import org.springframework.mail.javamail.JavaMailSender;
@@ -21,6 +22,7 @@
 
 @Component("guestTicketEmailSender")
 @RequiredArgsConstructor
+@Slf4j
 public class GuestTicketEmailSender {
     private final JavaMailSender mailSender;
     private final TemplateEngine templateEngine;
@@ -64,6 +66,8 @@ public void sendGuestTicketsEmail(
             }
 
             mailSender.send(mimeMessage);
+            log.info("[Guest Ticket Email] 발송 완료 - 수신자: {} ({}), 이벤트: {}, 티켓 수: {}",
+                    guestName, toEmail, eventName, ticketCodes.size());
         } catch (MessagingException | UnsupportedEncodingException e) {
             throw new EmailSendException(ErrorCode.INTERNAL_EMAIL_SEND_ERROR);
         }