diff --git a/admin-frontend-vue/src/pages/records/digitalhuman-api.ts b/admin-frontend-vue/src/pages/records/digitalhuman-api.ts new file mode 100644 index 00000000..2ae838f5 --- /dev/null +++ b/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 { + const { data } = await http.get(DIGITAL_HUMAN_VERSIONS_ENDPOINT) + return parseDigitalHumanVersions(data) +} diff --git a/admin-frontend-vue/src/pages/records/digitalhuman-model.ts b/admin-frontend-vue/src/pages/records/digitalhuman-model.ts new file mode 100644 index 00000000..ef276800 --- /dev/null +++ b/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 + 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(payload) + const list = Array.isArray(data) ? data : data && typeof data === 'object' ? (data as Record).items : null + if (!Array.isArray(list)) return { items: [] } + return { + items: list + .map((raw) => toDigitalHumanVersion(raw)) + .filter((version): version is DigitalHumanVersion => version !== null), + } +} diff --git a/admin-frontend-vue/tests/task-132.test.ts b/admin-frontend-vue/tests/task-132.test.ts new file mode 100644 index 00000000..25f29075 --- /dev/null +++ b/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, '数字人解析保持纯逻辑') +})