⚡️ 能从 CDUT 新版教务系统高效、便捷地生成订阅日历的工具。
仅需在 此网站 轻轻输入你的学号与新教务处密码，不过须臾便可导入课程表订阅到日历。
请特别关注：订阅日历能每 7 天 自动同步 教务系统课程表的 变更。
 |
 |
|---|---|
 |
 |
- 仅需在 此网站 输入你的学号与新教务处密码。
⚠️ 这个密码一定不会是你的身份证后 6 位，因为第一次登录会强制要求改密码。如果登录时显示密码错误，请登录 新教务处，检查密码是否正确 ✅，或者是否已经根据新教务系统的要求更改密码。初始密码为身份证后 6 位。
这个密码可能与砚湖易办的统一身份认证密码不同，请以能以登录 https://jw.cdut.edu.cn/jsxsd/ 为准。
-
在接下来的页面点击 导入到日历 按钮，或者复制订阅链接。
-
在日历 App 导入订阅日历。
⚠️ 请特别关注iOS/iPadOS/macOS 在导入订阅日历时，请 取消 勾选 订阅详细信息 -> 移除提醒。否则将不会收到提前 30 分钟的课程信息通知。
-
克隆此项目到本地。
-
确保你的电脑已安装 Python 3+ 与 pip 包管理器、Node 14+、yarn/npm 包管理器、MySQL 8+ 的本地或者云数据库。
-
将 configTemplate.json 重命名为 config.json。
-
配置数据库。新建数据库名为
timetable。在 config.json 中输入数据库的连接地址、用户名与密码。表的详细信息如下。不用新建表，因为程序在没有 accounts 表的时候会自动新建 accounts 表。
- 配置后端 FastAPI 服务器。
-
在项目文件夹内运行以下命令。
pip install -r requirements.txt
-
在
main.py->class userDAO->config里修改你的数据库密码与表名（如果与预设的表名不一致的话）。 -
运行服务器。你有以下两种选择。
- 在项目文件夹直接运行 `python main.py`。
- 在终端运行命令：`uvicorn backend.server:app --reload --port 7669`。
- 在浏览器访问 http://localhost:7669/，如果出现
{"detail":"Not Found"}就说明你已配置成功。
- 配置前端服务器。
-
进入仓库 frontend 目录。
-
更改 frontend/src/store/index.js 中的
backendUrl为http://localhost:7669。 -
安装依赖。在终端运行
# 如果你是用的是 yarn yarn # 如果你是用的是 npm npm install -
运行前端（开发测试）。
# 如果你是用的是 yarn yarn run serve # 如果你是用的是 npm npm run serve
-
运行前端（正式环境）
- 打包。运行成功后，将会生成 dist 文件夹。
# 如果你是用的是 yarn yarn run build # 如果你是用的是 npm npm run build
-
运行生成的 dist。
生成的 dist 是纯静态资源，能提供 http 服务的服务器都能运行。 你可以使用 nginx、caddy、express.js(基于 Node.js 的服务器) 等服务器部署 dist 文件夹。
这里我们选择使用
serve。安装
serve。# 如果你是用的是 yarn yarn global add serve # 如果你是用的是 npm npm install -g serve运行 dist。
serve -s dist -l 5000 -
如果你能在浏览器打开链接 http://localhost:5000，你就部署成功了。
- 登录
-
预获取 Precondition Cookies 与 public Key。
-
根据官网登录流程，使用 public Key 加密密码。
-
登录，保留 session 直到获取完课程与考试信息。
-
- 在此次 Session 获取课表与考试信息的 HTML 表格。
- 解析 HTML 表格，得到原始课程信息。
- 分析原始课程信息，将其转换为含有明确开始、结束节数的列表。
- 根据列表生成 ics 文件。
-
添加课程的学分、学时、类型（理论或实践）信息。
-
使用云服务器并搭建 日历订阅 服务器（WebCal Server）。
日历订阅最值得关注的特性，或许是拥有 自动同步日程 的能力。
只需要在日历输入订阅链接，日历就能以最快的速度自动同步教务系统课程表的变更。
服务器可以每隔两天从教务处获取最新课表，并更新日历订阅。得益于日历订阅的自动同步能力，在本地的日历程序即可始终同步教务系统课表的最新更改。 但即便是这样，也仍然面临一个很严肃的问题：如果想要采用日历订阅，那么在云服务器（或者云数据库）就必须至少保留用户登录的 Cookie 信息。如何确保掌握数据库权限的人绝不会越界呢？这是个恒久不衰的商业道德问题。
你的隐私，当由你全权管控。我深知保护用户隐私的重要性与必要性，我也有必要在此承诺，绝不会窥探阁下的任何隐私。
此程序仅供阁下个人导出教务系统课程表的用途，禁止商用。
技术本无罪，如遇任何法律纠纷，作者对代码的行为以及可能产生的任何后果不负任何责任。
Android
在文件管理器，或者在分享界面使用第三方应用打开，选择系统自带日历即可导入。
受测试支持导入 ics 日历文件的，基于 Android 的操作系统包括小米 MIUI、OPPO ColorOS、华为 HarmonyOS、魅族 Flyme。
macOS/Windows
双击生成的日历 ics 文件，即可导入。
iOS/iPadOS
方法 1 邮件
使用系统自带邮件 App，发送含有 ics 文件的邮件给自己。待收到邮件后，点击收件箱的 ics 文件即可导入到日历。
方法 2 隔空投送
使用另一苹果设备隔空投送给当前设备，然后日历会自动导入。
方法 3 快捷指令
-
安装快捷指令 ICS To Calendar。 👉 请点击此处导入快捷指令。
-
打开 ics 文件的共享页面，选择 ICS To Calendar，等待出现日程信息后，点击添加全部。
-
RFC 5545. 这是 iCalendar 标准的官方文档。
-
iCalendar for Python 第三方库官方文档。这是能够快速生成并处理 iCalendar 对象的 Python 库。
-
BeautifulSoup 第三方库官方文档。BeautifulSoup 是一个可以从 HTML 或 XML 文件中提取数据的 Python 库。
-
FastAPI 官方文档. FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints.
-
Vue.js 官方文档. Vue (读音 /vjuː/，类似于 view) 是一套用于构建用户界面的渐进式框架。