feat(clients): 添加考试成绩获取

Author: GoForceX

clients/course-client.ts

@@ -2,8 +2,14 @@ import type { AxiosInstance } from 'axios';
 import axios from 'axios';
 import { useCookie } from '@/utils/use-cookie';
 import type HUST from '..';
-import { getPhysicsCourseGrades, getPhysicsCourseSchedule as getPhysicsCourseSchedule } from './course/physics';
-import { getNormalCourseSchedule } from './course/course';
+import {
+  getPhysicsCourseGrades,
+  getPhysicsCourseSchedule as getPhysicsCourseSchedule,
+} from './course/physics';
+import {
+  getNormalCourseGrades,
+  getNormalCourseSchedule,
+} from './course/course';
 
 export default class CourseClient {
   protected readonly axios: AxiosInstance;
@@ -40,4 +46,29 @@ export default class CourseClient {
       getNormalCourseSchedule(this.axios, semesterId),
     );
   }
-}
+
+  async getNormalCourseGrades(
+    semesterId: string,
+    {
+      all,
+      pageNumber,
+      pageSize,
+    }: {
+      all?: boolean;
+      pageNumber?: number;
+      pageSize?: number;
+    } = {
+      all: false,
+      pageNumber: 1,
+      pageSize: 20,
+    },
+  ) {
+    if (all) {
+      pageNumber = 1;
+      pageSize = 100;
+    }
+    return await this.hust.handleRequest(() =>
+      getNormalCourseGrades(this.axios, semesterId, pageNumber, pageSize),
+    );
+  }
+}

clients/course/course.ts

@@ -1,4 +1,6 @@
 import type {
+  NormalCourseGrade,
+  NormalCourseGradesResponse,
   NormalCourseSchedule,
   NormalCourseScheduleResponse,
 } from '@/types/clients/course/course';
@@ -157,3 +159,44 @@ export async function getNormalCourseSchedule(
     throw e;
   }
 }
+
+export async function getNormalCourseGrades(
+  axios: AxiosInstance,
+  semesterId: string,
+  pageNumber: number = 1,
+  pageSize: number = 20,
+): Promise<NormalCourseGrade[]> {
+  const params = new URLSearchParams();
+  params.append('XQH', semesterId);
+  params.append('pageNum', String(pageNumber));
+  params.append('pageSize', String(pageSize));
+  const url = `https://hubs.hust.edu.cn/student/gradeSelect/queryResults?${params.toString()}`;
+
+  try {
+    const response = await axios.get(url);
+    if (response.status !== 200) {
+      throw new Error(
+        `Error fetching course grades for semester ${semesterId}.`,
+      );
+    }
+    const data: NormalCourseGradesResponse = response.data;
+
+    return data.list.map((item) => ({
+      className: item.BJMC,
+      scoreType: item.CJLX,
+      courseId: item.KCBH,
+      courseName: item.KCMC,
+      studentId: item.XH,
+      score: item.XSCJ,
+      hundredScore: item.BFCJ,
+      evaluationStatus: item.SFPJ,
+      studentName: item.XM,
+      semesterId: item.XQH,
+      totalCredits: item.ZXF,
+      schoolName: item.YXSMC,
+    }));
+  } catch (e) {
+    console.error('CourseClient.getNormalCourseGrades error on fetching', e);
+    throw e;
+  }
+}

index.ts

@@ -267,7 +267,7 @@ console.log('Initializing HUST SDK...');
 const res = await hust.news.getNewsList();
 console.log('News List:', res);
 
-const res2 = await hust.course.getNormalCourseSchedule('20242');
-console.log('Course Schedule:', res2);
+const res2 = await hust.course.getNormalCourseGrades('20241', { all: true });
+console.log('Course Grades:', res2);
 
 console.log(`initialized after ${new Date().getTime() - now.getTime()}ms`);

types/clients/course/course.ts

@@ -139,4 +139,179 @@ export type NormalCourseSchedule = CourseSchedule & {
    * 学期号
    */
   semesterId: string;
+}
+
+export type NormalCourseGradesResponseItem = {
+    /**
+     * 百分成绩
+     */
+    BFCJ: number;
+    /**
+     * 班级名称
+     */
+    BJMC: string;
+    /**
+     * 成绩类型
+     */
+    CJLX: string;
+    /**
+     * ？
+     */
+    DFFSDM: string;
+    /**
+     * ？
+     */
+    HDCJFS: string;
+    /**
+     * 课程编号
+     */
+    KCBH: string;
+    /**
+     * 课程名称
+     */
+    KCMC: string;
+    /**
+     * ？
+     */
+    KGZT: string;
+    /**
+     * ？
+     */
+    KSQKZCM: string;
+    /**
+     * 行编号
+     */
+    PAGEHELPER_ROW_ID: number;
+    /**
+     * 行编号
+     */
+    RANK: number;
+    /**
+     * 身份 ID？
+     */
+    SFID: string;
+    /**
+     * ？
+     */
+    SFJRJQ: string;
+    /**
+     * 是否评价
+     */
+    SFPJ: string;
+    /**
+     * 学号
+     */
+    XH: string;
+    /**
+     * ？
+     */
+    XKXZDM: string;
+    /**
+     * 姓名
+     */
+    XM: string;
+    /**
+     * 学期
+     */
+    XQ: string;
+    /**
+     * 学期号
+     */
+    XQH: string;
+    /**
+     * 学生成绩
+     */
+    XSCJ: string;
+    /**
+     * 院系名称
+     */
+    YXSMC: string;
+    /**
+     * 总学分
+     */
+    ZXF: number;
+}
+
+export type NormalCourseGradesResponse = {
+    /**
+     * 结束行号
+     */
+    endRow: number;
+    /**
+     * 是否有下一页
+     */
+    hasNextPage: boolean;
+    /**
+     * 是否有上一页
+     */
+    hasPreviousPage: boolean;
+    /**
+     * 是否为第一页
+     */
+    isFirstPage: boolean;
+    /**
+     * 是否为最后一页
+     */
+    isLastPage: boolean;
+    list: NormalCourseGradesResponseItem[];
+    /**
+     * 第一页页码
+     */
+    navigateFirstPage: number;
+    /**
+     * 最后一页页码
+     */
+    navigateLastPage: number;
+    /**
+     * 可导航页码列表
+     */
+    navigatepageNums: number[];
+    navigatePages: number;
+    /**
+     * 下一页页码
+     */
+    nextPage: number;
+    /**
+     * 页码
+     */
+    pageNum: number;
+    /**
+     * 总页数
+     */
+    pages: number;
+    /**
+     * 单页数据量
+     */
+    pageSize: number;
+    /**
+     * 上一页页码
+     */
+    prePage: number;
+    /**
+     * 单页数据量
+     */
+    size: number;
+    /**
+     * 起始行号
+     */
+    startRow: number;
+    /**
+     * 科目门数
+     */
+    total: number;
+}
+
+export type NormalCourseGrade = {
+  className: string;
+  scoreType: string;
+  courseId: string;
+  courseName: string;
+  studentId: string;
+  score: string;
+  hundredScore: number;
+  evaluationStatus: string;
+  studentName: string;
+  semesterId: string;
+  totalCredits: number;
+  schoolName: string;
 }