task-128(记录与版本中心): 实现软件版本上传表单

新增 version-upload-model.ts(版本号/文件校验与表单字段) 与 uploadSoftwareVersion (multipart POST /api/admin/version)。 TDD: task-128.test.ts 8 用例 RED→GREEN。
2026-09-05 17:35:34 +08:00
parent 154ec6e301
commit b60bf7bc13
3 changed files with 100 additions and 0 deletions
@@ -0,0 +1,64 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import {
+  buildSoftwareVersionUploadRequest,
+  validateSoftwareVersionUpload,
+} from '../src/pages/records/version-upload-model.ts'
+
+test('test_task_128_version_upload_normal_primary_path', () => {
+  // 正常主路径：合法版本+文件校验通过并序列化 multipart 表单字段。
+  const form = { version: '1.0.46', file: { name: 'a.zip', size: 1024 } }
+  const { valid, errors } = validateSoftwareVersionUpload(form)
+  assert.equal(valid, true)
+  assert.deepEqual(errors, {})
+  assert.deepEqual(buildSoftwareVersionUploadRequest(form), { version: '1.0.46' })
+})
+
+test('test_task_128_version_upload_normal_variant_input', () => {
+  // 正常变体：版本首尾空白去除。
+  const request = buildSoftwareVersionUploadRequest({ version: ' 1.0.46 ', file: { name: 'b.zip', size: 1 } })
+  assert.equal(request.version, '1.0.46')
+})
+
+test('test_task_128_version_upload_repeated_is_idempotent', () => {
+  // 正常重复：序列化稳定、不改输入。
+  const form = { version: '1.0.0', file: { name: 'a.zip', size: 5 } }
+  assert.deepEqual(buildSoftwareVersionUploadRequest(form), buildSoftwareVersionUploadRequest(form))
+  assert.equal((form as { version: string }).version, '1.0.0')
+})
+
+test('test_task_128_version_upload_boundary_empty_input', () => {
+  // 边界空值：空版本/无文件校验失败。
+  const { errors } = validateSoftwareVersionUpload({ version: '', file: null })
+  assert.equal(errors.version, '版本号不能为空')
+  assert.equal(errors.file, '请选择安装包文件')
+})
+
+test('test_task_128_version_upload_boundary_single_item', () => {
+  // 边界单元素：仅版本号合法但缺文件报错。
+  const { errors } = validateSoftwareVersionUpload({ version: '1.0.0', file: null })
+  assert.equal(errors.file, '请选择安装包文件')
+})
+
+test('test_task_128_version_upload_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：空文件按未选择处理。
+  const { errors } = validateSoftwareVersionUpload({ version: '1.0.0', file: { name: 'x.zip', size: 0 } })
+  assert.equal(errors.file, '安装包为空或无效')
+})
+
+test('test_task_128_version_upload_invalid_input_rejected', () => {
+  // 异常输入：非法版本字符仅去空白，不做语义强校验。
+  const request = buildSoftwareVersionUploadRequest({ version: ' v1 ', file: { name: 'x.zip', size: 1 } })
+  assert.equal(request.version, 'v1')
+})
+
+test('test_task_128_version_upload_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/提交走 adapter：上传表单纯逻辑；POST /api/admin/version multipart。
+  const mod = readSource('src/pages/records/version-upload-model.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '上传表单保持纯逻辑')
+  const api = readSource('src/pages/records/version-api.ts')
+  assert.match(api, /uploadSoftwareVersion/)
+  assert.match(api, /\/api\/admin\/version/)
+  assert.match(api, /FormData/)
+})