fromsko / goschedule

纯 Go 实现的课表后端服务

课表绘制(Go-后端)

📅 吉首大学个人课表绘制

🛠️ 简化课程表查询和生成课表图片的流程

---

📑 功能特点

• 自动化课程表数据爬取 - rod
• 可自定义课表样式和颜色 - gg
• 支持定时任务，定期 [12/h] 更新课表 - cron
• 提供简单的接口，方便集成到其他应用中 - gin

---

配套应用

• 前端应用：前端页面数据展示
• 微信推送：推送数据到微信测试号

📦 安装

首先，确保您的 Go 版本为 1.21 或更高。然后，执行以下步骤来安装项目：

🚀 快速开始

1. 填写配置文件 ./config.json

   {
     "username": "xxxx",
     "password": "xxxx"
   }

2. 构建应用程序 main.py

   cd GoSchedule
   go mod tidy
   go build -ldflags "-w -s" .

3. 启动程序

   Toch.exe

4. 访问项目文档：

   • 访问 http://host:port 查看主页

5. 绘制个人课表：

   • 初次运行会自动获取一次数据
   • 后续则会自动执行定时任务

🔗 示例请求

获取课表数据

• 请求地址: http://host:prot/api/v1/get_cname_data?week=1
• 请求方式: GET
• 返回格式: json

获取课表图片

• 请求地址: http://host:prot/api/v1/get_cname_table?week=1
• 请求方式: GET
• 返回格式: image

运行说明

程序运行于 Linux | Windows | Mac 平台上, 并提供 API 服务.

图标修改

• 原生修改

  # 安装工具
  go install github.com/tc-hib/go-winres@latest
  # 初始化
  go-winres init
  # 构建
  go-winres make
  # 编译
  go build -ldflags "-w -s" .

• 直接修改 winres/ 两个文件的内容

🙏 鸣谢

感谢以下开源项目，它们为本项目的开发提供了重要支持：

• gg: 🖼️ 用于图像处理的 Go 库。
• cron: 🕒 用于定时任务的 Go 库。
• Rod: 🌐 用于自动化网页爬取的工具。
• Gin: 🚀 用于构建高性能 API 的 Web 框架。

©️ 许可

本项目基于 MIT 许可证，请查阅 LICENSE 文件以获取更多信息。