feat(courseware,docs): 完善课件传输与岛编辑并统一全仓文档

- 增加课件上传、班级可见范围、设备补收与传输进度
- 整合自定义灵动岛编辑器和相关客户端交互
- 同步三端契约、数据库迁移、部署配置与隔离回归
- 按源码统一文档与官网说明，移除过时任务书和审查记录
- 保持产品版本为 1.4.0

packages/server/src/modules/courseware/courseware.schemas.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { COURSEWARE_MAX_BYTES } from '@classhelper/shared';
+
+export const coursewareScopeSchema = z.object({ classIds: z.array(z.string().min(1).max(100)).max(100) });
+export const coursewareUploadSchema = coursewareScopeSchema
+  .extend({
+    name: z
+      .string()
+      .trim()
+      .min(1)
+      .max(180)
+      .refine(
+        (name) => !/[<>:"/\\|?*\u0000-\u001f]/.test(name) && !name.endsWith('.') && !name.endsWith(' '),
+        '文件名含无效字符',
+      ),
+    size: z.number().int().min(1).max(COURSEWARE_MAX_BYTES),
+    mode: z.enum(['cloud', 'push']),
+  })
+  .refine((input) => input.mode !== 'push' || input.classIds.length > 0, '推送时请选择授课班级');
+export const coursewareUploadQuery = z.object({
+  metadata: z
+    .string()
+    .transform((value, ctx): unknown => {
+      try {
+        return JSON.parse(value);
+      } catch {
+        ctx.addIssue({ code: 'custom', message: '上传信息格式错误' });
+        return z.NEVER;
+      }
+    })
+    .pipe(coursewareUploadSchema),
+});
+export const coursewareDeviceQuery = z.object({ deviceKey: z.string().min(1).max(100) });