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

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

@@ -0,0 +1,87 @@
+import { Router } from 'express';
+import { sendCreated, sendOk } from '../../lib/http.js';
+import { idParamSchema } from '../../lib/schemas.js';
+import { resolveCurrentWeek } from '../../lib/term.js';
+import { authenticate, getAuthUser, requireRole } from '../../middleware/auth.js';
+import { validate, validatedParams, validatedQuery } from '../../middleware/validate.js';
+import { defineModule } from '../module.types.js';
+import {
+  createScheduleSchema,
+  gridQuerySchema,
+  listSchedulesQuerySchema,
+  updateScheduleSchema,
+  type CreateScheduleInput,
+  type UpdateScheduleInput,
+} from './schedules.schemas.js';
+import * as scheduleService from './schedules.service.js';
+
+const router = Router();
+router.use(authenticate());
+
+/** GET /api/schedules?classId=&week=&dayOfWeek= - 课表列表 */
+router.get('/', validate({ query: listSchedulesQuerySchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const query = validatedQuery<{ classId?: string; week?: number; dayOfWeek?: number }>(req);
+  sendOk(res, await scheduleService.listSchedules(user, query), '获取课表成功');
+});
+
+/** GET /api/schedules/grid?classId=&week= - 周视图（7 列结构） */
+router.get('/grid', validate({ query: gridQuerySchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const { classId, week } = validatedQuery<{ classId?: string; week?: number }>(req);
+  sendOk(
+    res,
+    await scheduleService.getScheduleGrid(user, { classId, week: week ?? resolveCurrentWeek() }),
+    '获取周视图成功',
+  );
+});
+
+/** POST /api/schedules - 新增课表 */
+router.post(
+  '/',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ body: createScheduleSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    sendCreated(
+      res,
+      await scheduleService.createSchedule(user, req.body as CreateScheduleInput),
+      '课表创建成功',
+    );
+  },
+);
+
+/** PATCH /api/schedules/:id - 修改课表 */
+router.patch(
+  '/:id',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema, body: updateScheduleSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    sendOk(
+      res,
+      await scheduleService.updateSchedule(user, id, req.body as UpdateScheduleInput),
+      '课表更新成功',
+    );
+  },
+);
+
+/** DELETE /api/schedules/:id - 删除课表 */
+router.delete(
+  '/:id',
+  requireRole('ADMIN', 'TEACHER'),
+  validate({ params: idParamSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    await scheduleService.deleteSchedule(user, id);
+    sendOk(res, { id }, '课表已删除');
+  },
+);
+
+export const schedulesModule = defineModule({
+  name: 'schedules',
+  basePath: '/schedules',
+  router,
+});