Files
BYW-VoiceHub/server/api/open/schedules.get.ts
T
Henry_Du a140ce8621 fix(open-api): 修复开放API两处缺陷并支持小程序取 token
- songs.get.ts: 引用未定义变量 songsWithDetails 导致 /api/open/songs 缓存未命中时必然 500,改为 formattedSongs;并让缓存分支兼容 requester 为字符串的情况,避免返回 { name: undefined }
- schedules.get.ts: 数据库分支补齐 sequence / played / song.voteCount,与此前只有缓存分支才返回这些字段的行为对齐(缺少 sequence 会让前端无法显示歌曲序号)
- login.post.ts: 响应体返回 token,便于小程序/App 通过 Authorization: Bearer 访问(不影响原有 httpOnly cookie 行为)
2026-09-26 13:48:27 +08:00

439 lines
14 KiB
TypeScript

import { createError, defineEventHandler, getQuery } from 'h3'
import { db } from '~/drizzle/db'
import {
playTimes,
schedules,
songCollaborators,
songs,
systemSettings,
users,
votes
} from '~/drizzle/schema'
import { and, asc, desc, eq, gte, inArray, like, lt, or, sql } from 'drizzle-orm'
import { formatDateTime } from '~/utils/timeUtils'
import { openApiCache } from '~~/server/utils/open-api-cache'
import { CACHE_CONSTANTS } from '~~/server/config/constants'
import { cacheService } from '~~/server/services/cacheService'
import { executeRedisCommand, isRedisReady } from '~~/server/utils/redis'
import {
resolveScheduleVisibilityRange,
isPlayDateInRange,
type VisibilitySettingsLike
} from '~~/server/utils/schedule-visibility'
export default defineEventHandler(async (event) => {
try {
const query = getQuery(event)
const apiKey = event.context.apiKey
console.log(`[Schedules API] 接收到请求,API Key context: ${apiKey ? '存在' : '不存在'}`)
if (apiKey) {
console.log(`[Schedules API] API Key ID: ${apiKey.id}, 名称: ${apiKey.name}`)
}
// API认证中间件已经验证了权限,这里只需要确保有API Key信息
if (!apiKey) {
console.log(`[Schedules API] API认证失败 - 缺少API Key context`)
throw createError({
statusCode: 401,
message: 'API认证失败'
})
}
const semester = (query.semester as string) || ''
const date = (query.date as string) || ''
const playTimeId = (query.playTimeId as string) || ''
const search = (query.search as string) || ''
const page = parseInt(query.page as string) || 1
const limit = Math.min(parseInt(query.limit as string) || 20, 100) // 最大100条
const sortBy = (query.sortBy as string) || 'playDate'
const sortOrder = (query.sortOrder as string) || 'asc'
// 读取系统设置:排期可见范围
let visibilityRange = { startAt: null as Date | null, endAt: null as Date | null }
try {
const systemSettingsDataResult = await db.select().from(systemSettings).limit(1)
const systemSettingsData = systemSettingsDataResult[0] || null
const visibilitySettings: VisibilitySettingsLike = {
scheduleDaysBeforeEnabled: systemSettingsData?.scheduleDaysBeforeEnabled,
scheduleDaysBefore: systemSettingsData?.scheduleDaysBefore,
scheduleDaysAfterEnabled: systemSettingsData?.scheduleDaysAfterEnabled,
scheduleDaysAfter: systemSettingsData?.scheduleDaysAfter
}
visibilityRange = resolveScheduleVisibilityRange(visibilitySettings)
} catch (err) {
console.warn('[Schedules API] 读取排期可见范围设置失败,将展示全部:', err)
}
const applyVisibilityFilter = (items: any[]): any[] => {
if (!visibilityRange.startAt && !visibilityRange.endAt) return items
return items.filter((s) => isPlayDateInRange(s.playDate, visibilityRange))
}
// 优先从普通API缓存获取数据
// 尝试从CacheService获取排期数据
const cachedSchedules = await cacheService.getSchedulesList()
if (cachedSchedules) {
console.log(`[OpenAPI Cache] 使用普通API缓存数据,数量: ${cachedSchedules.length}`)
// 如果指定了学期,过滤数据
let filteredSchedules = cachedSchedules
if (semester) {
filteredSchedules = cachedSchedules.filter((s) => s.song?.semester === semester)
}
filteredSchedules = applyVisibilityFilter(filteredSchedules)
// 转换为开放API格式
const result = {
success: true,
data: {
schedules: filteredSchedules.map((schedule: any) => ({
id: schedule.id,
playDate: schedule.playDate,
sequence: schedule.sequence,
played: schedule.played,
song: {
id: schedule.song.id,
title: schedule.song.title,
artist: schedule.song.artist,
semester: schedule.song.semester,
cover: schedule.song.cover,
musicPlatform: schedule.song.musicPlatform,
musicId: schedule.song.musicId
},
playTime: schedule.playTime
? {
id: schedule.playTime.id,
name: schedule.playTime.name,
startTime: schedule.playTime.startTime,
endTime: schedule.playTime.endTime,
enabled: schedule.playTime.enabled
}
: null
})),
total: filteredSchedules.length,
semester: semester || null
}
}
return result
}
// 如果普通缓存没有数据,尝试从Redis获取公共排期缓存
if (isRedisReady()) {
const redisCacheKey = semester ? `public_schedules:${semester}` : 'public_schedules:all'
const redisData = await executeRedisCommand(async () => {
const client = (await import('~~/server/utils/redis')).getRedisClient()
if (!client) return null
const data = await client.get(redisCacheKey)
if (data) {
const parsedData = JSON.parse(data)
console.log(
`[OpenAPI Cache] 使用Redis公共排期缓存: ${redisCacheKey},数量: ${parsedData.length}`
)
return parsedData
}
return null
})
if (redisData) {
const filteredRedisData = applyVisibilityFilter(redisData)
// 转换为开放API格式
const result = {
success: true,
data: {
schedules: filteredRedisData.map((schedule: any) => ({
id: schedule.id,
playDate: schedule.playDate,
sequence: schedule.sequence,
played: schedule.played,
song: {
id: schedule.song.id,
title: schedule.song.title,
artist: schedule.song.artist,
semester: schedule.song.semester,
cover: schedule.song.cover,
musicPlatform: schedule.song.musicPlatform,
musicId: schedule.song.musicId
},
playTime: schedule.playTime
? {
id: schedule.playTime.id,
name: schedule.playTime.name,
startTime: schedule.playTime.startTime,
endTime: schedule.playTime.endTime,
enabled: schedule.playTime.enabled
}
: null
})),
total: filteredRedisData.length,
semester: semester || null
}
}
return result
}
}
// 构建查询条件
const conditions = [
eq(schedules.isDraft, false) // 只查询已发布的排期
]
if (semester) {
conditions.push(eq(songs.semester, semester))
}
if (date) {
const targetDate = new Date(date)
const startOfDay = new Date(
targetDate.getFullYear(),
targetDate.getMonth(),
targetDate.getDate()
)
const endOfDay = new Date(
targetDate.getFullYear(),
targetDate.getMonth(),
targetDate.getDate() + 1
)
conditions.push(and(gte(schedules.playDate, startOfDay)!, lt(schedules.playDate, endOfDay)!)!)
}
if (playTimeId) {
conditions.push(eq(schedules.playTimeId, parseInt(playTimeId)))
}
if (search) {
conditions.push(or(like(songs.title, `%${search}%`)!, like(songs.artist, `%${search}%`)!)!)
}
if (visibilityRange.startAt) {
conditions.push(gte(schedules.playDate, visibilityRange.startAt)!)
}
if (visibilityRange.endAt) {
conditions.push(lt(schedules.playDate, visibilityRange.endAt)!)
}
const whereCondition = conditions.length > 0 ? and(...conditions) : undefined
// 计算偏移量
const offset = (page - 1) * limit
// 查询排期数据
const schedulesData = await db
.select({
id: schedules.id,
playDate: schedules.playDate,
sequence: schedules.sequence,
played: schedules.played,
createdAt: schedules.createdAt,
updatedAt: schedules.updatedAt,
song: {
id: songs.id,
title: songs.title,
artist: songs.artist,
cover: songs.cover,
musicPlatform: songs.musicPlatform,
musicId: songs.musicId,
played: songs.played,
playedAt: songs.playedAt,
createdAt: songs.createdAt,
semester: songs.semester
},
requester: {
id: users.id,
name: users.name,
grade: users.grade,
class: users.class
},
playTime: {
id: playTimes.id,
name: playTimes.name,
startTime: playTimes.startTime,
endTime: playTimes.endTime,
enabled: playTimes.enabled
}
})
.from(schedules)
.innerJoin(songs, eq(schedules.songId, songs.id))
.leftJoin(users, eq(songs.requesterId, users.id))
.leftJoin(playTimes, eq(schedules.playTimeId, playTimes.id))
.where(whereCondition)
.orderBy(
sortBy === 'playDate'
? sortOrder === 'desc'
? desc(schedules.playDate)
: asc(schedules.playDate)
: sortBy === 'createdAt'
? sortOrder === 'desc'
? desc(schedules.createdAt)
: asc(schedules.createdAt)
: sortBy === 'title'
? sortOrder === 'desc'
? desc(songs.title)
: asc(songs.title)
: asc(schedules.playDate)
)
.limit(limit)
.offset(offset)
// 获取总数
const totalResult = await db
.select({ count: sql`count(*)` })
.from(schedules)
.innerJoin(songs, eq(schedules.songId, songs.id))
.leftJoin(users, eq(songs.requesterId, users.id))
.where(whereCondition)
const total = Number(totalResult[0].count)
// 获取联合投稿人信息
const songIds = schedulesData.map((s) => s.song.id)
const collaboratorsMap = new Map()
if (songIds.length > 0) {
const collaboratorsData = await db
.select({
songId: songCollaborators.songId,
user: {
id: users.id,
name: users.name,
grade: users.grade,
class: users.class
}
})
.from(songCollaborators)
.leftJoin(users, eq(songCollaborators.userId, users.id))
.where(
and(inArray(songCollaborators.songId, songIds), eq(songCollaborators.status, 'ACCEPTED'))
)
collaboratorsData.forEach((c) => {
if (!collaboratorsMap.has(c.songId)) {
collaboratorsMap.set(c.songId, [])
}
if (c.user) {
collaboratorsMap.get(c.songId).push(c.user)
}
})
}
// 统计每首歌的票数。
// 该接口的缓存分支(本文件上方)会返回 voteCount,数据库分支此前漏了,
// 导致两条分支字段不一致,这里补齐。
const voteCountsMap = new Map<number, number>()
if (songIds.length > 0) {
const voteCountsData = await db
.select({
songId: votes.songId,
count: sql`count(*)`
})
.from(votes)
.where(inArray(votes.songId, songIds))
.groupBy(votes.songId)
voteCountsData.forEach((row) => {
voteCountsMap.set(row.songId, Number(row.count))
})
}
// 格式化数据
const formattedSchedules = schedulesData.map((schedule) => {
const collaborators = collaboratorsMap.get(schedule.song.id) || []
return {
id: schedule.id,
playDate: schedule.playDate,
playDateFormatted: formatDateTime(schedule.playDate),
sequence: schedule.sequence,
played: schedule.played,
semester: schedule.song.semester,
song: {
id: schedule.song.id,
title: schedule.song.title,
artist: schedule.song.artist,
cover: schedule.song.cover,
musicPlatform: schedule.song.musicPlatform,
musicId: schedule.song.musicId,
voteCount: voteCountsMap.get(schedule.song.id) || 0,
played: schedule.song.played,
playedAt: schedule.song.playedAt,
requestedAt: formatDateTime(schedule.song.createdAt),
collaborators: collaborators.map((c: any) => ({
id: c.id,
name: c.name,
grade: c.grade,
class: c.class
}))
},
requester: schedule.requester
? {
id: schedule.requester.id,
name: schedule.requester.name,
grade: schedule.requester.grade,
class: schedule.requester.class
}
: null,
playTime: schedule.playTime
? {
id: schedule.playTime.id,
name: schedule.playTime.name,
startTime: schedule.playTime.startTime,
endTime: schedule.playTime.endTime,
enabled: schedule.playTime.enabled
}
: null,
createdAt: schedule.createdAt,
updatedAt: schedule.updatedAt
}
})
const result = {
success: true,
data: {
schedules: formattedSchedules,
pagination: {
page,
limit,
total,
totalPages: Math.ceil(total / limit)
}
}
}
// 将查询结果缓存到CacheService中,供普通API和开放API共享
await cacheService.setSchedulesList(schedulesData)
console.log(`[OpenAPI Cache] 排期数据已缓存到CacheService,数量: ${schedulesData.length}`)
// 可选:也缓存到开放API专用缓存(保留原有逻辑,但优先级较低)
const cacheKey = openApiCache.generateKey('schedules', {
semester,
date,
playTimeId,
search,
page,
limit,
sortBy,
sortOrder
})
await openApiCache.set(cacheKey, result, CACHE_CONSTANTS.DEFAULT_TTL)
return result
} catch (error: any) {
console.error('[Open API] 获取排期列表失败:', error)
if (error.statusCode) {
throw error
} else {
throw createError({
statusCode: 500,
message: '获取排期列表失败'
})
}
}
})