From 75e407aee471f3ef2c9d68f5024424b7d1a5b048 Mon Sep 17 00:00:00 2001
From: uykhc <yoon002003@snu.ac.kr>
Date: Tue, 14 Apr 2026 23:07:34 +0900
Subject: [PATCH 01/27] refactor(openapi): migrate from swagger annotations to
 static openapi.yaml

---
 .github/PULL_REQUEST_TEMPLATE/dev.md          |    2 +
 .github/PULL_REQUEST_TEMPLATE/main.md         |    1 +
 .github/workflows/ci.yml                      |    8 +
 .../image/controller/ImageController.kt       |   15 +-
 .../domain/auth/controller/AuthController.kt  |   40 -
 .../auth/controller/SocialAuthController.kt   |   11 -
 .../domain/auth/dto/LoginRequest.kt           |    5 -
 .../domain/auth/dto/RegisterRequest.kt        |    7 -
 .../domain/auth/dto/SignupRequest.kt          |    7 -
 .../domain/auth/dto/SocialLoginRequest.kt     |    5 -
 .../event/controller/EventController.kt       |   11 -
 .../domain/event/dto/core/EventDto.kt         |   15 -
 .../event/dto/request/CreateEventRequest.kt   |   23 -
 .../event/dto/request/UpdateEventRequest.kt   |   23 -
 .../event/dto/response/EventDetailResponse.kt |   52 -
 .../domain/event/dto/response/GuestPreview.kt |   10 -
 .../domain/event/dto/response/MyRole.kt       |    6 -
 .../domain/event/dto/response/ViewerStatus.kt |    8 -
 .../controller/EventRegistrationController.kt |   36 -
 .../controller/MyRegistrationController.kt    |   10 +-
 .../controller/RegistrationController.kt      |   14 -
 .../registration/dto/core/RegistrationDto.kt  |    9 -
 .../dto/core/RegistrationWithEventDto.kt      |   10 -
 .../dto/request/CreateRegistrationRequest.kt  |    4 -
 .../dto/request/DeleteRegistrationRequest.kt  |    5 -
 .../UpdateRegistrationStatusRequest.kt        |    2 -
 .../response/CreateRegistrationResponse.kt    |    4 -
 .../response/GetEventRegistrationsResponse.kt |   14 -
 .../response/GetMyRegistrationsResponse.kt    |   14 -
 .../dto/response/GetRegistrationResponse.kt   |    2 -
 .../dto/response/PatchRegistrationResponse.kt |    3 -
 .../response/RegistrationGuestsResponse.kt    |   10 -
 .../domain/user/controller/UserController.kt  |   54 +-
 .../user/identity/dto/core/UserIdentityDto.kt |    7 -
 src/main/resources/application.yaml           |    7 +
 src/main/resources/static/docs/openapi.yaml   | 1181 +++++++++++++++++
 .../resources/static/docs/swagger-ui.html     |   36 +
 37 files changed, 1239 insertions(+), 432 deletions(-)
 create mode 100644 src/main/resources/static/docs/openapi.yaml
 create mode 100644 src/main/resources/static/docs/swagger-ui.html

diff --git a/.github/PULL_REQUEST_TEMPLATE/dev.md b/.github/PULL_REQUEST_TEMPLATE/dev.md
index ad0b6ad0..558f1a66 100644
--- a/.github/PULL_REQUEST_TEMPLATE/dev.md
+++ b/.github/PULL_REQUEST_TEMPLATE/dev.md
@@ -2,6 +2,8 @@
 
 ### 🧪 로컬 테스트 여부 (작업자 체크)
 - [ ] 로컬에서 Swagger 혹은 테스트 코드로 동작을 확인했습니다.
+- [ ] API 변경이 있다면 `src/main/resources/static/docs/openapi.yaml`을 함께 갱신했습니다.
+- [ ] `/docs/swagger-ui.html`에서 변경 API가 의도대로 보이는지 확인했습니다.
 
 ### 📄 documentation 최신화 여부
 > 변경사항과 관련된 API의 swagger documentation이 실제 동작과 일치하는지 확인합니다.
diff --git a/.github/PULL_REQUEST_TEMPLATE/main.md b/.github/PULL_REQUEST_TEMPLATE/main.md
index e46646af..15cd0692 100644
--- a/.github/PULL_REQUEST_TEMPLATE/main.md
+++ b/.github/PULL_REQUEST_TEMPLATE/main.md
@@ -5,6 +5,7 @@
 - [ ] CI 성공
 - [ ] 환경 변수 설정 확인
 - [ ] dev 서버에서 변경사항에 대해 의도대로 동작함을 확인
+- [ ] API 변경이 있다면 `src/main/resources/static/docs/openapi.yaml` 반영 완료
 
 ### 📝 업데이트 사항 요약
 
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d75114a4..80cda61f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,6 +21,14 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Set up Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Lint OpenAPI YAML
+        run: npx @redocly/cli@latest lint src/main/resources/static/docs/openapi.yaml
+
       - name: Set up JDK 21
         uses: actions/setup-java@v4
         with:
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt b/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
index d774bdb0..1cdb9ea8 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
@@ -4,10 +4,6 @@ import com.wafflestudio.spring2025.common.image.dto.ImageUploadResponse
 import com.wafflestudio.spring2025.common.image.service.ImageService
 import com.wafflestudio.spring2025.domain.auth.LoggedInUser
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
 import org.springframework.http.MediaType
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PostMapping
@@ -22,21 +18,12 @@ import org.springframework.web.multipart.MultipartFile
 class ImageController(
     private val imageService: ImageService,
 ) {
-    @Operation(summary = "이미지 업로드", description = "서버 저장소에 이미지를 업로드합니다.")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "이미지 업로드 성공"),
-            ApiResponse(responseCode = "400", description = "잘못된 요청 (파일 누락/형식 오류 등)"),
-            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-        ],
-    )
     @PostMapping(
         consumes = [MediaType.MULTIPART_FORM_DATA_VALUE],
     )
     fun uploadImage(
-        @Parameter(hidden = true) @LoggedInUser user: User?,
+        @LoggedInUser user: User?,
         @RequestPart("image") image: MultipartFile,
-        @Parameter(description = "이미지를 저장할 상위 경로", required = false)
         @RequestParam(name = "prefix", required = false)
         prefix: String?,
     ): ResponseEntity<ImageUploadResponse> {
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
index fae13d16..f35d874e 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
@@ -5,10 +5,6 @@ import com.wafflestudio.spring2025.domain.auth.dto.LoginResponse
 import com.wafflestudio.spring2025.domain.auth.dto.SignupRequest
 import com.wafflestudio.spring2025.domain.auth.service.AuthService
 import com.wafflestudio.spring2025.domain.auth.service.EmailVerificationService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import jakarta.servlet.http.HttpServletRequest
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PathVariable
@@ -19,23 +15,10 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/auth")
-@Tag(name = "Auth", description = "인증 API")
 class AuthController(
     private val authService: AuthService,
     private val emailVerificationService: EmailVerificationService,
 ) {
-    @Operation(
-        summary = "이메일 회원가입",
-        description = "새로운 사용자를 등록하고 인증 이메일을 발송합니다. 이메일 인증 후 가입이 완료됩니다.",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "204", description = "인증 이메일 발송 성공"),
-            ApiResponse(responseCode = "400", description = "잘못된 요청 (유효하지 않은 email/password/name)"),
-            ApiResponse(responseCode = "409", description = "이미 존재하는 email"),
-            ApiResponse(responseCode = "503", description = "이메일 서비스 장애"),
-        ],
-    )
     @PostMapping("/signup")
     fun signup(
         @RequestBody signupRequest: SignupRequest,
@@ -51,16 +34,6 @@ class AuthController(
         return ResponseEntity.noContent().build()
     }
 
-    @Operation(
-        summary = "이메일 인증",
-        description = "이메일로 받은 인증 코드를 검증하고 회원가입을 완료합니다",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "인증 성공, 유저 등록 완료"),
-            ApiResponse(responseCode = "400", description = "유효하지 않거나 만료된 인증 코드"),
-        ],
-    )
     @PostMapping("/email-verification/{verificationCode}")
     fun verifyEmail(
         @PathVariable verificationCode: String,
@@ -69,13 +42,6 @@ class AuthController(
         return ResponseEntity.ok().build()
     }
 
-    @Operation(summary = "로그인", description = "email로 로그인하여 JWT 토큰을 발급받습니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "로그인 성공, JWT 토큰 반환"),
-            ApiResponse(responseCode = "401", description = "인증 실패"),
-        ],
-    )
     @PostMapping("/login")
     fun login(
         @RequestBody loginRequest: LoginRequest,
@@ -84,12 +50,6 @@ class AuthController(
         return ResponseEntity.ok(LoginResponse(token))
     }
 
-    @Operation(summary = "로그아웃", description = "현재 JWT 토큰을 블랙리스트에 추가하여 로그아웃합니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "204", description = "로그아웃 성공"),
-        ],
-    )
     @PostMapping("/logout")
     fun logout(request: HttpServletRequest): ResponseEntity<Void> {
         val token = resolveToken(request)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
index b43a4ced..dbd09f73 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
@@ -4,9 +4,6 @@ import com.wafflestudio.spring2025.domain.auth.dto.LoginResponse
 import com.wafflestudio.spring2025.domain.auth.dto.SocialLoginRequest
 import com.wafflestudio.spring2025.domain.auth.model.SocialProvider
 import com.wafflestudio.spring2025.domain.auth.service.SocialAuthService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
@@ -18,14 +15,6 @@ import org.springframework.web.bind.annotation.RestController
 class SocialAuthController(
     private val socialAuthService: SocialAuthService,
 ) {
-    @Operation(summary = "소셜 로그인", description = "소셜 로그인을 요청합니다.")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "소셜 로그인 성공"),
-            ApiResponse(responseCode = "401", description = "인증 실패"),
-            ApiResponse(responseCode = "409", description = "이미 가입된 이메일"),
-        ],
-    )
     @PostMapping
     suspend fun social(
         @RequestBody socialLoginRequest: SocialLoginRequest,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
index bf17a881..0d5ffea7 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "로그인 요청")
 data class LoginRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 비밀번호", example = "mypassword", required = true)
     val password: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
index 470bcb7f..32ee7ed3 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
@@ -1,15 +1,8 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "회원가입 요청")
 data class RegisterRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 이름", example = "홍길동", required = true)
     val name: String,
-    @Schema(description = "비밀번호", example = "password123", required = true)
     val password: String,
-    @Schema(description = "프로필 이미지 URL", example = "https://cdn.example.com/profile.png")
     val profileImage: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
index 94c273ff..53618934 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
@@ -1,15 +1,8 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "회원가입 요청")
 data class SignupRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 이름", example = "홍길동", required = true)
     val name: String,
-    @Schema(description = "비밀번호", example = "password123", required = true)
     val password: String,
-    @Schema(description = "프로필 이미지 URL", example = "https://cdn.example.com/profile.png")
     val profileImage: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
