feat: 完成 P1 全部功能 + 修复 proxy 导出 + 切换 MySQL 端口至 14013
## P1 功能（20 项） - 站内消息系统、家长仪表盘、学生考勤管理 - Excel 导入导出、用户批量导入、成绩导出 - 排课规则+自动排课+课表调整 - 成绩趋势+对比分析、密码安全策略、速率限制 - 数据变更日志、文件预览+存储策略、全文检索 - 依赖审计集成 CI、数据库定时备份、E2E 测试完善 - 通知偏好管理 ## 基础设施修复 - src/proxy.ts: 将 middleware 导出重命名为 proxy（Next.js 16 要求） - .env: MySQL 端口从 13002 切换至 14013 - scripts/create-db.ts: 新增数据库初始化脚本 ## 架构文档同步 - 004_architecture_impact_map.md 和 005_architecture_data.json 完整记录所有新增表、模块、路由、权限、依赖关系
This commit is contained in:
SpecialX
302
src/modules/scheduling/actions.ts
Normal file
302
src/modules/scheduling/actions.ts
Normal file
@@ -0,0 +1,302 @@
|
||||
"use server"
|
||||
|
||||
import { revalidatePath } from "next/cache"
|
||||
import { eq, or } from "drizzle-orm"
|
||||
import { createId } from "@paralleldrive/cuid2"
|
||||
|
||||
import { requirePermission, PermissionDeniedError } from "@/shared/lib/auth-guard"
|
||||
import { Permissions } from "@/shared/types/permissions"
|
||||
import type { ActionState } from "@/shared/types/action-state"
|
||||
|
||||
import { db } from "@/shared/db"
|
||||
import { classSchedule, users } from "@/shared/db/schema"
|
||||
|
||||
import {
|
||||
getSchedulingRules,
|
||||
upsertSchedulingRules,
|
||||
getScheduleChanges,
|
||||
createScheduleChange,
|
||||
updateScheduleChangeStatus,
|
||||
getClassConflicts,
|
||||
getAdminClassesForScheduling,
|
||||
getTeachersForScheduling,
|
||||
getClassroomsForScheduling,
|
||||
getClassSubjectsForScheduling,
|
||||
} from "./data-access"
|
||||
import { autoSchedule, buildDefaultTimeSlots } from "./auto-scheduler"
|
||||
import {
|
||||
SchedulingRuleSchema,
|
||||
ScheduleChangeSchema,
|
||||
AutoScheduleParamsSchema,
|
||||
} from "./schema"
|
||||
import type {
|
||||
AutoScheduleParams,
|
||||
AutoScheduleResult,
|
||||
ScheduleChangeListItem,
|
||||
ScheduleConflict,
|
||||
ScheduleChangeQueryParams,
|
||||
} from "./types"
|
||||
|
||||
export async function saveSchedulingRulesAction(
|
||||
prevState: ActionState<string> | null,
|
||||
formData: FormData
|
||||
): Promise<ActionState<string>> {
|
||||
try {
|
||||
await requirePermission(Permissions.SCHEDULE_ADJUST)
|
||||
|
||||
const parsed = SchedulingRuleSchema.safeParse({
|
||||
classId: formData.get("classId"),
|
||||
maxDailyHours: formData.get("maxDailyHours") || undefined,
|
||||
maxContinuousHours: formData.get("maxContinuousHours") || undefined,
|
||||
lunchBreakStart: formData.get("lunchBreakStart") || undefined,
|
||||
lunchBreakEnd: formData.get("lunchBreakEnd") || undefined,
|
||||
morningStart: formData.get("morningStart") || undefined,
|
||||
afternoonEnd: formData.get("afternoonEnd") || undefined,
|
||||
avoidBackToBack: formData.get("avoidBackToBack") === "true",
|
||||
balancedSubjects: formData.get("balancedSubjects") === "true",
|
||||
})
|
||||
|
||||
if (!parsed.success) {
|
||||
return {
|
||||
success: false,
|
||||
message: "Invalid form data",
|
||||
errors: parsed.error.flatten().fieldErrors,
|
||||
}
|
||||
}
|
||||
|
||||
const id = await upsertSchedulingRules(parsed.data)
|
||||
revalidatePath("/admin/scheduling/rules")
|
||||
return { success: true, message: "Scheduling rules saved", data: id }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function autoScheduleAction(
|
||||
prevState: ActionState<AutoScheduleResult> | null,
|
||||
formData: FormData
|
||||
): Promise<ActionState<AutoScheduleResult>> {
|
||||
try {
|
||||
await requirePermission(Permissions.SCHEDULE_AUTO)
|
||||
|
||||
const classId = String(formData.get("classId") ?? "").trim()
|
||||
if (!classId) return { success: false, message: "Class is required" }
|
||||
|
||||
// Load rules for class (or global fallback)
|
||||
const rulesRows = await getSchedulingRules(classId)
|
||||
const rules = rulesRows.find((r) => r.classId === classId) ?? rulesRows.find((r) => r.classId === null)
|
||||
if (!rules) return { success: false, message: "No scheduling rules found. Please configure rules first." }
|
||||
|
||||
// Load subjects + teacher assignments for this class
|
||||
const subjectRows = await getClassSubjectsForScheduling(classId)
|
||||
if (subjectRows.length === 0) {
|
||||
return { success: false, message: "No subjects assigned to this class" }
|
||||
}
|
||||
|
||||
// Default weekly hours: 5 per subject (configurable in future)
|
||||
const subjectsInput = subjectRows.map((r) => ({
|
||||
subjectId: r.subjectId,
|
||||
subjectName: r.subjectName,
|
||||
weeklyHours: 5,
|
||||
teacherId: r.teacherId ?? null,
|
||||
}))
|
||||
|
||||
// Load teachers
|
||||
const teacherIds = Array.from(
|
||||
new Set(subjectRows.map((r) => r.teacherId).filter((v): v is string => v !== null))
|
||||
)
|
||||
const teacherRows =
|
||||
teacherIds.length > 0
|
||||
? await db
|
||||
.select({ id: users.id, name: users.name })
|
||||
.from(users)
|
||||
.where(teacherIds.length === 1 ? eq(users.id, teacherIds[0]!) : or(...teacherIds.map((id) => eq(users.id, id))))
|
||||
: []
|
||||
const teachersInput = teacherRows.map((t) => ({ id: t.id, name: t.name ?? "Unknown" }))
|
||||
|
||||
// Load classrooms
|
||||
const classroomRows = await getClassroomsForScheduling()
|
||||
const classroomsInput = classroomRows.map((c) => ({ id: c.id, name: c.name }))
|
||||
|
||||
// Build default time slots: Mon-Fri, 4 morning + 4 afternoon sessions
|
||||
const timeSlots = buildDefaultTimeSlots(rules.morningStart, rules.afternoonEnd, rules.lunchBreakStart, rules.lunchBreakEnd)
|
||||
|
||||
const params: AutoScheduleParams = {
|
||||
classId,
|
||||
rules,
|
||||
subjects: subjectsInput,
|
||||
teachers: teachersInput,
|
||||
classrooms: classroomsInput,
|
||||
timeSlots,
|
||||
}
|
||||
|
||||
const parsed = AutoScheduleParamsSchema.safeParse(params)
|
||||
if (!parsed.success) {
|
||||
return { success: false, message: "Invalid scheduling parameters", errors: parsed.error.flatten().fieldErrors }
|
||||
}
|
||||
|
||||
const result = autoSchedule(params)
|
||||
return { success: true, message: `Scheduled ${result.scheduledCount} sessions, ${result.conflictCount} conflicts`, data: result }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function applyAutoScheduleAction(
|
||||
classId: string,
|
||||
schedules: Array<{
|
||||
weekday: number
|
||||
startTime: string
|
||||
endTime: string
|
||||
course: string
|
||||
location: string | null
|
||||
}>
|
||||
): Promise<ActionState<number>> {
|
||||
try {
|
||||
await requirePermission(Permissions.SCHEDULE_AUTO)
|
||||
|
||||
if (!classId) return { success: false, message: "Class is required" }
|
||||
if (!Array.isArray(schedules) || schedules.length === 0) {
|
||||
return { success: false, message: "No schedules to apply" }
|
||||
}
|
||||
|
||||
// Replace existing schedule for the class
|
||||
await db.transaction(async (tx) => {
|
||||
await tx.delete(classSchedule).where(eq(classSchedule.classId, classId))
|
||||
const rows = schedules.map((s) => ({
|
||||
id: createId(),
|
||||
classId,
|
||||
weekday: s.weekday,
|
||||
startTime: s.startTime,
|
||||
endTime: s.endTime,
|
||||
course: s.course,
|
||||
location: s.location ?? null,
|
||||
}))
|
||||
await tx.insert(classSchedule).values(rows)
|
||||
})
|
||||
|
||||
revalidatePath("/admin/scheduling/auto")
|
||||
revalidatePath("/teacher/classes/schedule")
|
||||
return { success: true, message: `Applied ${schedules.length} schedule items`, data: schedules.length }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function requestScheduleChangeAction(
|
||||
prevState: ActionState<string> | null,
|
||||
formData: FormData
|
||||
): Promise<ActionState<string>> {
|
||||
try {
|
||||
const ctx = await requirePermission(Permissions.SCHEDULE_ADJUST)
|
||||
|
||||
const parsed = ScheduleChangeSchema.safeParse({
|
||||
classId: formData.get("classId"),
|
||||
originalScheduleId: formData.get("originalScheduleId") || undefined,
|
||||
originalTeacherId: formData.get("originalTeacherId") || undefined,
|
||||
substituteTeacherId: formData.get("substituteTeacherId") || undefined,
|
||||
originalDate: formData.get("originalDate") || undefined,
|
||||
newDate: formData.get("newDate") || undefined,
|
||||
newStartTime: formData.get("newStartTime") || undefined,
|
||||
newEndTime: formData.get("newEndTime") || undefined,
|
||||
reason: formData.get("reason"),
|
||||
})
|
||||
|
||||
if (!parsed.success) {
|
||||
return {
|
||||
success: false,
|
||||
message: "Invalid form data",
|
||||
errors: parsed.error.flatten().fieldErrors,
|
||||
}
|
||||
}
|
||||
|
||||
const id = await createScheduleChange(parsed.data, ctx.userId)
|
||||
revalidatePath("/teacher/schedule-changes")
|
||||
revalidatePath("/admin/scheduling/changes")
|
||||
return { success: true, message: "Schedule change request submitted", data: id }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function approveScheduleChangeAction(changeId: string): Promise<ActionState> {
|
||||
try {
|
||||
const ctx = await requirePermission(Permissions.SCHEDULE_AUTO)
|
||||
if (!changeId) return { success: false, message: "Missing change id" }
|
||||
|
||||
await updateScheduleChangeStatus(changeId, "approved", ctx.userId)
|
||||
revalidatePath("/admin/scheduling/changes")
|
||||
revalidatePath("/teacher/schedule-changes")
|
||||
return { success: true, message: "Schedule change approved" }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function rejectScheduleChangeAction(
|
||||
changeId: string,
|
||||
reason?: string
|
||||
): Promise<ActionState> {
|
||||
try {
|
||||
const ctx = await requirePermission(Permissions.SCHEDULE_AUTO)
|
||||
if (!changeId) return { success: false, message: "Missing change id" }
|
||||
|
||||
await updateScheduleChangeStatus(changeId, "rejected", ctx.userId)
|
||||
revalidatePath("/admin/scheduling/changes")
|
||||
revalidatePath("/teacher/schedule-changes")
|
||||
return { success: true, message: reason ? `Rejected: ${reason}` : "Schedule change rejected" }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function getScheduleChangesAction(
|
||||
params: ScheduleChangeQueryParams
|
||||
): Promise<ActionState<ScheduleChangeListItem[]>> {
|
||||
try {
|
||||
await requirePermission(Permissions.SCHEDULE_ADJUST)
|
||||
const items = await getScheduleChanges(params)
|
||||
return { success: true, data: items }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
export async function getClassConflictsAction(
|
||||
classId: string
|
||||
): Promise<ActionState<ScheduleConflict[]>> {
|
||||
try {
|
||||
await requirePermission(Permissions.SCHEDULE_ADJUST)
|
||||
if (!classId) return { success: false, message: "Class is required" }
|
||||
const conflicts = await getClassConflicts(classId)
|
||||
return { success: true, data: conflicts }
|
||||
} catch (e) {
|
||||
if (e instanceof PermissionDeniedError) return { success: false, message: e.message }
|
||||
if (e instanceof Error) return { success: false, message: e.message }
|
||||
return { success: false, message: "Unexpected error" }
|
||||
}
|
||||
}
|
||||
|
||||
// Re-export data-access for server pages
|
||||
export {
|
||||
getSchedulingRules,
|
||||
getScheduleChanges,
|
||||
getClassConflicts,
|
||||
getAdminClassesForScheduling,
|
||||
getTeachersForScheduling,
|
||||
getClassroomsForScheduling,
|
||||
}
|
||||
Reference in New Issue
Block a user