From 9fdcecace84da5aeeb7f9c8bdfc924f52222f08b Mon Sep 17 00:00:00 2001
From: ttipo <kysung114y@gmail.com>
Date: Sat, 20 Jun 2026 21:22:23 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20=EC=9D=B4=EB=A9=94=EC=9D=BC=20=EC=9D=B8?=
 =?UTF-8?q?=EC=A6=9D=20=EB=A7=81=ED=81=AC=EB=A5=BC=20=EA=B2=B0=EA=B3=BC=20?=
 =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80(=EC=B0=BD=20=EB=8B=AB=EA=B8=B0)?=
 =?UTF-8?q?=EB=A1=9C=20=EB=B6=84=EB=A6=AC=20+=20=EA=B0=80=EC=9E=85=20?=
 =?UTF-8?q?=EB=8C=80=EA=B8=B0=20=ED=99=94=EB=A9=B4=EC=97=90=20=EB=A1=9C?=
 =?UTF-8?q?=EA=B7=B8=EC=9D=B8=20=EB=B2=84=ED=8A=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 인증 링크(verify-email)의 리다이렉트 대상을 /login?verified → /email-verified?ok=1|0 으로 변경
- 신규 EmailVerifiedPage(/email-verified): 인증 완료/실패 표시 후 창 자동 닫기 시도.
  브라우저가 사용자가 연 탭의 close 를 막을 수 있어 안내 문구 + 수동 로그인/가입 링크 병행
- SignupPage 인증 대기 화면에 '인증을 완료했어요 · 로그인하러 가기' 기본 버튼 추가
  (다른 탭에서 인증을 마친 뒤 기존 화면에서 로그인 진입)

런타임 검증: 유효 토큰→/email-verified?ok=1·무효→ok=0, 인증 후 로그인 200, SPA 라우트 제공.
백엔드 build/lint 0, 프론트 type-check/lint/build 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 backend/src/modules/auth/auth.controller.ts   |   7 +-
 .../src/pages/relay/EmailVerifiedPage.vue     | 210 ++++++++++++++++++
 frontend/src/pages/relay/SignupPage.vue       |  25 +++
 frontend/src/router/index.ts                  |   7 +
 4 files changed, 246 insertions(+), 3 deletions(-)
 create mode 100644 frontend/src/pages/relay/EmailVerifiedPage.vue

diff --git a/backend/src/modules/auth/auth.controller.ts b/backend/src/modules/auth/auth.controller.ts
index 8cfbb5e..b482b89 100644
--- a/backend/src/modules/auth/auth.controller.ts
+++ b/backend/src/modules/auth/auth.controller.ts
@@ -139,7 +139,8 @@ export class AuthController {
     return null;
   }
 
-  // 이메일 인증 링크 — 메일의 버튼에서 직접 GET 진입. 검증 후 프론트로 리다이렉트.
+  // 이메일 인증 링크 — 메일의 버튼에서 직접 GET 진입(보통 새 탭).
+  // 검증 후 결과 페이지로 리다이렉트하며, 그 페이지는 완료를 표시하고 창을 닫는다.
   @Get('verify-email')
   @SkipTransform()
   @ApiOperation({ summary: '이메일 인증 (메일 링크)' })
@@ -149,9 +150,9 @@ export class AuthController {
   ): Promise<void> {
     try {
       await this.authService.verifyEmail(token);
-      res.redirect(`${this.webUrl()}/login?verified=1`);
+      res.redirect(`${this.webUrl()}/email-verified?ok=1`);
     } catch {
-      res.redirect(`${this.webUrl()}/login?verified=0`);
+      res.redirect(`${this.webUrl()}/email-verified?ok=0`);
     }
   }
 
