feat(server): 统一课表解析并完善权限范围与年度升级

This commit is contained in:
LoveChengke committed 2026-10-17 09:34:23 +08:00
1 parent 66ef878a71
commit 4dc824c283
54 files changed
+2401 -625

No files matched your search

@@ -1,3 +1,5 @@
import { getReleaseProgress, setReleaseProgress } from './release-progress.js';
import { Transform } from 'node:stream';
import crypto from 'node:crypto';
import fs from 'node:fs';
import path from 'node:path';
@@ -81,9 +83,7 @@ async function sha256Of(file: string): Promise<string> {
/** GET /api/update/client/releases - 已缓存的安装包(按版本从新到旧) */
export async function listReleases(): Promise<ClientReleaseDto[]> {
const rows = (await prisma.clientRelease.findMany()) as unknown as ReleaseRow[];
return rows
.sort((a, b) => compareVersions(b.version, a.version))
.map((row) => toReleaseDto(row));
return rows.sort((a, b) => compareVersions(b.version, a.version)).map((row) => toReleaseDto(row));
}
/** 服务端缓存的**最新**版本(推送更新时省略 version 就用它) */
@@ -116,7 +116,9 @@ export async function resolveUpdateInfo(version: string): Promise<ClientUpdateIn
}
/** 绝对路径(下载路由用);文件不存在返回 null */
export async function resolveReleaseFile(version: string): Promise<{ file: string; fileName: string } | null> {
export async function resolveReleaseFile(
version: string,
): Promise<{ file: string; fileName: string } | null> {
const row = (await prisma.clientRelease.findUnique({ where: { version } })) as ReleaseRow | null;
if (!row) return null;
const file = releaseFilePath(row.version, row.fileName);
@@ -161,7 +163,9 @@ export async function registerRelease(
},
})) as ReleaseRow;
logger.info(`登记客户端安装包 v${version}(${fileName},${stat.size} 字节,sha256=${sha256.slice(0, 12)}…)`);
logger.info(
`登记客户端安装包 v${version}(${fileName},${stat.size} 字节,sha256=${sha256.slice(0, 12)}…)`,
);
return toReleaseDto(row);
}
@@ -170,7 +174,10 @@ export async function fetchReleaseFromGithub(
userId: string,
input: FetchClientReleaseInput,
): Promise<ClientReleaseDto> {
if (['downloading', 'verifying'].includes(getReleaseProgress().stage))
throw ApiError.conflict('已有安装包正在下载');
const version = input.version;
setReleaseProgress({ version, stage: 'downloading', downloadedBytes: 0, totalBytes: 0, error: '' });
const fileName = clientReleaseFileName(version);
const url = clientReleaseDownloadUrl(version);
const target = releaseFilePath(version, fileName);
@@ -199,14 +206,24 @@ export async function fetchReleaseFromGithub(
}
try {
await pipeline(Readable.fromWeb(response.body as never), fs.createWriteStream(target));
setReleaseProgress({ totalBytes: Number(response.headers.get('content-length')) || 0 });
const counter = new Transform({
transform(chunk, _encoding, done) {
setReleaseProgress({ downloadedBytes: getReleaseProgress().downloadedBytes + chunk.length });
done(null, chunk);
},
});
await pipeline(Readable.fromWeb(response.body as never), counter, fs.createWriteStream(target));
} catch (error) {
fs.rmSync(target, { force: true });
throw ApiError.badRequest(`写入安装包失败:${error instanceof Error ? error.message : String(error)}`);
}
// 落盘后统一走登记:sha256 / 大小 / 落库都在同一处算
return registerRelease(userId, { version, fileName });
setReleaseProgress({ stage: 'verifying' });
const release = await registerRelease(userId, { version, fileName });
setReleaseProgress({ stage: 'ready', downloadedBytes: release.size, totalBytes: release.size });
return release;
}
/** 删除一份缓存的安装包(元数据 + 磁盘文件) */
@@ -0,0 +1,27 @@
import { SOCKET_EVENTS, SOCKET_ROOMS, type ReleaseProgressDto } from '@classhelper/shared';
import { emitToRooms } from '../../realtime/bus.js';
// 下载状态只属于本次进程;重启回到 idle,不会残留无法完成的 downloading。
let progress: ReleaseProgressDto = {
version: '',
stage: 'idle',
downloadedBytes: 0,
totalBytes: 0,
percent: null,
error: '',
};
let lastEmit = 0;
export function getReleaseProgress() {
return { ...progress };
}
export function setReleaseProgress(patch: Partial<ReleaseProgressDto>) {
const stageChanged = patch.stage && patch.stage !== progress.stage;
progress = { ...progress, ...patch };
progress.percent = progress.totalBytes
? Math.min(100, Math.round((progress.downloadedBytes / progress.totalBytes) * 100))
: null;
if (stageChanged || Date.now() - lastEmit >= 250) {
emitToRooms([SOCKET_ROOMS.role('ADMIN')], SOCKET_EVENTS.clientReleaseProgress, getReleaseProgress());
lastEmit = Date.now();
}
}
@@ -1,3 +1,4 @@
import { getReleaseProgress, setReleaseProgress } from './release-progress.js';
import { Router } from 'express';
import { sendCreated, sendOk, ApiError } from '../../lib/http.js';
import {
@@ -22,6 +23,9 @@ import {
const router = Router();
router.use(authenticate());
router.get('/client/progress', requirePermission('client:update'), async (_req, res) =>
sendOk(res, getReleaseProgress()),
);
/**
* GET /api/update/check?force=1 - 检查 GitHub 上有没有比本机新的版本
@@ -64,12 +68,24 @@ router.get(
*/
router.post(
'/client/fetch',
requirePermission('client:update-push'),
requirePermission('client:update'),
validate({ body: fetchClientReleaseSchema }),
async (req, res) => {
const user = getAuthUser(req);
const input = validatedBody<FetchClientReleaseInput>(req);
sendCreated(res, await clientReleases.fetchReleaseFromGithub(user.sub, input), '安装包已下载并登记');
try {
sendCreated(res, await clientReleases.fetchReleaseFromGithub(user.sub, input), '安装包已下载并登记');
} catch (error) {
if (
!(error instanceof ApiError && error.status === 409) &&
getReleaseProgress().version === input.version
)
setReleaseProgress({
stage: 'failed',
error: error instanceof Error ? error.message : String(error),
});
throw error;
}
},
);
@@ -81,7 +97,7 @@ router.post(
*/
router.post(
'/client/releases',
requirePermission('client:update-push'),
requirePermission('client:update'),
validate({ body: registerClientReleaseSchema }),
async (req, res) => {
const user = getAuthUser(req);
@@ -93,7 +109,7 @@ router.post(
/** DELETE /api/update/client/releases/:version - 删除缓存(元数据 + 磁盘文件) */
router.delete(
'/client/releases/:version',
requirePermission('client:update-push'),
requirePermission('client:update'),
validate({ params: clientReleaseVersionParamSchema }),
async (req, res) => {
const { version } = validatedParams<{ version: string }>(req);