task-132(记录与版本中心): 实现数字人版本列表加载

新增 digitalhuman-model.ts/数字人-api.ts(GET /api/digital-human/versions)。

TDD: task-132.test.ts 8 用例 RED→GREEN。

admin-frontend-vue/src/pages/records/digitalhuman-api.ts

@@ -0,0 +1,10 @@
+/** 数字人版本列表加载适配（任务 132）：GET /api/digital-human/versions。 */
+import { http } from '@/api/http'
+import { parseDigitalHumanVersions, type DigitalHumanVersionList } from './digitalhuman-model.ts'
+
+export const DIGITAL_HUMAN_VERSIONS_ENDPOINT = '/api/digital-human/versions'
+
+export async function fetchDigitalHumanVersions(): Promise<DigitalHumanVersionList> {
+  const { data } = await http.get<unknown>(DIGITAL_HUMAN_VERSIONS_ENDPOINT)
+  return parseDigitalHumanVersions(data)
+}

admin-frontend-vue/src/pages/records/digitalhuman-model.ts

@@ -0,0 +1,50 @@
+/** 数字人版本列表加载模型（任务 132）：解析 /api/digital-human/versions 数组负载(camel)；纯逻辑。 */
+import { unwrap } from '../../api/envelope.ts'
+import { normalizeDigitalHumanStatus, type DigitalHumanVersion, type DigitalHumanVersionList } from './digitalhuman-dto.ts'
+
+function text(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : ''
+}
+
+function numberOrNull(value: unknown): number | null {
+  return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
+}
+
+/** 解析单条数字人版本；缺 id 视为无效。 */
+export function toDigitalHumanVersion(raw: unknown): DigitalHumanVersion | null {
+  if (!raw || typeof raw !== 'object') return null
+  const r = raw as Record<string, unknown>
+  const id = numberOrNull(r.id)
+  if (id === null) return null
+  const version: DigitalHumanVersion = { id, version: text(r.version), status: normalizeDigitalHumanStatus(r.status) }
+  const fileSize = numberOrNull(r.fileSize)
+  if (fileSize !== null) version.fileSize = fileSize
+  const md5 = text(r.md5)
+  if (md5) version.md5 = md5
+  const changelog = text(r.changelog)
+  if (changelog) version.changelog = changelog
+  const minClientVersion = text(r.minClientVersion)
+  if (minClientVersion) version.minClientVersion = minClientVersion
+  const downloadUrl = text(r.downloadUrl)
+  if (downloadUrl) version.downloadUrl = downloadUrl
+  const createdBy = text(r.createdBy)
+  if (createdBy) version.createdBy = createdBy
+  const createdAt = text(r.createdAt)
+  if (createdAt) version.createdAt = createdAt
+  const releasedAt = text(r.releasedAt)
+  if (releasedAt) version.releasedAt = releasedAt
+  if (typeof r.isLatest === 'boolean') version.isLatest = r.isLatest
+  return version
+}
+
+/** 归一化版本列表负载(data 数组)为前端列表；缺省回空。 */
+export function parseDigitalHumanVersions(payload: unknown): DigitalHumanVersionList {
+  const data = unwrap<unknown>(payload)
+  const list = Array.isArray(data) ? data : data && typeof data === 'object' ? (data as Record<string, unknown>).items : null
+  if (!Array.isArray(list)) return { items: [] }
+  return {
+    items: list
+      .map((raw) => toDigitalHumanVersion(raw))
+      .filter((version): version is DigitalHumanVersion => version !== null),
+  }
+}

admin-frontend-vue/tests/task-132.test.ts

@@ -0,0 +1,63 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import { parseDigitalHumanVersions } from '../src/pages/records/digitalhuman-model.ts'
+
+test('test_task_132_dh_version_list_load_normal_primary_path', () => {
+  // 正常主路径：camel 版本数组负载解析。
+  const list = parseDigitalHumanVersions({
+    success: true,
+    data: [
+      { id: 1, version: '1.0.0', fileSize: 100, isLatest: true, status: 'RELEASED', downloadUrl: 'https://oss/dh.zip', createdAt: '2026-01-01T10:00:00' },
+    ],
+  })
+  assert.equal(list.items.length, 1)
+  assert.equal(list.items[0].version, '1.0.0')
+  assert.equal(list.items[0].status, 'RELEASED')
+  assert.equal(list.items[0].isLatest, true)
+  assert.equal(list.items[0].downloadUrl, 'https://oss/dh.zip')
+})
+
+test('test_task_132_dh_version_list_load_normal_variant_input', () => {
+  // 正常变体：缺字段行回默认；小写状态归一大写。
+  const list = parseDigitalHumanVersions({ data: [{ id: 2, version: '2.0.0', status: 'draft' }] })
+  assert.equal(list.items[0].status, 'DRAFT')
+  assert.equal(list.items[0].fileSize, undefined)
+})
+
+test('test_task_132_dh_version_list_load_repeated_is_idempotent', () => {
+  // 正常重复：解析稳定、不改输入。
+  const payload = { data: [{ id: 1, version: 'v', status: 'RELEASED' }] }
+  assert.deepEqual(parseDigitalHumanVersions(payload), parseDigitalHumanVersions(payload))
+})
+
+test('test_task_132_dh_version_list_load_boundary_empty_input', () => {
+  // 边界空值：空列表/空负载。
+  assert.deepEqual(parseDigitalHumanVersions({ data: [] }).items, [])
+  assert.deepEqual(parseDigitalHumanVersions({}).items, [])
+})
+
+test('test_task_132_dh_version_list_load_boundary_single_item', () => {
+  // 边界单元素：单版本；缺 id 过滤。
+  const list = parseDigitalHumanVersions({ data: [{ id: 9, version: 'v', status: 'DRAFT' }, { version: 'x' }] })
+  assert.equal(list.items.length, 1)
+})
+
+test('test_task_132_dh_version_list_load_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：非对象过滤。
+  assert.deepEqual(parseDigitalHumanVersions({ data: ['bad'] }).items, [])
+})
+
+test('test_task_132_dh_version_list_load_invalid_input_rejected', () => {
+  // 异常输入：success=false 抛后端 message。
+  assert.throws(() => parseDigitalHumanVersions({ success: false, message: '无权访问' }), /无权访问/)
+})
+
+test('test_task_132_dh_version_list_load_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/加载走 adapter：GET /api/digital-human/versions。
+  const api = readSource('src/pages/records/digitalhuman-api.ts')
+  assert.match(api, /\/api\/digital-human\/versions/)
+  assert.match(api, /fetchDigitalHumanVersions/)
+  const model = readSource('src/pages/records/digitalhuman-model.ts')
+  assert.equal(/axios|http\./.test(model), false, '数字人解析保持纯逻辑')
+})