From e063aedb8f2a5b6f8b4c98481a3b0c42f9632deb 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:38:01 +0800 Subject: [PATCH] =?UTF-8?q?task-132(=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=E6=95=B0?= =?UTF-8?q?=E5=AD=97=E4=BA=BA=E7=89=88=E6=9C=AC=E5=88=97=E8=A1=A8=E5=8A=A0?= =?UTF-8?q?=E8=BD=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 digitalhuman-model.ts/数字人-api.ts(GET /api/digital-human/versions)。 TDD: task-132.test.ts 8 用例 RED→GREEN。 --- .../src/pages/records/digitalhuman-api.ts | 10 +++ .../src/pages/records/digitalhuman-model.ts | 50 +++++++++++++++ admin-frontend-vue/tests/task-132.test.ts | 63 +++++++++++++++++++ 3 files changed, 123 insertions(+) create mode 100644 admin-frontend-vue/src/pages/records/digitalhuman-api.ts create mode 100644 admin-frontend-vue/src/pages/records/digitalhuman-model.ts create mode 100644 admin-frontend-vue/tests/task-132.test.ts 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, '数字人解析保持纯逻辑') +})