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
@@ -4,8 +4,17 @@ import { parseSoftwareVersionList } from './version-model.ts'
 import type { SoftwareVersionList } from './version-dto.ts'

 export const SOFTWARE_VERSIONS_ENDPOINT = '/api/admin/versions'
+export const SOFTWARE_VERSION_UPLOAD_ENDPOINT = '/api/admin/version'

 export async function fetchSoftwareVersions(): Promise<SoftwareVersionList> {
  const { data } = await http.get<unknown>(SOFTWARE_VERSIONS_ENDPOINT)
  return parseSoftwareVersionList(data)
 }
+
+/** 上传客户端软件版本(multipart version + file)。 */
+export async function uploadSoftwareVersion(version: string, file: Blob, filename = ''): Promise<void> {
+  const form = new FormData()
+  form.append('version', version)
+  form.append('file', file, filename || (file instanceof File ? file.name : 'version.zip'))
+  await http.post<unknown>(SOFTWARE_VERSION_UPLOAD_ENDPOINT, form)
+}
@@ -0,0 +1,27 @@
+/** 软件版本上传表单（任务 128）：版本号/文件校验与 multipart 表单字段构建；纯逻辑。 */
+
+export interface VersionUploadForm {
+  version: string
+  file: { name?: string; size?: number } | null
+}
+
+export interface VersionUploadErrors {
+  version?: string
+  file?: string
+}
+
+/** 校验上传表单(版本号必填非空、文件已选且非空)；返回逐字段错误。 */
+export function validateSoftwareVersionUpload(form: VersionUploadForm): { valid: boolean; errors: VersionUploadErrors } {
+  const errors: VersionUploadErrors = {}
+  const version = (form.version || '').trim()
+  if (!version) errors.version = '版本号不能为空'
+  const file = form.file
+  if (!file) errors.file = '请选择安装包文件'
+  else if (typeof file.size === 'number' && file.size <= 0) errors.file = '安装包为空或无效'
+  return { valid: Object.keys(errors).length === 0, errors }
+}
+
+/** 版本号 → multipart 表单字段(空白去除)；文件在 adapter 端追加。 */
+export function buildSoftwareVersionUploadRequest(form: VersionUploadForm): { version: string } {
+  return { version: (form.version || '').trim() }
+}