index f83e60f3..28fc2bad 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "소셜 로그인 요청")
 data class SocialLoginRequest(
-    @Schema(description = "소셜로그인 제공자", example = "GOOGLE", required = true)
     val provider: String,
-    @Schema(description = "인가 코드 (authorization code)", required = true)
     val code: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
index 7ba5fae8..7e1a9de5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
@@ -10,8 +10,6 @@ import com.wafflestudio.spring2025.domain.event.dto.response.MyEventsInfiniteRes
 import com.wafflestudio.spring2025.domain.event.dto.response.UpdateEventResponse
 import com.wafflestudio.spring2025.domain.event.service.EventService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
@@ -26,12 +24,10 @@ import java.time.Instant
 
 @RestController
 @RequestMapping("/api/events")
-@Tag(name = "Event", description = "이벤트 관리 API")
 class EventController(
     private val eventService: EventService,
 ) {
     @AuthRequired
-    @Operation(summary = "이벤트 생성", description = "새로운 이벤트를 생성합니다")
     @PostMapping // POST /api/events
     fun create(
         @LoggedInUser user: User,
@@ -54,7 +50,6 @@ class EventController(
         return ResponseEntity.ok(CreateEventResponse(publicId))
     }
 
-    @Operation(summary = "이벤트 상세 조회", description = "이벤트 상세 정보를 조회합니다")
     @GetMapping("/{publicId}") // GET /api/events/{publicId}
     fun getById(
         @LoggedInUser user: User?, // nullable
@@ -69,10 +64,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(
-        summary = "내가 만든 이벤트 목록 조회 (무한 스크롤)",
-        description = "로그인된 사용자가 생성한 이벤트 목록을 무한 스크롤 방식(cursor)으로 조회합니다",
-    )
     @GetMapping("/me")
     fun getMyEvents(
         @LoggedInUser user: User,
@@ -89,7 +80,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(summary = "이벤트 수정", description = "이벤트를 수정합니다")
     @PutMapping("/{publicId}") // PUT /api/events/{publicId}
     fun update(
         @LoggedInUser user: User,
@@ -116,7 +106,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(summary = "이벤트 삭제", description = "이벤트를 삭제합니다")
     @DeleteMapping("/{publicId}") // DELETE /api/events/{publicId}
     fun delete(
         @LoggedInUser user: User,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
index 2b4765a2..778ea5ca 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
@@ -1,35 +1,20 @@
 package com.wafflestudio.spring2025.domain.event.dto.core
 
 import com.wafflestudio.spring2025.domain.event.model.Event
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "일정 정보")
 data class EventDto(
-    @Schema(description = "일정 ID (publicId)")
     val id: String,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "이벤트 설명")
     val description: String?,
-    @Schema(description = "장소")
     val location: String?,
-    @Schema(description = "시작 시간 (epoch milliseconds)")
     val startsAt: Long?,
-    @Schema(description = "종료 시간 (epoch milliseconds)")
     val endsAt: Long?,
-    @Schema(description = "정원")
     val capacity: Int?,
-    @Schema(description = "대기 명단 사용 여부")
     val waitlistEnabled: Boolean,
-    @Schema(description = "신청 시작 시간 (epoch milliseconds)")
     val registrationStartsAt: Long?,
-    @Schema(description = "신청 마감 시간 (epoch milliseconds)")
     val registrationEndsAt: Long,
-    @Schema(description = "작성자 ID")
     val createdBy: Long,
-    @Schema(description = "생성 일시 (epoch milliseconds)")
     val createdAt: Long?,
-    @Schema(description = "수정 일시 (epoch milliseconds)")
     val updatedAt: Long?,
 ) {
     constructor(event: Event) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
index db6254ca..1c46a314 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
@@ -1,38 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 생성 요청")
 data class CreateEventRequest(
-    @Schema(description = "이벤트 제목", example = "정기 모임")
     val title: String,
-    @Schema(description = "이벤트 설명", example = "정기 모임입니다")
     val description: String? = null,
-    @Schema(description = "장소", example = "강의실 101")
     val location: String? = null,
-    @Schema(
-        description = "시작 시간 (ISO-8601)",
-        example = "2026-02-02T18:00:00Z",
-    )
     val startsAt: Instant? = null,
-    @Schema(
-        description = "종료 시간 (ISO-8601)",
-        example = "2026-02-02T20:00:00Z",
-    )
     val endsAt: Instant? = null,
-    @Schema(description = "정원", example = "30")
     val capacity: Int,
-    @Schema(description = "대기 명단 사용 여부", example = "true")
     val waitlistEnabled: Boolean,
-    @Schema(
-        description = "신청 시작 시간 (ISO-8601). null인 경우 요청 시점으로 자동 설정됩니다.",
-        example = "2026-02-02T17:00:00Z",
-    )
     val registrationStartsAt: Instant? = null,
-    @Schema(
-        description = "신청 마감 시간 (ISO-8601)",
-        example = "2026-02-02T17:30:00Z",
-    )
     val registrationEndsAt: Instant,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
index e237b56c..2206d5c5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
@@ -1,38 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 수정 요청")
 data class UpdateEventRequest(
-    @Schema(description = "이벤트 제목", example = "정기 모임")
     val title: String? = null,
-    @Schema(description = "이벤트 설명", example = "정기 모임입니다")
     val description: String? = null,
-    @Schema(description = "장소", example = "강의실 101")
     val location: String? = null,
-    @Schema(
-        description = "시작 시간 (ISO-8601)",
-        example = "2026-02-02T18:00:00Z",
-    )
     val startsAt: Instant? = null,
-    @Schema(
-        description = "종료 시간 (ISO-8601)",
-        example = "2026-02-02T20:00:00Z",
-    )
     val endsAt: Instant? = null,
-    @Schema(description = "정원", example = "30")
     val capacity: Int? = null,
-    @Schema(description = "대기 명단 사용 여부", example = "true")
     val waitlistEnabled: Boolean? = null,
-    @Schema(
-        description = "신청 시작 시간 (ISO-8601)",
-        example = "2026-02-02T17:00:00Z",
-    )
     val registrationStartsAt: Instant? = null,
-    @Schema(
-        description = "신청 마감 시간 (ISO-8601)",
-        example = "2026-02-02T17:30:00Z",
-    )
     val registrationEndsAt: Instant? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
index 08d7cccd..4456f298 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
@@ -1,97 +1,45 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 상세 조회 응답")
 data class EventDetailResponse(
-    @Schema(description = "이벤트 정보")
     val event: EventInfo,
-    @Schema(description = "이벤트 생성자 정보")
     val creator: CreatorInfo,
-    @Schema(description = "조회자(viewer) 정보")
     val viewer: ViewerInfo,
-    @Schema(description = "조회자가 할 수 있는 동작")
     val capabilities: CapabilitiesInfo,
-    @Schema(description = "참여자 미리보기 목록")
     val guestsPreview: List<GuestPreview>,
 )
 
-@Schema(description = "이벤트 정보 블록")
 data class EventInfo(
-    @Schema(description = "이벤트 publicId", example = "dj8sadj10djnkas")
     val publicId: String,
-    @Schema(description = "이벤트 제목", example = "제2회 기획 세미나")
     val title: String,
-    @Schema(description = "이벤트 설명", example = "일정 상세 설명...", nullable = true)
     val description: String?,
-    @Schema(description = "장소", example = "서울대", nullable = true)
     val location: String?,
-    @Schema(description = "시작 시간 (ISO-8601)", example = "2026-02-02T18:00:00Z", nullable = true)
     val startsAt: Instant?,
-    @Schema(description = "종료 시간 (ISO-8601)", example = "2026-02-02T20:00:00Z", nullable = true)
     val endsAt: Instant?,
-    @Schema(description = "정원", example = "10", nullable = true)
     val capacity: Int?,
-    @Schema(description = "총 신청자 수(확정+대기 등)", example = "8")
     val totalApplicants: Int,
-    @Schema(description = "신청 시작 시간 (ISO-8601)", example = "2026-02-02T17:00:00Z", nullable = true)
     val registrationStartsAt: Instant?,
-    @Schema(description = "신청 마감 시간 (ISO-8601)", example = "2026-02-02T17:00:00Z")
     val registrationEndsAt: Instant,
 )
 
-@Schema(description = "생성자 정보 블록")
 data class CreatorInfo(
-    @Schema(description = "이름", example = "홍길동")
     val name: String,
-    @Schema(description = "이메일", example = "user@example.com")
     val email: String,
-    @Schema(description = "프로필 이미지", example = "https://example.com/profile.png", nullable = true)
     val profileImage: String?,
 )
 
-@Schema(description = "조회자(viewer) 정보 블록")
 data class ViewerInfo(
-    @Schema(
-        description = "viewer의 등록 상태 (RegistrationStatus 사용)",
-        example = "WAITLISTED",
-    )
     val status: ViewerStatus,
-    @Schema(
-        description = "viewer 이름 (비회원이면 null)",
-        example = "홍길동",
-        nullable = true,
-    )
     val name: String?,
-    @Schema(
-        description = "대기 순번 (WAITLISTED일 때만 숫자, 아니면 null)",
-        example = "3",
-        nullable = true,
-    )
     val waitlistPosition: Int?,
-    @Schema(
-        description = "registrationPublicId (게스트면 값, 아니면 null)",
-        example = "1",
-        nullable = true,
-    )
     val registrationPublicId: String?,
-    @Schema(
-        description = "예약 이메일(게스트면 guestEmail, 로그인 유저면 user email 등 정책에 따름)",
-        example = "skdfsj@gmaldkl",
-        nullable = true,
-    )
     val reservationEmail: String?,
 )
 
-@Schema(description = "가능한 동작 블록")
 data class CapabilitiesInfo(
-    @Schema(description = "공유 링크 가능 여부", example = "false")
     val shareLink: Boolean,
-    @Schema(description = "참여 신청 가능 여부(확정 자리 신청)", example = "false")
     val apply: Boolean,
-    @Schema(description = "대기 신청 가능 여부(정원 찼을 때)", example = "false")
     val wait: Boolean,
-    @Schema(description = "신청 취소 가능 여부", example = "true")
     val cancel: Boolean,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
index 01781f48..2f3314a7 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
@@ -1,21 +1,11 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 이벤트 참여자 미리보기 정보
  * (회원/비회원 포함)
  */
-@Schema(description = "참여자 미리보기 정보")
 data class GuestPreview(
-    @Schema(description = "참여자 ID (비회원이면 null)", example = "1", nullable = true)
     val id: Long?,
-    @Schema(description = "참여자 이름", example = "홍길동")
     val name: String,
-    @Schema(
-        description = "프로필 이미지 URL",
-        example = "https://example.com/profile.png",
-        nullable = true,
-    )
     val profileImage: String?,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
index d1a8b89a..c06024ed 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
@@ -1,21 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 요청자 역할
  * - CREATOR: 이벤트 생성자
  * - PARTICIPANT: 이벤트 참여자 (CONFIRMED / WAITLISTED)
  * - NONE: 로그인은 했지만 참여하지 않음
  */
-@Schema(description = "요청자 역할")
 enum class MyRole {
-    @Schema(description = "이벤트 생성자")
     CREATOR,
 
-    @Schema(description = "이벤트 참여자")
     PARTICIPANT,
 
-    @Schema(description = "이벤트 미참여자")
     NONE,
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
index a250a6db..d85fe72a 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
@@ -1,25 +1,17 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 이벤트 상세 조회 시,
  * "viewer(요청자)"가 해당 이벤트와 어떤 관계에 있는지를 나타내는 상태
  */
-@Schema(description = "이벤트 조회자(Viewer)의 상태")
 enum class ViewerStatus {
-    @Schema(description = "이벤트 생성자")
     HOST,
 
-    @Schema(description = "참여 확정된 사용자")
     CONFIRMED,
 
-    @Schema(description = "대기 중인 사용자")
     WAITLISTED,
 
-    @Schema(description = "강제 취소(차단)된 사용자")
     BANNED,
 
-    @Schema(description = "이벤트와 아무 관계 없는 사용자")
     NONE,
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
index 4fb815e9..213bc67d 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
@@ -6,11 +6,6 @@ import com.wafflestudio.spring2025.domain.registration.dto.response.CreateRegist
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetEventRegistrationsResponse
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
@@ -22,35 +17,9 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/events/{eventId}/registrations")
-@Tag(name = "Registration", description = "이벤트 기준 신청 API")
 class EventRegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "이벤트 참여 신청",
-        description =
-            "특정 이벤트에 신청합니다. 정원이 남아있으면 CONFIRMED로 등록되고, 정원이 찼으나 대기 명단이 허용된 경우 WAITLISTED로 등록됩니다. " +
-                "정원이 찼고 대기 명단이 비활성화된 경우 신청이 거절됩니다.",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "신청 성공"),
-            ApiResponse(
-                responseCode = "400",
-                description =
-                    "유효하지 않은 요청: 3003(Wrong guest name), 3004(Wrong guest email), 2204(Invalid registration window)",
-            ),
-            ApiResponse(
-                responseCode = "403",
-                description = "권한 없음: 3006(Banned user cannot register)",
-            ),
-            ApiResponse(responseCode = "404", description = "이벤트 없음: 2001(Event not found)"),
-            ApiResponse(
-                responseCode = "409",
-                description = "신청 불가: 3001(Registration already exists), 3005(Host cannot register), 2301(Event is full)",
-            ),
-        ],
-    )
     @PostMapping
     fun create(
         @PathVariable eventId: String,
@@ -67,17 +36,12 @@ class EventRegistrationController(
         return ResponseEntity.ok(registration)
     }
 
-    @Operation(
-        summary = "이벤트 신청 목록 조회",
-        description = "특정 이벤트에 속한 신청 목록을 조회합니다. 신청 상태(CONFIRMED/WAITLISTED/BANNED)와 신청 시각을 포함해 반환합니다.",
-    )
     @GetMapping
     fun list(
         @PathVariable eventId: String,
         @LoggedInUser user: User?,
         @RequestParam(required = false) status: String?,
         @RequestParam(required = false) orderBy: String?,
-        @Parameter(description = "다음 페이지 시작 offset (없으면 0부터)")
         @RequestParam(required = false) cursor: Int?,
     ): ResponseEntity<GetEventRegistrationsResponse> =
         ResponseEntity.ok(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
index 6da5b2c9..71022123 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
@@ -5,9 +5,6 @@ import com.wafflestudio.spring2025.domain.auth.LoggedInUser
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetMyRegistrationsResponse
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
@@ -17,17 +14,12 @@ import org.springframework.web.bind.annotation.RestController
 @AuthRequired
 @RestController
 @RequestMapping("/api/registrations")
-@Tag(name = "Registration", description = "내 신청 조회 API")
 class MyRegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "내 이벤트 신청 목록 조회",
-        description = "로그인한 사용자의 이벤트 신청 목록을 조회합니다. 최신 신청 순으로 반환되며 page/size로 페이징합니다.",
-    )
     @GetMapping("/me")
     fun myRegistrations(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
         @RequestParam(defaultValue = "0") page: Int,
         @RequestParam(defaultValue = "20") size: Int,
     ): ResponseEntity<GetMyRegistrationsResponse> {
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
index 2ffccbe6..f2568d12 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
@@ -10,8 +10,6 @@ import com.wafflestudio.spring2025.domain.registration.exception.RegistrationErr
 import com.wafflestudio.spring2025.domain.registration.exception.RegistrationValidationException
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
@@ -23,16 +21,9 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/registrations/{registrationId}")
-@Tag(name = "Registration", description = "신청 단건 리소스 API")
 class RegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "신청 단건 상태 변경",
-        description =
-            "신청 단건 리소스의 상태를 변경합니다. " +
-                "사용자가 본인의 신청을 취소하는 경우와 관리자가 강제 취소/밴 처리하는 경우를 로직 레벨에서 구분합니다.",
-    )
     @PatchMapping
     fun updateStatus(
         @PathVariable registrationId: String,
@@ -45,11 +36,6 @@ class RegistrationController(
         return ResponseEntity.ok(response)
     }
 
-    @Operation(
-        summary = "신청 단건 정보 요청",
-        description =
-            "신청 단건의 정보를 반환합니다.",
-    )
     @GetMapping
     fun getRegistrationInformation(
         @PathVariable registrationId: String,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
index e6764f91..33f1410e 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
@@ -2,23 +2,14 @@ package com.wafflestudio.spring2025.domain.registration.dto.core
 
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 정보")
 data class RegistrationDto(
-    @Schema(description = "신청 공개 ID")
     val registrationPublicId: String,
-    @Schema(description = "사용자 ID")
     val userId: Long?,
-    @Schema(description = "이벤트 ID")
     val eventId: Long,
-    @Schema(description = "비회원 이름")
     val guestName: String?,
-    @Schema(description = "비회원 이메일")
     val guestEmail: String?,
-    @Schema(description = "신청 상태")
     val status: RegistrationStatus,
-    @Schema(description = "신청 일시 (epoch milliseconds)")
     val createdAt: Long,
 ) {
     constructor(registration: Registration) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
index 5255eb9e..70c08a66 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
@@ -2,13 +2,9 @@ package com.wafflestudio.spring2025.domain.registration.dto.core
 
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.registration.model.Registration
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "내 이벤트 신청 정보")
 data class RegistrationWithEventDto(
-    @Schema(description = "신청 정보")
     val registration: RegistrationDto,
-    @Schema(description = "이벤트 요약 정보")
     val event: EventSummaryDto,
 ) {
     constructor(registration: Registration, event: Event) : this(
@@ -17,17 +13,11 @@ data class RegistrationWithEventDto(
     )
 }
 
-@Schema(description = "이벤트 요약 정보")
 data class EventSummaryDto(
-    @Schema(description = "이벤트 ID")
     val id: Long,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "장소")
     val location: String?,
-    @Schema(description = "시작 시간 (epoch milliseconds)")
     val startsAt: Long?,
-    @Schema(description = "종료 시간 (epoch milliseconds)")
     val endsAt: Long?,
 ) {
     constructor(event: Event) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
index baf7052f..820bd1e5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
@@ -1,14 +1,10 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
 import com.fasterxml.jackson.annotation.JsonAlias
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 요청")
 data class CreateRegistrationRequest(
-    @Schema(description = "비회원 이름")
     @JsonAlias("guest_name")
     val guestName: String? = null,
-    @Schema(description = "비회원 이메일")
     @JsonAlias("guest_email")
     val guestEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
index 3f34c5f8..0df46b98 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 취소 요청")
 data class DeleteRegistrationRequest(
-    @Schema(description = "비회원 이름")
     val guestName: String? = null,
-    @Schema(description = "비회원 이메일")
     val guestEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
index f87d15fb..2182cddc 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
@@ -1,9 +1,7 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 상태 변경 요청")
 data class UpdateRegistrationStatusRequest(
     val status: RegistrationStatus? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
index eb4ea566..3abe25e8 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
@@ -1,9 +1,5 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 신청 응답")
 data class CreateRegistrationResponse(
-    @Schema(description = "신청 id")
     val registrationPublicId: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
index 39a7951b..c5837bd2 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
@@ -3,36 +3,22 @@ package com.wafflestudio.spring2025.domain.registration.dto.response
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "이벤트 신청 목록 조회 응답")
 data class GetEventRegistrationsResponse(
-    @Schema(description = "신청자 목록")
     val participants: List<EventRegistrationItem>,
-    @Schema(description = "필터에 따라 변하는 참여자 수")
     val totalCount: Int?,
-    @Schema(description = "다음 페이지 시작 offset (없으면 null)")
     val nextCursor: Int?,
-    @Schema(description = "다음 페이지 존재 여부")
     val hasNext: Boolean,
 )
 
-@Schema(description = "신청자 정보")
 data class EventRegistrationItem(
-    @Schema(description = "신청 공개 ID")
     val registrationId: String,
-    @Schema(description = "이름")
     val name: String,
-    @Schema(description = "이메일 (관리자 요청 시 노출)")
     val email: String?,
-    @Schema(description = "프로필 이미지 URL")
     val profileImage: String?,
-    @Schema(description = "신청 일시")
     val createdAt: Instant,
-    @Schema(description = "신청 상태")
     val status: RegistrationStatus,
-    @Schema(description = "대기 순번 (status가 WAITLISTED일 때만 아니면 null)")
     val waitingNum: Int?,
 ) {
     constructor(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
index 74c36966..5c597315 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
@@ -3,36 +3,22 @@ package com.wafflestudio.spring2025.domain.registration.dto.response
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "내 이벤트 신청 목록 응답")
 data class GetMyRegistrationsResponse(
-    @Schema(description = "신청 목록")
     val registrations: List<MyRegistrationItem>,
 )
 
-@Schema(description = "내 이벤트 신청 요약")
 data class MyRegistrationItem(
-    @Schema(description = "이벤트 공개 ID")
     val publicId: String,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "이벤트 시작 시간 (ISO-8601)")
     val startsAt: Instant?,
-    @Schema(description = "이벤트 종료 시간 (ISO-8601)")
     val endsAt: Instant?,
-    @Schema(description = "신청 시작 시간 (ISO-8601)")
     val registrationStartsAt: Instant?,
-    @Schema(description = "신청 마감 시간 (ISO-8601)")
     val registrationEndsAt: Instant?,
-    @Schema(description = "정원")
     val capacity: Int?,
-    @Schema(description = "현재 신청 수 + 대기 수")
     val registrationCnt: Int,
-    @Schema(description = "신청 상태")
     val status: MyRegistrationStatus,
-    @Schema(description = "대기 순번 (WAITLISTED가 아니면 null)")
     val waitlistedNum: Int?,
 ) {
     constructor(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
index e03dd30c..d241cd32 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
@@ -1,9 +1,7 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 정보 요청 응답")
 data class GetRegistrationResponse(
     val status: RegistrationStatus,
     val guestName: String,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
index 5f8f534a..e328c6db 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
@@ -1,8 +1,5 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 신청 상태 변경")
 data class PatchRegistrationResponse(
     val patchEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
index 5d0d0855..fe52c458 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
@@ -1,29 +1,19 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
 import com.fasterxml.jackson.annotation.JsonProperty
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 참여자 명단 응답")
 data class RegistrationGuestsResponse(
-    @Schema(description = "확정 참여자 목록")
     val guests: List<Guest>,
     @JsonProperty("confirmed_count")
-    @Schema(description = "확정 참여자 수")
     val confirmedCount: Int,
     @JsonProperty("waiting_count")
-    @Schema(description = "대기 참여자 수")
     val waitingCount: Int,
 ) {
-    @Schema(description = "참여자 정보")
     data class Guest(
-        @Schema(description = "신청 공개 ID")
         val registrationPublicId: String,
-        @Schema(description = "이름")
         val name: String,
-        @Schema(description = "이메일 (관리자 요청 시 노출)")
         val email: String?,
         @JsonProperty("profile_image")
-        @Schema(description = "프로필 이미지 URL")
         val profileImage: String?,
     )
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
index 85c924bd..8f214cf1 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
@@ -7,11 +7,6 @@ import com.wafflestudio.spring2025.domain.user.dto.PatchMeRequest
 import com.wafflestudio.spring2025.domain.user.dto.PatchMeResponse
 import com.wafflestudio.spring2025.domain.user.model.User
 import com.wafflestudio.spring2025.domain.user.service.UserService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PatchMapping
@@ -22,27 +17,19 @@ import org.springframework.web.bind.annotation.RestController
 @AuthRequired
 @RestController
 @RequestMapping("/api/users")
-@Tag(name = "User", description = "사용자 API")
 class UserController(
     private val userService: UserService,
 ) {
-    @Operation(summary = "본인 정보 조회", description = "로그인한 사용자의 정보를 조회합니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "사용자 정보 조회 성공"),
-            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-        ],
-    )
     @AuthRequired
     @GetMapping("/me")
     fun me(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
     ): ResponseEntity<GetMeResponse> = ResponseEntity.ok(userService.me(user))
 
     @AuthRequired
     @PatchMapping("/me")
     fun patchMe(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
         @RequestBody request: PatchMeRequest,
     ): ResponseEntity<PatchMeResponse> {
         userService.patchMe(
@@ -54,41 +41,4 @@ class UserController(
         )
         return ResponseEntity.ok(userService.me(user))
     }
-
-//    @Operation(summary = "프로필 이미지 업로드", description = "로그인한 사용자의 프로필 이미지를 업로드(교체)합니다")
-//    @ApiResponses(
-//        value = [
-//            ApiResponse(responseCode = "204", description = "프로필 이미지 업로드 성공"),
-//            ApiResponse(responseCode = "400", description = "잘못된 요청 (파일 누락/형식 오류 등)"),
-//            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-//        ],
-//    )
-//    @AuthRequired
-//    @PutMapping(
-//        "/me/profile-image",
-//        consumes = [MediaType.MULTIPART_FORM_DATA_VALUE],
-//    )
-//    fun uploadProfileImage(
-//        @Parameter(hidden = true) @LoggedInUser user: User?,
-//        @RequestPart("image") image: MultipartFile,
-//    ): ResponseEntity<Void> {
-//        userService.updateProfileImage(user, image)
-//        return ResponseEntity.noContent().build()
-//    }
-//
-//    @Operation(summary = "프로필 이미지 삭제", description = "로그인한 사용자의 프로필 이미지를 삭제(기본 이미지로 복귀)합니다")
-//    @ApiResponses(
-//        value = [
-//            ApiResponse(responseCode = "204", description = "프로필 이미지 삭제 성공"),
-//            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-//        ],
-//    )
-//    @AuthRequired
-//    @DeleteMapping("/me/profile-image")
-//    fun deleteProfileImage(
-//        @Parameter(hidden = true) @LoggedInUser user: User?,
-//    ): ResponseEntity<Void> {
-//        userService.deleteProfileImage(user)
-//        return ResponseEntity.noContent().build()
-//    }
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
index 092180d5..1a0f9e05 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
@@ -1,19 +1,12 @@
 package com.wafflestudio.spring2025.domain.user.identity.dto.core
 
 import com.wafflestudio.spring2025.domain.user.identity.model.UserIdentity
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "소셜 계정 정보")
 data class UserIdentityDto(
-    @Schema(description = "소셜 계정 ID")
     val id: Long,
-    @Schema(description = "사용자 ID")
     val userId: Long,
-    @Schema(description = "소셜 로그인 제공자")
     val provider: String,
-    @Schema(description = "제공자 사용자 ID")
     val providerUserId: String,
-    @Schema(description = "생성 일시 (epoch milliseconds)")
     val createdAt: Long,
 ) {
     constructor(identity: UserIdentity) : this(
diff --git a/src/main/resources/application.yaml b/src/main/resources/application.yaml
index 00626212..69f7caf8 100644
--- a/src/main/resources/application.yaml
+++ b/src/main/resources/application.yaml
@@ -95,6 +95,13 @@ aws:
 server:
   forward-headers-strategy: framework
 
+springdoc:
+  api-docs:
+    enabled: false
+  swagger-ui:
+    url: /docs/openapi.yaml
+    disable-swagger-default-url: true
+
 ---
 spring:
   config:
diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
new file mode 100644
index 00000000..cdfaeb8b
--- /dev/null
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -0,0 +1,1181 @@
+openapi: 3.0.1
+info:
+  title: Moiming - Event Schedule Management System API
+  description: 모임 일정 관리 시스템 '모이밍' API 문서
+  version: "1.0"
+servers:
+- url: http://localhost:8080
+  description: Generated server url
+tags:
+- name: Event
+  description: 이벤트 관리 API
+- name: Registration
+  description: 신청 API
+- name: Auth
+  description: 인증 API
+- name: User
+  description: 사용자 API
+- name: Image
+  description: 이미지 API
+paths:
+  /api/events/{publicId}:
+    get:
+      tags:
+      - Event
+      summary: 이벤트 상세 조회
+      description: 이벤트 상세 정보를 조회합니다
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/EventDetailResponse"
+    put:
+      tags:
+      - Event
+      summary: 이벤트 수정
+      description: 이벤트를 수정합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateEventRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UpdateEventResponse"
+        "401":
+          description: 인증 필요
+    delete:
+      tags:
+      - Event
+      summary: 이벤트 삭제
+      description: 이벤트를 삭제합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "204":
+          description: No Content
+        "401":
+          description: 인증 필요
+  /api/images:
+    post:
+      tags:
+      - Image
+      summary: 이미지 업로드
+      description: 서버 저장소에 이미지를 업로드합니다.
+      parameters:
+      - name: prefix
+        in: query
+        description: 이미지를 저장할 상위 경로
+        required: false
+        schema:
+          type: string
+      requestBody:
+        content:
+          multipart/form-data:
+            schema:
+              required:
+              - image
+              type: object
+              properties:
+                image:
+                  type: string
+                  format: binary
+      responses:
+        "401":
+          description: 인증 실패 (유효하지 않은 토큰)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+        "200":
+          description: 이미지 업로드 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+        "400":
+          description: 잘못된 요청 (파일 누락/형식 오류 등)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+  /api/events:
+    post:
+      tags:
+      - Event
+      summary: 이벤트 생성
+      description: 새로운 이벤트를 생성합니다
+      security:
+      - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateEventRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateEventResponse"
+        "401":
+          description: 인증 필요
+  /api/events/{eventId}/registrations:
+    get:
+      tags:
+      - Registration
+      summary: 이벤트 신청 목록 조회
+      description: 특정 이벤트에 속한 신청 목록을 조회합니다. 신청 상태(CONFIRMED/WAITLISTED/BANNED)와 신청
+        시각을 포함해 반환합니다.
+      parameters:
+      - name: eventId
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: status
+        in: query
+        required: false
+        schema:
+          type: string
+      - name: orderBy
+        in: query
+        required: false
+        schema:
+          type: string
+      - name: cursor
+        in: query
+        description: 다음 페이지 시작 offset (없으면 0부터)
+        required: false
+        schema:
+          type: integer
+          format: int32
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetEventRegistrationsResponse"
+    post:
+      tags:
+      - Registration
+      summary: 이벤트 참여 신청
+      description: "특정 이벤트에 신청합니다. 정원이 남아있으면 CONFIRMED로 등록되고, 정원이 찼으나 대기 명단이 허용된 경\
+        우 WAITLISTED로 등록됩니다. 정원이 찼고 대기 명단이 비활성화된 경우 신청이 거절됩니다."
+      parameters:
+      - name: eventId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateRegistrationRequest"
+        required: true
+      responses:
+        "200":
+          description: 신청 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "409":
+          description: "신청 불가: 3001(Registration already exists), 3005(Host cannot\
+            \ register), 2301(Event is full)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "400":
+          description: "유효하지 않은 요청: 3003(Wrong guest name), 3004(Wrong guest email),\
+            \ 2204(Invalid registration window)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "403":
+          description: "권한 없음: 3006(Banned user cannot register)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "404":
+          description: "이벤트 없음: 2001(Event not found)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+  /api/auth/social:
+    post:
+      tags:
+      - Auth
+      summary: 소셜 로그인
+      description: 소셜 로그인을 요청합니다.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SocialLoginRequest"
+        required: true
+      responses:
+        "200":
+          description: 소셜 로그인 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "409":
+          description: 이미 가입된 이메일
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "401":
+          description: 인증 실패
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+  /api/auth/signup:
+    post:
+      tags:
+      - Auth
+      summary: 이메일 회원가입
+      description: 새로운 사용자를 등록하고 인증 이메일을 발송합니다. 이메일 인증 후 가입이 완료됩니다.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SignupRequest"
+        required: true
+      responses:
+        "409":
+          description: 이미 존재하는 email
+        "204":
+          description: 인증 이메일 발송 성공
+        "400":
+          description: 잘못된 요청 (유효하지 않은 email/password/name)
+        "503":
+          description: 이메일 서비스 장애
+  /api/auth/logout:
+    post:
+      tags:
+      - Auth
+      summary: 로그아웃
+      description: 현재 JWT 토큰을 블랙리스트에 추가하여 로그아웃합니다
+      responses:
+        "204":
+          description: 로그아웃 성공
+  /api/auth/login:
+    post:
+      tags:
+      - Auth
+      summary: 로그인
+      description: email로 로그인하여 JWT 토큰을 발급받습니다
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LoginRequest"
+        required: true
+      responses:
+        "401":
+          description: 인증 실패
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "200":
+          description: "로그인 성공, JWT 토큰 반환"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+  /api/auth/email-verification/{verificationCode}:
+    post:
+      tags:
+      - Auth
+      summary: 이메일 인증
+      description: 이메일로 받은 인증 코드를 검증하고 회원가입을 완료합니다
+      parameters:
+      - name: verificationCode
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "400":
+          description: 유효하지 않거나 만료된 인증 코드
+        "200":
+          description: "인증 성공, 유저 등록 완료"
+  /api/users/me:
+    get:
+      tags:
+      - User
+      summary: 본인 정보 조회
+      description: 로그인한 사용자의 정보를 조회합니다
+      security:
+      - bearerAuth: []
+      responses:
+        "401":
+          description: 인증 실패 (유효하지 않은 토큰)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+        "200":
+          description: 사용자 정보 조회 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+    patch:
+      tags:
+      - User
+      summary: 본인 정보 수정
+      description: 로그인한 사용자의 정보를 수정합니다
+      security:
+      - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PatchMeRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+        "401":
+          description: 인증 필요
+  /api/registrations/{registrationId}:
+    get:
+      tags:
+      - Registration
+      summary: 신청 단건 정보 요청
+      description: 신청 단건의 정보를 반환합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetRegistrationResponse"
+    delete:
+      tags:
+      - Registration
+      summary: 신청 단건 취소
+      description: 신청 단건 리소스를 취소합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/DeleteRegistrationRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/DeleteRegistrationResponse"
+    patch:
+      tags:
+      - Registration
+      summary: 신청 단건 상태 변경
+      description: 신청 단건 리소스의 상태를 변경합니다. 사용자가 본인의 신청을 취소하는 경우와 관리자가 강제 취소/밴 처리하는 경우를
+        로직 레벨에서 구분합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateRegistrationStatusRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/PatchRegistrationResponse"
+  /api/registrations/me:
+    get:
+      tags:
+      - Registration
+      summary: 내 이벤트 신청 목록 조회
+      description: 로그인한 사용자의 이벤트 신청 목록을 조회합니다. 최신 신청 순으로 반환되며 page/size로 페이징합니다.
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: page
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 0
+      - name: size
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 20
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetMyRegistrationsResponse"
+        "401":
+          description: 인증 필요
+  /api/events/me:
+    get:
+      tags:
+      - Event
+      summary: 내가 만든 이벤트 목록 조회 (무한 스크롤)
+      description: 로그인된 사용자가 생성한 이벤트 목록을 무한 스크롤 방식(cursor)으로 조회합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: cursor
+        in: query
+        required: false
+        schema:
+          type: string
+          format: date-time
+      - name: size
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 5
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/MyEventsInfiniteResponse"
+        "401":
+          description: 인증 필요
+components:
+  schemas:
+    UpdateEventRequest:
+      type: object
+      properties:
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 정기 모임
+        description:
+          type: string
+          description: 이벤트 설명
+          example: 정기 모임입니다
+        location:
+          type: string
+          description: 장소
+          example: 강의실 101
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          example: 30
+        waitlistEnabled:
+          type: boolean
+          description: 대기 명단 사용 여부
+          example: true
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:30:00Z
+      description: 일정 수정 요청
+    UpdateEventResponse:
+      required:
+      - registrationEndsAt
+      - title
+      - waitlistEnabled
+      type: object
+      properties:
+        title:
+          type: string
+        description:
+          type: string
+        location:
+          type: string
+        startsAt:
+          type: string
+          format: date-time
+        endsAt:
+          type: string
+          format: date-time
+        capacity:
+          type: integer
+          format: int32
+        waitlistEnabled:
+          type: boolean
+        registrationStartsAt:
+          type: string
+          format: date-time
+        registrationEndsAt:
+          type: string
+          format: date-time
+    ImageUploadResponse:
+      required:
+      - key
+      - url
+      type: object
+      properties:
+        key:
+          type: string
+        url:
+          type: string
+    CreateEventRequest:
+      required:
+      - capacity
+      - registrationEndsAt
+      - title
+      - waitlistEnabled
+      type: object
+      properties:
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 정기 모임
+        description:
+          type: string
+          description: 이벤트 설명
+          example: 정기 모임입니다
+        location:
+          type: string
+          description: 장소
+          example: 강의실 101
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          example: 30
+        waitlistEnabled:
+          type: boolean
+          description: 대기 명단 사용 여부
+          example: true
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601). null인 경우 요청 시점으로 자동 설정됩니다.
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:30:00Z
+      description: 일정 생성 요청
+    CreateEventResponse:
+      required:
+      - publicId
+      type: object
+      properties:
+        publicId:
+          type: string
+    CreateRegistrationRequest:
+      type: object
+      properties:
+        guestName:
+          type: string
+          description: 비회원 이름
+        guestEmail:
+          type: string
+          description: 비회원 이메일
+      description: 이벤트 신청 요청
+    CreateRegistrationResponse:
+      required:
+      - registrationPublicId
+      type: object
+      properties:
+        registrationPublicId:
+          type: string
+          description: 신청 id
+      description: 이벤트 신청 응답
+    SocialLoginRequest:
+      required:
+      - code
+      - provider
+      type: object
+      properties:
+        provider:
+          type: string
+          description: 소셜로그인 제공자
+          example: GOOGLE
+        code:
+          type: string
+          description: 인가 코드 (authorization code)
+      description: 소셜 로그인 요청
+    LoginResponse:
+      required:
+      - token
+      type: object
+      properties:
+        token:
+          type: string
+    SignupRequest:
+      required:
+      - email
+      - name
+      - password
+      type: object
+      properties:
+        email:
+          type: string
+          description: 사용자 이메일
+          example: user@example.com
+        name:
+          type: string
+          description: 사용자 이름
+          example: 홍길동
+        password:
+          type: string
+          description: 비밀번호
+          example: password123
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+          example: https://cdn.example.com/profile.png
+      description: 회원가입 요청
+    LoginRequest:
+      required:
+      - email
+      - password
+      type: object
+      properties:
+        email:
+          type: string
+          description: 사용자 이메일
+          example: user@example.com
+        password:
+          type: string
+          description: 사용자 비밀번호
+          example: mypassword
+      description: 로그인 요청
+    PatchMeRequest:
+      type: object
+      properties:
+        name:
+          type: string
+        email:
+          type: string
+        password:
+          type: string
+        profileImage:
+          type: string
+    UserDto:
+      required:
+      - email
+      - id
+      - name
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int64
+        email:
+          type: string
+        name:
+          type: string
+        profileImage:
+          type: string
+    UpdateRegistrationStatusRequest:
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+      description: 이벤트 신청 상태 변경 요청
+    PatchRegistrationResponse:
+      type: object
+      properties:
+        patchEmail:
+          type: string
+      description: 이벤트 신청 상태 변경
+    GetRegistrationResponse:
+      required:
+      - guestName
+      - registrationPublicId
+      - reservationEmail
+      - status
+      - waitlistPosition
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        guestName:
+          type: string
+        waitlistPosition:
+          type: integer
+          format: int32
+        registrationPublicId:
+          type: string
+        reservationEmail:
+          type: string
+      description: 이벤트 신청 정보 요청 응답
+    GetMyRegistrationsResponse:
+      required:
+      - registrations
+      type: object
+      properties:
+        registrations:
+          type: array
+          description: 신청 목록
+          items:
+            $ref: "#/components/schemas/MyRegistrationItem"
+      description: 내 이벤트 신청 목록 응답
+    MyRegistrationItem:
+      required:
+      - publicId
+      - registrationCnt
+      - status
+      - title
+      type: object
+      properties:
+        publicId:
+          type: string
+          description: 이벤트 공개 ID
+        title:
+          type: string
+          description: 이벤트 제목
+        startsAt:
+          type: string
+          description: 이벤트 시작 시간 (ISO-8601)
+          format: date-time
+        endsAt:
+          type: string
+          description: 이벤트 종료 시간 (ISO-8601)
+          format: date-time
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+        registrationCnt:
+          type: integer
+          description: 현재 신청 수 + 대기 수
+          format: int32
+        status:
+          type: string
+          description: 신청 상태
+          enum:
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        waitlistedNum:
+          type: integer
+          description: 대기 순번 (WAITLISTED가 아니면 null)
+          format: int32
+      description: 내 이벤트 신청 요약
+    CapabilitiesInfo:
+      required:
+      - apply
+      - cancel
+      - shareLink
+      - wait
+      type: object
+      properties:
+        shareLink:
+          type: boolean
+          description: 공유 링크 가능 여부
+          example: false
+        apply:
+          type: boolean
+          description: 참여 신청 가능 여부(확정 자리 신청)
+          example: false
+        wait:
+          type: boolean
+          description: 대기 신청 가능 여부(정원 찼을 때)
+          example: false
+        cancel:
+          type: boolean
+          description: 신청 취소 가능 여부
+          example: true
+      description: 가능한 동작 블록
+    CreatorInfo:
+      required:
+      - email
+      - name
+      type: object
+      properties:
+        name:
+          type: string
+          description: 이름
+          example: 홍길동
+        email:
+          type: string
+          description: 이메일
+          example: user@example.com
+        profileImage:
+          type: string
+          description: 프로필 이미지
+          nullable: true
+          example: https://example.com/profile.png
+      description: 생성자 정보 블록
+    EventDetailResponse:
+      required:
+      - capabilities
+      - creator
+      - event
+      - guestsPreview
+      - viewer
+      type: object
+      properties:
+        event:
+          $ref: "#/components/schemas/EventInfo"
+        creator:
+          $ref: "#/components/schemas/CreatorInfo"
+        viewer:
+          $ref: "#/components/schemas/ViewerInfo"
+        capabilities:
+          $ref: "#/components/schemas/CapabilitiesInfo"
+        guestsPreview:
+          type: array
+          description: 참여자 미리보기 목록
+          items:
+            $ref: "#/components/schemas/GuestPreview"
+      description: 일정 상세 조회 응답
+    EventInfo:
+      required:
+      - publicId
+      - registrationEndsAt
+      - title
+      - totalApplicants
+      type: object
+      properties:
+        publicId:
+          type: string
+          description: 이벤트 publicId
+          example: dj8sadj10djnkas
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 제2회 기획 세미나
+        description:
+          type: string
+          description: 이벤트 설명
+          nullable: true
+          example: 일정 상세 설명...
+        location:
+          type: string
+          description: 장소
+          nullable: true
+          example: 서울대
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          nullable: true
+          example: 10
+        totalApplicants:
+          type: integer
+          description: 총 신청자 수(확정+대기 등)
+          format: int32
+          example: 8
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+      description: 이벤트 정보 블록
+    GuestPreview:
+      required:
+      - name
+      type: object
+      properties:
+        id:
+          type: integer
+          description: 참여자 ID (비회원이면 null)
+          format: int64
+          nullable: true
+          example: 1
+        name:
+          type: string
+          description: 참여자 이름
+          example: 홍길동
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+          nullable: true
+          example: https://example.com/profile.png
+      description: 참여자 미리보기 정보
+    ViewerInfo:
+      required:
+      - status
+      type: object
+      properties:
+        status:
+          type: string
+          description: 이벤트 조회자(Viewer)의 상태
+          example: WAITLISTED
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+          - NONE
+        name:
+          type: string
+          description: viewer 이름 (비회원이면 null)
+          nullable: true
+          example: 홍길동
+        waitlistPosition:
+          type: integer
+          description: "대기 순번 (WAITLISTED일 때만 숫자, 아니면 null)"
+          format: int32
+          nullable: true
+          example: 3
+        registrationPublicId:
+          type: string
+          description: "registrationPublicId (게스트면 값, 아니면 null)"
+          nullable: true
+          example: "1"
+        reservationEmail:
+          type: string
+          description: "예약 이메일(게스트면 guestEmail, 로그인 유저면 user email 등 정책에 따름)"
+          nullable: true
+          example: skdfsj@gmaldkl
+      description: 조회자(viewer) 정보 블록
+    EventRegistrationItem:
+      required:
+      - createdAt
+      - name
+      - registrationId
+      - status
+      type: object
+      properties:
+        registrationId:
+          type: string
+          description: 신청 공개 ID
+        name:
+          type: string
+          description: 이름
+        email:
+          type: string
+          description: 이메일 (관리자 요청 시 노출)
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+        createdAt:
+          type: string
+          description: 신청 일시
+          format: date-time
+        status:
+          type: string
+          description: 신청 상태
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        waitingNum:
+          type: integer
+          description: 대기 순번 (status가 WAITLISTED일 때만 아니면 null)
+          format: int32
+      description: 신청자 정보
+    GetEventRegistrationsResponse:
+      required:
+      - hasNext
+      - participants
+      type: object
+      properties:
+        participants:
+          type: array
+          description: 신청자 목록
+          items:
+            $ref: "#/components/schemas/EventRegistrationItem"
+        totalCount:
+          type: integer
+          description: 필터에 따라 변하는 참여자 수
+          format: int32
+        nextCursor:
+          type: integer
+          description: 다음 페이지 시작 offset (없으면 null)
+          format: int32
+        hasNext:
+          type: boolean
+          description: 다음 페이지 존재 여부
+      description: 이벤트 신청 목록 조회 응답
+    MyEventResponse:
+      required:
+      - publicId
+      - registrationEndsAt
+      - title
+      - totalApplicants
+      type: object
+      properties:
+        publicId:
+          type: string
+        title:
+          type: string
+        startsAt:
+          type: string
+          format: date-time
+        endsAt:
+          type: string
+          format: date-time
+        registrationStartsAt:
+          type: string
+          format: date-time
+        registrationEndsAt:
+          type: string
+          format: date-time
+        capacity:
+          type: integer
+          format: int32
+        totalApplicants:
+          type: integer
+          format: int32
+    MyEventsInfiniteResponse:
+      required:
+      - events
+      - hasNext
+      type: object
+      properties:
+        events:
+          type: array
+          items:
+            $ref: "#/components/schemas/MyEventResponse"
+        nextCursor:
+          type: string
+          format: date-time
+        hasNext:
+          type: boolean
+    DeleteRegistrationRequest:
+      type: object
+      properties:
+        guestName:
+          type: string
+          description: 비회원 이름
+        guestEmail:
+          type: string
+          description: 비회원 이메일
+      description: 이벤트 취소 요청
+    DeleteRegistrationResponse:
+      type: object
+  securitySchemes:
+    bearerAuth:
+      type: http
+      description: JWT 토큰을 입력하세요
+      name: bearerAuth
+      scheme: bearer
+      bearerFormat: JWT
diff --git a/src/main/resources/static/docs/swagger-ui.html b/src/main/resources/static/docs/swagger-ui.html
new file mode 100644
index 00000000..517735db
--- /dev/null
+++ b/src/main/resources/static/docs/swagger-ui.html
@@ -0,0 +1,36 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>MoiMing API Docs</title>
+    <link rel="stylesheet" href="/webjars/swagger-ui/swagger-ui.css" />
+    <style>
+      html,
+      body {
+        margin: 0;
+        height: 100%;
+      }
+      #swagger-ui {
+        height: 100%;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="swagger-ui"></div>
+    <script src="/webjars/swagger-ui/swagger-ui-bundle.js"></script>
+    <script src="/webjars/swagger-ui/swagger-ui-standalone-preset.js"></script>
+    <script>
+      window.onload = function () {
+        window.ui = SwaggerUIBundle({
+          url: "/docs/openapi.yaml",
+          dom_id: "#swagger-ui",
+          deepLinking: true,
+          presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
+          plugins: [SwaggerUIBundle.plugins.DownloadUrl],
+          layout: "StandaloneLayout",
+        });
+      };
+    </script>
+  </body>
+</html>

From 8cebad2e2c6fcf0090845539c8496c69ecebad0a Mon Sep 17 00:00:00 2001
From: uykhc <yoon002003@snu.ac.kr>
Date: Tue, 14 Apr 2026 23:07:34 +0900
Subject: [PATCH 02/27] refactor(openapi): migrate from swagger annotations to
 static openapi.yaml

---
 .github/PULL_REQUEST_TEMPLATE/dev.md          |    2 +
 .github/PULL_REQUEST_TEMPLATE/main.md         |    1 +
 .github/workflows/ci.yml                      |    8 +
 .../image/controller/ImageController.kt       |   15 +-
 .../domain/auth/controller/AuthController.kt  |   40 -
 .../auth/controller/SocialAuthController.kt   |   11 -
 .../domain/auth/dto/LoginRequest.kt           |    5 -
 .../domain/auth/dto/RegisterRequest.kt        |    7 -
 .../domain/auth/dto/SignupRequest.kt          |    7 -
 .../domain/auth/dto/SocialLoginRequest.kt     |    5 -
 .../event/controller/EventController.kt       |   11 -
 .../domain/event/dto/core/EventDto.kt         |   15 -
 .../event/dto/request/CreateEventRequest.kt   |   23 -
 .../event/dto/request/UpdateEventRequest.kt   |   23 -
 .../event/dto/response/EventDetailResponse.kt |   53 -
 .../domain/event/dto/response/GuestPreview.kt |   10 -
 .../domain/event/dto/response/MyRole.kt       |    6 -
 .../domain/event/dto/response/ViewerStatus.kt |    8 -
 .../controller/EventRegistrationController.kt |   36 -
 .../controller/MyRegistrationController.kt    |   10 +-
 .../controller/RegistrationController.kt      |   14 -
 .../registration/dto/core/RegistrationDto.kt  |    9 -
 .../dto/core/RegistrationWithEventDto.kt      |   10 -
 .../dto/request/CreateRegistrationRequest.kt  |    4 -
 .../dto/request/DeleteRegistrationRequest.kt  |    5 -
 .../UpdateRegistrationStatusRequest.kt        |    2 -
 .../response/CreateRegistrationResponse.kt    |    4 -
 .../response/GetEventRegistrationsResponse.kt |   14 -
 .../response/GetMyRegistrationsResponse.kt    |   14 -
 .../dto/response/GetRegistrationResponse.kt   |    2 -
 .../dto/response/PatchRegistrationResponse.kt |    3 -
 .../response/RegistrationGuestsResponse.kt    |   10 -
 .../domain/user/controller/UserController.kt  |   54 +-
 .../user/identity/dto/core/UserIdentityDto.kt |    7 -
 src/main/resources/application.yaml           |    7 +
 src/main/resources/static/docs/openapi.yaml   | 1181 +++++++++++++++++
 .../resources/static/docs/swagger-ui.html     |   36 +
 37 files changed, 1239 insertions(+), 433 deletions(-)
 create mode 100644 src/main/resources/static/docs/openapi.yaml
 create mode 100644 src/main/resources/static/docs/swagger-ui.html

diff --git a/.github/PULL_REQUEST_TEMPLATE/dev.md b/.github/PULL_REQUEST_TEMPLATE/dev.md
index ad0b6ad0..558f1a66 100644
--- a/.github/PULL_REQUEST_TEMPLATE/dev.md
+++ b/.github/PULL_REQUEST_TEMPLATE/dev.md
@@ -2,6 +2,8 @@
 
 ### 🧪 로컬 테스트 여부 (작업자 체크)
 - [ ] 로컬에서 Swagger 혹은 테스트 코드로 동작을 확인했습니다.
+- [ ] API 변경이 있다면 `src/main/resources/static/docs/openapi.yaml`을 함께 갱신했습니다.
+- [ ] `/docs/swagger-ui.html`에서 변경 API가 의도대로 보이는지 확인했습니다.
 
 ### 📄 documentation 최신화 여부
 > 변경사항과 관련된 API의 swagger documentation이 실제 동작과 일치하는지 확인합니다.
diff --git a/.github/PULL_REQUEST_TEMPLATE/main.md b/.github/PULL_REQUEST_TEMPLATE/main.md
index e46646af..15cd0692 100644
--- a/.github/PULL_REQUEST_TEMPLATE/main.md
+++ b/.github/PULL_REQUEST_TEMPLATE/main.md
@@ -5,6 +5,7 @@
 - [ ] CI 성공
 - [ ] 환경 변수 설정 확인
 - [ ] dev 서버에서 변경사항에 대해 의도대로 동작함을 확인
+- [ ] API 변경이 있다면 `src/main/resources/static/docs/openapi.yaml` 반영 완료
 
 ### 📝 업데이트 사항 요약
 
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d75114a4..80cda61f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,6 +21,14 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Set up Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Lint OpenAPI YAML
+        run: npx @redocly/cli@latest lint src/main/resources/static/docs/openapi.yaml
+
       - name: Set up JDK 21
         uses: actions/setup-java@v4
         with:
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt b/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
index d774bdb0..1cdb9ea8 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/common/image/controller/ImageController.kt
@@ -4,10 +4,6 @@ import com.wafflestudio.spring2025.common.image.dto.ImageUploadResponse
 import com.wafflestudio.spring2025.common.image.service.ImageService
 import com.wafflestudio.spring2025.domain.auth.LoggedInUser
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
 import org.springframework.http.MediaType
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PostMapping
@@ -22,21 +18,12 @@ import org.springframework.web.multipart.MultipartFile
 class ImageController(
     private val imageService: ImageService,
 ) {
-    @Operation(summary = "이미지 업로드", description = "서버 저장소에 이미지를 업로드합니다.")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "이미지 업로드 성공"),
-            ApiResponse(responseCode = "400", description = "잘못된 요청 (파일 누락/형식 오류 등)"),
-            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-        ],
-    )
     @PostMapping(
         consumes = [MediaType.MULTIPART_FORM_DATA_VALUE],
     )
     fun uploadImage(
-        @Parameter(hidden = true) @LoggedInUser user: User?,
+        @LoggedInUser user: User?,
         @RequestPart("image") image: MultipartFile,
-        @Parameter(description = "이미지를 저장할 상위 경로", required = false)
         @RequestParam(name = "prefix", required = false)
         prefix: String?,
     ): ResponseEntity<ImageUploadResponse> {
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
index fae13d16..f35d874e 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/AuthController.kt
@@ -5,10 +5,6 @@ import com.wafflestudio.spring2025.domain.auth.dto.LoginResponse
 import com.wafflestudio.spring2025.domain.auth.dto.SignupRequest
 import com.wafflestudio.spring2025.domain.auth.service.AuthService
 import com.wafflestudio.spring2025.domain.auth.service.EmailVerificationService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import jakarta.servlet.http.HttpServletRequest
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PathVariable
@@ -19,23 +15,10 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/auth")
-@Tag(name = "Auth", description = "인증 API")
 class AuthController(
     private val authService: AuthService,
     private val emailVerificationService: EmailVerificationService,
 ) {
-    @Operation(
-        summary = "이메일 회원가입",
-        description = "새로운 사용자를 등록하고 인증 이메일을 발송합니다. 이메일 인증 후 가입이 완료됩니다.",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "204", description = "인증 이메일 발송 성공"),
-            ApiResponse(responseCode = "400", description = "잘못된 요청 (유효하지 않은 email/password/name)"),
-            ApiResponse(responseCode = "409", description = "이미 존재하는 email"),
-            ApiResponse(responseCode = "503", description = "이메일 서비스 장애"),
-        ],
-    )
     @PostMapping("/signup")
     fun signup(
         @RequestBody signupRequest: SignupRequest,
@@ -51,16 +34,6 @@ class AuthController(
         return ResponseEntity.noContent().build()
     }
 
-    @Operation(
-        summary = "이메일 인증",
-        description = "이메일로 받은 인증 코드를 검증하고 회원가입을 완료합니다",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "인증 성공, 유저 등록 완료"),
-            ApiResponse(responseCode = "400", description = "유효하지 않거나 만료된 인증 코드"),
-        ],
-    )
     @PostMapping("/email-verification/{verificationCode}")
     fun verifyEmail(
         @PathVariable verificationCode: String,
@@ -69,13 +42,6 @@ class AuthController(
         return ResponseEntity.ok().build()
     }
 
-    @Operation(summary = "로그인", description = "email로 로그인하여 JWT 토큰을 발급받습니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "로그인 성공, JWT 토큰 반환"),
-            ApiResponse(responseCode = "401", description = "인증 실패"),
-        ],
-    )
     @PostMapping("/login")
     fun login(
         @RequestBody loginRequest: LoginRequest,
@@ -84,12 +50,6 @@ class AuthController(
         return ResponseEntity.ok(LoginResponse(token))
     }
 
-    @Operation(summary = "로그아웃", description = "현재 JWT 토큰을 블랙리스트에 추가하여 로그아웃합니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "204", description = "로그아웃 성공"),
-        ],
-    )
     @PostMapping("/logout")
     fun logout(request: HttpServletRequest): ResponseEntity<Void> {
         val token = resolveToken(request)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
index b43a4ced..dbd09f73 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
@@ -4,9 +4,6 @@ import com.wafflestudio.spring2025.domain.auth.dto.LoginResponse
 import com.wafflestudio.spring2025.domain.auth.dto.SocialLoginRequest
 import com.wafflestudio.spring2025.domain.auth.model.SocialProvider
 import com.wafflestudio.spring2025.domain.auth.service.SocialAuthService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
@@ -18,14 +15,6 @@ import org.springframework.web.bind.annotation.RestController
 class SocialAuthController(
     private val socialAuthService: SocialAuthService,
 ) {
-    @Operation(summary = "소셜 로그인", description = "소셜 로그인을 요청합니다.")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "소셜 로그인 성공"),
-            ApiResponse(responseCode = "401", description = "인증 실패"),
-            ApiResponse(responseCode = "409", description = "이미 가입된 이메일"),
-        ],
-    )
     @PostMapping
     suspend fun social(
         @RequestBody socialLoginRequest: SocialLoginRequest,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
index bf17a881..0d5ffea7 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/LoginRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "로그인 요청")
 data class LoginRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 비밀번호", example = "mypassword", required = true)
     val password: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
index 470bcb7f..32ee7ed3 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
@@ -1,15 +1,8 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "회원가입 요청")
 data class RegisterRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 이름", example = "홍길동", required = true)
     val name: String,
-    @Schema(description = "비밀번호", example = "password123", required = true)
     val password: String,
-    @Schema(description = "프로필 이미지 URL", example = "https://cdn.example.com/profile.png")
     val profileImage: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
index 94c273ff..53618934 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SignupRequest.kt
@@ -1,15 +1,8 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "회원가입 요청")
 data class SignupRequest(
-    @Schema(description = "사용자 이메일", example = "user@example.com", required = true)
     val email: String,
-    @Schema(description = "사용자 이름", example = "홍길동", required = true)
     val name: String,
-    @Schema(description = "비밀번호", example = "password123", required = true)
     val password: String,
-    @Schema(description = "프로필 이미지 URL", example = "https://cdn.example.com/profile.png")
     val profileImage: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
index f83e60f3..28fc2bad 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/SocialLoginRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.auth.dto
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "소셜 로그인 요청")
 data class SocialLoginRequest(
-    @Schema(description = "소셜로그인 제공자", example = "GOOGLE", required = true)
     val provider: String,
-    @Schema(description = "인가 코드 (authorization code)", required = true)
     val code: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
index 7ba5fae8..7e1a9de5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/controller/EventController.kt
@@ -10,8 +10,6 @@ import com.wafflestudio.spring2025.domain.event.dto.response.MyEventsInfiniteRes
 import com.wafflestudio.spring2025.domain.event.dto.response.UpdateEventResponse
 import com.wafflestudio.spring2025.domain.event.service.EventService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
@@ -26,12 +24,10 @@ import java.time.Instant
 
 @RestController
 @RequestMapping("/api/events")
-@Tag(name = "Event", description = "이벤트 관리 API")
 class EventController(
     private val eventService: EventService,
 ) {
     @AuthRequired
-    @Operation(summary = "이벤트 생성", description = "새로운 이벤트를 생성합니다")
     @PostMapping // POST /api/events
     fun create(
         @LoggedInUser user: User,
@@ -54,7 +50,6 @@ class EventController(
         return ResponseEntity.ok(CreateEventResponse(publicId))
     }
 
-    @Operation(summary = "이벤트 상세 조회", description = "이벤트 상세 정보를 조회합니다")
     @GetMapping("/{publicId}") // GET /api/events/{publicId}
     fun getById(
         @LoggedInUser user: User?, // nullable
@@ -69,10 +64,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(
-        summary = "내가 만든 이벤트 목록 조회 (무한 스크롤)",
-        description = "로그인된 사용자가 생성한 이벤트 목록을 무한 스크롤 방식(cursor)으로 조회합니다",
-    )
     @GetMapping("/me")
     fun getMyEvents(
         @LoggedInUser user: User,
@@ -89,7 +80,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(summary = "이벤트 수정", description = "이벤트를 수정합니다")
     @PutMapping("/{publicId}") // PUT /api/events/{publicId}
     fun update(
         @LoggedInUser user: User,
@@ -116,7 +106,6 @@ class EventController(
     }
 
     @AuthRequired
-    @Operation(summary = "이벤트 삭제", description = "이벤트를 삭제합니다")
     @DeleteMapping("/{publicId}") // DELETE /api/events/{publicId}
     fun delete(
         @LoggedInUser user: User,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
index 2b4765a2..778ea5ca 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/core/EventDto.kt
@@ -1,35 +1,20 @@
 package com.wafflestudio.spring2025.domain.event.dto.core
 
 import com.wafflestudio.spring2025.domain.event.model.Event
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "일정 정보")
 data class EventDto(
-    @Schema(description = "일정 ID (publicId)")
     val id: String,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "이벤트 설명")
     val description: String?,
-    @Schema(description = "장소")
     val location: String?,
-    @Schema(description = "시작 시간 (epoch milliseconds)")
     val startsAt: Long?,
-    @Schema(description = "종료 시간 (epoch milliseconds)")
     val endsAt: Long?,
-    @Schema(description = "정원")
     val capacity: Int?,
-    @Schema(description = "대기 명단 사용 여부")
     val waitlistEnabled: Boolean,
-    @Schema(description = "신청 시작 시간 (epoch milliseconds)")
     val registrationStartsAt: Long?,
-    @Schema(description = "신청 마감 시간 (epoch milliseconds)")
     val registrationEndsAt: Long,
-    @Schema(description = "작성자 ID")
     val createdBy: Long,
-    @Schema(description = "생성 일시 (epoch milliseconds)")
     val createdAt: Long?,
-    @Schema(description = "수정 일시 (epoch milliseconds)")
     val updatedAt: Long?,
 ) {
     constructor(event: Event) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
index db6254ca..1c46a314 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/CreateEventRequest.kt
@@ -1,38 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 생성 요청")
 data class CreateEventRequest(
-    @Schema(description = "이벤트 제목", example = "정기 모임")
     val title: String,
-    @Schema(description = "이벤트 설명", example = "정기 모임입니다")
     val description: String? = null,
-    @Schema(description = "장소", example = "강의실 101")
     val location: String? = null,
-    @Schema(
-        description = "시작 시간 (ISO-8601)",
-        example = "2026-02-02T18:00:00Z",
-    )
     val startsAt: Instant? = null,
-    @Schema(
-        description = "종료 시간 (ISO-8601)",
-        example = "2026-02-02T20:00:00Z",
-    )
     val endsAt: Instant? = null,
-    @Schema(description = "정원", example = "30")
     val capacity: Int,
-    @Schema(description = "대기 명단 사용 여부", example = "true")
     val waitlistEnabled: Boolean,
-    @Schema(
-        description = "신청 시작 시간 (ISO-8601). null인 경우 요청 시점으로 자동 설정됩니다.",
-        example = "2026-02-02T17:00:00Z",
-    )
     val registrationStartsAt: Instant? = null,
-    @Schema(
-        description = "신청 마감 시간 (ISO-8601)",
-        example = "2026-02-02T17:30:00Z",
-    )
     val registrationEndsAt: Instant,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
index e237b56c..2206d5c5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/request/UpdateEventRequest.kt
@@ -1,38 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 수정 요청")
 data class UpdateEventRequest(
-    @Schema(description = "이벤트 제목", example = "정기 모임")
     val title: String? = null,
-    @Schema(description = "이벤트 설명", example = "정기 모임입니다")
     val description: String? = null,
-    @Schema(description = "장소", example = "강의실 101")
     val location: String? = null,
-    @Schema(
-        description = "시작 시간 (ISO-8601)",
-        example = "2026-02-02T18:00:00Z",
-    )
     val startsAt: Instant? = null,
-    @Schema(
-        description = "종료 시간 (ISO-8601)",
-        example = "2026-02-02T20:00:00Z",
-    )
     val endsAt: Instant? = null,
-    @Schema(description = "정원", example = "30")
     val capacity: Int? = null,
-    @Schema(description = "대기 명단 사용 여부", example = "true")
     val waitlistEnabled: Boolean? = null,
-    @Schema(
-        description = "신청 시작 시간 (ISO-8601)",
-        example = "2026-02-02T17:00:00Z",
-    )
     val registrationStartsAt: Instant? = null,
-    @Schema(
-        description = "신청 마감 시간 (ISO-8601)",
-        example = "2026-02-02T17:30:00Z",
-    )
     val registrationEndsAt: Instant? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
index 84e7616a..685cfd04 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/EventDetailResponse.kt
@@ -1,99 +1,46 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "일정 상세 조회 응답")
 data class EventDetailResponse(
-    @Schema(description = "이벤트 정보")
     val event: EventInfo,
-    @Schema(description = "이벤트 생성자 정보")
     val creator: CreatorInfo,
-    @Schema(description = "조회자(viewer) 정보")
     val viewer: ViewerInfo,
-    @Schema(description = "조회자가 할 수 있는 동작")
     val capabilities: CapabilitiesInfo,
-    @Schema(description = "참여자 미리보기 목록")
     val guestsPreview: List<GuestPreview>,
 )
 
-@Schema(description = "이벤트 정보 블록")
 data class EventInfo(
-    @Schema(description = "이벤트 publicId", example = "dj8sadj10djnkas")
     val publicId: String,
-    @Schema(description = "이벤트 제목", example = "제2회 기획 세미나")
     val title: String,
-    @Schema(description = "이벤트 설명", example = "일정 상세 설명...", nullable = true)
     val description: String?,
-    @Schema(description = "장소", example = "서울대", nullable = true)
     val location: String?,
-    @Schema(description = "시작 시간 (ISO-8601)", example = "2026-02-02T18:00:00Z", nullable = true)
     val startsAt: Instant?,
-    @Schema(description = "종료 시간 (ISO-8601)", example = "2026-02-02T20:00:00Z", nullable = true)
     val endsAt: Instant?,
-    @Schema(description = "정원", example = "10", nullable = true)
     val capacity: Int?,
-    @Schema(description = "참여자 수(참여 확정 인원)", example = "5")
     val confirmedCount: Int,
-    @Schema(description = "대기자 수", example = "5")
     val waitlistCount: Int,
-    @Schema(description = "신청 시작 시간 (ISO-8601)", example = "2026-02-02T17:00:00Z", nullable = true)
     val registrationStartsAt: Instant?,
-    @Schema(description = "신청 마감 시간 (ISO-8601)", example = "2026-02-02T17:00:00Z")
     val registrationEndsAt: Instant,
 )
 
-@Schema(description = "생성자 정보 블록")
 data class CreatorInfo(
-    @Schema(description = "이름", example = "홍길동")
     val name: String,
-    @Schema(description = "이메일", example = "user@example.com")
     val email: String,
-    @Schema(description = "프로필 이미지", example = "https://example.com/profile.png", nullable = true)
     val profileImage: String?,
 )
 
-@Schema(description = "조회자(viewer) 정보 블록")
 data class ViewerInfo(
-    @Schema(
-        description = "viewer의 등록 상태 (RegistrationStatus 사용)",
-        example = "WAITLISTED",
-    )
     val status: ViewerStatus,
-    @Schema(
-        description = "viewer 이름 (비회원이면 null)",
-        example = "홍길동",
-        nullable = true,
-    )
     val name: String?,
-    @Schema(
-        description = "대기 순번 (WAITLISTED일 때만 숫자, 아니면 null)",
-        example = "3",
-        nullable = true,
-    )
     val waitlistPosition: Int?,
-    @Schema(
-        description = "registrationPublicId (게스트면 값, 아니면 null)",
-        example = "1",
-        nullable = true,
-    )
     val registrationPublicId: String?,
-    @Schema(
-        description = "예약 이메일(게스트면 guestEmail, 로그인 유저면 user email 등 정책에 따름)",
-        example = "skdfsj@gmaldkl",
-        nullable = true,
-    )
     val reservationEmail: String?,
 )
 
-@Schema(description = "가능한 동작 블록")
 data class CapabilitiesInfo(
-    @Schema(description = "공유 링크 가능 여부", example = "false")
     val shareLink: Boolean,
-    @Schema(description = "참여 신청 가능 여부(확정 자리 신청)", example = "false")
     val apply: Boolean,
-    @Schema(description = "대기 신청 가능 여부(정원 찼을 때)", example = "false")
     val wait: Boolean,
-    @Schema(description = "신청 취소 가능 여부", example = "true")
     val cancel: Boolean,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
index 01781f48..2f3314a7 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/GuestPreview.kt
@@ -1,21 +1,11 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 이벤트 참여자 미리보기 정보
  * (회원/비회원 포함)
  */
-@Schema(description = "참여자 미리보기 정보")
 data class GuestPreview(
-    @Schema(description = "참여자 ID (비회원이면 null)", example = "1", nullable = true)
     val id: Long?,
-    @Schema(description = "참여자 이름", example = "홍길동")
     val name: String,
-    @Schema(
-        description = "프로필 이미지 URL",
-        example = "https://example.com/profile.png",
-        nullable = true,
-    )
     val profileImage: String?,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
index d1a8b89a..c06024ed 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/MyRole.kt
@@ -1,21 +1,15 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 요청자 역할
  * - CREATOR: 이벤트 생성자
  * - PARTICIPANT: 이벤트 참여자 (CONFIRMED / WAITLISTED)
  * - NONE: 로그인은 했지만 참여하지 않음
  */
-@Schema(description = "요청자 역할")
 enum class MyRole {
-    @Schema(description = "이벤트 생성자")
     CREATOR,
 
-    @Schema(description = "이벤트 참여자")
     PARTICIPANT,
 
-    @Schema(description = "이벤트 미참여자")
     NONE,
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
index a250a6db..d85fe72a 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/dto/response/ViewerStatus.kt
@@ -1,25 +1,17 @@
 package com.wafflestudio.spring2025.domain.event.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
 /**
  * 이벤트 상세 조회 시,
  * "viewer(요청자)"가 해당 이벤트와 어떤 관계에 있는지를 나타내는 상태
  */
-@Schema(description = "이벤트 조회자(Viewer)의 상태")
 enum class ViewerStatus {
-    @Schema(description = "이벤트 생성자")
     HOST,
 
-    @Schema(description = "참여 확정된 사용자")
     CONFIRMED,
 
-    @Schema(description = "대기 중인 사용자")
     WAITLISTED,
 
-    @Schema(description = "강제 취소(차단)된 사용자")
     BANNED,
 
-    @Schema(description = "이벤트와 아무 관계 없는 사용자")
     NONE,
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
index 4fb815e9..213bc67d 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/EventRegistrationController.kt
@@ -6,11 +6,6 @@ import com.wafflestudio.spring2025.domain.registration.dto.response.CreateRegist
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetEventRegistrationsResponse
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
@@ -22,35 +17,9 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/events/{eventId}/registrations")
-@Tag(name = "Registration", description = "이벤트 기준 신청 API")
 class EventRegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "이벤트 참여 신청",
-        description =
-            "특정 이벤트에 신청합니다. 정원이 남아있으면 CONFIRMED로 등록되고, 정원이 찼으나 대기 명단이 허용된 경우 WAITLISTED로 등록됩니다. " +
-                "정원이 찼고 대기 명단이 비활성화된 경우 신청이 거절됩니다.",
-    )
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "신청 성공"),
-            ApiResponse(
-                responseCode = "400",
-                description =
-                    "유효하지 않은 요청: 3003(Wrong guest name), 3004(Wrong guest email), 2204(Invalid registration window)",
-            ),
-            ApiResponse(
-                responseCode = "403",
-                description = "권한 없음: 3006(Banned user cannot register)",
-            ),
-            ApiResponse(responseCode = "404", description = "이벤트 없음: 2001(Event not found)"),
-            ApiResponse(
-                responseCode = "409",
-                description = "신청 불가: 3001(Registration already exists), 3005(Host cannot register), 2301(Event is full)",
-            ),
-        ],
-    )
     @PostMapping
     fun create(
         @PathVariable eventId: String,
@@ -67,17 +36,12 @@ class EventRegistrationController(
         return ResponseEntity.ok(registration)
     }
 
-    @Operation(
-        summary = "이벤트 신청 목록 조회",
-        description = "특정 이벤트에 속한 신청 목록을 조회합니다. 신청 상태(CONFIRMED/WAITLISTED/BANNED)와 신청 시각을 포함해 반환합니다.",
-    )
     @GetMapping
     fun list(
         @PathVariable eventId: String,
         @LoggedInUser user: User?,
         @RequestParam(required = false) status: String?,
         @RequestParam(required = false) orderBy: String?,
-        @Parameter(description = "다음 페이지 시작 offset (없으면 0부터)")
         @RequestParam(required = false) cursor: Int?,
     ): ResponseEntity<GetEventRegistrationsResponse> =
         ResponseEntity.ok(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
index 6da5b2c9..71022123 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/MyRegistrationController.kt
@@ -5,9 +5,6 @@ import com.wafflestudio.spring2025.domain.auth.LoggedInUser
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetMyRegistrationsResponse
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
@@ -17,17 +14,12 @@ import org.springframework.web.bind.annotation.RestController
 @AuthRequired
 @RestController
 @RequestMapping("/api/registrations")
-@Tag(name = "Registration", description = "내 신청 조회 API")
 class MyRegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "내 이벤트 신청 목록 조회",
-        description = "로그인한 사용자의 이벤트 신청 목록을 조회합니다. 최신 신청 순으로 반환되며 page/size로 페이징합니다.",
-    )
     @GetMapping("/me")
     fun myRegistrations(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
         @RequestParam(defaultValue = "0") page: Int,
         @RequestParam(defaultValue = "20") size: Int,
     ): ResponseEntity<GetMyRegistrationsResponse> {
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
index 2ffccbe6..f2568d12 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
@@ -10,8 +10,6 @@ import com.wafflestudio.spring2025.domain.registration.exception.RegistrationErr
 import com.wafflestudio.spring2025.domain.registration.exception.RegistrationValidationException
 import com.wafflestudio.spring2025.domain.registration.service.RegistrationService
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
@@ -23,16 +21,9 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/registrations/{registrationId}")
-@Tag(name = "Registration", description = "신청 단건 리소스 API")
 class RegistrationController(
     private val registrationService: RegistrationService,
 ) {
-    @Operation(
-        summary = "신청 단건 상태 변경",
-        description =
-            "신청 단건 리소스의 상태를 변경합니다. " +
-                "사용자가 본인의 신청을 취소하는 경우와 관리자가 강제 취소/밴 처리하는 경우를 로직 레벨에서 구분합니다.",
-    )
     @PatchMapping
     fun updateStatus(
         @PathVariable registrationId: String,
@@ -45,11 +36,6 @@ class RegistrationController(
         return ResponseEntity.ok(response)
     }
 
-    @Operation(
-        summary = "신청 단건 정보 요청",
-        description =
-            "신청 단건의 정보를 반환합니다.",
-    )
     @GetMapping
     fun getRegistrationInformation(
         @PathVariable registrationId: String,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
index e6764f91..33f1410e 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationDto.kt
@@ -2,23 +2,14 @@ package com.wafflestudio.spring2025.domain.registration.dto.core
 
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 정보")
 data class RegistrationDto(
-    @Schema(description = "신청 공개 ID")
     val registrationPublicId: String,
-    @Schema(description = "사용자 ID")
     val userId: Long?,
-    @Schema(description = "이벤트 ID")
     val eventId: Long,
-    @Schema(description = "비회원 이름")
     val guestName: String?,
-    @Schema(description = "비회원 이메일")
     val guestEmail: String?,
-    @Schema(description = "신청 상태")
     val status: RegistrationStatus,
-    @Schema(description = "신청 일시 (epoch milliseconds)")
     val createdAt: Long,
 ) {
     constructor(registration: Registration) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
index 5255eb9e..70c08a66 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/core/RegistrationWithEventDto.kt
@@ -2,13 +2,9 @@ package com.wafflestudio.spring2025.domain.registration.dto.core
 
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.registration.model.Registration
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "내 이벤트 신청 정보")
 data class RegistrationWithEventDto(
-    @Schema(description = "신청 정보")
     val registration: RegistrationDto,
-    @Schema(description = "이벤트 요약 정보")
     val event: EventSummaryDto,
 ) {
     constructor(registration: Registration, event: Event) : this(
@@ -17,17 +13,11 @@ data class RegistrationWithEventDto(
     )
 }
 
-@Schema(description = "이벤트 요약 정보")
 data class EventSummaryDto(
-    @Schema(description = "이벤트 ID")
     val id: Long,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "장소")
     val location: String?,
-    @Schema(description = "시작 시간 (epoch milliseconds)")
     val startsAt: Long?,
-    @Schema(description = "종료 시간 (epoch milliseconds)")
     val endsAt: Long?,
 ) {
     constructor(event: Event) : this(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
index baf7052f..820bd1e5 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/CreateRegistrationRequest.kt
@@ -1,14 +1,10 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
 import com.fasterxml.jackson.annotation.JsonAlias
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 요청")
 data class CreateRegistrationRequest(
-    @Schema(description = "비회원 이름")
     @JsonAlias("guest_name")
     val guestName: String? = null,
-    @Schema(description = "비회원 이메일")
     @JsonAlias("guest_email")
     val guestEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
index 3f34c5f8..0df46b98 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
@@ -1,11 +1,6 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 취소 요청")
 data class DeleteRegistrationRequest(
-    @Schema(description = "비회원 이름")
     val guestName: String? = null,
-    @Schema(description = "비회원 이메일")
     val guestEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
index f87d15fb..2182cddc 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/UpdateRegistrationStatusRequest.kt
@@ -1,9 +1,7 @@
 package com.wafflestudio.spring2025.domain.registration.dto.request
 
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 상태 변경 요청")
 data class UpdateRegistrationStatusRequest(
     val status: RegistrationStatus? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
index eb4ea566..3abe25e8 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/CreateRegistrationResponse.kt
@@ -1,9 +1,5 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 신청 응답")
 data class CreateRegistrationResponse(
-    @Schema(description = "신청 id")
     val registrationPublicId: String,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
index 39a7951b..c5837bd2 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetEventRegistrationsResponse.kt
@@ -3,36 +3,22 @@ package com.wafflestudio.spring2025.domain.registration.dto.response
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
 import com.wafflestudio.spring2025.domain.user.model.User
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "이벤트 신청 목록 조회 응답")
 data class GetEventRegistrationsResponse(
-    @Schema(description = "신청자 목록")
     val participants: List<EventRegistrationItem>,
-    @Schema(description = "필터에 따라 변하는 참여자 수")
     val totalCount: Int?,
-    @Schema(description = "다음 페이지 시작 offset (없으면 null)")
     val nextCursor: Int?,
-    @Schema(description = "다음 페이지 존재 여부")
     val hasNext: Boolean,
 )
 
-@Schema(description = "신청자 정보")
 data class EventRegistrationItem(
-    @Schema(description = "신청 공개 ID")
     val registrationId: String,
-    @Schema(description = "이름")
     val name: String,
-    @Schema(description = "이메일 (관리자 요청 시 노출)")
     val email: String?,
-    @Schema(description = "프로필 이미지 URL")
     val profileImage: String?,
-    @Schema(description = "신청 일시")
     val createdAt: Instant,
-    @Schema(description = "신청 상태")
     val status: RegistrationStatus,
-    @Schema(description = "대기 순번 (status가 WAITLISTED일 때만 아니면 null)")
     val waitingNum: Int?,
 ) {
     constructor(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
index 74c36966..5c597315 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
@@ -3,36 +3,22 @@ package com.wafflestudio.spring2025.domain.registration.dto.response
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 import java.time.Instant
 
-@Schema(description = "내 이벤트 신청 목록 응답")
 data class GetMyRegistrationsResponse(
-    @Schema(description = "신청 목록")
     val registrations: List<MyRegistrationItem>,
 )
 
-@Schema(description = "내 이벤트 신청 요약")
 data class MyRegistrationItem(
-    @Schema(description = "이벤트 공개 ID")
     val publicId: String,
-    @Schema(description = "이벤트 제목")
     val title: String,
-    @Schema(description = "이벤트 시작 시간 (ISO-8601)")
     val startsAt: Instant?,
-    @Schema(description = "이벤트 종료 시간 (ISO-8601)")
     val endsAt: Instant?,
-    @Schema(description = "신청 시작 시간 (ISO-8601)")
     val registrationStartsAt: Instant?,
-    @Schema(description = "신청 마감 시간 (ISO-8601)")
     val registrationEndsAt: Instant?,
-    @Schema(description = "정원")
     val capacity: Int?,
-    @Schema(description = "현재 신청 수 + 대기 수")
     val registrationCnt: Int,
-    @Schema(description = "신청 상태")
     val status: MyRegistrationStatus,
-    @Schema(description = "대기 순번 (WAITLISTED가 아니면 null)")
     val waitlistedNum: Int?,
 ) {
     constructor(
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
index e03dd30c..d241cd32 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetRegistrationResponse.kt
@@ -1,9 +1,7 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 신청 정보 요청 응답")
 data class GetRegistrationResponse(
     val status: RegistrationStatus,
     val guestName: String,
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
index 5f8f534a..e328c6db 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/PatchRegistrationResponse.kt
@@ -1,8 +1,5 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 신청 상태 변경")
 data class PatchRegistrationResponse(
     val patchEmail: String? = null,
 )
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
index 5d0d0855..fe52c458 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/RegistrationGuestsResponse.kt
@@ -1,29 +1,19 @@
 package com.wafflestudio.spring2025.domain.registration.dto.response
 
 import com.fasterxml.jackson.annotation.JsonProperty
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "이벤트 참여자 명단 응답")
 data class RegistrationGuestsResponse(
-    @Schema(description = "확정 참여자 목록")
     val guests: List<Guest>,
     @JsonProperty("confirmed_count")
-    @Schema(description = "확정 참여자 수")
     val confirmedCount: Int,
     @JsonProperty("waiting_count")
-    @Schema(description = "대기 참여자 수")
     val waitingCount: Int,
 ) {
-    @Schema(description = "참여자 정보")
     data class Guest(
-        @Schema(description = "신청 공개 ID")
         val registrationPublicId: String,
-        @Schema(description = "이름")
         val name: String,
-        @Schema(description = "이메일 (관리자 요청 시 노출)")
         val email: String?,
         @JsonProperty("profile_image")
-        @Schema(description = "프로필 이미지 URL")
         val profileImage: String?,
     )
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
index 85c924bd..8f214cf1 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/controller/UserController.kt
@@ -7,11 +7,6 @@ import com.wafflestudio.spring2025.domain.user.dto.PatchMeRequest
 import com.wafflestudio.spring2025.domain.user.dto.PatchMeResponse
 import com.wafflestudio.spring2025.domain.user.model.User
 import com.wafflestudio.spring2025.domain.user.service.UserService
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.Parameter
-import io.swagger.v3.oas.annotations.responses.ApiResponse
-import io.swagger.v3.oas.annotations.responses.ApiResponses
-import io.swagger.v3.oas.annotations.tags.Tag
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PatchMapping
@@ -22,27 +17,19 @@ import org.springframework.web.bind.annotation.RestController
 @AuthRequired
 @RestController
 @RequestMapping("/api/users")
-@Tag(name = "User", description = "사용자 API")
 class UserController(
     private val userService: UserService,
 ) {
-    @Operation(summary = "본인 정보 조회", description = "로그인한 사용자의 정보를 조회합니다")
-    @ApiResponses(
-        value = [
-            ApiResponse(responseCode = "200", description = "사용자 정보 조회 성공"),
-            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-        ],
-    )
     @AuthRequired
     @GetMapping("/me")
     fun me(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
     ): ResponseEntity<GetMeResponse> = ResponseEntity.ok(userService.me(user))
 
     @AuthRequired
     @PatchMapping("/me")
     fun patchMe(
-        @Parameter(hidden = true) @LoggedInUser user: User,
+        @LoggedInUser user: User,
         @RequestBody request: PatchMeRequest,
     ): ResponseEntity<PatchMeResponse> {
         userService.patchMe(
@@ -54,41 +41,4 @@ class UserController(
         )
         return ResponseEntity.ok(userService.me(user))
     }
-
-//    @Operation(summary = "프로필 이미지 업로드", description = "로그인한 사용자의 프로필 이미지를 업로드(교체)합니다")
-//    @ApiResponses(
-//        value = [
-//            ApiResponse(responseCode = "204", description = "프로필 이미지 업로드 성공"),
-//            ApiResponse(responseCode = "400", description = "잘못된 요청 (파일 누락/형식 오류 등)"),
-//            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-//        ],
-//    )
-//    @AuthRequired
-//    @PutMapping(
-//        "/me/profile-image",
-//        consumes = [MediaType.MULTIPART_FORM_DATA_VALUE],
-//    )
-//    fun uploadProfileImage(
-//        @Parameter(hidden = true) @LoggedInUser user: User?,
-//        @RequestPart("image") image: MultipartFile,
-//    ): ResponseEntity<Void> {
-//        userService.updateProfileImage(user, image)
-//        return ResponseEntity.noContent().build()
-//    }
-//
-//    @Operation(summary = "프로필 이미지 삭제", description = "로그인한 사용자의 프로필 이미지를 삭제(기본 이미지로 복귀)합니다")
-//    @ApiResponses(
-//        value = [
-//            ApiResponse(responseCode = "204", description = "프로필 이미지 삭제 성공"),
-//            ApiResponse(responseCode = "401", description = "인증 실패 (유효하지 않은 토큰)"),
-//        ],
-//    )
-//    @AuthRequired
-//    @DeleteMapping("/me/profile-image")
-//    fun deleteProfileImage(
-//        @Parameter(hidden = true) @LoggedInUser user: User?,
-//    ): ResponseEntity<Void> {
-//        userService.deleteProfileImage(user)
-//        return ResponseEntity.noContent().build()
-//    }
 }
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
index 092180d5..1a0f9e05 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/user/identity/dto/core/UserIdentityDto.kt
@@ -1,19 +1,12 @@
 package com.wafflestudio.spring2025.domain.user.identity.dto.core
 
 import com.wafflestudio.spring2025.domain.user.identity.model.UserIdentity
-import io.swagger.v3.oas.annotations.media.Schema
 
-@Schema(description = "소셜 계정 정보")
 data class UserIdentityDto(
-    @Schema(description = "소셜 계정 ID")
     val id: Long,
-    @Schema(description = "사용자 ID")
     val userId: Long,
-    @Schema(description = "소셜 로그인 제공자")
     val provider: String,
-    @Schema(description = "제공자 사용자 ID")
     val providerUserId: String,
-    @Schema(description = "생성 일시 (epoch milliseconds)")
     val createdAt: Long,
 ) {
     constructor(identity: UserIdentity) : this(
diff --git a/src/main/resources/application.yaml b/src/main/resources/application.yaml
index 7fefbb20..473a1ff9 100644
--- a/src/main/resources/application.yaml
+++ b/src/main/resources/application.yaml
@@ -95,6 +95,13 @@ aws:
 server:
   forward-headers-strategy: framework
 
+springdoc:
+  api-docs:
+    enabled: false
+  swagger-ui:
+    url: /docs/openapi.yaml
+    disable-swagger-default-url: true
+
 ---
 spring:
   config:
diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
new file mode 100644
index 00000000..cdfaeb8b
--- /dev/null
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -0,0 +1,1181 @@
+openapi: 3.0.1
+info:
+  title: Moiming - Event Schedule Management System API
+  description: 모임 일정 관리 시스템 '모이밍' API 문서
+  version: "1.0"
+servers:
+- url: http://localhost:8080
+  description: Generated server url
+tags:
+- name: Event
+  description: 이벤트 관리 API
+- name: Registration
+  description: 신청 API
+- name: Auth
+  description: 인증 API
+- name: User
+  description: 사용자 API
+- name: Image
+  description: 이미지 API
+paths:
+  /api/events/{publicId}:
+    get:
+      tags:
+      - Event
+      summary: 이벤트 상세 조회
+      description: 이벤트 상세 정보를 조회합니다
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/EventDetailResponse"
+    put:
+      tags:
+      - Event
+      summary: 이벤트 수정
+      description: 이벤트를 수정합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateEventRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UpdateEventResponse"
+        "401":
+          description: 인증 필요
+    delete:
+      tags:
+      - Event
+      summary: 이벤트 삭제
+      description: 이벤트를 삭제합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: publicId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "204":
+          description: No Content
+        "401":
+          description: 인증 필요
+  /api/images:
+    post:
+      tags:
+      - Image
+      summary: 이미지 업로드
+      description: 서버 저장소에 이미지를 업로드합니다.
+      parameters:
+      - name: prefix
+        in: query
+        description: 이미지를 저장할 상위 경로
+        required: false
+        schema:
+          type: string
+      requestBody:
+        content:
+          multipart/form-data:
+            schema:
+              required:
+              - image
+              type: object
+              properties:
+                image:
+                  type: string
+                  format: binary
+      responses:
+        "401":
+          description: 인증 실패 (유효하지 않은 토큰)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+        "200":
+          description: 이미지 업로드 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+        "400":
+          description: 잘못된 요청 (파일 누락/형식 오류 등)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ImageUploadResponse"
+  /api/events:
+    post:
+      tags:
+      - Event
+      summary: 이벤트 생성
+      description: 새로운 이벤트를 생성합니다
+      security:
+      - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateEventRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateEventResponse"
+        "401":
+          description: 인증 필요
+  /api/events/{eventId}/registrations:
+    get:
+      tags:
+      - Registration
+      summary: 이벤트 신청 목록 조회
+      description: 특정 이벤트에 속한 신청 목록을 조회합니다. 신청 상태(CONFIRMED/WAITLISTED/BANNED)와 신청
+        시각을 포함해 반환합니다.
+      parameters:
+      - name: eventId
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: status
+        in: query
+        required: false
+        schema:
+          type: string
+      - name: orderBy
+        in: query
+        required: false
+        schema:
+          type: string
+      - name: cursor
+        in: query
+        description: 다음 페이지 시작 offset (없으면 0부터)
+        required: false
+        schema:
+          type: integer
+          format: int32
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetEventRegistrationsResponse"
+    post:
+      tags:
+      - Registration
+      summary: 이벤트 참여 신청
+      description: "특정 이벤트에 신청합니다. 정원이 남아있으면 CONFIRMED로 등록되고, 정원이 찼으나 대기 명단이 허용된 경\
+        우 WAITLISTED로 등록됩니다. 정원이 찼고 대기 명단이 비활성화된 경우 신청이 거절됩니다."
+      parameters:
+      - name: eventId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateRegistrationRequest"
+        required: true
+      responses:
+        "200":
+          description: 신청 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "409":
+          description: "신청 불가: 3001(Registration already exists), 3005(Host cannot\
+            \ register), 2301(Event is full)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "400":
+          description: "유효하지 않은 요청: 3003(Wrong guest name), 3004(Wrong guest email),\
+            \ 2204(Invalid registration window)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "403":
+          description: "권한 없음: 3006(Banned user cannot register)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+        "404":
+          description: "이벤트 없음: 2001(Event not found)"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CreateRegistrationResponse"
+  /api/auth/social:
+    post:
+      tags:
+      - Auth
+      summary: 소셜 로그인
+      description: 소셜 로그인을 요청합니다.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SocialLoginRequest"
+        required: true
+      responses:
+        "200":
+          description: 소셜 로그인 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "409":
+          description: 이미 가입된 이메일
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "401":
+          description: 인증 실패
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+  /api/auth/signup:
+    post:
+      tags:
+      - Auth
+      summary: 이메일 회원가입
+      description: 새로운 사용자를 등록하고 인증 이메일을 발송합니다. 이메일 인증 후 가입이 완료됩니다.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SignupRequest"
+        required: true
+      responses:
+        "409":
+          description: 이미 존재하는 email
+        "204":
+          description: 인증 이메일 발송 성공
+        "400":
+          description: 잘못된 요청 (유효하지 않은 email/password/name)
+        "503":
+          description: 이메일 서비스 장애
+  /api/auth/logout:
+    post:
+      tags:
+      - Auth
+      summary: 로그아웃
+      description: 현재 JWT 토큰을 블랙리스트에 추가하여 로그아웃합니다
+      responses:
+        "204":
+          description: 로그아웃 성공
+  /api/auth/login:
+    post:
+      tags:
+      - Auth
+      summary: 로그인
+      description: email로 로그인하여 JWT 토큰을 발급받습니다
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LoginRequest"
+        required: true
+      responses:
+        "401":
+          description: 인증 실패
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+        "200":
+          description: "로그인 성공, JWT 토큰 반환"
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/LoginResponse"
+  /api/auth/email-verification/{verificationCode}:
+    post:
+      tags:
+      - Auth
+      summary: 이메일 인증
+      description: 이메일로 받은 인증 코드를 검증하고 회원가입을 완료합니다
+      parameters:
+      - name: verificationCode
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "400":
+          description: 유효하지 않거나 만료된 인증 코드
+        "200":
+          description: "인증 성공, 유저 등록 완료"
+  /api/users/me:
+    get:
+      tags:
+      - User
+      summary: 본인 정보 조회
+      description: 로그인한 사용자의 정보를 조회합니다
+      security:
+      - bearerAuth: []
+      responses:
+        "401":
+          description: 인증 실패 (유효하지 않은 토큰)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+        "200":
+          description: 사용자 정보 조회 성공
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+    patch:
+      tags:
+      - User
+      summary: 본인 정보 수정
+      description: 로그인한 사용자의 정보를 수정합니다
+      security:
+      - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PatchMeRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/UserDto"
+        "401":
+          description: 인증 필요
+  /api/registrations/{registrationId}:
+    get:
+      tags:
+      - Registration
+      summary: 신청 단건 정보 요청
+      description: 신청 단건의 정보를 반환합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetRegistrationResponse"
+    delete:
+      tags:
+      - Registration
+      summary: 신청 단건 취소
+      description: 신청 단건 리소스를 취소합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/DeleteRegistrationRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/DeleteRegistrationResponse"
+    patch:
+      tags:
+      - Registration
+      summary: 신청 단건 상태 변경
+      description: 신청 단건 리소스의 상태를 변경합니다. 사용자가 본인의 신청을 취소하는 경우와 관리자가 강제 취소/밴 처리하는 경우를
+        로직 레벨에서 구분합니다.
+      parameters:
+      - name: registrationId
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateRegistrationStatusRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/PatchRegistrationResponse"
+  /api/registrations/me:
+    get:
+      tags:
+      - Registration
+      summary: 내 이벤트 신청 목록 조회
+      description: 로그인한 사용자의 이벤트 신청 목록을 조회합니다. 최신 신청 순으로 반환되며 page/size로 페이징합니다.
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: page
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 0
+      - name: size
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 20
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/GetMyRegistrationsResponse"
+        "401":
+          description: 인증 필요
+  /api/events/me:
+    get:
+      tags:
+      - Event
+      summary: 내가 만든 이벤트 목록 조회 (무한 스크롤)
+      description: 로그인된 사용자가 생성한 이벤트 목록을 무한 스크롤 방식(cursor)으로 조회합니다
+      security:
+      - bearerAuth: []
+      parameters:
+      - name: cursor
+        in: query
+        required: false
+        schema:
+          type: string
+          format: date-time
+      - name: size
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int32
+          default: 5
+      responses:
+        "200":
+          description: OK
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/MyEventsInfiniteResponse"
+        "401":
+          description: 인증 필요
+components:
+  schemas:
+    UpdateEventRequest:
+      type: object
+      properties:
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 정기 모임
+        description:
+          type: string
+          description: 이벤트 설명
+          example: 정기 모임입니다
+        location:
+          type: string
+          description: 장소
+          example: 강의실 101
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          example: 30
+        waitlistEnabled:
+          type: boolean
+          description: 대기 명단 사용 여부
+          example: true
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:30:00Z
+      description: 일정 수정 요청
+    UpdateEventResponse:
+      required:
+      - registrationEndsAt
+      - title
+      - waitlistEnabled
+      type: object
+      properties:
+        title:
+          type: string
+        description:
+          type: string
+        location:
+          type: string
+        startsAt:
+          type: string
+          format: date-time
+        endsAt:
+          type: string
+          format: date-time
+        capacity:
+          type: integer
+          format: int32
+        waitlistEnabled:
+          type: boolean
+        registrationStartsAt:
+          type: string
+          format: date-time
+        registrationEndsAt:
+          type: string
+          format: date-time
+    ImageUploadResponse:
+      required:
+      - key
+      - url
+      type: object
+      properties:
+        key:
+          type: string
+        url:
+          type: string
+    CreateEventRequest:
+      required:
+      - capacity
+      - registrationEndsAt
+      - title
+      - waitlistEnabled
+      type: object
+      properties:
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 정기 모임
+        description:
+          type: string
+          description: 이벤트 설명
+          example: 정기 모임입니다
+        location:
+          type: string
+          description: 장소
+          example: 강의실 101
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          example: 30
+        waitlistEnabled:
+          type: boolean
+          description: 대기 명단 사용 여부
+          example: true
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601). null인 경우 요청 시점으로 자동 설정됩니다.
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:30:00Z
+      description: 일정 생성 요청
+    CreateEventResponse:
+      required:
+      - publicId
+      type: object
+      properties:
+        publicId:
+          type: string
+    CreateRegistrationRequest:
+      type: object
+      properties:
+        guestName:
+          type: string
+          description: 비회원 이름
+        guestEmail:
+          type: string
+          description: 비회원 이메일
+      description: 이벤트 신청 요청
+    CreateRegistrationResponse:
+      required:
+      - registrationPublicId
+      type: object
+      properties:
+        registrationPublicId:
+          type: string
+          description: 신청 id
+      description: 이벤트 신청 응답
+    SocialLoginRequest:
+      required:
+      - code
+      - provider
+      type: object
+      properties:
+        provider:
+          type: string
+          description: 소셜로그인 제공자
+          example: GOOGLE
+        code:
+          type: string
+          description: 인가 코드 (authorization code)
+      description: 소셜 로그인 요청
+    LoginResponse:
+      required:
+      - token
+      type: object
+      properties:
+        token:
+          type: string
+    SignupRequest:
+      required:
+      - email
+      - name
+      - password
+      type: object
+      properties:
+        email:
+          type: string
+          description: 사용자 이메일
+          example: user@example.com
+        name:
+          type: string
+          description: 사용자 이름
+          example: 홍길동
+        password:
+          type: string
+          description: 비밀번호
+          example: password123
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+          example: https://cdn.example.com/profile.png
+      description: 회원가입 요청
+    LoginRequest:
+      required:
+      - email
+      - password
+      type: object
+      properties:
+        email:
+          type: string
+          description: 사용자 이메일
+          example: user@example.com
+        password:
+          type: string
+          description: 사용자 비밀번호
+          example: mypassword
+      description: 로그인 요청
+    PatchMeRequest:
+      type: object
+      properties:
+        name:
+          type: string
+        email:
+          type: string
+        password:
+          type: string
+        profileImage:
+          type: string
+    UserDto:
+      required:
+      - email
+      - id
+      - name
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int64
+        email:
+          type: string
+        name:
+          type: string
+        profileImage:
+          type: string
+    UpdateRegistrationStatusRequest:
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+      description: 이벤트 신청 상태 변경 요청
+    PatchRegistrationResponse:
+      type: object
+      properties:
+        patchEmail:
+          type: string
+      description: 이벤트 신청 상태 변경
+    GetRegistrationResponse:
+      required:
+      - guestName
+      - registrationPublicId
+      - reservationEmail
+      - status
+      - waitlistPosition
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        guestName:
+          type: string
+        waitlistPosition:
+          type: integer
+          format: int32
+        registrationPublicId:
+          type: string
+        reservationEmail:
+          type: string
+      description: 이벤트 신청 정보 요청 응답
+    GetMyRegistrationsResponse:
+      required:
+      - registrations
+      type: object
+      properties:
+        registrations:
+          type: array
+          description: 신청 목록
+          items:
+            $ref: "#/components/schemas/MyRegistrationItem"
+      description: 내 이벤트 신청 목록 응답
+    MyRegistrationItem:
+      required:
+      - publicId
+      - registrationCnt
+      - status
+      - title
+      type: object
+      properties:
+        publicId:
+          type: string
+          description: 이벤트 공개 ID
+        title:
+          type: string
+          description: 이벤트 제목
+        startsAt:
+          type: string
+          description: 이벤트 시작 시간 (ISO-8601)
+          format: date-time
+        endsAt:
+          type: string
+          description: 이벤트 종료 시간 (ISO-8601)
+          format: date-time
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+        registrationCnt:
+          type: integer
+          description: 현재 신청 수 + 대기 수
+          format: int32
+        status:
+          type: string
+          description: 신청 상태
+          enum:
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        waitlistedNum:
+          type: integer
+          description: 대기 순번 (WAITLISTED가 아니면 null)
+          format: int32
+      description: 내 이벤트 신청 요약
+    CapabilitiesInfo:
+      required:
+      - apply
+      - cancel
+      - shareLink
+      - wait
+      type: object
+      properties:
+        shareLink:
+          type: boolean
+          description: 공유 링크 가능 여부
+          example: false
+        apply:
+          type: boolean
+          description: 참여 신청 가능 여부(확정 자리 신청)
+          example: false
+        wait:
+          type: boolean
+          description: 대기 신청 가능 여부(정원 찼을 때)
+          example: false
+        cancel:
+          type: boolean
+          description: 신청 취소 가능 여부
+          example: true
+      description: 가능한 동작 블록
+    CreatorInfo:
+      required:
+      - email
+      - name
+      type: object
+      properties:
+        name:
+          type: string
+          description: 이름
+          example: 홍길동
+        email:
+          type: string
+          description: 이메일
+          example: user@example.com
+        profileImage:
+          type: string
+          description: 프로필 이미지
+          nullable: true
+          example: https://example.com/profile.png
+      description: 생성자 정보 블록
+    EventDetailResponse:
+      required:
+      - capabilities
+      - creator
+      - event
+      - guestsPreview
+      - viewer
+      type: object
+      properties:
+        event:
+          $ref: "#/components/schemas/EventInfo"
+        creator:
+          $ref: "#/components/schemas/CreatorInfo"
+        viewer:
+          $ref: "#/components/schemas/ViewerInfo"
+        capabilities:
+          $ref: "#/components/schemas/CapabilitiesInfo"
+        guestsPreview:
+          type: array
+          description: 참여자 미리보기 목록
+          items:
+            $ref: "#/components/schemas/GuestPreview"
+      description: 일정 상세 조회 응답
+    EventInfo:
+      required:
+      - publicId
+      - registrationEndsAt
+      - title
+      - totalApplicants
+      type: object
+      properties:
+        publicId:
+          type: string
+          description: 이벤트 publicId
+          example: dj8sadj10djnkas
+        title:
+          type: string
+          description: 이벤트 제목
+          example: 제2회 기획 세미나
+        description:
+          type: string
+          description: 이벤트 설명
+          nullable: true
+          example: 일정 상세 설명...
+        location:
+          type: string
+          description: 장소
+          nullable: true
+          example: 서울대
+        startsAt:
+          type: string
+          description: 시작 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T18:00:00Z
+        endsAt:
+          type: string
+          description: 종료 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T20:00:00Z
+        capacity:
+          type: integer
+          description: 정원
+          format: int32
+          nullable: true
+          example: 10
+        totalApplicants:
+          type: integer
+          description: 총 신청자 수(확정+대기 등)
+          format: int32
+          example: 8
+        registrationStartsAt:
+          type: string
+          description: 신청 시작 시간 (ISO-8601)
+          format: date-time
+          nullable: true
+          example: 2026-02-02T17:00:00Z
+        registrationEndsAt:
+          type: string
+          description: 신청 마감 시간 (ISO-8601)
+          format: date-time
+          example: 2026-02-02T17:00:00Z
+      description: 이벤트 정보 블록
+    GuestPreview:
+      required:
+      - name
+      type: object
+      properties:
+        id:
+          type: integer
+          description: 참여자 ID (비회원이면 null)
+          format: int64
+          nullable: true
+          example: 1
+        name:
+          type: string
+          description: 참여자 이름
+          example: 홍길동
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+          nullable: true
+          example: https://example.com/profile.png
+      description: 참여자 미리보기 정보
+    ViewerInfo:
+      required:
+      - status
+      type: object
+      properties:
+        status:
+          type: string
+          description: 이벤트 조회자(Viewer)의 상태
+          example: WAITLISTED
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+          - NONE
+        name:
+          type: string
+          description: viewer 이름 (비회원이면 null)
+          nullable: true
+          example: 홍길동
+        waitlistPosition:
+          type: integer
+          description: "대기 순번 (WAITLISTED일 때만 숫자, 아니면 null)"
+          format: int32
+          nullable: true
+          example: 3
+        registrationPublicId:
+          type: string
+          description: "registrationPublicId (게스트면 값, 아니면 null)"
+          nullable: true
+          example: "1"
+        reservationEmail:
+          type: string
+          description: "예약 이메일(게스트면 guestEmail, 로그인 유저면 user email 등 정책에 따름)"
+          nullable: true
+          example: skdfsj@gmaldkl
+      description: 조회자(viewer) 정보 블록
+    EventRegistrationItem:
+      required:
+      - createdAt
+      - name
+      - registrationId
+      - status
+      type: object
+      properties:
+        registrationId:
+          type: string
+          description: 신청 공개 ID
+        name:
+          type: string
+          description: 이름
+        email:
+          type: string
+          description: 이메일 (관리자 요청 시 노출)
+        profileImage:
+          type: string
+          description: 프로필 이미지 URL
+        createdAt:
+          type: string
+          description: 신청 일시
+          format: date-time
+        status:
+          type: string
+          description: 신청 상태
+          enum:
+          - HOST
+          - CONFIRMED
+          - WAITLISTED
+          - BANNED
+        waitingNum:
+          type: integer
+          description: 대기 순번 (status가 WAITLISTED일 때만 아니면 null)
+          format: int32
+      description: 신청자 정보
+    GetEventRegistrationsResponse:
+      required:
+      - hasNext
+      - participants
+      type: object
+      properties:
+        participants:
+          type: array
+          description: 신청자 목록
+          items:
+            $ref: "#/components/schemas/EventRegistrationItem"
+        totalCount:
+          type: integer
+          description: 필터에 따라 변하는 참여자 수
+          format: int32
+        nextCursor:
+          type: integer
+          description: 다음 페이지 시작 offset (없으면 null)
+          format: int32
+        hasNext:
+          type: boolean
+          description: 다음 페이지 존재 여부
+      description: 이벤트 신청 목록 조회 응답
+    MyEventResponse:
+      required:
+      - publicId
+      - registrationEndsAt
+      - title
+      - totalApplicants
+      type: object
+      properties:
+        publicId:
+          type: string
+        title:
+          type: string
+        startsAt:
+          type: string
+          format: date-time
+        endsAt:
+          type: string
+          format: date-time
+        registrationStartsAt:
+          type: string
+          format: date-time
+        registrationEndsAt:
+          type: string
+          format: date-time
+        capacity:
+          type: integer
+          format: int32
+        totalApplicants:
+          type: integer
+          format: int32
+    MyEventsInfiniteResponse:
+      required:
+      - events
+      - hasNext
+      type: object
+      properties:
+        events:
+          type: array
+          items:
+            $ref: "#/components/schemas/MyEventResponse"
+        nextCursor:
+          type: string
+          format: date-time
+        hasNext:
+          type: boolean
+    DeleteRegistrationRequest:
+      type: object
+      properties:
+        guestName:
+          type: string
+          description: 비회원 이름
+        guestEmail:
+          type: string
+          description: 비회원 이메일
+      description: 이벤트 취소 요청
+    DeleteRegistrationResponse:
+      type: object
+  securitySchemes:
+    bearerAuth:
+      type: http
+      description: JWT 토큰을 입력하세요
+      name: bearerAuth
+      scheme: bearer
+      bearerFormat: JWT
diff --git a/src/main/resources/static/docs/swagger-ui.html b/src/main/resources/static/docs/swagger-ui.html
new file mode 100644
index 00000000..517735db
--- /dev/null
+++ b/src/main/resources/static/docs/swagger-ui.html
@@ -0,0 +1,36 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>MoiMing API Docs</title>
+    <link rel="stylesheet" href="/webjars/swagger-ui/swagger-ui.css" />
+    <style>
+      html,
+      body {
+        margin: 0;
+        height: 100%;
+      }
+      #swagger-ui {
+        height: 100%;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="swagger-ui"></div>
+    <script src="/webjars/swagger-ui/swagger-ui-bundle.js"></script>
+    <script src="/webjars/swagger-ui/swagger-ui-standalone-preset.js"></script>
+    <script>
+      window.onload = function () {
+        window.ui = SwaggerUIBundle({
+          url: "/docs/openapi.yaml",
+          dom_id: "#swagger-ui",
+          deepLinking: true,
+          presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
+          plugins: [SwaggerUIBundle.plugins.DownloadUrl],
+          layout: "StandaloneLayout",
+        });
+      };
+    </script>
+  </body>
+</html>

From bd0c580f019074351099b9e8f766889f849c4811 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 18 Apr 2026 22:18:27 +0900
Subject: [PATCH 03/27] =?UTF-8?q?:memo:=20swagger=20=EB=B6=88=EC=9D=BC?=
 =?UTF-8?q?=EC=B9=98=20=EB=B6=80=EB=B6=84=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/resources/static/docs/openapi.yaml | 125 ++++++++++++++++----
 1 file changed, 99 insertions(+), 26 deletions(-)

diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
index cdfaeb8b..6fa1daac 100644
--- a/src/main/resources/static/docs/openapi.yaml
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -108,12 +108,6 @@ paths:
                   type: string
                   format: binary
       responses:
-        "401":
-          description: 인증 실패 (유효하지 않은 토큰)
-          content:
-            '*/*':
-              schema:
-                $ref: "#/components/schemas/ImageUploadResponse"
         "200":
           description: 이미지 업로드 성공
           content:
@@ -125,7 +119,13 @@ paths:
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/ImageUploadResponse"
+                $ref: "#/components/schemas/ErrorResponse"
+        "401":
+          description: 인증 실패 (유효하지 않은 토큰)
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
   /api/events:
     post:
       tags:
@@ -212,31 +212,29 @@ paths:
               schema:
                 $ref: "#/components/schemas/CreateRegistrationResponse"
         "409":
-          description: "신청 불가: 3001(Registration already exists), 3005(Host cannot\
-            \ register), 2301(Event is full)"
+          description: "신청 불가: REGISTRATION_ALREADY_EXISTS, REGISTRATION_BLOCKED_HOST, EVENT_FULL"
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/CreateRegistrationResponse"
+                $ref: "#/components/schemas/ErrorResponse"
         "400":
-          description: "유효하지 않은 요청: 3003(Wrong guest name), 3004(Wrong guest email),\
-            \ 2204(Invalid registration window)"
+          description: "유효하지 않은 요청: REGISTRATION_WRONG_NAME, REGISTRATION_WRONG_EMAIL, NOT_WITHIN_REGISTRATION_WINDOW"
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/CreateRegistrationResponse"
+                $ref: "#/components/schemas/ErrorResponse"
         "403":
-          description: "권한 없음: 3006(Banned user cannot register)"
+          description: "권한 없음: REGISTRATION_BLOCKED_BANNED"
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/CreateRegistrationResponse"
+                $ref: "#/components/schemas/ErrorResponse"
         "404":
-          description: "이벤트 없음: 2001(Event not found)"
+          description: "이벤트 없음: EVENT_NOT_FOUND"
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/CreateRegistrationResponse"
+                $ref: "#/components/schemas/ErrorResponse"
   /api/auth/social:
     post:
       tags:
@@ -261,13 +259,13 @@ paths:
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/LoginResponse"
+                $ref: "#/components/schemas/ErrorResponse"
         "401":
           description: 인증 실패
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/LoginResponse"
+                $ref: "#/components/schemas/ErrorResponse"
   /api/auth/signup:
     post:
       tags:
@@ -316,7 +314,7 @@ paths:
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/LoginResponse"
+                $ref: "#/components/schemas/ErrorResponse"
         "200":
           description: "로그인 성공, JWT 토큰 반환"
           content:
@@ -354,7 +352,7 @@ paths:
           content:
             '*/*':
               schema:
-                $ref: "#/components/schemas/UserDto"
+                $ref: "#/components/schemas/ErrorResponse"
         "200":
           description: 사용자 정보 조회 성공
           content:
@@ -522,43 +520,52 @@ components:
         title:
           type: string
           description: 이벤트 제목
+          nullable: true
           example: 정기 모임
         description:
           type: string
           description: 이벤트 설명
+          nullable: true
           example: 정기 모임입니다
         location:
           type: string
           description: 장소
+          nullable: true
           example: 강의실 101
         startsAt:
           type: string
           description: 시작 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T18:00:00Z
         endsAt:
           type: string
           description: 종료 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T20:00:00Z
         capacity:
           type: integer
           description: 정원
           format: int32
+          nullable: true
           example: 30
         waitlistEnabled:
           type: boolean
           description: 대기 명단 사용 여부
+          nullable: true
           example: true
         registrationStartsAt:
           type: string
           description: 신청 시작 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T17:00:00Z
         registrationEndsAt:
           type: string
           description: 신청 마감 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T17:30:00Z
       description: 일정 수정 요청
     UpdateEventResponse:
@@ -572,22 +579,28 @@ components:
           type: string
         description:
           type: string
+          nullable: true
         location:
           type: string
+          nullable: true
         startsAt:
           type: string
           format: date-time
+          nullable: true
         endsAt:
           type: string
           format: date-time
+          nullable: true
         capacity:
           type: integer
           format: int32
+          nullable: true
         waitlistEnabled:
           type: boolean
         registrationStartsAt:
           type: string
           format: date-time
+          nullable: true
         registrationEndsAt:
           type: string
           format: date-time
@@ -616,20 +629,24 @@ components:
         description:
           type: string
           description: 이벤트 설명
+          nullable: true
           example: 정기 모임입니다
         location:
           type: string
           description: 장소
+          nullable: true
           example: 강의실 101
         startsAt:
           type: string
           description: 시작 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T18:00:00Z
         endsAt:
           type: string
           description: 종료 시간 (ISO-8601)
           format: date-time
+          nullable: true
           example: 2026-02-02T20:00:00Z
         capacity:
           type: integer
@@ -644,6 +661,7 @@ components:
           type: string
           description: 신청 시작 시간 (ISO-8601). null인 경우 요청 시점으로 자동 설정됩니다.
           format: date-time
+          nullable: true
           example: 2026-02-02T17:00:00Z
         registrationEndsAt:
           type: string
@@ -664,9 +682,11 @@ components:
         guestName:
           type: string
           description: 비회원 이름
+          nullable: true
         guestEmail:
           type: string
           description: 비회원 이메일
+          nullable: true
       description: 이벤트 신청 요청
     CreateRegistrationResponse:
       required:
@@ -720,6 +740,7 @@ components:
         profileImage:
           type: string
           description: 프로필 이미지 URL
+          nullable: true
           example: https://cdn.example.com/profile.png
       description: 회원가입 요청
     LoginRequest:
@@ -742,12 +763,16 @@ components:
       properties:
         name:
           type: string
+          nullable: true
         email:
           type: string
+          nullable: true
         password:
           type: string
+          nullable: true
         profileImage:
           type: string
+          nullable: true
     UserDto:
       required:
       - email
@@ -764,11 +789,13 @@ components:
           type: string
         profileImage:
           type: string
+          nullable: true
     UpdateRegistrationStatusRequest:
       type: object
       properties:
         status:
           type: string
+          nullable: true
           enum:
           - HOST
           - CONFIRMED
@@ -780,6 +807,7 @@ components:
       properties:
         patchEmail:
           type: string
+          nullable: true
       description: 이벤트 신청 상태 변경
     GetRegistrationResponse:
       required:
@@ -836,22 +864,27 @@ components:
           type: string
           description: 이벤트 시작 시간 (ISO-8601)
           format: date-time
+          nullable: true
         endsAt:
           type: string
           description: 이벤트 종료 시간 (ISO-8601)
           format: date-time
+          nullable: true
         registrationStartsAt:
           type: string
           description: 신청 시작 시간 (ISO-8601)
           format: date-time
+          nullable: true
         registrationEndsAt:
           type: string
           description: 신청 마감 시간 (ISO-8601)
           format: date-time
+          nullable: true
         capacity:
           type: integer
           description: 정원
           format: int32
+          nullable: true
         registrationCnt:
           type: integer
           description: 현재 신청 수 + 대기 수
@@ -867,6 +900,7 @@ components:
           type: integer
           description: 대기 순번 (WAITLISTED가 아니면 null)
           format: int32
+          nullable: true
       description: 내 이벤트 신청 요약
     CapabilitiesInfo:
       required:
@@ -941,7 +975,8 @@ components:
       - publicId
       - registrationEndsAt
       - title
-      - totalApplicants
+      - confirmedCount
+      - waitlistCount
       type: object
       properties:
         publicId:
@@ -980,9 +1015,14 @@ components:
           format: int32
           nullable: true
           example: 10
-        totalApplicants:
+        confirmedCount:
+          type: integer
+          description: 참여 확정 신청자 수
+          format: int32
+          example: 8
+        waitlistCount:
           type: integer
-          description: 총 신청자 수(확정+대기 등)
+          description: 대기자 수
           format: int32
           example: 8
         registrationStartsAt:
@@ -1072,9 +1112,11 @@ components:
         email:
           type: string
           description: 이메일 (관리자 요청 시 노출)
+          nullable: true
         profileImage:
           type: string
           description: 프로필 이미지 URL
+          nullable: true
         createdAt:
           type: string
           description: 신청 일시
@@ -1091,6 +1133,7 @@ components:
           type: integer
           description: 대기 순번 (status가 WAITLISTED일 때만 아니면 null)
           format: int32
+          nullable: true
       description: 신청자 정보
     GetEventRegistrationsResponse:
       required:
@@ -1107,10 +1150,12 @@ components:
           type: integer
           description: 필터에 따라 변하는 참여자 수
           format: int32
+          nullable: true
         nextCursor:
           type: integer
           description: 다음 페이지 시작 offset (없으면 null)
           format: int32
+          nullable: true
         hasNext:
           type: boolean
           description: 다음 페이지 존재 여부
@@ -1120,7 +1165,8 @@ components:
       - publicId
       - registrationEndsAt
       - title
-      - totalApplicants
+      - confirmedCount
+      - waitlistCount
       type: object
       properties:
         publicId:
@@ -1130,19 +1176,26 @@ components:
         startsAt:
           type: string
           format: date-time
+          nullable: true
         endsAt:
           type: string
           format: date-time
+          nullable: true
         registrationStartsAt:
           type: string
           format: date-time
+          nullable: true
         registrationEndsAt:
           type: string
           format: date-time
         capacity:
           type: integer
           format: int32
-        totalApplicants:
+          nullable: true
+        confirmedCount:
+          type: integer
+          format: int32
+        waitlistCount:
           type: integer
           format: int32
     MyEventsInfiniteResponse:
@@ -1158,6 +1211,7 @@ components:
         nextCursor:
           type: string
           format: date-time
+          nullable: true
         hasNext:
           type: boolean
     DeleteRegistrationRequest:
@@ -1166,12 +1220,31 @@ components:
         guestName:
           type: string
           description: 비회원 이름
+          nullable: true
         guestEmail:
           type: string
           description: 비회원 이메일
+          nullable: true
       description: 이벤트 취소 요청
     DeleteRegistrationResponse:
       type: object
+    ErrorResponse:
+      required:
+      - code
+      - message
+      - title
+      type: object
+      properties:
+        code:
+          type: string
+          description: 에러 코드
+        title:
+          type: string
+          description: 에러 제목
+        message:
+          type: string
+          description: 에러 메시지
+      description: 에러 응답
   securitySchemes:
     bearerAuth:
       type: http

From 33f66300703b9d476ecf61f3cda116f2b49c477d Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 19:55:45 +0900
Subject: [PATCH 04/27] =?UTF-8?q?:zap:=20=EB=8C=80=EA=B8=B0=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EA=B3=84=EC=82=B0=20=EC=8B=9C=20=EB=AA=A8=EB=93=A0?=
 =?UTF-8?q?=20=EB=8C=80=EA=B8=B0=20=EC=8B=A0=EC=B2=AD=20=EA=B1=B4=20?=
 =?UTF-8?q?=EB=A1=9C=EB=93=9C=ED=95=98=EC=A7=80=20=EC=95=8A=EB=8F=84?=
 =?UTF-8?q?=EB=A1=9D=20=EB=B3=80=EA=B2=BD=20(=EB=A9=94=EB=AA=A8=EB=A6=AC?=
 =?UTF-8?q?=20=EC=B5=9C=EC=A0=81=ED=99=94)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/event/service/EventService.kt        | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
index e52f056d..4275a045 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
@@ -121,17 +121,16 @@ class EventService(
                 .countByEventIdAndStatus(eventID = eventId, registrationStatus = RegistrationStatus.WAITLISTED)
                 .toInt()
 
-        val totalApplicants = confirmedCount + waitlistedCount
-
         val waitlistPosition: Int? =
             if (myReg?.status == RegistrationStatus.WAITLISTED) {
-                val waitlistedRegs =
-                    registrationRepository.findByEventIdAndStatusOrderByCreatedAtAsc(
-                        eventID = eventId,
-                        registrationStatus = RegistrationStatus.WAITLISTED,
-                    )
-                val idx = waitlistedRegs.indexOfFirst { it.id == myReg.id }
-                if (idx >= 0) idx + 1 else null
+                registrationRepository
+                    .findWaitlistPositionsByRegistrationPublicIds(
+                        eventId = eventId,
+                        status = RegistrationStatus.WAITLISTED,
+                        registrationPublicIds = listOf(myReg.registrationPublicId),
+                    ).firstOrNull()
+                    ?.waitlistNumber
+                    ?.toInt()
             } else {
                 null
             }

From adb4a94ab5b6a9ce03d34751b1571b70d4b810d7 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 19:58:35 +0900
Subject: [PATCH 05/27] =?UTF-8?q?:zap:=20=EC=9D=B4=EB=B2=A4=ED=8A=B8=20?=
 =?UTF-8?q?=EC=83=81=EC=84=B8=EC=A0=95=EB=B3=B4=20=EC=A1=B0=ED=9A=8C=20?=
 =?UTF-8?q?=EC=8B=9C=20user=20=ED=85=8C=EC=9D=B4=EB=B8=94=20=EC=BF=BC?=
 =?UTF-8?q?=EB=A6=AC=20=ED=9A=9F=EC=88=98=20=EC=A4=84=EC=9D=B4=EA=B8=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../spring2025/domain/event/service/EventService.kt  | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
index 4275a045..762ec817 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
@@ -96,10 +96,9 @@ class EventService(
         val event = getEventByPublicId(publicId)
         val eventId = requireNotNull(event.id) { "Event id is null: publicId=$publicId" }
 
-        val creatorUser =
-            userRepository.findById(event.createdBy).orElseThrow {
-                EventNotFoundException()
-            }
+        val userIdsToFetch = listOfNotNull(event.createdBy, requesterId).distinct()
+        val usersById = userRepository.findAllById(userIdsToFetch).associateBy { it.id!! }
+        val creatorUser = usersById[event.createdBy] ?: throw EventNotFoundException()
 
         val myReg =
             if (requesterId == null) {
@@ -149,10 +148,7 @@ class EventService(
                     }
             }
 
-        val viewerName: String? =
-            requesterId?.let {
-                userRepository.findById(it).orElse(null)?.name
-            }
+        val viewerName: String? = requesterId?.let { usersById[it]?.name }
 
         val viewer =
             if (viewerStatus == ViewerStatus.NONE) {

From f36546d7abb77ffededb83c3a30ea3aee81d1634 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:00:57 +0900
Subject: [PATCH 06/27] =?UTF-8?q?:zap:=20guest=20preview=20=EA=B5=AC?=
 =?UTF-8?q?=EC=84=B1=20=EC=8B=9C=20db=EC=97=90=EC=84=9C=20=EC=B2=98?=
 =?UTF-8?q?=EC=9D=8C=EB=B6=80=ED=84=B0=205=EA=B1=B4=EB=A7=8C=20=EC=A1=B0?=
 =?UTF-8?q?=ED=9A=8C=ED=95=98=EB=8F=84=EB=A1=9D=20=EC=88=98=EC=A0=95=20(?=
 =?UTF-8?q?=EB=A9=94=EB=AA=A8=EB=A6=AC=20=EC=B5=9C=EC=A0=81=ED=99=94)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../spring2025/domain/event/service/EventService.kt    | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
index 762ec817..e451a6b9 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
@@ -23,6 +23,7 @@ import com.wafflestudio.spring2025.domain.registration.repository.RegistrationRe
 import com.wafflestudio.spring2025.domain.registration.service.WaitlistReconciliationService
 import com.wafflestudio.spring2025.domain.user.repository.UserRepository
 import org.springframework.data.domain.PageRequest
+import org.springframework.data.domain.Pageable
 import org.springframework.data.domain.Sort
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional
@@ -179,18 +180,17 @@ class EventService(
                 registrationEndsAt = event.registrationEndsAt,
             )
 
-        val confirmedRegs =
+        val previewRegs =
             registrationRepository.findByEventIdAndStatusOrderByCreatedAtAsc(
                 eventID = eventId,
                 registrationStatus = RegistrationStatus.CONFIRMED,
+                pageable = Pageable.ofSize(5),
             )
 
-        val previewRegs = confirmedRegs.take(5)
-
         val previewUserIds =
             previewRegs.mapNotNull { it.userId }.distinct()
 
-        val usersById =
+        val previewUsersById =
             userRepository.findAllById(previewUserIds).associateBy { it.id!! }
 
         val guestsPreview =
@@ -203,7 +203,7 @@ class EventService(
                         profileImage = null,
                     )
                 } else {
-                    usersById[uid]?.let {
+                    previewUsersById[uid]?.let {
                         GuestPreview(
                             id = it.id!!,
                             name = it.name,

From 4186c111cd27f69f68f75c9c771860c04e47a340 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:02:38 +0900
Subject: [PATCH 07/27] =?UTF-8?q?:zap:=20event=20=EB=AA=A9=EB=A1=9D=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20=EC=8B=9C=20N+1=20=EC=BF=BC=EB=A6=AC=20?=
 =?UTF-8?q?=EB=AC=B8=EC=A0=9C=20=ED=95=B4=EA=B2=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/event/service/EventService.kt      | 32 +++++++++++++------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
index e451a6b9..6392e094 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
@@ -271,19 +271,31 @@ class EventService(
         val sliced = fetched.take(pageSize)
         val nextCursor = sliced.lastOrNull()?.createdAt
 
+        val eventIds = sliced.map { requireNotNull(it.id) }
+
+        val confirmedCounts =
+            if (eventIds.isEmpty()) {
+                emptyMap()
+            } else {
+                registrationRepository
+                    .countByEventIdsAndStatuses(eventIds = eventIds, listOf(RegistrationStatus.CONFIRMED))
+                    .associate { it.eventId to it.totalCount.toInt() }
+            }
+
+        val waitlistedCounts =
+            if (eventIds.isEmpty()) {
+                emptyMap()
+            } else {
+                registrationRepository
+                    .countByEventIdsAndStatuses(eventIds = eventIds, listOf(RegistrationStatus.WAITLISTED))
+                    .associate { it.eventId to it.totalCount.toInt() }
+            }
+
         val responses =
             sliced.map { event ->
                 val eventId = requireNotNull(event.id)
-
-                val confirmedCount =
-                    registrationRepository
-                        .countByEventIdAndStatus(eventID = eventId, registrationStatus = RegistrationStatus.CONFIRMED)
-                        .toInt()
-
-                val waitlistedCount =
-                    registrationRepository
-                        .countByEventIdAndStatus(eventID = eventId, registrationStatus = RegistrationStatus.WAITLISTED)
-                        .toInt()
+                val confirmedCount = confirmedCounts[eventId] ?: 0
+                val waitlistedCount = waitlistedCounts[eventId] ?: 0
 
                 MyEventResponse(
                     publicId = event.publicId,

From 8080f1f0b455e1628e0778847e500ce01db9a70c Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:03:53 +0900
Subject: [PATCH 08/27] =?UTF-8?q?:zap:=20event=20=EC=82=AD=EC=A0=9C=20?=
 =?UTF-8?q?=EC=95=8C=EB=A6=BC=20=EB=8C=80=EC=83=81=20=EC=A1=B0=ED=9A=8C=20?=
 =?UTF-8?q?=EC=8B=9C=20=EC=B2=98=EC=9D=8C=EB=B6=80=ED=84=B0=20CONFIRMED+WA?=
 =?UTF-8?q?ITLISTED=EB=A7=8C=20=EA=B0=80=EC=A0=B8=EC=98=A4=EB=8F=84?=
 =?UTF-8?q?=EB=A1=9D=20=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../spring2025/domain/event/service/EventService.kt        | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
index 6392e094..7d41b3e9 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/event/service/EventService.kt
@@ -385,9 +385,10 @@ class EventService(
 
         // 알림 대상: CONFIRMED + WAITLISTED (BANNED 제외)
         val registrationsToNotify =
-            registrationRepository
-                .findByEventId(eventId)
-                .filter { it.status == RegistrationStatus.CONFIRMED || it.status == RegistrationStatus.WAITLISTED }
+            registrationRepository.findByEventIdAndStatusIn(
+                eventID = eventId,
+                statuses = listOf(RegistrationStatus.CONFIRMED, RegistrationStatus.WAITLISTED),
+            )
 
         // 이메일 데이터 구성 (삭제 전에 user 정보 조회)
         val hostUser = userRepository.findById(event.createdBy).orElse(null)

From 2cc448120d04ce50352f7106007cf39cda140776 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:04:27 +0900
Subject: [PATCH 09/27] =?UTF-8?q?:zap:=20event=20=EB=8F=84=EB=A9=94?=
 =?UTF-8?q?=EC=9D=B8=20=EC=BF=BC=EB=A6=AC=20=EC=B5=9C=EC=A0=81=ED=99=94?=
 =?UTF-8?q?=EB=A5=BC=20=EC=9C=84=ED=95=9C=20repository=20method=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../registration/repository/RegistrationRepository.kt | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
index 5ed64233..3c5afa24 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
@@ -41,6 +41,11 @@ interface RegistrationRepository :
         eventId: Long,
     ): Registration?
 
+    fun findByEventIdAndStatusIn(
+        eventID: Long,
+        statuses: Collection<RegistrationStatus>,
+    ): List<Registration>
+
     fun countByEventId(eventID: Long): Long
 
     fun countByEventIdAndStatus(
@@ -66,6 +71,12 @@ interface RegistrationRepository :
         registrationStatus: RegistrationStatus,
     ): List<Registration>
 
+    fun findByEventIdAndStatusOrderByCreatedAtAsc(
+        eventID: Long,
+        registrationStatus: RegistrationStatus,
+        pageable: Pageable,
+    ): List<Registration>
+
     @Query(
         """
         SELECT * FROM registrations

From 63b791ffd88b15bce982d666ffbb2eb70aea6699 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:33:51 +0900
Subject: [PATCH 10/27] =?UTF-8?q?:zap:=20reconcileWaitlist=EC=97=90?=
 =?UTF-8?q?=EC=84=9C=20=EB=B6=88=ED=95=84=EC=9A=94=ED=95=9C=20=EC=A0=84?=
 =?UTF-8?q?=EC=B2=B4=20waitlist=EC=8B=A0=EC=B2=AD=20=EC=A1=B0=ED=9A=8C=20?=
 =?UTF-8?q?=EC=A0=9C=EA=B1=B0=20(=EB=A9=94=EB=AA=A8=EB=A6=AC=20=EC=B5=9C?=
 =?UTF-8?q?=EC=A0=81=ED=99=94)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../registration/service/RegistrationService.kt    | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index a87b211a..a3a8fd01 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -28,6 +28,7 @@ import com.wafflestudio.spring2025.domain.user.model.User
 import com.wafflestudio.spring2025.domain.user.repository.UserRepository
 import org.springframework.dao.DuplicateKeyException
 import org.springframework.data.domain.PageRequest
+import org.springframework.data.domain.Pageable
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional
 import org.springframework.transaction.support.TransactionSynchronization
@@ -755,23 +756,26 @@ RegistrationService(
         val available = capacity - confirmed
         if (available <= 0) return
 
-        val waitlistedRegs =
+        val totalWaitlisted =
+            registrationRepository.countByEventIdAndStatus(eventId, RegistrationStatus.WAITLISTED).toInt()
+
+        val promoted =
             registrationRepository.findByEventIdAndStatusOrderByCreatedAtAsc(
                 eventId,
                 RegistrationStatus.WAITLISTED,
+                Pageable.ofSize(available),
             )
 
         val waitlistNumbers =
-            waitlistedRegs.withIndex().associate { indexed ->
-                indexed.value.registrationPublicId to (indexed.index + 1)
+            promoted.withIndex().associate { (index, reg) ->
+                reg.registrationPublicId to (index + 1)
             }
 
-        val promoted = waitlistedRegs.take(available)
         promoted.forEach { it.status = RegistrationStatus.CONFIRMED }
         registrationRepository.saveAll(promoted)
 
         val confirmedAfter = confirmed + promoted.size
-        val remainingWaitlisted = waitlistedRegs.size - promoted.size
+        val remainingWaitlisted = totalWaitlisted - promoted.size
         val totalCount = confirmedAfter + remainingWaitlisted
 
         val emailDataList =

From 5ed23a64f1f7d1c53c8dbd7cb2682b12335700c7 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:35:23 +0900
Subject: [PATCH 11/27] =?UTF-8?q?:zap:=20registration=20create=20=EC=8B=9C?=
 =?UTF-8?q?=20user=20=ED=85=8C=EC=9D=B4=EB=B8=94=20=EC=A1=B0=ED=9A=8C=20?=
 =?UTF-8?q?=ED=9A=9F=EC=88=98=20=EC=A4=84=EC=9D=B4=EA=B8=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/service/RegistrationService.kt    | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index a3a8fd01..87dfaaba 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -97,6 +97,11 @@ RegistrationService(
                 registrationRepository.findByUserIdAndEventId(userId, eventPk)
             }
 
+        val userIdsToFetch = listOfNotNull(lockedEvent.createdBy, userId).distinct()
+        val fetchedUsersById = userRepository.findAllById(userIdsToFetch).associateBy { it.id!! }
+        val hostEmail = fetchedUsersById[lockedEvent.createdBy]?.email
+        val user = userId?.let { fetchedUsersById[it] }
+
         val saved =
             try {
                 if (existingRegistration != null) {
@@ -113,8 +118,7 @@ RegistrationService(
                         -> throw RegistrationConflictException(RegistrationErrorCode.REGISTRATION_ALREADY_EXISTS)
                     }
                 } else {
-                    val hostEmail = userRepository.findById(lockedEvent.createdBy).orElse(null)?.email
-                    val registrationEmail = userId?.let { userRepository.findById(it).orElse(null)?.email } ?: guestEmail
+                    val registrationEmail = user?.email ?: guestEmail
 
                     if (hostEmail != null && hostEmail == registrationEmail) {
                         throw RegistrationValidationException(RegistrationErrorCode.REGISTRATION_BLOCKED_HOST)

From 0848edd14828d293bf893a1b80ad5908617eec33 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:36:57 +0900
Subject: [PATCH 12/27] =?UTF-8?q?:zap:=20registration=20create=20=EC=8B=9C?=
 =?UTF-8?q?=20waitlist=20count=20=EC=A4=91=EB=B3=B5=20=EC=A1=B0=ED=9A=8C?=
 =?UTF-8?q?=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../service/RegistrationService.kt            | 22 +++++--------------
 1 file changed, 5 insertions(+), 17 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index 87dfaaba..36800e33 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -148,19 +148,11 @@ RegistrationService(
                 throw RegistrationConflictException(RegistrationErrorCode.REGISTRATION_ALREADY_EXISTS)
             }
 
-        val waitlistedNumber: Int? =
-            if (saved.status == RegistrationStatus.WAITLISTED) {
-                registrationRepository
-                    .countByEventIdAndStatus(eventPk, RegistrationStatus.WAITLISTED)
-                    .toInt()
-            } else {
-                null
-            }
-
-        val user =
-            userId?.let { id ->
-                userRepository.findById(id).orElse(null)
-            }
+        val waitlistedCount =
+            registrationRepository
+                .countByEventIdAndStatus(eventPk, RegistrationStatus.WAITLISTED)
+                .toInt()
+        val waitlistedNumber: Int? = if (saved.status == RegistrationStatus.WAITLISTED) waitlistedCount else null
 
         val recipientEmail = user?.email ?: guestEmail
 
@@ -169,10 +161,6 @@ RegistrationService(
                 registrationRepository
                     .countByEventIdAndStatus(eventPk, RegistrationStatus.CONFIRMED)
                     .toInt()
-            val waitlistedCount =
-                registrationRepository
-                    .countByEventIdAndStatus(eventPk, RegistrationStatus.WAITLISTED)
-                    .toInt()
             val totalCount = confirmedCount + waitlistedCount
 
             val emailData =

From 4f822e0f4bb866b1fdaa90ecc2cf943bc7a0fbae Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:37:18 +0900
Subject: [PATCH 13/27] =?UTF-8?q?:zap:=20registration=20delete=20=EC=8B=9C?=
 =?UTF-8?q?=20=EC=A4=91=EB=B3=B5=20lock=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/service/RegistrationService.kt          | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index 36800e33..f5061e42 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -253,8 +253,6 @@ RegistrationService(
             }
         }
 
-        eventLockRepository.lockById(registration.eventId)
-
         if (!isRegistrationEnabled(event)) {
             throw RegistrationValidationException(RegistrationErrorCode.NOT_WITHIN_REGISTRATION_WINDOW)
         }

From 9ff360af56fcf0dcf0a45f4420a4c36e8f172a84 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:38:03 +0900
Subject: [PATCH 14/27] =?UTF-8?q?:zap:=20=EB=8C=80=EA=B8=B0=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EA=B3=84=EC=82=B0=20=EC=8B=9C=20=EB=B6=88=ED=95=84?=
 =?UTF-8?q?=EC=9A=94=ED=95=9C=20=EB=A9=94=EB=AA=A8=EB=A6=AC=20=EB=A1=9C?=
 =?UTF-8?q?=EB=93=9C=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../registration/service/RegistrationService.kt   | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index f5061e42..a7a3dffc 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -576,13 +576,14 @@ RegistrationService(
         val status = registration.status
         val waitlistPosition =
             if (status == RegistrationStatus.WAITLISTED) {
-                val waitlistedRegs =
-                    registrationRepository.findByEventIdAndStatusOrderByCreatedAtAsc(
-                        registration.eventId,
-                        RegistrationStatus.WAITLISTED,
-                    )
-                val idx = waitlistedRegs.indexOfFirst { it.id == registration.id }
-                if (idx >= 0) idx + 1 else 0
+                registrationRepository
+                    .findWaitlistPositionsByRegistrationPublicIds(
+                        eventId = registration.eventId,
+                        status = RegistrationStatus.WAITLISTED,
+                        registrationPublicIds = listOf(registration.registrationPublicId),
+                    ).firstOrNull()
+                    ?.waitlistNumber
+                    ?.toInt() ?: 0
             } else {
                 0
             }

From 936cfb1d80e09886ac22a5e0c35672ffc1cbc188 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Sat, 2 May 2026 20:38:43 +0900
Subject: [PATCH 15/27] =?UTF-8?q?:zap:=20reconcileWaitlist=EC=97=90?=
 =?UTF-8?q?=EC=84=9C=20user=20=EC=A1=B0=ED=9A=8C=20N+1=20=EC=BF=BC?=
 =?UTF-8?q?=EB=A6=AC=20=EB=AC=B8=EC=A0=9C=20=ED=95=B4=EA=B2=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/service/RegistrationService.kt    | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index a7a3dffc..00df08fc 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -769,12 +769,12 @@ RegistrationService(
         val remainingWaitlisted = totalWaitlisted - promoted.size
         val totalCount = confirmedAfter + remainingWaitlisted
 
+        val promotedUserIds = promoted.mapNotNull { it.userId }.distinct()
+        val promotedUsersById = userRepository.findAllById(promotedUserIds).associateBy { it.id!! }
+
         val emailDataList =
             promoted.mapNotNull { registration ->
-                val user: User? =
-                    registration.userId?.let { uid ->
-                        userRepository.findById(uid).orElse(null)
-                    }
+                val user: User? = registration.userId?.let { promotedUsersById[it] }
 
                 val recipientEmail = user?.email ?: registration.guestEmail
                 val recipientName = user?.name ?: registration.guestName ?: "참여자"

From fe12ce10e6c2f3ee220ecfa577ef5b18adb0bb0d Mon Sep 17 00:00:00 2001
From: uykhc <yoon002003@snu.ac.kr>
Date: Sat, 2 May 2026 22:53:53 +0900
Subject: [PATCH 16/27] docs(openapi): fix Redocly lint errors for security
 scheme and operation security

---
 src/main/resources/static/docs/openapi.yaml | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
index 6fa1daac..ee0b86b3 100644
--- a/src/main/resources/static/docs/openapi.yaml
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -20,6 +20,7 @@ tags:
 paths:
   /api/events/{publicId}:
     get:
+      security: []
       tags:
       - Event
       summary: 이벤트 상세 조회
@@ -85,6 +86,8 @@ paths:
           description: 인증 필요
   /api/images:
     post:
+      security:
+      - bearerAuth: []
       tags:
       - Image
       summary: 이미지 업로드
@@ -151,6 +154,8 @@ paths:
           description: 인증 필요
   /api/events/{eventId}/registrations:
     get:
+      security:
+      - bearerAuth: []
       tags:
       - Registration
       summary: 이벤트 신청 목록 조회
@@ -187,6 +192,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/GetEventRegistrationsResponse"
     post:
+      security: []
       tags:
       - Registration
       summary: 이벤트 참여 신청
@@ -237,6 +243,7 @@ paths:
                 $ref: "#/components/schemas/ErrorResponse"
   /api/auth/social:
     post:
+      security: []
       tags:
       - Auth
       summary: 소셜 로그인
@@ -268,6 +275,7 @@ paths:
                 $ref: "#/components/schemas/ErrorResponse"
   /api/auth/signup:
     post:
+      security: []
       tags:
       - Auth
       summary: 이메일 회원가입
@@ -289,6 +297,8 @@ paths:
           description: 이메일 서비스 장애
   /api/auth/logout:
     post:
+      security:
+      - bearerAuth: []
       tags:
       - Auth
       summary: 로그아웃
@@ -298,6 +308,7 @@ paths:
           description: 로그아웃 성공
   /api/auth/login:
     post:
+      security: []
       tags:
       - Auth
       summary: 로그인
@@ -323,6 +334,7 @@ paths:
                 $ref: "#/components/schemas/LoginResponse"
   /api/auth/email-verification/{verificationCode}:
     post:
+      security: []
       tags:
       - Auth
       summary: 이메일 인증
@@ -383,6 +395,7 @@ paths:
           description: 인증 필요
   /api/registrations/{registrationId}:
     get:
+      security: []
       tags:
       - Registration
       summary: 신청 단건 정보 요청
@@ -401,6 +414,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/GetRegistrationResponse"
     delete:
+      security: []
       tags:
       - Registration
       summary: 신청 단건 취소
@@ -425,6 +439,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/DeleteRegistrationResponse"
     patch:
+      security:
+      - bearerAuth: []
       tags:
       - Registration
       summary: 신청 단건 상태 변경
@@ -1249,6 +1265,5 @@ components:
     bearerAuth:
       type: http
       description: JWT 토큰을 입력하세요
-      name: bearerAuth
       scheme: bearer
       bearerFormat: JWT

From b045dfc2cab132ef8e1cb8e4148d730eb6ac5a96 Mon Sep 17 00:00:00 2001
From: uykhc <yoon002003@snu.ac.kr>
Date: Sat, 2 May 2026 23:02:41 +0900
Subject: [PATCH 17/27] refactor(swagger): remove leftover @Schema annotations
 for static OpenAPI docs

---
 .../registration/dto/response/GetMyRegistrationsResponse.kt    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
index ced9b0f2..0aca3e06 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/response/GetMyRegistrationsResponse.kt
@@ -17,11 +17,8 @@ data class MyRegistrationItem(
     val registrationStartsAt: Instant?,
     val registrationEndsAt: Instant?,
     val capacity: Int?,
-    @Schema(description = "확정 참여자 수")
     val confirmedCount: Int,
-    @Schema(description = "대기자 수")
     val waitlistCount: Int,
-    @Schema(description = "신청 상태")
     val status: MyRegistrationStatus,
     val waitlistedNum: Int?,
 ) {

From 5e1d0d9824a8c46db03a85be8160f8d0178d496f Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 17:57:28 +0900
Subject: [PATCH 18/27] =?UTF-8?q?:bug:=20api=20spec=EC=97=90=20=EB=A7=9E?=
 =?UTF-8?q?=EC=A7=80=20=EC=95=8A=EB=8A=94=20registration=20delete=20reques?=
 =?UTF-8?q?t=20dto=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controller/RegistrationController.kt      |  4 ----
 .../dto/request/DeleteRegistrationRequest.kt  | 11 ----------
 .../service/RegistrationService.kt            | 22 -------------------
 .../spring2025/RegistrationIntegrationTest.kt |  6 -----
 4 files changed, 43 deletions(-)
 delete mode 100644 src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
index 2ffccbe6..b3a09f28 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
@@ -1,7 +1,6 @@
 package com.wafflestudio.spring2025.domain.registration.controller
 
 import com.wafflestudio.spring2025.domain.auth.LoggedInUser
-import com.wafflestudio.spring2025.domain.registration.dto.request.DeleteRegistrationRequest
 import com.wafflestudio.spring2025.domain.registration.dto.request.UpdateRegistrationStatusRequest
 import com.wafflestudio.spring2025.domain.registration.dto.response.DeleteRegistrationResponse
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetRegistrationResponse
@@ -62,15 +61,12 @@ class RegistrationController(
     @DeleteMapping
     fun delete(
         @PathVariable registrationId: String,
-        @RequestBody request: DeleteRegistrationRequest,
         @LoggedInUser user: User?,
     ): ResponseEntity<DeleteRegistrationResponse> {
         val response =
             registrationService.delete(
                 registrationPublicId = registrationId,
                 userId = user?.id,
-                guestName = request.guestName,
-                guestEmail = request.guestEmail,
             )
 
         return ResponseEntity.ok(response)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
deleted file mode 100644
index 3f34c5f8..00000000
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
+++ /dev/null
@@ -1,11 +0,0 @@
-package com.wafflestudio.spring2025.domain.registration.dto.request
-
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "이벤트 취소 요청")
-data class DeleteRegistrationRequest(
-    @Schema(description = "비회원 이름")
-    val guestName: String? = null,
-    @Schema(description = "비회원 이메일")
-    val guestEmail: String? = null,
-)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index a87b211a..47660431 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -205,22 +205,9 @@ RegistrationService(
     fun delete(
         registrationPublicId: String,
         userId: Long?,
-        guestName: String?,
-        guestEmail: String?,
     ): DeleteRegistrationResponse {
-        if (userId == null) {
-            if (guestName.isNullOrBlank()) {
-                throw RegistrationValidationException(RegistrationErrorCode.REGISTRATION_WRONG_NAME)
-            }
-            if (guestEmail.isNullOrBlank()) {
-                throw RegistrationValidationException(RegistrationErrorCode.REGISTRATION_WRONG_EMAIL)
-            }
-        }
-
         deleteInternal(
             userId = userId,
-            guestName = guestName,
-            guestEmail = guestEmail,
             registrationPublicId = registrationPublicId,
         )
         return DeleteRegistrationResponse()
@@ -228,8 +215,6 @@ RegistrationService(
 
     private fun deleteInternal(
         userId: Long?,
-        guestName: String?,
-        guestEmail: String?,
         registrationPublicId: String,
     ) {
         // eventId를 얻기 위한 미리보기 조회 (락 없음)
@@ -251,13 +236,6 @@ RegistrationService(
             if (registration.userId != userId) {
                 throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
             }
-        } else {
-            if (registration.userId != null ||
-                registration.guestName != guestName ||
-                registration.guestEmail != guestEmail
-            ) {
-                throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
-            }
         }
 
         eventLockRepository.lockById(registration.eventId)
diff --git a/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt b/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
index 48b9cd3d..f2b1564a 100644
--- a/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
+++ b/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
@@ -6,7 +6,6 @@ import com.wafflestudio.spring2025.common.email.service.EmailService
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.event.repository.EventRepository
 import com.wafflestudio.spring2025.domain.registration.dto.request.CreateRegistrationRequest
-import com.wafflestudio.spring2025.domain.registration.dto.request.DeleteRegistrationRequest
 import com.wafflestudio.spring2025.domain.registration.dto.request.UpdateRegistrationStatusRequest
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
@@ -243,7 +242,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$participantRegistrationId")
                         .header("Authorization", "Bearer $hostToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isForbidden)
                 .andExpect(jsonPath("$.code").value("REGISTRATION_DELETE_UNAUTHORIZED"))
@@ -252,7 +250,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$participantRegistrationId")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isOk)
 
@@ -276,7 +273,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$confirmedRegistrationId")
                         .header("Authorization", "Bearer $confirmedUserToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isOk)
 
@@ -347,7 +343,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/${registration.registrationPublicId}")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isBadRequest)
                 .andExpect(jsonPath("$.code").value("NOT_WITHIN_REGISTRATION_WINDOW"))
@@ -378,7 +373,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/${registration.registrationPublicId}")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isBadRequest)
                 .andExpect(jsonPath("$.code").value("NOT_WITHIN_REGISTRATION_WINDOW"))

From 7cf4198147f90b61476f4391e791bc5f314cffb2 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 20:29:59 +0900
Subject: [PATCH 19/27] =?UTF-8?q?:bug:=20=EC=B0=B8=EC=97=AC=20=EC=B7=A8?=
 =?UTF-8?q?=EC=86=8C=20=EC=8B=9C=20=EA=B6=8C=ED=95=9C=20=EA=B2=80=EC=A6=9D?=
 =?UTF-8?q?=20fix?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/service/RegistrationService.kt          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index 47660431..1eb74ea2 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -232,7 +232,7 @@ RegistrationService(
             registrationRepository.lockByRegistrationPublicId(registrationPublicId)
                 ?: throw RegistrationNotFoundException()
 
-        if (userId != null) {
+        if (registration.userId != null) {
             if (registration.userId != userId) {
                 throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
             }

From 04ca11974c40e52205a6a57f1a2b0d144f158b6e Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 21:20:29 +0900
Subject: [PATCH 20/27] =?UTF-8?q?:memo:=20=EB=B6=88=EC=9D=BC=EC=B9=98=20?=
 =?UTF-8?q?=ED=95=B4=EA=B2=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/auth/controller/SocialAuthController.kt   |  2 +-
 src/main/resources/static/docs/openapi.yaml          | 12 +++++++++---
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
index dbd09f73..14da8c08 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/controller/SocialAuthController.kt
@@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
-@RequestMapping("api/auth/social")
+@RequestMapping("/api/auth/social")
 class SocialAuthController(
     private val socialAuthService: SocialAuthService,
 ) {
diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
index 6fa1daac..bb9bacb4 100644
--- a/src/main/resources/static/docs/openapi.yaml
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -572,6 +572,7 @@ components:
       required:
       - registrationEndsAt
       - title
+      - capacity
       - waitlistEnabled
       type: object
       properties:
@@ -849,7 +850,8 @@ components:
     MyRegistrationItem:
       required:
       - publicId
-      - registrationCnt
+      - confirmedCount
+      - waitlistCount
       - status
       - title
       type: object
@@ -885,9 +887,13 @@ components:
           description: 정원
           format: int32
           nullable: true
-        registrationCnt:
+        confirmedCount:
+          type: integer
+          description: 참여 확정자 수
+          format: int32
+        waitlistCount:
           type: integer
-          description: 현재 신청 수 + 대기 수
+          description: 참여 확정자 수
           format: int32
         status:
           type: string

From e4c5c724bc02fc260c2d87a30de675bb883d3a9c Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 21:24:27 +0900
Subject: [PATCH 21/27] =?UTF-8?q?:memo:=20=EB=B6=88=EC=9D=BC=EC=B9=98=20?=
 =?UTF-8?q?=ED=95=B4=EA=B2=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/resources/static/docs/openapi.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
index 7fcbefff..e83c7598 100644
--- a/src/main/resources/static/docs/openapi.yaml
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -909,7 +909,7 @@ components:
           format: int32
         waitlistCount:
           type: integer
-          description: 참여 확정자 수
+          description: 대기자 수
           format: int32
         status:
           type: string

From 8a06dfba03bc11a6aaaf1a6d14cc2b2fa52bedec Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 21:25:14 +0900
Subject: [PATCH 22/27] =?UTF-8?q?:fire:=20=EC=95=88=20=EC=93=B0=EC=9D=B4?=
 =?UTF-8?q?=EB=8A=94=20RegisterRequest=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../spring2025/domain/auth/dto/RegisterRequest.kt         | 8 --------
 1 file changed, 8 deletions(-)
 delete mode 100644 src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
deleted file mode 100644
index 32ee7ed3..00000000
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/auth/dto/RegisterRequest.kt
+++ /dev/null
@@ -1,8 +0,0 @@
-package com.wafflestudio.spring2025.domain.auth.dto
-
-data class RegisterRequest(
-    val email: String,
-    val name: String,
-    val password: String,
-    val profileImage: String? = null,
-)

From e45ead73669fb081994e7597c416d582741def07 Mon Sep 17 00:00:00 2001
From: uykhc <yoon002003@snu.ac.kr>
Date: Tue, 5 May 2026 20:34:50 +0900
Subject: [PATCH 23/27] =?UTF-8?q?feat:=20prometheus=20=EB=AA=A8=EB=8B=88?=
 =?UTF-8?q?=ED=84=B0=EB=A7=81=20=EC=84=A4=EC=A0=95=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Spring Boot Actuator 및 Micrometer Prometheus registry 의존성 추가
- docker-compose.dev에 prometheus 서비스/볼륨 구성 추가
- management endpoint 노출 범위에 info, metrics, prometheus 추가
---
 build.gradle.kts                    |  5 ++++-
 docker-compose.dev.yml              | 17 +++++++++++++++++
 src/main/resources/application.yaml |  2 +-
 3 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/build.gradle.kts b/build.gradle.kts
index cfebb3cb..5b8d2200 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -44,7 +44,6 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-webflux")
     implementation("org.springframework.boot:spring-boot-starter-data-jdbc")
     implementation("org.springframework.boot:spring-boot-starter-data-redis")
-    implementation("org.springframework.boot:spring-boot-starter-actuator")
     implementation("org.springframework.boot:spring-boot-starter-mail")
     implementation("org.mindrot:jbcrypt:0.4")
     implementation("io.jsonwebtoken:jjwt-api:0.11.5")
@@ -73,6 +72,10 @@ dependencies {
     // OCI Vault - SDK 직접 사용 (waffle-oci-vault 2.1.0은 Spring Boot 3.5와 호환 안됨)
     implementation("com.oracle.oci.sdk:oci-java-sdk-secrets:3.80.1")
     implementation("com.oracle.oci.sdk:oci-java-sdk-common-httpclient-jersey3:3.80.1")
+
+    // prometheus 의존성 추가
+    implementation("org.springframework.boot:spring-boot-starter-actuator")
+    implementation("io.micrometer:micrometer-registry-prometheus")
 }
 
 kotlin {
diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index 99b4dc2e..b723e04d 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -76,6 +76,23 @@ services:
         limits:
           memory: 64M
 
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: prometheus-dev
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:9090:9090"
+    volumes:
+      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - prometheus_data_dev:/prometheus
+    command:
+      - "--config.file=/etc/prometheus/prometheus.yml"
+      - "--storage.tsdb.path=/prometheus"
+    depends_on:
+      app:
+        condition: service_healthy
+
 volumes:
   mysql_data_dev:
   redis_data_dev:
+  prometheus_data_dev:
diff --git a/src/main/resources/application.yaml b/src/main/resources/application.yaml
index 473a1ff9..ee7ef521 100644
--- a/src/main/resources/application.yaml
+++ b/src/main/resources/application.yaml
@@ -68,7 +68,7 @@ management:
   endpoints:
     web:
       exposure:
-        include: health
+        include: health,info,prometheus,metrics
   endpoint:
     health:
       show-details: always

From 810e3976fe42b36d8fd5d058caec1c0465b47f33 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Tue, 5 May 2026 20:56:45 +0900
Subject: [PATCH 24/27] =?UTF-8?q?:bug:=20=EB=8C=80=EA=B8=B0=20=EC=88=9C?=
 =?UTF-8?q?=EB=B2=88=20=EA=B3=84=EC=82=B0=20=EB=B0=A9=EC=8B=9D=20=ED=86=B5?=
 =?UTF-8?q?=EC=9D=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/repository/RegistrationRepository.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
index 3c5afa24..1c91aa06 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/repository/RegistrationRepository.kt
@@ -186,7 +186,7 @@ interface RegistrationRepository :
                ranked.waitlist_number AS waitlist_number
         FROM (
             SELECT r.registration_public_id,
-                   ROW_NUMBER() OVER (ORDER BY r.created_at ASC, r.registration_public_id ASC) AS waitlist_number
+                   ROW_NUMBER() OVER (ORDER BY r.created_at ASC, r.id ASC) AS waitlist_number
             FROM registrations r
             WHERE r.event_id = :eventId AND r.status = :status
         ) ranked

From 22762d1ca9dcd3d4c855254e70b3f5dc976b8003 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 17:57:28 +0900
Subject: [PATCH 25/27] =?UTF-8?q?:bug:=20api=20spec=EC=97=90=20=EB=A7=9E?=
 =?UTF-8?q?=EC=A7=80=20=EC=95=8A=EB=8A=94=20registration=20delete=20reques?=
 =?UTF-8?q?t=20dto=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controller/RegistrationController.kt      |  4 ----
 .../dto/request/DeleteRegistrationRequest.kt  |  6 -----
 .../service/RegistrationService.kt            | 22 -------------------
 .../spring2025/RegistrationIntegrationTest.kt |  6 -----
 4 files changed, 38 deletions(-)
 delete mode 100644 src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
index f2568d12..28381a59 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/controller/RegistrationController.kt
@@ -1,7 +1,6 @@
 package com.wafflestudio.spring2025.domain.registration.controller
 
 import com.wafflestudio.spring2025.domain.auth.LoggedInUser
-import com.wafflestudio.spring2025.domain.registration.dto.request.DeleteRegistrationRequest
 import com.wafflestudio.spring2025.domain.registration.dto.request.UpdateRegistrationStatusRequest
 import com.wafflestudio.spring2025.domain.registration.dto.response.DeleteRegistrationResponse
 import com.wafflestudio.spring2025.domain.registration.dto.response.GetRegistrationResponse
@@ -48,15 +47,12 @@ class RegistrationController(
     @DeleteMapping
     fun delete(
         @PathVariable registrationId: String,
-        @RequestBody request: DeleteRegistrationRequest,
         @LoggedInUser user: User?,
     ): ResponseEntity<DeleteRegistrationResponse> {
         val response =
             registrationService.delete(
                 registrationPublicId = registrationId,
                 userId = user?.id,
-                guestName = request.guestName,
-                guestEmail = request.guestEmail,
             )
 
         return ResponseEntity.ok(response)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
deleted file mode 100644
index 0df46b98..00000000
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/dto/request/DeleteRegistrationRequest.kt
+++ /dev/null
@@ -1,6 +0,0 @@
-package com.wafflestudio.spring2025.domain.registration.dto.request
-
-data class DeleteRegistrationRequest(
-    val guestName: String? = null,
-    val guestEmail: String? = null,
-)
diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index 00df08fc..89d2f788 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -198,22 +198,9 @@ RegistrationService(
     fun delete(
         registrationPublicId: String,
         userId: Long?,
-        guestName: String?,
-        guestEmail: String?,
     ): DeleteRegistrationResponse {
-        if (userId == null) {
-            if (guestName.isNullOrBlank()) {
-                throw RegistrationValidationException(RegistrationErrorCode.REGISTRATION_WRONG_NAME)
-            }
-            if (guestEmail.isNullOrBlank()) {
-                throw RegistrationValidationException(RegistrationErrorCode.REGISTRATION_WRONG_EMAIL)
-            }
-        }
-
         deleteInternal(
             userId = userId,
-            guestName = guestName,
-            guestEmail = guestEmail,
             registrationPublicId = registrationPublicId,
         )
         return DeleteRegistrationResponse()
@@ -221,8 +208,6 @@ RegistrationService(
 
     private fun deleteInternal(
         userId: Long?,
-        guestName: String?,
-        guestEmail: String?,
         registrationPublicId: String,
     ) {
         // eventId를 얻기 위한 미리보기 조회 (락 없음)
@@ -244,13 +229,6 @@ RegistrationService(
             if (registration.userId != userId) {
                 throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
             }
-        } else {
-            if (registration.userId != null ||
-                registration.guestName != guestName ||
-                registration.guestEmail != guestEmail
-            ) {
-                throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
-            }
         }
 
         if (!isRegistrationEnabled(event)) {
diff --git a/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt b/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
index 48b9cd3d..f2b1564a 100644
--- a/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
+++ b/src/test/kotlin/com/wafflestudio/spring2025/RegistrationIntegrationTest.kt
@@ -6,7 +6,6 @@ import com.wafflestudio.spring2025.common.email.service.EmailService
 import com.wafflestudio.spring2025.domain.event.model.Event
 import com.wafflestudio.spring2025.domain.event.repository.EventRepository
 import com.wafflestudio.spring2025.domain.registration.dto.request.CreateRegistrationRequest
-import com.wafflestudio.spring2025.domain.registration.dto.request.DeleteRegistrationRequest
 import com.wafflestudio.spring2025.domain.registration.dto.request.UpdateRegistrationStatusRequest
 import com.wafflestudio.spring2025.domain.registration.model.Registration
 import com.wafflestudio.spring2025.domain.registration.model.RegistrationStatus
@@ -243,7 +242,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$participantRegistrationId")
                         .header("Authorization", "Bearer $hostToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isForbidden)
                 .andExpect(jsonPath("$.code").value("REGISTRATION_DELETE_UNAUTHORIZED"))
@@ -252,7 +250,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$participantRegistrationId")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isOk)
 
@@ -276,7 +273,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/$confirmedRegistrationId")
                         .header("Authorization", "Bearer $confirmedUserToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isOk)
 
@@ -347,7 +343,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/${registration.registrationPublicId}")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isBadRequest)
                 .andExpect(jsonPath("$.code").value("NOT_WITHIN_REGISTRATION_WINDOW"))
@@ -378,7 +373,6 @@ class RegistrationIntegrationTest
                 .perform(
                     delete("/api/registrations/${registration.registrationPublicId}")
                         .header("Authorization", "Bearer $participantToken")
-                        .content(mapper.writeValueAsString(DeleteRegistrationRequest()))
                         .contentType(MediaType.APPLICATION_JSON),
                 ).andExpect(status().isBadRequest)
                 .andExpect(jsonPath("$.code").value("NOT_WITHIN_REGISTRATION_WINDOW"))

From 942b79e64e4dd0e76657c3f1911732672f7c6395 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Mon, 4 May 2026 20:29:59 +0900
Subject: [PATCH 26/27] =?UTF-8?q?:bug:=20=EC=B0=B8=EC=97=AC=20=EC=B7=A8?=
 =?UTF-8?q?=EC=86=8C=20=EC=8B=9C=20=EA=B6=8C=ED=95=9C=20=EA=B2=80=EC=A6=9D?=
 =?UTF-8?q?=20fix?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/registration/service/RegistrationService.kt          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
index 89d2f788..46ea8c70 100644
--- a/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
+++ b/src/main/kotlin/com/wafflestudio/spring2025/domain/registration/service/RegistrationService.kt
@@ -225,7 +225,7 @@ RegistrationService(
             registrationRepository.lockByRegistrationPublicId(registrationPublicId)
                 ?: throw RegistrationNotFoundException()
 
-        if (userId != null) {
+        if (registration.userId != null) {
             if (registration.userId != userId) {
                 throw RegistrationForbiddenException(RegistrationErrorCode.REGISTRATION_DELETE_UNAUTHORIZED)
             }

From 458048cc31eb0c670d68226a35de22c135addcc1 Mon Sep 17 00:00:00 2001
From: Jisu Hong <jaylovegood@snu.ac.kr>
Date: Tue, 5 May 2026 22:23:34 +0900
Subject: [PATCH 27/27] =?UTF-8?q?:memo:=20swagger=EC=97=90=EC=84=9C=20Dele?=
 =?UTF-8?q?teRegistrationRequest=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/resources/static/docs/openapi.yaml | 18 ------------------
 1 file changed, 18 deletions(-)

diff --git a/src/main/resources/static/docs/openapi.yaml b/src/main/resources/static/docs/openapi.yaml
index e83c7598..9f62c069 100644
--- a/src/main/resources/static/docs/openapi.yaml
+++ b/src/main/resources/static/docs/openapi.yaml
@@ -425,12 +425,6 @@ paths:
         required: true
         schema:
           type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/DeleteRegistrationRequest"
-        required: true
       responses:
         "200":
           description: OK
@@ -1236,18 +1230,6 @@ components:
           nullable: true
         hasNext:
           type: boolean
-    DeleteRegistrationRequest:
-      type: object
-      properties:
-        guestName:
-          type: string
-          description: 비회원 이름
-          nullable: true
-        guestEmail:
-          type: string
-          description: 비회원 이메일
-          nullable: true
-      description: 이벤트 취소 요청
     DeleteRegistrationResponse:
       type: object
     ErrorResponse: