6fe5c8c8d0
- 后端新增 evidence 模块(V182 证据表/独立桶/超管读取面/内部登记)与 application.yml evidence 块;管理员四端点逐个 requireSuperAdmin。 - 分片通道补 @Scheduled 回收与 LocalTempCleanupService 的 chunk-uploads 覆盖; 版本/教程 confirm 接受 file_key,把拼装件搬进 client 桶后落库。 - 用户端 9MB 视频改走 uploadTempFileToJava 分片;后管版本/教程 >8MB 走分片, 小文件仍走原 presign 直传。 - 激活 Phase 3/4 后端与两前端预置契约。
95 lines
4.3 KiB
TypeScript
95 lines
4.3 KiB
TypeScript
/** 教程包接口适配(教程管理页):列表 / 直传预签名 / 确认 / 删除。 */
|
|
import axios from 'axios'
|
|
import { http, unwrap } from '@/api/http'
|
|
import { CHUNK_UPLOAD_THRESHOLD, uploadFileInChunks } from '@/api/chunk-upload'
|
|
import { parseTutorialPackageList, parseTutorialPackageUpload } from './tutorial-model.ts'
|
|
import type { TutorialPackageItem, TutorialPackageList } from './tutorial-dto.ts'
|
|
|
|
export const TUTORIALS_ENDPOINT = '/api/admin/tutorials'
|
|
export const TUTORIAL_UPLOAD_ENDPOINT = '/api/admin/tutorial'
|
|
export const TUTORIAL_PRESIGN_ENDPOINT = `${TUTORIAL_UPLOAD_ENDPOINT}/presign`
|
|
export const TUTORIAL_CONFIRM_ENDPOINT = `${TUTORIAL_UPLOAD_ENDPOINT}/confirm`
|
|
export const TUTORIAL_DELETE_ENDPOINT = `${TUTORIAL_UPLOAD_ENDPOINT}/delete`
|
|
/** 大档分片通道(AC-11):>8MB 的教程包走这里,不再一次性 presign PUT。 */
|
|
export const TUTORIAL_CHUNK_ENDPOINT = '/api/files/chunk'
|
|
|
|
/** MinIO 直传专用实例:不带 cookie、不挂 401 跳登录拦截器(预签名过期/签名失败不能误判会话过期);大 zip 给足超时。 */
|
|
const directPut = axios.create({ timeout: 600_000, withCredentials: false })
|
|
|
|
export async function fetchTutorialPackages(): Promise<TutorialPackageList> {
|
|
const { data } = await http.get<unknown>(TUTORIALS_ENDPOINT)
|
|
return parseTutorialPackageList(data)
|
|
}
|
|
|
|
export interface TutorialUploadTarget {
|
|
objectKey: string
|
|
uploadUrl: string
|
|
fileUrl: string
|
|
version: string
|
|
}
|
|
|
|
/** 第一步:向后端申请直传 PUT 预签名地址(登录会话签发,3 分钟有效)。 */
|
|
export async function requestTutorialPresign(fileName: string, version = ''): Promise<TutorialUploadTarget> {
|
|
const { data } = await http.post<unknown>(TUTORIAL_PRESIGN_ENDPOINT, null, { params: { file_name: fileName, version } })
|
|
const core = (unwrap(data) ?? {}) as Record<string, unknown>
|
|
const uploadUrl = typeof core.upload_url === 'string' ? core.upload_url : ''
|
|
const objectKey = typeof core.object_key === 'string' ? core.object_key : ''
|
|
if (!uploadUrl || !objectKey) {
|
|
throw new Error('后端未返回直传地址,请重试')
|
|
}
|
|
return {
|
|
objectKey,
|
|
uploadUrl,
|
|
fileUrl: typeof core.file_url === 'string' ? core.file_url : '',
|
|
version: typeof core.version === 'string' ? core.version : version.trim(),
|
|
}
|
|
}
|
|
|
|
/** 第三步:直传完成后通知后端校验对象并写入记录(data.item 为新记录行)。 */
|
|
export async function confirmTutorialPackage(
|
|
objectKey: string,
|
|
fileName: string,
|
|
version = '',
|
|
fileKey = '',
|
|
): Promise<TutorialPackageItem | null> {
|
|
const params: Record<string, string> = { object_key: objectKey, file_name: fileName, version }
|
|
if (fileKey) params.file_key = fileKey
|
|
const { data } = await http.post<unknown>(TUTORIAL_CONFIRM_ENDPOINT, null, { params })
|
|
return parseTutorialPackageUpload(data)
|
|
}
|
|
|
|
/** 按 id 批量删除教程包(后端会顺带清理无引用对象的 MinIO 包体);返回实际删除行数。 */
|
|
export async function deleteTutorialPackages(ids: number[]): Promise<number> {
|
|
if (!ids.length) return 0
|
|
const { data } = await http.post<unknown>(TUTORIAL_DELETE_ENDPOINT, ids)
|
|
const core = (unwrap(data) ?? {}) as Record<string, unknown>
|
|
return typeof core.deleted === 'number' ? core.deleted : ids.length
|
|
}
|
|
|
|
/**
|
|
* 上传教程包(浏览器直传):presign 申请 → 直接 PUT 到 MinIO client 桶(不走 Java 中转)
|
|
* → confirm 校验落库。onProgress 回传 0-100 上传进度。
|
|
*/
|
|
export async function uploadTutorialPackage(
|
|
file: Blob,
|
|
fileName: string,
|
|
version = '',
|
|
onProgress?: (percent: number) => void,
|
|
): Promise<TutorialPackageItem | null> {
|
|
if (file.size > CHUNK_UPLOAD_THRESHOLD) {
|
|
const uploaded = await uploadFileInChunks(file, fileName, onProgress)
|
|
const fileKey = String(uploaded.fileKey ?? uploaded.file_key ?? '')
|
|
return confirmTutorialPackage(String(uploaded.objectKey ?? ''), fileName, version, fileKey)
|
|
}
|
|
const target = await requestTutorialPresign(fileName, version)
|
|
await directPut.put(target.uploadUrl, file, {
|
|
headers: { 'Content-Type': 'application/octet-stream' },
|
|
onUploadProgress: (event) => {
|
|
if (!onProgress) return
|
|
const total = event.total || 0
|
|
onProgress(total > 0 ? Math.min(Math.round((event.loaded / total) * 100), 100) : 0)
|
|
},
|
|
})
|
|
return confirmTutorialPackage(target.objectKey, fileName, target.version)
|
|
}
|