feat(clients): 添加考试安排获取

Author: GoForceX

auth/cas.ts

@@ -362,6 +362,33 @@ export default class CASAuth {
     }
   }
 
+  async loginMHUB() {
+    const url = 'http://mhub.hust.edu.cn/';
+    const isLogin = await this.checkLoginStatus();
+
+    if (!isLogin) {
+      return false;
+    }
+
+    try {
+      let response = await this.axios.get(url);
+
+      if (
+        response.status === 302 &&
+        response.headers.location.includes('login')
+      ) {
+        response = await this.axios.get(
+          `${CASAuth.CAS_URL}/login?service=${encodeURIComponent('https://mhub.hust.edu.cn/cas/login')}`,
+        );
+
+        response = await followRedirect(response, this.axios);
+      }
+      return response.status === 200;
+    } catch (e) {
+      return false;
+    }
+  }
+
   async loginONE() {
     const url = 'https://one.hust.edu.cn/dcp/';
     const isLogin = await this.checkLoginStatus();

clients/course-client.ts

@@ -7,9 +7,11 @@ import {
   getPhysicsCourseSchedule as getPhysicsCourseSchedule,
 } from './course/physics';
 import {
+  getExaminationArrangements,
   getNormalCourseGrades,
   getNormalCourseSchedule,
 } from './course/course';
+import { ExaminationType } from '@/types/clients/course/course';
 
 export default class CourseClient {
   protected readonly axios: AxiosInstance;
@@ -71,4 +73,33 @@ export default class CourseClient {
       getNormalCourseGrades(this.axios, semesterId, pageNumber, pageSize),
     );
   }
+
+  async getExaminationArrangements(
+    semesterId: string,
+    {
+      pageIndex,
+      pageSize,
+      keyword,
+      type,
+    }: {
+      pageIndex: number;
+      pageSize: number;
+      keyword: string;
+      type: ExaminationType;
+    } = {
+      pageIndex: 1,
+      pageSize: 100,
+      keyword: '',
+      type: ExaminationType.NORMAL,
+    },
+  ) {
+    return await this.hust.handleRequest(() =>
+      getExaminationArrangements(this.axios, semesterId, {
+        pageIndex,
+        pageSize,
+        keyword,
+        type,
+      }),
+    );
+  }
 }

clients/course/course.ts

@@ -1,8 +1,11 @@
-import type {
-  NormalCourseGrade,
-  NormalCourseGradesResponse,
-  NormalCourseSchedule,
-  NormalCourseScheduleResponse,
+import {
+  ExaminationType,
+  type ExaminationArrangement,
+  type ExaminationArrangementsResponse,
+  type NormalCourseGrade,
+  type NormalCourseGradesResponse,
+  type NormalCourseSchedule,
+  type NormalCourseScheduleResponse,
 } from '@/types/clients/course/course';
 import type { AxiosInstance } from 'axios';
 import type { Dayjs } from 'dayjs';
@@ -200,3 +203,67 @@ export async function getNormalCourseGrades(
     throw e;
   }
 }
+
+export async function getExaminationArrangements(
+  axios: AxiosInstance,
+  semesterId: string,
+  {
+    pageIndex,
+    pageSize,
+    keyword,
+    type,
+  }: {
+    pageIndex: number;
+    pageSize: number;
+    keyword: string | null;
+    type: ExaminationType;
+  } = {
+    pageIndex: 1,
+    pageSize: 100,
+    keyword: null,
+    type: ExaminationType.NORMAL,
+  },
+): Promise<ExaminationArrangement[]> {
+  const url = 'https://mhub.hust.edu.cn/ksapController/getStuKsxx';
+
+  try {
+    const response = await axios.post(url, {
+      xqh: semesterId,
+      pageIndex: pageIndex,
+      pageSize: pageSize,
+      kcmc: keyword,
+      kslx: type,
+    });
+    if (response.status !== 200) {
+      throw new Error(
+        `Error fetching examination arrangements for semester ${semesterId}.`,
+      );
+    }
+    const data: ExaminationArrangementsResponse = response.data;
+
+    console.log(data);
+
+    return data.list.map((item) => ({
+      scheduleId: item.SCHEDULEID,
+      departmentName: item.DWMC,
+      departmentId: item.PKDW,
+      classroomName: item.JSMC,
+      courseId: item.KCBH,
+      courseName: item.KCMC,
+      examType: item.KSLX === '0' ? ExaminationType.RETAKE : ExaminationType.NORMAL,
+      examDate: item.KSRQ,
+      classId: item.KTBH,
+      studentId: item.SFID,
+      studentName: item.XM,
+      semesterId: item.XQH,
+      semesterName: item.XQMC,
+      lastTeachingWeek: item.ZHSKZC,
+    }));
+  } catch (e) {
+    console.error(
+      'CourseClient.getExaminationArrangements error on fetching',
+      e,
+    );
+    throw e;
+  }
+}

index.ts

@@ -159,6 +159,7 @@ export default class HUST {
             this.auth.loginPhysics(),
             this.auth.loginHUBM(),
             this.auth.loginHUBS(),
+            this.auth.loginMHUB(),
           ])
         ).every((item) => item);
       default:
@@ -267,7 +268,7 @@ console.log('Initializing HUST SDK...');
 const res = await hust.news.getNewsList();
 console.log('News List:', res);
 
-const res2 = await hust.course.getNormalCourseGrades('20241', { all: true });
-console.log('Course Grades:', res2);
+const res2 = await hust.course.getExaminationArrangements('20241');
+console.log('Examination Arrangements:', res2);
 
 console.log(`initialized after ${new Date().getTime() - now.getTime()}ms`);