/kite-server

上应小风筝API代码和文档

Primary LanguageRustGNU General Public License v3.0GPL-3.0

上应小风筝 API

概要

本项目旨在为上海应用技术大学的学生提供校园信息整合与管理服务,项目背景详情见 上应小风筝 项目仓库。

后端 API 为整个项目提供接口支持和数据处理。由于经费有限,尽可能需要一个资源占用小的后端服务,开发者希望它能在单核 1G 内存的机器上流畅运行,并承载和选课阶段差不多的访问量。 在之前的测试中,能稳定应对 1k 左右的并发量,并保持低内存占用。

功能

  • 登录模块
  • 活动与签到
  • 第二课堂 (开发中)
  • 课表查询与选课
  • 空教室查询(开发中)
  • 二手闲置交易(开发中)
  • 入学信息查询
  • 失物招领

安装

请先确保系统中已预装有 rust 编程环境(rustc、cargo等),并已连接上互联网。

下载并编译:

git clone https://github.com/SIT-Yiban/kite-server.git
cd kite-server
cargo build

同时修改根目录下 kite.example.toml 文件。默认如下:

# Server config
[server]
# HTTPS API service address.
bind = "0.0.0.0:443"
# Postgresql connection string.
db = "postgresql://user:password@address:port/database"
# Token secret for API.
secret = "secret"
# Directory path should be end with "\"
attachment = "D:\\tmp\\"

# Wechat platform config. Access https://mp.weixin.qq.com for details
[wechat]
# Miniprogram appid
appid = "111"
# Secret
secret = "111"

[host]
# Bind address, for accepting connections from agents
bind = "0.0.0.0:1040"
# Max agent connections
max = 32

微信相关接口(微信登录)需要填写 appidsecret 后才能使用。 执行下面命令即可运行,目标二进制文件存放在 target 目录下。

cargo run

有关项目

项目 说明
kite-agent 后端数据抓取工具
kite-protocol 通信协议库(已废弃)
kite-string 校园网爬虫工具

如何贡献

非常欢迎你的加入!提一个 Issue 或者提交一个 Pull Request。

如果您有意见或建议,可以联系我们。

开源协议

GPL v3 © 上海应用技术大学易班 sunnysab

除此之外,您不能将本程序用于各类竞赛、毕业设计、论文等。