refactor(modules): update existing module implementations across attendance, audit, auth, classes, course-plans, exams, files, homework, layout, proctoring, questions, scheduling, textbooks, users

- Update attendance components and data-access for record management

- Update audit log views, filters, and data-access

- Update auth login and register forms

- Update classes actions, components, and data-access (admin, schedule, stats)

- Update course-plans actions, form, list, progress, and schema

- Update exams actions, AI pipeline, preview components, and hooks

- Update files components (icon, list, preview, upload) and data-access

- Update homework assignment form, review view, auto-save hook, and stats-service

- Update layout sidebar, header, and navigation config

- Update proctoring actions, anti-cheat monitor, and data-access

- Update questions actions, components (dialog, actions, columns, filters), and data-access

- Update scheduling actions, auto-scheduler, components, and schema

- Update textbooks constants and text-selection hook

- Update users class-registration, import-dialog, data-access, and user-service

src/modules/classes/data-access.ts

@@ -402,6 +402,28 @@ export const getClassesByGradeId = async (gradeId: string): Promise<Array<{ id:
   return rows.map((r) => ({ id: r.id, name: r.name }))
 }
 
+/**
+ * 获取多个年级下的所有班级 ID（供 grades 模块 grade_managed scope 过滤使用）。
+ * 供跨模块调用使用，避免直接查询 classes 表。
+ */
+export const getClassIdsByGradeIds = async (gradeIds: string[]): Promise<string[]> => {
+  const uniqueIds = Array.from(new Set(gradeIds.filter((v): v is string => typeof v === "string" && v.length > 0)))
+  if (uniqueIds.length === 0) return []
+  const rows = await db
+    .select({ id: classes.id })
+    .from(classes)
+    .where(inArray(classes.gradeId, uniqueIds))
+  return rows.map((r) => r.id)
+}
+
+/**
+ * 构建一个 Drizzle 子查询 SQL，用于过滤 classId IN (SELECT id FROM classes WHERE grade_id IN (...))。
+ * 供 grades 模块 grade_managed scope 同步构建 SQL 过滤条件使用，避免直接查询 classes 表。
+ */
+export const getClassIdsByGradeIdsSubquery = (gradeIds: string[]) => {
+  return db.select({ id: classes.id }).from(classes).where(inArray(classes.gradeId, gradeIds))
+}
+
 export const getTeacherClasses = cache(async (params?: { teacherId?: string }): Promise<TeacherClass[]> => {
   const teacherId = params?.teacherId ?? (await getSessionTeacherId())
   if (!teacherId) return []