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

新增 digitalhuman-model.ts/数字人-api.ts(GET /api/digital-human/versions)。 TDD: task-132.test.ts 8 用例 RED→GREEN。
2026-09-05 17:38:01 +08:00
parent 5eb3e865b2
commit e063aedb8f
3 changed files with 123 additions and 0 deletions
@@ -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)
+}
@@ -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),
+  }
+}