feat: 班级小助手 阶段1-3（monorepo + 后端 REST/Socket.IO + Web 管理端）
This commit is contained in:
LoveChengke committed
commit
84ab49de10
102 files changed
+14751
No files matched your search
@@ -0,0 +1,209 @@
|
||||
import { WEEKDAY_LABELS, WEEKDAYS } from './constants.js';
|
||||
import type { GradeLevel, ScheduleDto, ScheduleWeekView } from './types.js';
|
||||
|
||||
/* ------------------------------------------------------------------ 日期时间 */
|
||||
|
||||
export function toDate(value: string | number | Date): Date {
|
||||
return value instanceof Date ? value : new Date(value);
|
||||
}
|
||||
|
||||
function pad(input: number): string {
|
||||
return input < 10 ? `0${input}` : String(input);
|
||||
}
|
||||
|
||||
/** 格式化为 YYYY-MM-DD，withTime=true 时追加 HH:mm */
|
||||
export function formatDate(value: string | number | Date | null | undefined, withTime = false): string {
|
||||
if (value === null || value === undefined || value === '') return '';
|
||||
const date = toDate(value);
|
||||
if (Number.isNaN(date.getTime())) return '';
|
||||
const day = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
|
||||
return withTime ? `${day} ${pad(date.getHours())}:${pad(date.getMinutes())}` : day;
|
||||
}
|
||||
|
||||
export function formatTime(value: string | number | Date | null | undefined): string {
|
||||
if (value === null || value === undefined || value === '') return '';
|
||||
const date = toDate(value);
|
||||
if (Number.isNaN(date.getTime())) return '';
|
||||
return `${pad(date.getHours())}:${pad(date.getMinutes())}`;
|
||||
}
|
||||
|
||||
/** 周几，1=周一 ... 7=周日 */
|
||||
export function weekdayOf(value: string | number | Date): number {
|
||||
const day = toDate(value).getDay();
|
||||
return day === 0 ? 7 : day;
|
||||
}
|
||||
|
||||
/** ISO 周次（与学期周次解耦，仅用于展示当前自然周） */
|
||||
export function getIsoWeek(value: string | number | Date): number {
|
||||
const date = toDate(value);
|
||||
const target = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
|
||||
const dayNumber = target.getUTCDay() || 7;
|
||||
target.setUTCDate(target.getUTCDate() + 4 - dayNumber);
|
||||
const yearStart = new Date(Date.UTC(target.getUTCFullYear(), 0, 1));
|
||||
return Math.ceil(((target.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
|
||||
}
|
||||
|
||||
/** 相对时间描述，例如"3 分钟前" */
|
||||
export function relativeTime(value: string | number | Date, now: Date = new Date()): string {
|
||||
const date = toDate(value);
|
||||
if (Number.isNaN(date.getTime())) return '';
|
||||
const diffSeconds = Math.floor((now.getTime() - date.getTime()) / 1000);
|
||||
if (diffSeconds < 60) return '刚刚';
|
||||
const minutes = Math.floor(diffSeconds / 60);
|
||||
if (minutes < 60) return `${minutes} 分钟前`;
|
||||
const hours = Math.floor(minutes / 60);
|
||||
if (hours < 24) return `${hours} 小时前`;
|
||||
const days = Math.floor(hours / 24);
|
||||
if (days < 30) return `${days} 天前`;
|
||||
return formatDate(date);
|
||||
}
|
||||
|
||||
/* ------------------------------------------------------------------ 课表 */
|
||||
|
||||
/** 判断某个课表条目在第 week 周是否上课 */
|
||||
export function isScheduleActiveInWeek(
|
||||
schedule: Pick<ScheduleDto, 'weekStart' | 'weekEnd'>,
|
||||
week: number,
|
||||
): boolean {
|
||||
return week >= schedule.weekStart && week <= schedule.weekEnd;
|
||||
}
|
||||
|
||||
/** 格式化周次范围，例如"1-20 周" / "单周" */
|
||||
export function formatWeekRange(weekStart: number, weekEnd: number): string {
|
||||
if (weekStart === weekEnd) return `第 ${weekStart} 周`;
|
||||
return `${weekStart}-${weekEnd} 周`;
|
||||
}
|
||||
|
||||
/** 按时间排序（HH:mm 字符串可直接字典序比较） */
|
||||
export function sortScheduleByTime<T extends Pick<ScheduleDto, 'dayOfWeek' | 'startTime'>>(items: T[]): T[] {
|
||||
return [...items].sort((a, b) =>
|
||||
a.dayOfWeek === b.dayOfWeek ? a.startTime.localeCompare(b.startTime) : a.dayOfWeek - b.dayOfWeek,
|
||||
);
|
||||
}
|
||||
|
||||
/** 组装周视图：7 列固定输出，便于前端直接渲染 */
|
||||
export function buildScheduleWeekView(items: ScheduleDto[], week: number): ScheduleWeekView {
|
||||
const active = sortScheduleByTime(items.filter((item) => isScheduleActiveInWeek(item, week)));
|
||||
return {
|
||||
week,
|
||||
columns: WEEKDAYS.map((dayOfWeek) => ({
|
||||
dayOfWeek,
|
||||
label: WEEKDAY_LABELS[dayOfWeek] ?? `周${dayOfWeek}`,
|
||||
items: active.filter((item) => item.dayOfWeek === dayOfWeek),
|
||||
})),
|
||||
};
|
||||
}
|
||||
|
||||
/** 计算两个 HH:mm 之间的时长（分钟），非法输入返回 0 */
|
||||
export function durationMinutes(startTime: string, endTime: string): number {
|
||||
const [sh, sm] = startTime.split(':').map(Number);
|
||||
const [eh, em] = endTime.split(':').map(Number);
|
||||
if ([sh, sm, eh, em].some((n) => Number.isNaN(n))) return 0;
|
||||
return (eh as number) * 60 + (em as number) - ((sh as number) * 60 + (sm as number));
|
||||
}
|
||||
|
||||
/* ------------------------------------------------------------------ 作业 */
|
||||
|
||||
/** 是否已过截止时间 */
|
||||
export function isOverdue(dueAt: string | null | undefined, now: Date = new Date()): boolean {
|
||||
if (!dueAt) return false;
|
||||
const due = toDate(dueAt);
|
||||
return !Number.isNaN(due.getTime()) && due.getTime() < now.getTime();
|
||||
}
|
||||
|
||||
/** 距离截止时间的可读描述，例如"还剩 2 天"、"已逾期 3 小时" */
|
||||
export function formatDeadline(dueAt: string | null | undefined, now: Date = new Date()): string {
|
||||
if (!dueAt) return '无截止时间';
|
||||
const due = toDate(dueAt);
|
||||
if (Number.isNaN(due.getTime())) return '无截止时间';
|
||||
const diffMinutes = Math.round((due.getTime() - now.getTime()) / 60000);
|
||||
const prefix = diffMinutes < 0 ? '已逾期' : '还剩';
|
||||
const abs = Math.abs(diffMinutes);
|
||||
if (abs < 60) return `${prefix} ${abs} 分钟`;
|
||||
if (abs < 60 * 24) return `${prefix} ${Math.floor(abs / 60)} 小时`;
|
||||
return `${prefix} ${Math.floor(abs / (60 * 24))} 天`;
|
||||
}
|
||||
|
||||
/* ------------------------------------------------------------------ 成绩 */
|
||||
|
||||
/** 得分率（0-100），总分非法时返回 0 */
|
||||
export function gradePercent(score: number, totalScore: number): number {
|
||||
if (!Number.isFinite(score) || !Number.isFinite(totalScore) || totalScore <= 0) return 0;
|
||||
return round((score / totalScore) * 100, 1);
|
||||
}
|
||||
|
||||
/** 等级换算，学生端图表与标签复用 */
|
||||
export function gradeLevel(percent: number): GradeLevel {
|
||||
if (percent >= 90) return 'A';
|
||||
if (percent >= 80) return 'B';
|
||||
if (percent >= 70) return 'C';
|
||||
if (percent >= 60) return 'D';
|
||||
return 'E';
|
||||
}
|
||||
|
||||
export function averageOf(numbers: number[]): number {
|
||||
const valid = numbers.filter((n) => Number.isFinite(n));
|
||||
if (valid.length === 0) return 0;
|
||||
return round(valid.reduce((sum, n) => sum + n, 0) / valid.length, 1);
|
||||
}
|
||||
|
||||
export function round(value: number, digits = 2): number {
|
||||
const factor = 10 ** digits;
|
||||
return Math.round(value * factor) / factor;
|
||||
}
|
||||
|
||||
/* ------------------------------------------------------------------ 通用 */
|
||||
|
||||
export function clamp(value: number, min: number, max: number): number {
|
||||
return Math.min(Math.max(value, min), max);
|
||||
}
|
||||
|
||||
export function groupBy<T, K extends string | number>(items: T[], keyOf: (item: T) => K): Map<K, T[]> {
|
||||
const map = new Map<K, T[]>();
|
||||
for (const item of items) {
|
||||
const key = keyOf(item);
|
||||
const bucket = map.get(key);
|
||||
if (bucket) bucket.push(item);
|
||||
else map.set(key, [item]);
|
||||
}
|
||||
return map;
|
||||
}
|
||||
|
||||
export function uniqueBy<T, K>(items: T[], keyOf: (item: T) => K): T[] {
|
||||
const seen = new Set<K>();
|
||||
const result: T[] = [];
|
||||
for (const item of items) {
|
||||
const key = keyOf(item);
|
||||
if (seen.has(key)) continue;
|
||||
seen.add(key);
|
||||
result.push(item);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/** 生成 [1, max] 的周次选项，课表周次切换与表单下拉复用 */
|
||||
export function buildWeekOptions(max = 20, min = 1): number[] {
|
||||
const safeMax = Math.max(min, Math.floor(max));
|
||||
return Array.from({ length: safeMax - min + 1 }, (_, index) => min + index);
|
||||
}
|
||||
|
||||
/** 安全的数字转换，表单输入（字符串）到接口字段（number）之间使用 */
|
||||
export function toNumber(value: unknown, fallback = 0): number {
|
||||
if (typeof value === 'number' && Number.isFinite(value)) return value;
|
||||
if (typeof value === 'string' && value.trim() !== '') {
|
||||
const parsed = Number(value);
|
||||
if (Number.isFinite(parsed)) return parsed;
|
||||
}
|
||||
return fallback;
|
||||
}
|
||||
|
||||
/** 截断长文本（列表页展示摘要） */
|
||||
export function truncate(text: string | null | undefined, max = 60): string {
|
||||
if (!text) return '';
|
||||
return text.length <= max ? text : `${text.slice(0, max)}…`;
|
||||
}
|
||||
|
||||
/** HH:mm 校验 */
|
||||
export function isValidTimeString(value: string): boolean {
|
||||
return /^([01]\d|2[0-3]):[0-5]\d$/.test(value);
|
||||
}
|
||||
Reference in new issue
Block a user