diff --git a/admin-frontend-vue/src/pages/records/digitalhuman-dto.ts b/admin-frontend-vue/src/pages/records/digitalhuman-dto.ts new file mode 100644 index 00000000..1e91947c --- /dev/null +++ b/admin-frontend-vue/src/pages/records/digitalhuman-dto.ts @@ -0,0 +1,33 @@ +/** 数字人版本 DTO(任务 131):数字人版本行/状态类型;与软件版本 DTO 分离,纯逻辑。 */ + +export type DigitalHumanVersionStatus = 'DRAFT' | 'RELEASED' + +/** 数字人版本行(GET /api/digital-human/versions,Java DigitalHumanVersionVo camel)。 */ +export interface DigitalHumanVersion { + id: number + version: string + fileSize?: number + md5?: string + changelog?: string + minClientVersion?: string + isLatest?: boolean + status: DigitalHumanVersionStatus + downloadUrl?: string + createdBy?: string + createdAt?: string + releasedAt?: string +} + +export interface DigitalHumanVersionList { + items: DigitalHumanVersion[] +} + +export function emptyDigitalHumanVersionList(): DigitalHumanVersionList { + return { items: [] } +} + +/** 状态归一:非受控一律回 DRAFT。 */ +export function normalizeDigitalHumanStatus(value: unknown): DigitalHumanVersionStatus { + const text = typeof value === 'string' ? value.trim().toUpperCase() : '' + return text === 'RELEASED' ? 'RELEASED' : 'DRAFT' +} diff --git a/admin-frontend-vue/tests/task-131.test.ts b/admin-frontend-vue/tests/task-131.test.ts new file mode 100644 index 00000000..67aa54eb --- /dev/null +++ b/admin-frontend-vue/tests/task-131.test.ts @@ -0,0 +1,50 @@ +import test from 'node:test' +import assert from 'node:assert/strict' +import { readSource } from './helpers.ts' +import { emptyDigitalHumanVersionList, normalizeDigitalHumanStatus } from '../src/pages/records/digitalhuman-dto.ts' + +test('test_task_131_dh_version_dto_normal_primary_path', () => { + // 正常主路径:数字人版本状态归一与空列表缺省。 + assert.equal(normalizeDigitalHumanStatus('RELEASED'), 'RELEASED') + assert.equal(normalizeDigitalHumanStatus('draft'), 'DRAFT') + assert.deepEqual(emptyDigitalHumanVersionList(), { items: [] }) +}) + +test('test_task_131_dh_version_dto_normal_variant_input', () => { + // 正常变体:未知状态回 DRAFT。 + assert.equal(normalizeDigitalHumanStatus('weird'), 'DRAFT') + assert.equal(normalizeDigitalHumanStatus(''), 'DRAFT') +}) + +test('test_task_131_dh_version_dto_repeated_is_idempotent', () => { + // 正常重复:归一稳定。 + assert.equal(normalizeDigitalHumanStatus('RELEASED'), normalizeDigitalHumanStatus('released')) +}) + +test('test_task_131_dh_version_dto_boundary_empty_input', () => { + // 边界空值:非字符串按 DRAFT。 + assert.equal(normalizeDigitalHumanStatus(null as unknown as string), 'DRAFT') +}) + +test('test_task_131_dh_version_dto_boundary_single_item', () => { + // 边界单元素:类型导出存在。 + assert.ok(typeof emptyDigitalHumanVersionList === 'function') +}) + +test('test_task_131_dh_version_dto_boundary_limit_or_missing_field', () => { + // 边界上限/缺字段:版本类型定义里 status 为受控枚举。 + const mod = readSource('src/pages/records/digitalhuman-dto.ts') + assert.match(mod, /'DRAFT' \| 'RELEASED'/) +}) + +test('test_task_131_dh_version_dto_invalid_input_rejected', () => { + // 异常输入:非受控状态被拒绝为 DRAFT。 + assert.equal(normalizeDigitalHumanStatus(1 as unknown as string), 'DRAFT') +}) + +test('test_task_131_dh_version_dto_dependency_failure_returns_actionable_message', () => { + // 依赖失败/可操作:DTO 纯逻辑、无框架/http;与软件版本 DTO 分离。 + const mod = readSource('src/pages/records/digitalhuman-dto.ts') + assert.equal(/axios|http\.|vue/.test(mod), false, '数字人 DTO 保持纯逻辑') + assert.match(mod, /DigitalHumanVersion/) +})