LoveChengke
11008928a1
一、灵动岛
- ①「紧急通知后来了新作业，收起再点开不了新作业」根因有二，都已修：
(a) active 仍是紧急那条，点击只会反复打开它 —— 现在点击胶囊优先打开**最新**那条未处理消息（队列里更晚的）；
(b) 上课时段 syncWindow 会把普通通知立刻隐藏（表现为点了没反应）—— 新增 explicitShowId，
"用户主动点开"的那条守卫放行（岛完全隐藏时仍严格不打扰）。
冒烟新增「紧急通知后来了新作业：收起再点击打开的是新作业（联合通知回归）」。
- ② 设置实时预览/保存：补「设置页真实链路」断言（window.desktop.islandSetAppearance → IPC → 主进程 →
渲染进程 CSS 变量 + 窗口尺寸），并断言"岛显示中改尺寸立即生效"（实测均通过）。
- ③ 未读红点移到「通知」图标右上角（此前在文字后面），并加 DOM 几何断言（dx>0 且 dy<0，
没有未读时自动造一条未读通知再断言、断言后删除）。
- 冒烟稳定性：新增 island.setBlurCollapseEnabled()（默认开），测试期间关掉"失焦收起"，
避免系统抢焦点导致展开态被收回的随机失败；专门验证失焦的用例仍临时打开。
二、作业看板（学生端）
- ⑥ 只看当天：新增「只看今天」开关（默认开），按 createdAt 的本地日期过滤，昨天的过期作业不再混入。
- ⑧ 完整显示：卡片同时渲染标题 + 作业要求全文（列表模式也加「作业要求」列）。
- ⑨ 铺满不滚动：看板外层高度固定 + overflow hidden，按内容/可用高度算缩放系数用 transform: scale 适配
（工具栏显示当前缩放比例），页面本身不出现滚动条。
- ⑦ 全屏看板标题栏用 #header 插槽：标题左对齐、当天日期时间绝对居中（受「显示时间」开关控制，每分钟刷新）。
三、课表与周数
- ⑤ 学期周数可调：新增 Class.termWeeks（默认 20，迁移 + 维护脚本），班主任在班级管理里改；
GET /api/dashboard/term?classId= 返回该班 maxWeek，课表周次下拉与新建课表的默认 weekEnd 都按它来
（不再固定 30 周）。
- ⑩ 课表管理只保留「导入 ClassIsland 课程表」入口（时间表由课程表 JSON 的 TimeLayouts 一并带入），
「导入时间配置」按钮下线；ui-smoke 第 7.7 段改为断言新弹窗（解析 4 行 + 单双周标签 + 旧入口已下线）。
四、以班级为单位（⑬）与 Web 端
- 个人学生账号登录停用：POST /api/auth/login 对 role=STUDENT 返回 403（改用班级码 + 班级密码）；
学生行仍作为个人数据记录键由班级会话代全班读写；e2e 全面切换到班级会话并新增该断言。
- ④ 作业科目过少：新增共享 SUBJECT_CATALOG（16 个常见科目）+ 种子课程扩到全科目；
Web 作业发布弹窗可选「其他科目（新建）」，提交前自动建课（同名复用）。
- ⑪ 通知支持多班批量发布（多选 + 逐班发布 + 汇总结果 + 二次确认覆盖所有选中班）；
⑫ 单班只显示已读情况、跨班才显示已读率；⑭ 手机端课表可横向滚动看全 7 天；
⑮ 手机端已连接不再显示孤立绿点（仅未连接时显示文字标签）；⑯ 手机端「叫人/发布通知」按钮同宽左对齐；
⑬ Web 学生管理去掉「用户名」列（新建自动生成学号式用户名，导入仍支持显式指定）。
验证：verify:e2e 149/149、verify:web 20/20、verify:desktop 75/75（复跑 68/68，打包便携版 75/75 packaged=true）、
typecheck / lint / format 全绿；服务端与 Web 已重新打包并部署到本机安装目录。
73 lines
3.2 KiB
TypeScript
73 lines
3.2 KiB
TypeScript
import {
|
|
API_PATHS,
|
|
type ClassDetailDto,
|
|
type ClassDto,
|
|
type DashboardSummary,
|
|
type GradeDto,
|
|
type HomeworkDto,
|
|
type HomeworkStatusDto,
|
|
type HomeworkSubmissionsDto,
|
|
type LoginRequest,
|
|
type LoginResponse,
|
|
type NotificationDto,
|
|
type ScheduleDto,
|
|
type ScheduleWeekView,
|
|
type StudentDto,
|
|
} from '@classhelper/shared';
|
|
import { api } from './http.js';
|
|
|
|
/** 客户端只需用到学生视角的这批接口（与后端同一套 REST 契约） */
|
|
export const authApi = {
|
|
/** 个人账号登录（教师/管理员/个人学生；客户端界面已不再展示，保留以兼容旧流程与排障） */
|
|
login: (payload: LoginRequest): Promise<LoginResponse> => api.post(API_PATHS.auth.login, payload),
|
|
/** 班级账号登录（学生端主入口）：班级码 + 班级密码 */
|
|
classLogin: (payload: { code: string; password: string }): Promise<LoginResponse> =>
|
|
api.post('/auth/class-login', payload),
|
|
logout: (): Promise<{ loggedOut: boolean }> => api.post(API_PATHS.auth.logout, {}),
|
|
me: (): Promise<StudentDto> => api.get(API_PATHS.auth.me),
|
|
};
|
|
|
|
export const classApi = {
|
|
list: (): Promise<ClassDto[]> => api.get(API_PATHS.classes),
|
|
detail: (id: string): Promise<ClassDetailDto> => api.get(`${API_PATHS.classes}/${id}`),
|
|
};
|
|
|
|
export const scheduleApi = {
|
|
list: (params: { classId?: string; week?: number }): Promise<ScheduleDto[]> =>
|
|
api.get(API_PATHS.schedules, params),
|
|
grid: (params: { classId?: string; week?: number }): Promise<ScheduleWeekView> =>
|
|
api.get(`${API_PATHS.schedules}/grid`, params),
|
|
};
|
|
|
|
export const homeworkApi = {
|
|
list: (params?: { classId?: string; pendingOnly?: boolean; courseId?: string }): Promise<HomeworkDto[]> =>
|
|
api.get(API_PATHS.homeworks, params),
|
|
detail: (id: string): Promise<HomeworkDto> => api.get(`${API_PATHS.homeworks}/${id}`),
|
|
updateStatus: (id: string, completed: boolean): Promise<HomeworkStatusDto> =>
|
|
api.patch(`${API_PATHS.homeworks}/${id}/status`, { completed }),
|
|
/** 提交名单 / 未交名单（教师与班级设备可用） */
|
|
submissions: (id: string): Promise<HomeworkSubmissionsDto> =>
|
|
api.get(`${API_PATHS.homeworks}/${id}/submissions`),
|
|
saveSubmissions: (id: string, notSubmittedUserIds: string[]): Promise<HomeworkSubmissionsDto> =>
|
|
api.patch(`${API_PATHS.homeworks}/${id}/submissions`, { notSubmittedUserIds }),
|
|
};
|
|
|
|
export const notificationApi = {
|
|
list: (params?: { classId?: string; unreadOnly?: boolean }): Promise<NotificationDto[]> =>
|
|
api.get(API_PATHS.notifications, params),
|
|
unreadCount: (): Promise<{ count: number }> => api.get(`${API_PATHS.notifications}/unread-count`),
|
|
markRead: (id: string): Promise<{ notificationId: string; readAt: string }> =>
|
|
api.post(`${API_PATHS.notifications}/${id}/read`, {}),
|
|
markAllRead: (): Promise<{ marked: number }> => api.post(`${API_PATHS.notifications}/read-all`, {}),
|
|
};
|
|
|
|
export const gradeApi = {
|
|
my: (): Promise<GradeDto[]> => api.get(`${API_PATHS.grades}/my`),
|
|
};
|
|
|
|
export const dashboardApi = {
|
|
summary: (): Promise<DashboardSummary> => api.get(API_PATHS.dashboard),
|
|
term: (classId?: string): Promise<{ currentWeek: number; maxWeek: number }> =>
|
|
api.get('/dashboard/term', classId ? { classId } : undefined),
|
|
};
|