From d397c88c3ca4acf29479f1353bd5ba6fb0b401d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sat, 5 Sep 2026 12:28:27 +0800
Subject: [PATCH] =?UTF-8?q?task-16(=E5=A3=B3=E5=B1=82/=E8=B7=AF=E7=94=B1):?=
 =?UTF-8?q?=20=E5=AE=9E=E7=8E=B0=E9=80=80=E5=87=BA=E7=99=BB=E5=BD=95?=
 =?UTF-8?q?=E5=85=A5=E5=8F=A3=E7=9A=84=E5=A3=B3=E5=B1=82=E4=BA=A4=E4=BA=92?=
 =?UTF-8?q?(=E7=A1=AE=E8=AE=A4=E5=BC=8F)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

logout.ts 定义 runLogout 纯流程(确认通过才 signOut，异常上抛由壳层反馈)；
AdminLayout 用 ElMessageBox.confirm 确认后再执行 store.signOut($reset + /login)。
---
 admin-frontend-vue/src/layout/AdminLayout.vue | 22 ++++-
 admin-frontend-vue/src/layout/logout.ts       | 20 +++++
 admin-frontend-vue/tests/task-16.test.ts      | 80 +++++++++++++++++++
 admin-frontend-vue/tests/task-3.test.ts       |  2 +-
 4 files changed, 121 insertions(+), 3 deletions(-)
 create mode 100644 admin-frontend-vue/src/layout/logout.ts
 create mode 100644 admin-frontend-vue/tests/task-16.test.ts

