sjtu-plus / course-plus Goto Github PK

View Code? Open in Web Editor NEW

133.0 3.0 11.0 844 KB

Course planning service for SJTU

Home Page: https://plus.sjtu.edu.cn/course-plus/

License: Apache License 2.0

JavaScript 91.50% HTML 2.89% SCSS 2.08% TypeScript 3.48% CSS 0.05%

sjtu vue bootstrap course classtable

course-plus's Introduction

SJTUPlus

How to startup

Install dependencies
```
$ pip3 install -r requirements.txt
```

Create database

$ python3 manage.py makemigrations
$ python3 manage.py migrate

Create Superuser
```
$ python3 manage.py createsuperuser
```

Load database backup

$ python3 manage.py loaddata /path/to/backup.json

Run the server

# To run a debug server
$ python3 manage.py runserver
# To run a production server
# This will collect the static resources to /static-files
# You need another web server to host the static resources
$ python3 manage.py collectstatics 
$ gunicorn -c gunicorn.conf.py SJTUPlus.wsgi:application

Run the db watcher
```
python3 manage.py watch groups
```

文档

/api/sjtu/canteen

返回各食堂的总座位数、总就餐人数、总剩余座位数

/api/sjtu/canteen/all

返回各食堂及其各子区域的座位数、就餐人数、剩余座位数

/api/sjtu/canteen/[canteen_id]

根据食堂的 canteen_id 返回该食堂各子区域的座位数、就餐人数、剩余座位数

/api/sjtu/library

返回各图书馆的在馆人数与限流人数

/api/sjtu/cainiao

返回菜鸟驿站的实时人数与限流人数

/api/sjtu/bathroom

返回各浴室的机位使用情况

/api/sjtu/washing_machine/[machine_id]

返回机器编号为 machine_id 的洗衣机使用情况，仅对部分商户的机型有效

/api/course/lesson?term=[term]

查询用户 term 学期的课程表，学期格式形如 2021-2022-1。用户需通过 /login?scope=lessons 完成 jAccount 登录并提供 课程表查询 授权。

/api/course/lesson_info?code_list=[code_list]

查询教学班编号列表 code_list 中的教学班的信息，教学班编号以逗号隔开形如 (2020-2021-1)-AB202-1,(2020-2021-1)-AB203-1。学期的课程表，学期格式形如 2021-2022-1。用户需进行 jAccount 登录方可访问此数据。该数据非实时数据。

/api/user/profile

查询当前用户的身份，信息包括姓名、jAccount账号、学工号、所属部门/学院、账号类型、账号类型名、班号（若有）、身份状态（若有）、身份过期日期（若有）。

/api/user/info

查询当前用户的身份，信息包括姓名、jAccount账号、学工号、账号类型、账号类型名。

/login?app=[app]&scope=[scope]&redirecturi=[redirecturi]

跳转到 jAccount 登录页。可选的 app 参数提供了一些预设的 scope 和 redirecturi 参数组合，这些组合可通过额外指定 scope 和 redirecturi 参数进行覆盖。所有参数忽略时，登录后将跳转到首页。

/authorize?code=[code]&state=[state]

用户完成 jAccount 登录后，将携带 code 和 state 返回此处完成 OAuth 认证。

/logout?app=[app]&redirecturi=[redirecturi]&state=[state]

退出本网站和 jAccount 的登录。可选的 app 参数提供了一些预设的 redirecturi 参数，可通过额外指定 redirecturi 参数进行覆盖。所有参数忽略时，登录后将跳转到首页。

course-plus's People

Contributors

Stargazers

Watchers

Forkers

photonquantum himself65 webufoqiu seanchao accelerate-star qiuhuiming sleepywatchdog toolmanp ililaoban ruoyichen2016

course-plus's Issues

add tutorial

Now course-plus has a lot of functionalities. We could tutor our users for their specific needs.

Create your calendar: filter your class with class composition, and use virtual arrangement to export calendar
Find your courses: ...

Use husky to hook git operations

... to do run code linting client-side on pre-commit and reduce lint error complained by GitHub workflow.

Feature request: Attach first day of school with semester

This textbox should be changed along with semester selection.

apply fixtures in iCalendar integration

We can define some fixtures including:

国庆调休
新生调休
...

When user checks these fixtures, their iCalendar exports will automatically move some courses to the corresponding dates.

Merge identical schedule in the table view as well

Lesson data is downloaded two times upon first load

Figure out `cdjc` and `jc` difference

希望搜索时自动去除字符串的头尾空格

目前的 课程名称/新旧课程号 上课时间 等各项搜索功能似乎使用的是未经处理的字符串匹配。然而，当用户从其他地方复制文本粘贴至搜索框中时，很容易由于种种原因在字符串头尾引入多余空格，导致无法正常搜索。

希望可以对这一功能的实现略做改进。

Filter the modules by candidates composition

So that one can find all his compulsory module efficiently

How to find graduate courses or add graduate courses?

Currently all data are loaded in App.vue. At the same time, some data are passed through components with props for multiple times, which is very hard to maintain. We want to refactor the course-plus, to split data loading into a service.

能不能加上选课备注然后再同步一下今年的放假信息呀

Feature Request: Show the max number of students in the course if possible

Just as the title said, this is pretty useful if students want to check out whether they could join a course before the second turn of joining courses begins, if there's a way to getting know of these info (although it seems that we can not check this out at i.sjtu.edu.cn/design/funcData_cxFuncDataList.html) .

Also, it would be better if currently how many students have joined the course are shown as well.

separate these two components
enhance jAccount login experience

use exception days in iCalendar to reduce event number

add lesson detail

Refer to https://github.com/SJTU-Plus/course-plus/blob/legacy-vue/src/components/LessonDetail.vue for legacy Vue code