From 085f3523209018e70b2975ab54c38dae552ca71b 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 16:51:51 +0800
Subject: [PATCH] =?UTF-8?q?task-97(=E5=BA=97=E9=93=BA=E4=B8=AD=E5=BF=83):?=
 =?UTF-8?q?=20=E5=AE=9E=E7=8E=B0=E5=BA=97=E9=93=BA=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E7=A9=BA=E7=8A=B6=E6=80=81=E5=92=8C=E9=94=99=E8=AF=AF=E7=8A=B6?=
 =?UTF-8?q?=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 shop-list-feedback.ts：店铺/密钥列表空态文案(含筛选无结果)与请求错误
归一为可展示文案。

TDD: task-97.test.ts 8 用例先 RED 后 GREEN。
---
 .../src/pages/shop/shop-list-feedback.ts      | 19 +++++++
 admin-frontend-vue/tests/task-97.test.ts      | 56 +++++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 admin-frontend-vue/src/pages/shop/shop-list-feedback.ts
 create mode 100644 admin-frontend-vue/tests/task-97.test.ts

diff --git a/admin-frontend-vue/src/pages/shop/shop-list-feedback.ts b/admin-frontend-vue/src/pages/shop/shop-list-feedback.ts
new file mode 100644
index 00000000..9d310f8d
--- /dev/null
+++ b/admin-frontend-vue/src/pages/shop/shop-list-feedback.ts
@@ -0,0 +1,19 @@
+/** 店铺列表空状态与错误反馈（任务 97）：空态文案与请求错误归一，纯逻辑。 */
+import { requestErrorMessage } from '../../api/envelope.ts'
+
+/** 店铺列表空态文案；有数据返回空串(不显示)。 */
+export function manageEmptyText(input: { hasFilter: boolean; total: number }): string {
+  if (typeof input.total === 'number' && input.total > 0) return ''
+  return input.hasFilter ? '暂无符合条件的店铺，请调整筛选条件' : '暂无店铺'
+}
+
+/** 店铺密钥列表空态文案(密钥页为本地关键词过滤)。 */
+export function keysEmptyText(input: { hasFilter: boolean }): string {
+  return input.hasFilter ? '没有匹配的店铺密钥，请调整关键词' : '暂无店铺密钥'
+}
+
+/** 请求失败/接口错误归一为可展示文案，空则回兜底。 */
+export function requestErrorFeedback(error: unknown): string {
+  const message = requestErrorMessage(error)
+  return message.trim() || '请求失败，请稍后重试'
+}
diff --git a/admin-frontend-vue/tests/task-97.test.ts b/admin-frontend-vue/tests/task-97.test.ts
new file mode 100644
index 00000000..8235ff4a
--- /dev/null
+++ b/admin-frontend-vue/tests/task-97.test.ts
@@ -0,0 +1,56 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import {
+  keysEmptyText,
+  manageEmptyText,
+  requestErrorFeedback,
+} from '../src/pages/shop/shop-list-feedback.ts'
+
+test('test_task_097_shop_list_feedback_normal_primary_path', () => {
+  // 正常主路径：无数据且未筛选时给出默认空态文案。
+  assert.equal(manageEmptyText({ hasFilter: false, total: 0 }), '暂无店铺')
+  assert.equal(keysEmptyText({ hasFilter: false }), '暂无店铺密钥')
+})
+
+test('test_task_097_shop_list_feedback_normal_variant_input', () => {
+  // 正常变体：启用筛选仍无结果时提示放宽条件。
+  assert.equal(manageEmptyText({ hasFilter: true, total: 0 }), '暂无符合条件的店铺，请调整筛选条件')
+  assert.equal(keysEmptyText({ hasFilter: true }), '没有匹配的店铺密钥，请调整关键词')
+})
+
+test('test_task_097_shop_list_feedback_repeated_is_idempotent', () => {
+  // 正常重复：同一输入文案稳定。
+  assert.equal(manageEmptyText({ hasFilter: false, total: 0 }), manageEmptyText({ hasFilter: false, total: 0 }))
+  assert.equal(keysEmptyText({ hasFilter: true }), keysEmptyText({ hasFilter: true }))
+})
+
+test('test_task_097_shop_list_feedback_boundary_empty_input', () => {
+  // 边界空值：非空数据不产出空态文案。
+  assert.equal(manageEmptyText({ hasFilter: false, total: 1 }), '')
+  assert.equal(keysEmptyText({ hasFilter: false }), '暂无店铺密钥')
+})
+
+test('test_task_097_shop_list_feedback_boundary_single_item', () => {
+  // 边界单元素：错误反馈取后端 message。
+  assert.equal(requestErrorFeedback({ message: '无权访问店铺数据' }), '无权访问店铺数据')
+})
+
+test('test_task_097_shop_list_feedback_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：无 message 的错误对象回兜底可操作文案。
+  const fallback = requestErrorFeedback(new Error(''))
+  assert.ok(fallback.length > 0)
+  assert.equal(requestErrorFeedback(undefined), fallback)
+})
+
+test('test_task_097_shop_list_feedback_invalid_input_rejected', () => {
+  // 异常输入：Error 对象与纯对象统一归一为字符串。
+  assert.match(requestErrorFeedback(new Error('网络异常，请稍后重试')), /网络异常/)
+})
+
+test('test_task_097_shop_list_feedback_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/可操作：反馈纯逻辑，无框架/http。
+  const mod = readSource('src/pages/shop/shop-list-feedback.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '反馈模块保持纯逻辑')
+  assert.match(mod, /requestErrorMessage/)
+})