From 423931eb1d6b5b549ca6bbfc460ef005bd1c5e3f 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 17:42:46 +0800
Subject: [PATCH] =?UTF-8?q?task-138(=E8=AE=B0=E5=BD=95=E4=B8=8E=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E4=B8=AD=E5=BF=83):=20=E5=AE=9E=E7=8E=B0=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E9=A1=B5=E9=9D=A2=E6=9D=83=E9=99=90=E8=B7=AF=E7=94=B1?=
 =?UTF-8?q?=E6=8E=A5=E5=85=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 records-route.ts：按菜单 key 过滤可见的记录/版本页。

TDD: task-138.test.ts 8 用例 RED→GREEN。
---
 .../src/pages/records/records-route.ts        | 10 ++++
 admin-frontend-vue/tests/task-138.test.ts     | 49 +++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 admin-frontend-vue/src/pages/records/records-route.ts
 create mode 100644 admin-frontend-vue/tests/task-138.test.ts

diff --git a/admin-frontend-vue/src/pages/records/records-route.ts b/admin-frontend-vue/src/pages/records/records-route.ts
new file mode 100644
index 00000000..166fec96
--- /dev/null
+++ b/admin-frontend-vue/src/pages/records/records-route.ts
@@ -0,0 +1,10 @@
+/** 记录与版本中心页可见性（任务 138）：依据菜单 key 决定历史/版本/数字人版本页是否展示；纯逻辑。 */
+
+export const RECORDS_PAGE_KEYS = ['history', 'version', 'digital-human-version'] as const
+export type RecordsPageKey = (typeof RECORDS_PAGE_KEYS)[number]
+
+/** 由菜单 key 集合过滤出可见的记录页(按固定顺序)。 */
+export function visibleRecordsPages(menuKeys: readonly string[] | null | undefined): RecordsPageKey[] {
+  if (!Array.isArray(menuKeys)) return []
+  return RECORDS_PAGE_KEYS.filter((key) => menuKeys.includes(key))
+}
diff --git a/admin-frontend-vue/tests/task-138.test.ts b/admin-frontend-vue/tests/task-138.test.ts
new file mode 100644
index 00000000..c91bf8c2
--- /dev/null
+++ b/admin-frontend-vue/tests/task-138.test.ts
@@ -0,0 +1,49 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import { visibleRecordsPages } from '../src/pages/records/records-route.ts'
+
+test('test_task_138_records_route_normal_primary_path', () => {
+  // 正常主路径：全部菜单允许时三页可见。
+  const pages = visibleRecordsPages(['history', 'version', 'digital-human-version'])
+  assert.deepEqual(pages, ['history', 'version', 'digital-human-version'])
+})
+
+test('test_task_138_records_route_normal_variant_input', () => {
+  // 正常变体：仅历史菜单允许时只显历史。
+  assert.deepEqual(visibleRecordsPages(['history']), ['history'])
+})
+
+test('test_task_138_records_route_repeated_is_idempotent', () => {
+  // 正常重复：结果稳定、不改输入。
+  const keys = ['history']
+  assert.deepEqual(visibleRecordsPages(keys), visibleRecordsPages(keys))
+  assert.deepEqual(keys, ['history'])
+})
+
+test('test_task_138_records_route_boundary_empty_input', () => {
+  // 边界空值：无菜单不显示任何页面。
+  assert.deepEqual(visibleRecordsPages([]), [])
+})
+
+test('test_task_138_records_route_boundary_single_item', () => {
+  // 边界单元素：仅软件版本。
+  assert.deepEqual(visibleRecordsPages(['version']), ['version'])
+})
+
+test('test_task_138_records_route_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：未知菜单键忽略。
+  assert.deepEqual(visibleRecordsPages(['unknown', 'version']), ['version'])
+})
+
+test('test_task_138_records_route_invalid_input_rejected', () => {
+  // 异常输入：非数组按空处理。
+  assert.deepEqual(visibleRecordsPages(null as unknown as string[]), [])
+})
+
+test('test_task_138_records_route_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/可操作：路由纯逻辑、无框架/http。
+  const mod = readSource('src/pages/records/records-route.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '路由保持纯逻辑')
+  assert.match(mod, /digital-human-version/)
+})