diff --git a/admin-frontend-vue/src/layout/AdminLayout.vue b/admin-frontend-vue/src/layout/AdminLayout.vue
index f7cbac1b..362f87e1 100644
--- a/admin-frontend-vue/src/layout/AdminLayout.vue
+++ b/admin-frontend-vue/src/layout/AdminLayout.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { computed, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { ElMessage } from 'element-plus'
+import { ElMessage, ElMessageBox } from 'element-plus'
 import { useAdminSessionStore } from '@/stores/admin-session'
 import { joinAdminPath } from '@/config/app'
 import { pageTitleOf, topbarUserOf } from '@/layout/topbar-model'
@@ -14,6 +14,13 @@ import {
 import GlobalErrorContainer from '@/layout/GlobalErrorContainer.vue'
 import { initialCollapsed, toggleCollapsed, writeCollapsePreference } from '@/layout/sidebar-collapse'
 import { crumbsForActiveRoute, resolveDocumentTitle, updateDocumentTitle } from '@/layout/title-breadcrumb'
+import {
+  LOGOUT_CONFIRM_CANCEL,
+  LOGOUT_CONFIRM_MESSAGE,
+  LOGOUT_CONFIRM_OK,
+  LOGOUT_CONFIRM_TITLE,
+  runLogout,
+} from '@/layout/logout'
 
 const route = useRoute()
 const router = useRouter()
@@ -52,7 +59,18 @@ watch(
 
 async function signOut() {
   try {
-    await session.signOut()
+    await runLogout({
+      confirm: () =>
+        ElMessageBox.confirm(LOGOUT_CONFIRM_MESSAGE, LOGOUT_CONFIRM_TITLE, {
+          confirmButtonText: LOGOUT_CONFIRM_OK,
+          cancelButtonText: LOGOUT_CONFIRM_CANCEL,
+          type: 'warning',
+        }).then(
+          () => true,
+          () => false,
+        ),
+      signOut: () => session.signOut(),
+    })
   } catch (error) {
     ElMessage.error(error instanceof Error ? error.message : '退出登录失败')
   }
diff --git a/admin-frontend-vue/src/layout/logout.ts b/admin-frontend-vue/src/layout/logout.ts
new file mode 100644
index 00000000..cde41cc3
--- /dev/null
+++ b/admin-frontend-vue/src/layout/logout.ts
@@ -0,0 +1,20 @@
+/** 壳层退出登录交互（任务 16）：确认后执行，取消/拒绝一律不退出。 */
+
+export const LOGOUT_CONFIRM_TITLE = '退出登录'
+export const LOGOUT_CONFIRM_MESSAGE = '确定要退出当前账号吗？'
+export const LOGOUT_CONFIRM_OK = '退出'
+export const LOGOUT_CONFIRM_CANCEL = '取消'
+
+export interface LogoutDeps {
+  /** 用户确认对话框，resolve true 表示确认退出。 */
+  confirm: () => Promise<boolean>
+  /** 真正执行退出（清状态 + 跳登录页）。 */
+  signOut: () => Promise<void>
+}
+
+/** 退出流程：先确认；确认后执行退出；signOut/confirm 异常向上抛由调用方反馈。 */
+export async function runLogout({ confirm, signOut }: LogoutDeps): Promise<void> {
+  const proceed = await confirm()
+  if (!proceed) return
+  await signOut()
+}
diff --git a/admin-frontend-vue/tests/task-16.test.ts b/admin-frontend-vue/tests/task-16.test.ts
new file mode 100644
index 00000000..ae2548d0
--- /dev/null
+++ b/admin-frontend-vue/tests/task-16.test.ts
@@ -0,0 +1,80 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import {
+  LOGOUT_CONFIRM_CANCEL,
+  LOGOUT_CONFIRM_MESSAGE,
+  LOGOUT_CONFIRM_OK,
+  LOGOUT_CONFIRM_TITLE,
+  runLogout,
+} from '../src/layout/logout.ts'
+
+test('test_task_016_shell_logout_interaction_normal_primary_path', async () => {
+  // 正常主路径：确认后执行退出。
+  let signedOut = 0
+  await runLogout({ confirm: async () => true, signOut: async () => { signedOut += 1 } })
+  assert.equal(signedOut, 1)
+})
+
+test('test_task_016_shell_logout_interaction_normal_variant_input', async () => {
+  // 正常变体：取消确认则不退出。
+  let signedOut = 0
+  await runLogout({ confirm: async () => false, signOut: async () => { signedOut += 1 } })
+  assert.equal(signedOut, 0)
+})
+
+test('test_task_016_shell_logout_interaction_normal_repeated_operation_is_idempotent', async () => {
+  // 正常重复：多次确认分别各执行一次，互不污染状态。
+  let signedOut = 0
+  const deps = { confirm: async () => true, signOut: async () => { signedOut += 1 } }
+  await runLogout(deps)
+  await runLogout(deps)
+  assert.equal(signedOut, 2)
+})
+
+test('test_task_016_shell_logout_interaction_boundary_empty_input', async () => {
+  // 边界空值：确认被拒后即便 signOut 有副作用也不会被调用。
+  let signedOut = 0
+  await runLogout({ confirm: async () => false, signOut: async () => { signedOut += 1 } })
+  assert.equal(signedOut, 0)
+})
+
+test('test_task_016_shell_logout_interaction_boundary_single_item', async () => {
+  // 边界单元素：signOut 异常向上抛出，供调用方反馈（不静默）。
+  await assert.rejects(
+    runLogout({ confirm: async () => true, signOut: async () => { throw new Error('退出接口失败') } }),
+    /退出接口失败/,
+  )
+})
+
+test('test_task_016_shell_logout_interaction_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：确认文案齐全、按钮语义完整。
+  assert.ok(LOGOUT_CONFIRM_MESSAGE.length > 0)
+  assert.ok(LOGOUT_CONFIRM_TITLE.length > 0)
+  assert.ok(LOGOUT_CONFIRM_OK.length > 0)
+  assert.ok(LOGOUT_CONFIRM_CANCEL.length > 0)
+})
+
+test('test_task_016_shell_logout_interaction_invalid_input_rejected', async () => {
+  // 异常输入：确认对话框异常（fail-closed），不得退出。
+  let signedOut = 0
+  await assert.rejects(
+    runLogout({
+      confirm: async () => { throw new Error('弹窗异常') },
+      signOut: async () => { signedOut += 1 },
+    }),
+    /弹窗异常/,
+  )
+  assert.equal(signedOut, 0)
+})
+
+test('test_task_016_shell_logout_interaction_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败：壳层使用 ElMessageBox 确认 + runLogout；store 退出清态并跳登录。
+  const layout = readSource('src/layout/AdminLayout.vue')
+  assert.match(layout, /ElMessageBox\.confirm/)
+  assert.match(layout, /runLogout/)
+  const store = readSource('src/stores/admin-session.ts')
+  assert.match(store, /\$reset\(\)/)
+  assert.match(store, /location\.assign\('\/login'\)/)
+  assert.match(layout, /LOGOUT_CONFIRM_MESSAGE/)
+})
diff --git a/admin-frontend-vue/tests/task-3.test.ts b/admin-frontend-vue/tests/task-3.test.ts
index 557df951..54930256 100644
--- a/admin-frontend-vue/tests/task-3.test.ts
+++ b/admin-frontend-vue/tests/task-3.test.ts
@@ -47,7 +47,7 @@ test('test_task_003_layout_contract_boundary_single_item', () => {
 test('test_task_003_layout_contract_boundary_limit_or_missing_field', () => {
   // 边界上限：Element Plus 交互能力按需命名导入，不整包拖入壳层。
   const layout = readSource(LAYOUT)
-  assert.match(layout, /import\s*\{\s*ElMessage\s*\}\s*from\s*['"]element-plus['"]/)
+  assert.match(layout, /import\s*\{\s*ElMessage(?:,\s*\w+)*\s*\}\s*from\s*['"]element-plus['"]/)
   assert.equal(occurrences(layout, 'import ElementPlus'), 0, '壳层不得整包导入 ElementPlus')
 })