From 5eb3e865b21f649d142f4ee76181b7b0ce03801e 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:37:30 +0800
Subject: [PATCH] =?UTF-8?q?task-131(=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=9A=E4=B9=89=E6=95=B0?=
 =?UTF-8?q?=E5=AD=97=E4=BA=BA=E7=89=88=E6=9C=AC=20DTO?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 digitalhuman-dto.ts：数字人版本行/状态类型，与软件版本分离。

TDD: task-131.test.ts 8 用例 RED→GREEN。
---
 .../src/pages/records/digitalhuman-dto.ts     | 33 ++++++++++++
 admin-frontend-vue/tests/task-131.test.ts     | 50 +++++++++++++++++++
 2 files changed, 83 insertions(+)
 create mode 100644 admin-frontend-vue/src/pages/records/digitalhuman-dto.ts
 create mode 100644 admin-frontend-vue/tests/task-131.test.ts

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/)
+})