feat: 班级小助手 阶段1-3（monorepo + 后端 REST/Socket.IO + Web 管理端）

packages/server/src/modules/classes/classes.module.ts

@@ -0,0 +1,134 @@
+import { Router } from 'express';
+import { sendCreated, sendOk } from '../../lib/http.js';
+import { idParamSchema } from '../../lib/schemas.js';
+import { authenticate, getAuthUser, requireRole } from '../../middleware/auth.js';
+import { validate, validatedParams, validatedQuery } from '../../middleware/validate.js';
+import { defineModule } from '../module.types.js';
+import {
+  addStudentSchema,
+  assignTeacherSchema,
+  classStudentParamSchema,
+  classTeacherParamSchema,
+  createClassSchema,
+  listClassesQuerySchema,
+  updateClassSchema,
+  type AddStudentInput,
+  type CreateClassInput,
+  type UpdateClassInput,
+} from './classes.schemas.js';
+import * as classService from './classes.service.js';
+
+const router = Router();
+
+// 班级相关接口统一需要登录
+router.use(authenticate());
+
+/** GET /api/classes - 班级列表（教师/管理员：自己管理的班级；学生：自己所在班级） */
+router.get('/', validate({ query: listClassesQuerySchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const { keyword } = validatedQuery<{ keyword?: string }>(req);
+  sendOk(res, await classService.listClasses(user, keyword), '获取班级列表成功');
+});
+
+/** GET /api/classes/:id - 班级详情 */
+router.get('/:id', validate({ params: idParamSchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const { id } = validatedParams<{ id: string }>(req);
+  sendOk(res, await classService.getClassDetail(user, id), '获取班级详情成功');
+});
+
+/** POST /api/classes - 创建班级 */
+router.post('/', requireRole('ADMIN', 'TEACHER'), validate({ body: createClassSchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  sendCreated(res, await classService.createClass(user, req.body as CreateClassInput), '班级创建成功');
+});
+
+/** PATCH /api/classes/:id - 编辑班级 */
+router.patch(
+  '/:id',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema, body: updateClassSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    sendOk(res, await classService.updateClass(user, id, req.body as UpdateClassInput), '班级更新成功');
+  },
+);
+
+/** DELETE /api/classes/:id - 删除班级 */
+router.delete(
+  '/:id',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    await classService.deleteClass(user, id);
+    sendOk(res, { id }, '班级已删除');
+  },
+);
+
+/** GET /api/classes/:id/students - 班级学生名单 */
+router.get('/:id/students', validate({ params: idParamSchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const { id } = validatedParams<{ id: string }>(req);
+  sendOk(res, await classService.listClassStudents(user, id), '获取学生名单成功');
+});
+
+/** POST /api/classes/:id/students - 添加学生（支持已存在账号转入） */
+router.post(
+  '/:id/students',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema, body: addStudentSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    sendCreated(res, await classService.addStudent(user, id, req.body as AddStudentInput), '学生已加入班级');
+  },
+);
+
+/** DELETE /api/classes/:id/students/:userId - 移出学生 */
+router.delete(
+  '/:id/students/:userId',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: classStudentParamSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id, userId } = validatedParams<{ id: string; userId: string }>(req);
+    await classService.removeStudent(user, id, userId);
+    sendOk(res, { classId: id, userId }, '学生已移出班级');
+  },
+);
+
+/** POST /api/classes/:id/teachers - 分配协作教师 */
+router.post(
+  '/:id/teachers',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema, body: assignTeacherSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    const { teacherId } = req.body as { teacherId: string };
+    await classService.assignTeacher(user, id, teacherId);
+    sendCreated(res, { classId: id, teacherId }, '教师已分配');
+  },
+);
+
+/** DELETE /api/classes/:id/teachers/:teacherId - 取消协作教师 */
+router.delete(
+  '/:id/teachers/:teacherId',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: classTeacherParamSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id, teacherId } = validatedParams<{ id: string; teacherId: string }>(req);
+    await classService.removeTeacher(user, id, teacherId);
+    sendOk(res, { classId: id, teacherId }, '已取消教师分配');
+  },
+);
+
+export const classesModule = defineModule({
+  name: 'classes',
+  basePath: '/classes',
+  router,
+});