## 灵动岛修复与动画优化(用户反馈) - **收回不再出现"方框"闪烁**:卡片改为**固定逻辑尺寸 + 顶部居中锚定**, 窗口只负责露出/裁切透明区域。此前卡片随窗口拉伸,形变过程中会看到被拉扁的圆角方块, 胶囊里的铃铛/文字还会被垂直居中而"从上跳到下";两条问题同源,现已消除。 冒烟用 15 次采样断言卡片尺寸恒为固定值(`396x308` / `260x38`),一旦出现中间值即失败。 - **点击屏幕任意位置收回**:展开态临时 `setFocusable(true)` 并取焦,点到别处即失焦 → 自动回缩为胶囊; 收起后立即释放可聚焦性。断言覆盖 `focusable=true → 失焦后 mode=pill、focusable=false`。 - 动画继续打磨:危险/叫人形态改为**内部光晕**(卡片四周再留 4px 透明边,彻底避免窗口边界裁切出硬边)、 尖角与圆角统一、形态尺寸各异(胶囊 268×44 / 详情 404×316 / 紧急 424×344 / 叫人 440×360)。 ## 灵动岛"标为已读"真正同步通知中心 - 新增链路:灵动岛 `mark-read` → 主进程 `setMarkReadHandler` → 主窗口渲染进程 → `notificationApi.markRead` + 刷新 store(未读红点即时减少)。 - 真机链路断言:点击"标为已读"后 `read=false → true`、未读数 `1 → 0`(此前只从灵动岛队列移除)。 ## 作业发布也上岛 - `homework:new` → 灵动岛 `kind=homework`:胶囊显示"新作业"(青蓝描边 + 书本图标), 展开显示作业说明与"截止时间:…"。 ## 新增"叫人"功能 - 服务端:新模块 `modules/calls`(`POST /api/calls`)——校验班级可写 + 学生属于该班, 落库一条 HIGH 级通知(进通知中心、可用已读状态),广播 `notification:new` 到班级房间, 并定向 `call:new` 给被叫学生。 - 共享层:`CALL_QUICK_PHRASES`(8 条快捷短语)、`buildCallTitle()`("请 XXX 同学找 XXX 老师",老师名已含"老师"不重复)、 `ServerToClientEvents['call:new']`、`CreateCallRequest`。 - Web 管理端:学生管理列表新增 **叫人** 按钮 → 弹窗显示对象、快捷短语(点选/取消)、自定义消息(优先),发送即通知。 - 客户端:`call:new` → 灵动岛 `kind=call`,**上课时段也立即展开**(老师正在等这名学生), 琥珀金卡片 +"叫人"徽标 +"收到"按钮,90 秒后自动收起。 ## 客户端界面改为 ClassIsland 同款 Fluent 风格 - 主题令牌:Mica 浅底 `#f3f3f3`、亚克力卡片 `rgba(255,255,255,.7)` + `backdrop-filter`、 强调色 `#0F6CBD`、半透明描边、卡片 8px / 控件 4px 圆角、极轻阴影。 - Element Plus 变量整体对齐(`--el-color-primary`、圆角、表头/行分隔、滚动条等)。 - 侧边导航改为 Fluent NavigationView 观感:白色半透明底、选中项强调色淡底 + 左侧 3px 强调条; 品牌标改为强调色渐变圆角方块。附客户端五个页面实拍(`docs/screenshots/client/`)。 ## 验证 - `pnpm verify:e2e` **68/68**(新增 6 项叫人:201 + 标题模板、自定义消息优先、上课时段允许、学生 403、通知中心可见、清理) - `pnpm verify:desktop` **33/33**(新增:卡片固定尺寸、点击任意处收回、标为已读同步、作业上岛、叫人上课中立即展开、真实通知链路) - `pnpm verify:web` **16/16**(新增叫人入口:弹窗、8 条快捷短语、自定义输入、短语可选中) - `pnpm lint` / `format:check` / `typecheck` 全部通过;服务端安装包已重打并安装验证
195 lines
8.3 KiB
TypeScript
195 lines
8.3 KiB
TypeScript
import {
|
||
API_PATHS,
|
||
type ClassDetailDto,
|
||
type ClassDto,
|
||
type ClassStatusDto,
|
||
type CourseDto,
|
||
type CreateClassRequest,
|
||
type CreateCallRequest,
|
||
type CreateCourseRequest,
|
||
type CreateGradeRequest,
|
||
type CreateHomeworkRequest,
|
||
type CreateNotificationRequest,
|
||
type CreateScheduleRequest,
|
||
type DashboardSummary,
|
||
type GradeDto,
|
||
type GradeStats,
|
||
type HomeworkDto,
|
||
type LoginRequest,
|
||
type LoginResponse,
|
||
type NotificationDto,
|
||
type ScheduleDto,
|
||
type ScheduleWeekView,
|
||
type StudentDto,
|
||
type UpdateClassRequest,
|
||
type UserDto,
|
||
} from '@classhelper/shared';
|
||
import { api } from './http';
|
||
|
||
/* ------------------------------------------------------------------ 认证 */
|
||
|
||
export const authApi = {
|
||
login: (payload: LoginRequest): Promise<LoginResponse> => api.post(API_PATHS.auth.login, payload),
|
||
logout: (): Promise<{ loggedOut: boolean }> => api.post(API_PATHS.auth.logout, {}),
|
||
me: (): Promise<StudentDto> => api.get(API_PATHS.auth.me),
|
||
changePassword: (payload: {
|
||
currentPassword: string;
|
||
newPassword: string;
|
||
}): Promise<{ changed: boolean }> => api.patch(API_PATHS.auth.changePassword, payload),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 班级 */
|
||
|
||
export const classApi = {
|
||
list: (params?: { keyword?: string }): Promise<ClassDto[]> => api.get(API_PATHS.classes, params),
|
||
detail: (id: string): Promise<ClassDetailDto> => api.get(`${API_PATHS.classes}/${id}`),
|
||
create: (payload: CreateClassRequest): Promise<ClassDto> => api.post(API_PATHS.classes, payload),
|
||
update: (id: string, payload: UpdateClassRequest): Promise<ClassDto> =>
|
||
api.patch(`${API_PATHS.classes}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.classes}/${id}`),
|
||
students: (id: string): Promise<StudentDto[]> => api.get(`${API_PATHS.classes}/${id}/students`),
|
||
addStudent: (
|
||
id: string,
|
||
payload: { username: string; name: string; password?: string },
|
||
): Promise<StudentDto> => api.post(`${API_PATHS.classes}/${id}/students`, payload),
|
||
removeStudent: (id: string, userId: string): Promise<unknown> =>
|
||
api.delete(`${API_PATHS.classes}/${id}/students/${userId}`),
|
||
assignTeacher: (id: string, teacherId: string): Promise<unknown> =>
|
||
api.post(`${API_PATHS.classes}/${id}/teachers`, { teacherId }),
|
||
removeTeacher: (id: string, teacherId: string): Promise<unknown> =>
|
||
api.delete(`${API_PATHS.classes}/${id}/teachers/${teacherId}`),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 课程 */
|
||
|
||
export const courseApi = {
|
||
list: (classId?: string): Promise<CourseDto[]> =>
|
||
api.get(API_PATHS.courses, classId ? { classId } : undefined),
|
||
create: (payload: CreateCourseRequest): Promise<CourseDto> => api.post(API_PATHS.courses, payload),
|
||
update: (id: string, payload: { name: string }): Promise<CourseDto> =>
|
||
api.patch(`${API_PATHS.courses}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.courses}/${id}`),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 课表 */
|
||
|
||
export const scheduleApi = {
|
||
list: (params: { classId?: string; week?: number; dayOfWeek?: number }): Promise<ScheduleDto[]> =>
|
||
api.get(API_PATHS.schedules, params),
|
||
grid: (params: { classId?: string; week?: number }): Promise<ScheduleWeekView> =>
|
||
api.get(`${API_PATHS.schedules}/grid`, params),
|
||
/** 班级当前上课状态:上课时段发布紧急通知时必须先二次确认 */
|
||
classStatus: (classId: string): Promise<ClassStatusDto> =>
|
||
api.get(`${API_PATHS.schedules}/current`, { classId }),
|
||
create: (payload: CreateScheduleRequest): Promise<ScheduleDto> => api.post(API_PATHS.schedules, payload),
|
||
update: (id: string, payload: Partial<CreateScheduleRequest>): Promise<ScheduleDto> =>
|
||
api.patch(`${API_PATHS.schedules}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.schedules}/${id}`),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 作业 */
|
||
|
||
export const homeworkApi = {
|
||
list: (params: {
|
||
classId?: string;
|
||
courseId?: string;
|
||
pendingOnly?: boolean;
|
||
keyword?: string;
|
||
}): Promise<HomeworkDto[]> => api.get(API_PATHS.homeworks, params),
|
||
detail: (id: string): Promise<HomeworkDto> => api.get(`${API_PATHS.homeworks}/${id}`),
|
||
create: (payload: CreateHomeworkRequest): Promise<HomeworkDto> => api.post(API_PATHS.homeworks, payload),
|
||
update: (id: string, payload: Partial<CreateHomeworkRequest>): Promise<HomeworkDto> =>
|
||
api.patch(`${API_PATHS.homeworks}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.homeworks}/${id}`),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 通知 */
|
||
|
||
export const notificationApi = {
|
||
list: (params: {
|
||
classId?: string;
|
||
priority?: string;
|
||
unreadOnly?: boolean;
|
||
keyword?: string;
|
||
}): Promise<NotificationDto[]> => api.get(API_PATHS.notifications, params),
|
||
create: (payload: CreateNotificationRequest): Promise<NotificationDto> =>
|
||
api.post(API_PATHS.notifications, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.notifications}/${id}`),
|
||
unreadCount: (classId?: string): Promise<{ count: number }> =>
|
||
api.get(`${API_PATHS.notifications}/unread-count`, classId ? { classId } : undefined),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 叫人 */
|
||
|
||
export const callApi = {
|
||
/** 点名让学生来找老师(学生端灵动岛会立即弹出"请 XXX 同学找 XXX 老师") */
|
||
create: (payload: CreateCallRequest): Promise<NotificationDto> => api.post(API_PATHS.calls, payload),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 成绩 */
|
||
|
||
export const gradeApi = {
|
||
list: (params: {
|
||
classId?: string;
|
||
courseId?: string;
|
||
userId?: string;
|
||
examName?: string;
|
||
}): Promise<GradeDto[]> => api.get(API_PATHS.grades, params),
|
||
stats: (params: { classId?: string; courseId?: string; examName?: string }): Promise<GradeStats> =>
|
||
api.get(`${API_PATHS.grades}/stats`, params),
|
||
create: (payload: CreateGradeRequest): Promise<GradeDto> => api.post(API_PATHS.grades, payload),
|
||
bulkCreate: (payload: {
|
||
classId: string;
|
||
courseId?: string | null;
|
||
examName: string;
|
||
totalScore?: number;
|
||
publishedAt?: string | null;
|
||
items: Array<{ userId: string; score: number }>;
|
||
}): Promise<{ count: number; items: GradeDto[] }> => api.post(`${API_PATHS.grades}/bulk`, payload),
|
||
update: (id: string, payload: Partial<CreateGradeRequest>): Promise<GradeDto> =>
|
||
api.patch(`${API_PATHS.grades}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.grades}/${id}`),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 学生 */
|
||
|
||
export const studentApi = {
|
||
list: (params?: { classId?: string; keyword?: string }): Promise<StudentDto[]> =>
|
||
api.get(API_PATHS.students, params),
|
||
create: (payload: {
|
||
username: string;
|
||
name: string;
|
||
password?: string;
|
||
classId?: string | null;
|
||
}): Promise<StudentDto> => api.post(API_PATHS.students, payload),
|
||
update: (
|
||
id: string,
|
||
payload: { username?: string; name?: string; classId?: string | null },
|
||
): Promise<StudentDto> => api.patch(`${API_PATHS.students}/${id}`, payload),
|
||
remove: (id: string): Promise<{ id: string }> => api.delete(`${API_PATHS.students}/${id}`),
|
||
resetPassword: (id: string, newPassword?: string): Promise<unknown> =>
|
||
api.post(`${API_PATHS.students}/${id}/reset-password`, newPassword ? { newPassword } : {}),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 仪表盘 */
|
||
|
||
export const dashboardApi = {
|
||
summary: (): Promise<DashboardSummary> => api.get(API_PATHS.dashboard),
|
||
term: (): Promise<{ currentWeek: number; maxWeek: number }> => api.get('/dashboard/term'),
|
||
};
|
||
|
||
/* ------------------------------------------------------------------ 协作教师 */
|
||
|
||
export const teacherApi = {
|
||
list: (keyword?: string): Promise<UserDto[]> =>
|
||
api.get(API_PATHS.teachers, keyword ? { keyword } : undefined),
|
||
create: (payload: {
|
||
username: string;
|
||
name: string;
|
||
password: string;
|
||
role?: 'TEACHER' | 'ADMIN';
|
||
}): Promise<UserDto> => api.post(API_PATHS.teachers, payload),
|
||
/** 班级详情中的 teachers 字段即为已分配的协作教师 */
|
||
fromClass: (classId: string): Promise<ClassDetailDto> => classApi.detail(classId),
|
||
};
|