task-127(记录与版本中心): 实现软件版本列表加载

新增 version-model.ts 与 version-api.ts(GET /api/admin/versions)。 TDD: task-127.test.ts 8 用例 RED→GREEN。
2026-09-05 17:34:49 +08:00
parent 1d98315877
commit 154ec6e301
3 changed files with 104 additions and 0 deletions
@@ -0,0 +1,58 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import { parseSoftwareVersionList } from '../src/pages/records/version-model.ts'
+
+test('test_task_127_version_list_load_normal_primary_path', () => {
+  // 正常主路径：snake 版本列表负载解析。
+  const list = parseSoftwareVersionList({
+    success: true,
+    data: { items: [{ id: 1, version: '1.0.46', file_url: 'https://oss/a.zip', created_at: '2026-01-01 10:00' }] },
+  })
+  assert.equal(list.items.length, 1)
+  assert.equal(list.items[0].version, '1.0.46')
+  assert.equal(list.items[0].fileUrl, 'https://oss/a.zip')
+})
+
+test('test_task_127_version_list_load_normal_variant_input', () => {
+  // 正常变体：缺 file_url 行字段默认空。
+  const list = parseSoftwareVersionList({ data: { items: [{ id: 2, version: '1.0.0' }] } })
+  assert.equal(list.items[0].fileUrl, '')
+})
+
+test('test_task_127_version_list_load_repeated_is_idempotent', () => {
+  // 正常重复：解析稳定、不改输入。
+  const payload = { data: { items: [{ id: 1, version: '1' }] } }
+  assert.deepEqual(parseSoftwareVersionList(payload), parseSoftwareVersionList(payload))
+})
+
+test('test_task_127_version_list_load_boundary_empty_input', () => {
+  // 边界空值：空列表负载。
+  assert.deepEqual(parseSoftwareVersionList({ data: { items: [] } }).items, [])
+})
+
+test('test_task_127_version_list_load_boundary_single_item', () => {
+  // 边界单元素：单版本；缺 id 行过滤。
+  const list = parseSoftwareVersionList({ data: { items: [{ id: 9, version: 'v' }, { version: 'no-id' }] } })
+  assert.equal(list.items.length, 1)
+})
+
+test('test_task_127_version_list_load_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：非对象版本行过滤。
+  const list = parseSoftwareVersionList({ data: { items: ['bad'] } })
+  assert.deepEqual(list.items, [])
+})
+
+test('test_task_127_version_list_load_invalid_input_rejected', () => {
+  // 异常输入：success=false 抛后端 message。
+  assert.throws(() => parseSoftwareVersionList({ success: false, message: '无权访问版本管理' }), /无权访问/)
+})
+
+test('test_task_127_version_list_load_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/加载走 adapter：GET /api/admin/versions。
+  const api = readSource('src/pages/records/version-api.ts')
+  assert.match(api, /\/api\/admin\/versions/)
+  assert.match(api, /fetchSoftwareVersions/)
+  const model = readSource('src/pages/records/version-model.ts')
+  assert.equal(/axios|http\./.test(model), false, '版本解析保持纯逻辑')
+})