cqupt-kebiao

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #rust #deep-learning #nodejs #windows #cli #kubernetes #awesome-list #openai #mcp #open-source

(★ 10)

重庆邮电大学 - 课表查询

cqupt-kebiao 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CQUPT 课表查询

> **重庆邮电大学课表查询后端**。通过解析教务在线数据，提供稳定、快速、易于集成的课表接口。支持生成符合标准的 iCalendar (.ics) 文件，方便一键导入手机日历。

## ✨ 特性

* 🚀 **高性能响应**: 基于 **FastAPI** 异步 IO 构建；采用 **Redis 永不过期策略**，实现“先响应缓存，后台静默更新”，秒级首屏加载。
* 🔄 **全量数据整合**:
    * **常规课表**: 精准解析课程代码、教学班、学分及修读类型。
    * **调停课**: 自动追踪“补课、代课、停课”信息并动态修正主课表。
    * **考试/补考**: 深度整合普通考试与补考安排，补考信息不受学年学期限制。

* 📅 **智能时间逻辑**:
    * **自动推导**: 实时从教务在线数据推导学期第一周周一，精准识别“第 0 周”开学预备期。
    * **跨周处理**: 智能切换视角，如周日晚自动呈现下周一的课程预告。

* 🛠️ **冲突标注算法**: 自动检测同时间段多门课程冲突，采用 `#1`, `#2` 格式合并描述，确保信息不遗漏。
* 🆔 **深度学号兼容**: 完美支持重邮 10 位纯数字学号及 **`L` 开头的特殊学号**，内置大小写标准化自动转换。
* 🔔 **高度定制导出**: 支持生成符合标准的 `.ics` 日历文件，支持自定义多重闹钟提醒逻辑（如：课前 30min 初提醒，10min 二次提醒）。
* 🎨 **优雅数据呈现**: 针对外教名与复杂教师备注（修、名单、学分）进行智能清洗拼接。

## 🛠️ 环境要求

* **内网环境**: 本程序必须部署于 **重邮校园网（校内 IP）** 环境下，才可穿透访问教务在线 API。
* **依赖服务**: Redis (用于数据持久化缓存)。

## 📖 接口文档

### 1. 日历导出 (iCalendar)

`GET /api/curriculum/{student_id}/curriculum.ics`

获取标准的日历文件，支持在 URL 中定制提醒。

| 参数 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `first` | `int` | 否 | 第一优先级提醒时间（单位：分钟）。 |
| `second` | `int` | 否 | 第二优先级提醒时间（需小于 `first`）。 |

**示例:**

* 不带提醒: `/api/curriculum/202621xxxx/curriculum.ics`
* 30分钟及10分钟双重提醒: `.../curriculum.ics?first=30&second=10`

### 2. JSON 课表数据

`GET /api/curriculum/{student_id}/curriculum.json`

返回详细的 JSON 格式课表实例，适合移动端/小程序直接渲染。

### 3. 课程总览

`GET /api/curriculum/{student_id}/overview`

返回学生当前学期的统计数据（如课程总数、学分概况等）。

## 🚀 快速开始

1. **克隆仓库**
```bash
git clone https://github.com/MeTerminator/cqupt-kebiao.git
cd cqupt-kebiao

```

2. **配置环境变量**
创建 `.env` 文件并配置 Redis 连接：
```env
REDIS_URL=redis://localhost:6379/0

```

3. **运行服务**
```bash
uvicorn app.main:app --host 0.0.0.0 --port 8000

```

## 📄 开源协议

本项目基于 **[MIT License](https://www.google.com/search?q=LICENSE)** 协议开源。

cqupt-kebiao

cqupt-kebiao 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cqupt-kebiao

cqupt-kebiao 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README