Files
ClassHelper/packages/server/src/modules/homeworks/homeworks.schemas.ts
T

88 lines
3.7 KiB
TypeScript
Raw Normal View History

import { z } from 'zod';
import { isDayKey } from '@classhelper/shared';
import { attachmentUrlSchema, booleanFlagSchema } from '../../lib/schemas.js';
/** YYYY-MM-DD,且必须是真实存在的日期 */
const dayKeySchema = z
.string()
.trim()
.refine((value) => isDayKey(value), { message: '日期格式应为 YYYY-MM-DD' });
export const listHomeworksQuerySchema = z.object({
classId: z.string().min(1).optional(),
courseId: z.string().min(1).optional(),
/** ClassHelper 班级端:只看未完成 */
pendingOnly: booleanFlagSchema,
keyword: z.string().trim().max(64).optional(),
/** 只看某一天的作业(按 Homework.assignDate,本地日期) */
date: dayKeySchema.optional(),
});
/** 按天查看用:查一段时间内"哪些天有作业"(日期选择器高亮) */
export const listHomeworkDaysQuerySchema = z.object({
classId: z.string().min(1).optional(),
from: dayKeySchema.optional(),
to: dayKeySchema.optional(),
/** 不传 from/to 时回看的天数(默认 60 天) */
days: z.coerce.number().int().min(1).max(366).optional(),
});
export const createHomeworkSchema = z.object({
classId: z.string().min(1, '请选择班级'),
courseId: z.string().min(1).nullish(),
title: z.string().trim().min(1, '请输入作业标题').max(120),
content: z.string().min(1, '请输入作业内容').max(5000),
attachmentUrl: attachmentUrlSchema,
/** 作业所属日期(YYYY-MM-DD):客户端/Web 录入时选,不传按服务器当天 */
assignDate: dayKeySchema.nullish(),
});
/**
* 一次给多个班级布置同一份作业(批量发布)。
*
* 上限 50 个班是刻意设的:逐班串行落库 + 逐班判定科目归属,
* 一批塞几百个班会长时间占住请求。
*/
export const bulkCreateHomeworkSchema = z.object({
classIds: z
.array(z.string().min(1))
.min(1, '请至少选择一个班级')
.max(50, '一次最多发布 50 个班级'),
courseId: z.string().min(1).nullish(),
/** 按科目名称指定(跨班只能用名称:课程是班级内的,同一门课在每个班是不同的记录) */
subjectName: z.string().trim().min(1).max(50).nullish(),
title: z.string().trim().min(1, '请输入作业标题').max(120),
content: z.string().min(1, '请输入作业内容').max(5000),
assignDate: dayKeySchema.nullish(),
attachmentUrl: attachmentUrlSchema,
});
export const updateHomeworkSchema = z.object({
courseId: z.string().min(1).nullish(),
/** 改作业所属日期(把作业挪到另一天) */
assignDate: dayKeySchema.optional(),
title: z.string().trim().min(1).max(120).optional(),
content: z.string().min(1).max(5000).optional(),
attachmentUrl: attachmentUrlSchema,
});
export const updateHomeworkStatusSchema = z.object({
completed: z.boolean(),
/**
* 教师代学生标记时必填(学生不是账号,必须显式指定本班学生);
* ClassHelper 班级端**不要传** —— 它代全班标记。
*/
studentId: z.string().min(1).optional(),
});
/** 保存"未交名单":列出未交的学生 id(其余学生一律标记为已交) */
export const updateHomeworkSubmissionsSchema = z.object({
notSubmittedStudentIds: z.array(z.string().min(1)).max(500).default([]),
});
export type ListHomeworkDaysInput = z.infer<typeof listHomeworkDaysQuerySchema>;
export type CreateHomeworkInput = z.infer<typeof createHomeworkSchema>;
export type BulkCreateHomeworkInput = z.infer<typeof bulkCreateHomeworkSchema>;
export type UpdateHomeworkInput = z.infer<typeof updateHomeworkSchema>;
export type UpdateHomeworkStatusInput = z.infer<typeof updateHomeworkStatusSchema>;
export type UpdateHomeworkSubmissionsInput = z.infer<typeof updateHomeworkSubmissionsSchema>;