89 lines
3.8 KiB
TypeScript
89 lines
3.8 KiB
TypeScript
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({
|
|
courseId: z.string().min(1).optional(),
|
|
keyword: z.string().trim().max(64).optional(),
|
|
pendingOnly: booleanFlagSchema,
|
|
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>;
|