2026-09-11 21:57:38 +08:00
|
|
|
|
import { z } from 'zod';
|
2026-10-02 00:25:04 +08:00
|
|
|
|
import { CLASSISLAND_NOTIFICATION_CHANNELS, MAX_TERM_WEEK } from '@classhelper/shared';
|
2026-09-11 21:57:38 +08:00
|
|
|
|
import { keywordSchema } from '../../lib/schemas.js';
|
|
|
|
|
|
|
|
|
|
|
|
export const createClassSchema = z.object({
|
|
|
|
|
|
name: z.string().trim().min(1, '请输入班级名称').max(64),
|
|
|
|
|
|
grade: z.string().trim().min(1, '请输入年级').max(32),
|
|
|
|
|
|
/** 仅管理员可指定班主任,教师创建时固定为自己 */
|
|
|
|
|
|
teacherId: z.string().min(1).optional(),
|
2026-09-12 15:51:08 +08:00
|
|
|
|
/** 可选:自定义班级码(学生端班级账号登录用),留空自动生成 */
|
|
|
|
|
|
code: z
|
|
|
|
|
|
.string()
|
|
|
|
|
|
.trim()
|
|
|
|
|
|
.regex(/^[A-Za-z0-9]{4,16}$/, '班级码需为 4~16 位字母或数字')
|
|
|
|
|
|
.optional(),
|
2026-10-02 00:25:04 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 本学期教学周数。上限与课表周次口径统一取 MAX_TERM_WEEK(30):
|
|
|
|
|
|
* 周次选择器与 weekNumberSchema 都只到 30,允许更大的值只会让用户设出一个
|
|
|
|
|
|
* 系统兑现不了的学期长度(第 31 周之后永远为空)。
|
|
|
|
|
|
*/
|
|
|
|
|
|
termWeeks: z.coerce.number().int().min(1).max(MAX_TERM_WEEK).optional(),
|
2026-09-11 21:57:38 +08:00
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
export const updateClassSchema = z.object({
|
|
|
|
|
|
name: z.string().trim().min(1).max(64).optional(),
|
|
|
|
|
|
grade: z.string().trim().min(1).max(32).optional(),
|
2026-10-02 00:25:04 +08:00
|
|
|
|
/** 本学期教学周数(1~30,管理员可调) */
|
|
|
|
|
|
termWeeks: z.coerce.number().int().min(1).max(MAX_TERM_WEEK).optional(),
|
2026-09-11 21:57:38 +08:00
|
|
|
|
});
|
|
|
|
|
|
|
2026-09-12 15:51:08 +08:00
|
|
|
|
/** 设置 / 重置班级账号(班级码 + 班级密码):仅管理员 */
|
|
|
|
|
|
export const updateClassAccountSchema = z
|
|
|
|
|
|
.object({
|
|
|
|
|
|
code: z
|
|
|
|
|
|
.string()
|
|
|
|
|
|
.trim()
|
|
|
|
|
|
.regex(/^[A-Za-z0-9]{4,16}$/, '班级码需为 4~16 位字母或数字')
|
|
|
|
|
|
.optional(),
|
|
|
|
|
|
password: z.string().min(6, '班级密码至少 6 位').max(64).optional(),
|
|
|
|
|
|
})
|
|
|
|
|
|
.refine((value) => value.code !== undefined || value.password !== undefined, {
|
|
|
|
|
|
message: '请至少填写班级码或班级密码中的一项',
|
|
|
|
|
|
});
|
|
|
|
|
|
|
2026-09-11 21:57:38 +08:00
|
|
|
|
export const listClassesQuerySchema = z.object({
|
|
|
|
|
|
keyword: keywordSchema,
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
export const addStudentSchema = z.object({
|
|
|
|
|
|
username: z.string().trim().min(3, '用户名至少 3 位').max(32),
|
|
|
|
|
|
name: z.string().trim().min(1, '请输入姓名').max(32),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
export const assignTeacherSchema = z.object({
|
|
|
|
|
|
teacherId: z.string().min(1, '请选择教师'),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
2026-09-13 10:34:46 +08:00
|
|
|
|
/** 设置 / 更改班主任(仅管理员) */
|
|
|
|
|
|
export const assignHeadTeacherSchema = z.object({
|
|
|
|
|
|
teacherId: z.string().min(1, '请选择班主任'),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
2026-09-27 14:59:12 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 通知显示位置(both / client / classisland)。
|
|
|
|
|
|
* 由**教室的班级客户端**在设置页里改,教师/管理员也可以在 Web 端改。
|
|
|
|
|
|
*/
|
|
|
|
|
|
export const updateNotificationChannelSchema = z.object({
|
|
|
|
|
|
notificationChannel: z.enum(
|
|
|
|
|
|
CLASSISLAND_NOTIFICATION_CHANNELS as unknown as [string, ...string[]],
|
|
|
|
|
|
{ message: '显示位置只能是 both / client / classisland' },
|
|
|
|
|
|
),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
2026-09-11 21:57:38 +08:00
|
|
|
|
export const classStudentParamSchema = z.object({
|
|
|
|
|
|
id: z.string().min(1),
|
|
|
|
|
|
userId: z.string().min(1),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
export const classTeacherParamSchema = z.object({
|
|
|
|
|
|
id: z.string().min(1),
|
|
|
|
|
|
teacherId: z.string().min(1),
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
export type CreateClassInput = z.infer<typeof createClassSchema>;
|
|
|
|
|
|
export type UpdateClassInput = z.infer<typeof updateClassSchema>;
|
2026-09-12 15:51:08 +08:00
|
|
|
|
export type UpdateClassAccountInput = z.infer<typeof updateClassAccountSchema>;
|
2026-09-27 14:59:12 +08:00
|
|
|
|
export type UpdateNotificationChannelInput = z.infer<typeof updateNotificationChannelSchema>;
|
2026-09-11 21:57:38 +08:00
|
|
|
|
export type AddStudentInput = z.infer<typeof addStudentSchema>;
|