huangzd1997
9ffd68bae5
- admin-vue 新增「记录与版本 → 教程管理」页（menuKey admin_tutorial）：
zip 浏览器直传 MinIO（presign → PUT 带进度 → confirm 落库）+ 列表/下载/删除，
最新一条标「当前生效」；补操作指引与 align-tutorial 守卫测试。
- frontend-vue 工具台「立即下载教程」进页面取 /api/tutorial/latest（最新上传优先），
接口异常或无记录回退历史固定直链，按钮不失效。
- Java 侧 tutorial 模块与 V119 迁移已在 dc6e8924 提交并上线（2026-09-13）。
vue-tsc + 两端单测（工具台 695 / 后台 1617）通过；生产已实测
presign→PUT→confirm→latest 切换→删除回落全链路。
50 lines
2.8 KiB
TypeScript
50 lines
2.8 KiB
TypeScript
import test from 'node:test'
|
|
import assert from 'node:assert/strict'
|
|
import { readSource } from './helpers.ts'
|
|
import { adminPages } from '../src/router/routes.ts'
|
|
|
|
/** 教程管理页（工具台「立即下载教程」的后台入口）：上传走 presign 直传、列表取最新、下载/删除留驻反馈。 */
|
|
|
|
test('align_tutorial_page_registered', () => {
|
|
const page = adminPages.find((p) => p.path === 'records/tutorial')
|
|
assert.ok(page, '路由注册表应包含 records/tutorial')
|
|
assert.equal(page.menuKey, 'admin_tutorial')
|
|
assert.equal(page.title, '教程管理')
|
|
})
|
|
|
|
test('align_tutorial_page_wiring', () => {
|
|
const page = readSource('src/pages/records/RecordsTutorialPage.vue')
|
|
// 上传入口：选择 zip → 直传（进度条）→ 成功提示留驻弹窗。
|
|
assert.match(page, /上传教程包/, '存在上传入口按钮')
|
|
assert.match(page, /uploadTutorialPackage/, '上传走教程包直传链路')
|
|
assert.match(page, /请选择 zip 压缩包/, '未选文件时提示')
|
|
assert.match(page, /仅支持 \.zip 格式/, '格式校验提示')
|
|
assert.match(page, /上传成功，工具台「立即下载教程」已切换为该包/, '成功提示说明生效位置')
|
|
assert.match(page, /上传完成，正在登记教程包/, '进度文案')
|
|
// 列表：当前生效标记 + 下载 + 删除 + 空态。
|
|
assert.match(page, /当前生效/, '最新上传的包标记当前生效')
|
|
assert.match(page, /formatFileSize/, '展示包体大小')
|
|
assert.match(page, /下载/, '操作列提供下载')
|
|
assert.match(page, /<a v-if="row\.fileUrl" class="btn btn-sm dl-btn"[^>]*download/, '下载链接带 download 强制下载')
|
|
assert.match(page, /确认删除选中的/, '批量删除二次确认')
|
|
assert.match(page, /暂无教程包记录/, '空态文案')
|
|
})
|
|
|
|
test('align_tutorial_api_contract', () => {
|
|
const api = readSource('src/pages/records/tutorial-api.ts')
|
|
assert.match(api, /\/api\/admin\/tutorials/, '列表端点')
|
|
assert.match(api, /TUTORIAL_UPLOAD_ENDPOINT = '\/api\/admin\/tutorial'/, '上传端点前缀')
|
|
assert.match(api, /\$\{TUTORIAL_UPLOAD_ENDPOINT\}\/presign/, '直传预签名端点')
|
|
assert.match(api, /\$\{TUTORIAL_UPLOAD_ENDPOINT\}\/confirm/, '确认端点')
|
|
assert.match(api, /\$\{TUTORIAL_UPLOAD_ENDPOINT\}\/delete/, '删除端点')
|
|
assert.match(api, /params: \{ object_key: objectKey, file_name: fileName \}/, '确认回传对象 key 与文件名')
|
|
assert.match(api, /withCredentials: false/, '直传实例不挂会话拦截器')
|
|
})
|
|
|
|
test('align_tutorial_model_parsers', () => {
|
|
const model = readSource('src/pages/records/tutorial-model.ts')
|
|
assert.match(model, /r\.file_name \?\? r\.fileName/, '兼容 snake/camel 文件名')
|
|
assert.match(model, /r\.file_url \?\? r\.fileUrl/, '兼容 snake/camel 下载链接')
|
|
assert.match(model, /r\.file_size \?\? r\.fileSize/, '兼容 snake/camel 文件大小')
|
|
})
|