diff --git a/frontend/src/pages/relay/EmailVerifiedPage.vue b/frontend/src/pages/relay/EmailVerifiedPage.vue
new file mode 100644
index 0000000..958deac
--- /dev/null
+++ b/frontend/src/pages/relay/EmailVerifiedPage.vue
@@ -0,0 +1,210 @@
+<script setup lang="ts">
+// 이메일 인증 결과 — 메일 링크(새 탭)로 진입. 인증 결과를 표시하고 창을 닫는다.
+// 브라우저가 스크립트의 창 닫기를 차단할 수 있으므로(사용자가 직접 연 탭),
+// 안내 문구를 함께 보여 사용자가 직접 닫고 기존 화면에서 로그인하도록 한다.
+import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { useRoute, RouterLink } from 'vue-router'
+
+const route = useRoute()
+const ok = computed(() => route.query.ok === '1')
+
+// 자동 닫기를 시도했는지(차단 시 안내 문구 노출)
+const triedClose = ref(false)
+let closeTimer: ReturnType<typeof setTimeout> | null = null
+
+onMounted(() => {
+  if (!ok.value) return
+  // 완료 표시 후 잠시 뒤 창 닫기 시도(직접 연 탭은 브라우저가 막을 수 있음)
+  closeTimer = setTimeout(() => {
+    triedClose.value = true
+    window.close()
+  }, 1500)
+})
+
+onBeforeUnmount(() => {
+  if (closeTimer) clearTimeout(closeTimer)
+})
+</script>
+
+<template>
+  <div class="verified-wrap">
+    <div class="card">
+      <div class="brand">
+        <span class="logo">R</span> Relay
+      </div>
+
+      <!-- 인증 성공 -->
+      <template v-if="ok">
+        <div class="ico ok">
+          <svg
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2.4"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          >
+            <path d="M20 6 9 17l-5-5" />
+          </svg>
+        </div>
+        <h1>이메일 인증 완료</h1>
+        <p class="lede">
+          회원가입이 완료되었습니다.<br>이 창을 닫고 기존 화면에서 로그인해 주세요.
+        </p>
+        <p
+          v-if="triedClose"
+          class="hint"
+        >
+          창이 자동으로 닫히지 않으면 직접 닫으셔도 됩니다.
+        </p>
+        <RouterLink
+          class="btn ghost"
+          to="/login"
+        >
+          이 창에서 로그인하기
+        </RouterLink>
+      </template>
+
+      <!-- 인증 실패/만료 -->
+      <template v-else>
+        <div class="ico bad">
+          <svg
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="2.4"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          >
+            <circle
+              cx="12"
+              cy="12"
+              r="10"
+            />
+            <path d="M15 9l-6 6M9 9l6 6" />
+          </svg>
+        </div>
+        <h1>인증에 실패했습니다</h1>
+        <p class="lede">
+          인증 링크가 만료되었거나 유효하지 않습니다.<br>회원가입 화면에서 인증 메일을 다시 받아 주세요.
+        </p>
+        <RouterLink
+          class="btn primary"
+          to="/signup"
+        >
+          회원가입으로 가기
+        </RouterLink>
+      </template>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.verified-wrap {
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+  background: var(--bg, #f4f5f7);
+  padding: 1.5rem;
+}
+.card {
+  width: 100%;
+  max-width: 25rem;
+  background: #fff;
+  border: 1px solid var(--border);
+  border-radius: 0.875rem;
+  box-shadow: var(--shadow-sm);
+  padding: 2.25rem 1.875rem;
+  text-align: center;
+}
+.brand {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  font-size: 1.0625rem;
+  font-weight: 700;
+  color: var(--text);
+  margin-bottom: 1.75rem;
+}
+.brand .logo {
+  width: 1.75rem;
+  height: 1.75rem;
+  border-radius: 0.5rem;
+  background: var(--accent);
+  color: #fff;
+  display: grid;
+  place-items: center;
+  font-size: 0.9375rem;
+  font-weight: 800;
+}
+.ico {
+  width: 3.75rem;
+  height: 3.75rem;
+  border-radius: 50%;
+  display: grid;
+  place-items: center;
+  margin: 0 auto 1.25rem;
+}
+.ico svg {
+  width: 1.75rem;
+  height: 1.75rem;
+}
+.ico.ok {
+  background: var(--green-weak);
+  color: #1b7a3d;
+  border: 1px solid var(--green-border);
+}
+.ico.bad {
+  background: var(--red-weak);
+  color: var(--red);
+  border: 1px solid var(--red-border);
+}
+h1 {
+  font-size: 1.375rem;
+  font-weight: 700;
+  letter-spacing: -0.025rem;
+}
+.lede {
+  font-size: 0.875rem;
+  color: var(--text-2);
+  line-height: 1.7;
+  margin-top: 0.625rem;
+}
+.hint {
+  font-size: 0.781rem;
+  color: var(--text-3);
+  margin-top: 0.75rem;
+}
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 2.625rem;
+  padding: 0 1.25rem;
+  margin-top: 1.5rem;
+  border-radius: var(--radius);
+  font-size: 0.9375rem;
+  font-weight: 700;
+  font-family: inherit;
+  text-decoration: none;
+  cursor: pointer;
+}
+.btn.primary {
+  border: none;
+  background: var(--accent);
+  color: #fff;
+}
+.btn.primary:hover {
+  background: var(--accent-hover);
+}
+.btn.ghost {
+  border: 1px solid var(--border-strong);
+  background: #fff;
+  color: var(--text-2);
+}
+.btn.ghost:hover {
+  background: #f7f8fa;
+  color: var(--text);
+}
+</style>
diff --git a/frontend/src/pages/relay/SignupPage.vue b/frontend/src/pages/relay/SignupPage.vue
index fd728e8..32cf44f 100644
--- a/frontend/src/pages/relay/SignupPage.vue
+++ b/frontend/src/pages/relay/SignupPage.vue
@@ -419,6 +419,12 @@ const points = [
             인증 메일을 다시 보냈습니다.
           </div>
           <div class="vactions">
+            <RouterLink
+              class="btn-login"
+              to="/login"
+            >
+              인증을 완료했어요 · 로그인하러 가기
+            </RouterLink>
             <button
               class="btn-ghost"
               type="button"
@@ -847,6 +853,25 @@ const points = [
   flex-direction: column;
   gap: 0.625rem;
 }
+.btn-login {
+  height: 2.75rem;
+  border-radius: var(--radius);
+  border: none;
+  background: var(--accent);
+  color: #fff;
+  font-family: inherit;
+  font-size: 0.9375rem;
+  font-weight: 700;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  text-decoration: none;
+  box-shadow: 0 1px 2px rgba(79, 70, 229, 0.4);
+}
+.btn-login:hover {
+  background: var(--accent-hover);
+}
 .btn-ghost {
   height: 2.75rem;
   border-radius: var(--radius);
diff --git a/frontend/src/router/index.ts b/frontend/src/router/index.ts
index cdaf23c..bd55777 100644
--- a/frontend/src/router/index.ts
+++ b/frontend/src/router/index.ts
@@ -31,6 +31,13 @@ const routes: RouteRecordRaw[] = [
     component: () => import('@/pages/relay/ResetPasswordPage.vue'),
     meta: { requiresAuth: false },
   },
+  {
+    // 이메일 인증 결과(메일 링크의 도착지) — 완료 표시 후 창 닫기
+    path: '/email-verified',
+    name: 'email-verified',
+    component: () => import('@/pages/relay/EmailVerifiedPage.vue'),
+    meta: { requiresAuth: false },
+  },
   {
     path: '/projects',
     name: 'project-list',