2026-10-17 09:32:52 +08:00
|
|
|
import type { ClassPeriod as ContractClassPeriod } from './types.js';
|
2026-10-25 16:41:29 +08:00
|
|
|
import type { CourseBrief, ScheduleDto } from './types.js';
|
2026-10-17 09:32:52 +08:00
|
|
|
|
|
|
|
|
export const TIME_POINT_TYPES = ['LESSON', 'BREAK', 'DIVIDER', 'ACTION'] as const;
|
|
|
|
|
export type TimePointType = (typeof TIME_POINT_TYPES)[number];
|
|
|
|
|
export interface TimePointDto {
|
|
|
|
|
id: string;
|
|
|
|
|
position: number;
|
|
|
|
|
name: string;
|
|
|
|
|
startTime: string;
|
|
|
|
|
endTime: string;
|
|
|
|
|
timeType: TimePointType;
|
|
|
|
|
isHideDefault: boolean;
|
|
|
|
|
defaultClassId: string | null;
|
2026-10-25 16:41:29 +08:00
|
|
|
/** 服务端投影出的默认课程;日课表没有单独条目时用它回退。 */
|
|
|
|
|
defaultCourse?: CourseBrief | null;
|
2026-10-17 09:32:52 +08:00
|
|
|
breakName: string;
|
|
|
|
|
actionSet: string;
|
|
|
|
|
}
|
|
|
|
|
export interface TimeLayoutDetailDto {
|
|
|
|
|
id: string;
|
|
|
|
|
name: string;
|
|
|
|
|
classId: string | null;
|
|
|
|
|
points: TimePointDto[];
|
|
|
|
|
}
|
|
|
|
|
export interface DailyPlanEntryDto {
|
|
|
|
|
id: string;
|
|
|
|
|
timeLayoutItemId: string;
|
|
|
|
|
courseId: string | null;
|
2026-10-25 16:41:29 +08:00
|
|
|
/** 服务端 include 的课程摘要;课表页据此显示科目。 */
|
|
|
|
|
course?: CourseBrief | null;
|
2026-10-17 09:32:52 +08:00
|
|
|
isEnabled: boolean;
|
|
|
|
|
isChangedClass: boolean;
|
|
|
|
|
location: string | null;
|
|
|
|
|
}
|
|
|
|
|
export interface ClassPlanDto {
|
|
|
|
|
id: string;
|
|
|
|
|
classId: string;
|
|
|
|
|
name: string;
|
|
|
|
|
timeLayoutId: string;
|
|
|
|
|
associatedGroup: string | null;
|
|
|
|
|
weekday: number;
|
|
|
|
|
weekCountDiv: number;
|
|
|
|
|
weekCountDivTotal: number;
|
|
|
|
|
weekStart: number;
|
|
|
|
|
weekEnd: number;
|
|
|
|
|
isEnabled: boolean;
|
|
|
|
|
isOverlay: boolean;
|
|
|
|
|
overlaySourceId: string | null;
|
|
|
|
|
entries: DailyPlanEntryDto[];
|
|
|
|
|
}
|
|
|
|
|
export interface ActiveClassPlanDto {
|
|
|
|
|
classPlan: ClassPlanDto | null;
|
|
|
|
|
timeLayout: TimeLayoutDetailDto | null;
|
|
|
|
|
schedules: ScheduleDto[];
|
|
|
|
|
current: ContractClassPeriod | null;
|
|
|
|
|
next: ContractClassPeriod | null;
|
|
|
|
|
inClass: boolean;
|
|
|
|
|
week: number;
|
|
|
|
|
}
|
|
|
|
|
export interface ActiveClassPlanWeekDto {
|
|
|
|
|
classId: string;
|
|
|
|
|
week: number;
|
|
|
|
|
days: Array<ActiveClassPlanDto & { weekday: number; date: string }>;
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-25 16:41:29 +08:00
|
|
|
/**
|
|
|
|
|
* 灵动岛当天时间点。
|
|
|
|
|
*
|
|
|
|
|
* 自定义常驻岛的「课程表」组件按它渲染 ClassIsland 主界面式的折叠/展开时间点:
|
|
|
|
|
* 上课点折叠只显示课程名,当前点展开显示时间段;课间休息与默认隐藏的时间点只在轮到时出现。
|
|
|
|
|
*/
|
|
|
|
|
export interface IslandTimePointDto {
|
|
|
|
|
id: string;
|
|
|
|
|
timeType: TimePointType;
|
|
|
|
|
/** 课间用 breakName,上课用时间点名称 */
|
|
|
|
|
name: string;
|
|
|
|
|
courseName: string | null;
|
|
|
|
|
/** HH:mm */
|
|
|
|
|
startTime: string;
|
|
|
|
|
/** HH:mm */
|
|
|
|
|
endTime: string;
|
|
|
|
|
isHideDefault: boolean;
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-17 09:32:52 +08:00
|
|
|
/** 设置来自服务端;离线/未初始化时统一回落 30。 */
|
|
|
|
|
export function getMaxTermWeeks(configured?: unknown): number {
|
|
|
|
|
const value = Number(configured);
|
|
|
|
|
return Number.isInteger(value) && value >= 1 && value <= 60 ? value : 30;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export type PermissionScope = 'SELF_CLASS' | 'GRADE' | 'DIVISION' | 'ALL';
|
|
|
|
|
export interface ReleaseProgressDto {
|
|
|
|
|
version: string;
|
|
|
|
|
stage: 'idle' | 'downloading' | 'verifying' | 'ready' | 'waiting' | 'installing' | 'failed';
|
|
|
|
|
downloadedBytes: number;
|
|
|
|
|
totalBytes: number;
|
|
|
|
|
percent: number | null;
|
|
|
|
|
error: string;
|
|
|
|
|
}
|
2026-10-18 17:39:54 +08:00
|
|
|
/** 设备上报状态与服务端缓存安装包的下载状态分开。 */
|
|
|
|
|
export interface ClientUpdateProgressDto extends Omit<ReleaseProgressDto, 'stage'> {
|
|
|
|
|
stage: ReleaseProgressDto['stage'] | 'completed';
|
|
|
|
|
updatedAt?: string;
|
|
|
|
|
}
|
2026-10-17 09:32:52 +08:00
|
|
|
export interface CollectiveGradeAnalysisDto {
|
|
|
|
|
mode: 'collective';
|
|
|
|
|
classId: string;
|
|
|
|
|
suppressed: boolean;
|
|
|
|
|
averagePercent: number | null;
|
|
|
|
|
passRate: number | null;
|
|
|
|
|
excellentRate: number | null;
|
|
|
|
|
subjects: { name: string; averagePercent: number | null }[];
|
|
|
|
|
distribution: { label: string; count: number | null }[];
|
|
|
|
|
trend: { examName: string; averagePercent: number | null }[];
|
|
|
|
|
}
|