Skip to content

Commit 5d551d9

Browse files
BenderBlogBenderBlog
committed
chore: upgrade flutter version
1 parent 7badc0c commit 5d551d9

File tree

3 files changed

+210
-5
lines changed

3 files changed

+210
-5
lines changed

‎.flutter

Submodule .flutter updated 34 files

‎README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,10 @@ Traintime PDA，又称 XDYou，是为西电本科生设计的开源信息查询
5555
## 编译环境
5656

5757
```bash
58-
Flutter 3.24.1 • channel stable • https://github.com/flutter/flutter.git
59-
Framework • revision 5874a72aa4 (2 weeks ago) • 2024-08-20 16:46:00 -0500
60-
Engine • revision c9b9d5780d
61-
Tools • Dart 3.5.1 • DevTools 2.37.2
58+
Flutter 3.24.3 • channel stable • https://github.com/flutter/flutter.git
59+
Framework • revision 2663184aa7 (3 days ago) • 2024-09-11 16:27:48 -0500
60+
Engine • revision 36335019a8
61+
Tools • Dart 3.5.3 • DevTools 2.37.3
6262
```
6363

6464
注意：要编译此项目，Dart 编译器必须在 3.0 以上。

‎doc/数据结构.md

+205
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,205 @@
1+
<!--
2+
Copyright 2024 BenderBlog Rodriguez and contributors.
3+
SPDX-License-Identifier: MPL-2.0
4+
-->
5+
# PDA 设计文档草案：数据结构
6+
7+
本草案面向服务端开发商，用于实际编程、估算服务端开发商需要的成本、向相关部门申请。
8+
9+
本文档是对 PDA 代码的分析，大多数是根据一站式API侦测所作出的。由于该数据结构没有过多深度设计，建议服务端开发者作出变通。
10+
11+
## 课程表信息
12+
13+
课程表信息包含三大类：主要课程信息，调课信息，未安排课程信息。
14+
15+
### 主要课程信息
16+
17+
课程信息由课程索引信息和课程安排信息构成。具体如下：
18+
19+
课程索引信息
20+
21+
| 名称 | 功能 | 格式 | 是否可空 |
22+
| -------- | ---------------------- | ------ | -------- |
23+
| 名称 | 显示课程名称 | 字符串 | 否 |
24+
| 课程序号 | 该课程在教务处里的序号 | 字符串 | 是 |
25+
| 班级序号 | 开课班级的序号 | 字符串 | 是 |
26+
课程安排信息
27+
28+
| 名称 | 功能 | 格式 | 是否可空 |
29+
| ------------ | ------------------------------- | -------------- | -------- |
30+
| 课程索引信息 | 指示课程索引信息的变量 | 外键到课程索引 | 否 |
31+
| 上课周次 | 在开课周次里面标志该周是否有课 | 布尔类型的数组 | 否 |
32+
| 上课教师 | 该次安排中上课教师 | 字符串 | 是 |
33+
| 上课教室 | 上课的地点 | 字符串 | 是 |
34+
| 上课星期 | 该周星期几上课，建议从1开始计数 | 整型数 | 否 |
35+
| 上课开始时间 | 第几节课开始，建议从1开始计数 | 整型数 | 否 |
36+
| 上课结束时间 | 第几节课结束，建议从1开始计数 | 整型数 | 否 |
37+
38+
### 调课信息
39+
40+
调课信息针对课程安排信息进行处理，具体如下：
41+
42+
| 名称 | 功能 | 格式 | 是否可空 |
43+
| -------------- | ------------------------------------------------ | -------------- | -------------- |
44+
| 调课类型 | 本次课程调整类型，分为三种情况：调课、停课、补课 | 枚举 | 否 |
45+
| 课程序号 | 调课课程在教务处里的序号 | 字符串 | 否 |
46+
| 班级序号 | 调课课程开课班级的序号 | 字符串 | 否 |
47+
| 课程名称 | 调课课程名称 | 字符串 | 否 |
48+
| 原上课周次 | 调课课程原先上课周次 | 布尔类型的数组 | 否 |
49+
| 新上课周次 | 调课课程新的上课周次 | 布尔类型的数组 | 是，如果无更改 |
50+
| 原上课教师 | 该次安排中原先的上课教师 | 字符串 | 否 |
51+
| 新上课教师 | 该次安排中新的上课教师 | 字符串 | 是，如果无更改 |
52+
| 原上课教室 | 原先上课的地点 | 字符串 | 否 |
53+
| 新上课教室 | 新上课的地点 | 字符串 | 是，如果无更改 |
54+
| 原上课星期 | 原先该周星期几上课，建议从1开始计数 | 整型数 | 否 |
55+
| 新上课星期 | 新该周星期几上课，建议从1开始计数 | 整型数 | 是，如果无更改 |
56+
| 原上课开始时间 | 原先第几节课开始，建议从1开始计数 | 整型数 | 否 |
57+
| 新上课开始时间 | 新第几节课开始，建议从1开始计数 | 整型数 | 是，如果无更改 |
58+
| 原上课结束时间 | 原先第几节课结束，建议从1开始计数 | 整型数 | 否 |
59+
| 新上课结束时间 | 新第几节课结束，建议从1开始计数 | 整型数 | 是，如果无更改 |
60+
61+
### 未安排课程信息
62+
63+
未安排课程信息具体如下：
64+
65+
| 名称 | 功能 | 格式 | 是否可空 |
66+
| -------- | ---------------------- | ------ | ------------ |
67+
| 名称 | 显示课程名称 | 字符串 | 否 |
68+
| 课程序号 | 该课程在教务处里的序号 | 字符串 | 是，但最好否 |
69+
| 班级序号 | 开课班级的序号 | 字符串 | 是，但最好否 |
70+
| 负责老师 | 由谁负责这门课 | 字符串 | 是，但最好否 |
71+
72+
## 成绩信息
73+
74+
成绩信息如下表所示
75+
76+
| 名称 | 功能 | 格式 | 是否可空 |
77+
| ------------ | -------------------------------------------- | ------ | -------------------- |
78+
| 名称 | 学科名称 | 字符串 | 否 |
79+
| 分数 | 数值分数 | 浮点数 | 是，如果尚未登记成绩 |
80+
| 学年 | 学年学期信息，按照开学年-结束年-第几学期计算 | 字符串 | 否 |
81+
| 学分 | 该课程获得的学分 | 浮点数 | 否 |
82+
| 课程性质 | 必修/选修 | 字符串 | 否 |
83+
| 课程类别 | 该课程类别 | 字符串 | 否 |
84+
| 计分方式 | 三级成绩/五级成绩/两级成绩 | 枚举 | 否 |
85+
| 等级 | 仅适用于三级成绩/五级成绩/两级成绩 | 字符串 | 是 |
86+
| 是否通过 | 是否及格 | 布尔 | 是，如果尚未登记成绩 |
87+
| 教学班序列号 | 用于可能的查排名 | 字符串 | 是 |
88+
89+
如果查排名能做，需要传递教学班序列号**和一个当前用户认证机制**来获得！
90+
91+
## 校园卡流水
92+
93+
需要通过开始日期和结束日期信息查询由消费地点、消费时间、消费金钱的数组。
94+
95+
## 图书馆借书信息
96+
97+
暂时不考虑查询书库信息，这个估计用API侦测那坨学校也不知道……
98+
99+
| 名称 | 功能 | 格式 | 是否可空 |
100+
| ------------------ | -------------------------- | ------ | ------------------ |
101+
| 借书名称 | 借书的名称 | 字符串 | 否 |
102+
| 借书作者 | 该书籍的作者 | 字符串 | 否 |
103+
| 借书发行商 | 该书籍的发行商 | 字符串 | 否 |
104+
| 借书 ISBN | 该书籍的isbn，用于获取封面 | 字符串 | 否 |
105+
| 借书记录 ID | recordId | 整型数 | 否 |
106+
| 借书 ID | loanId | 整型数 | 否 |
107+
| 书籍本身的 ID | itemId | 整型数 | 否 |
108+
| 借书日期 | 开始借书的日期 | 日期 | 否 |
109+
| 续借日期 | 如有续借，续借日期 | 日期 | 是，如果从未续借过 |
110+
| 理论还书日期 | 借书期限到期日期 | 日期 | 否 |
111+
| 借书类型 | loanType | 字符串 | 否 |
112+
| 书本身的一维码信息 | barCode | 字符串 | 否 |
113+
114+
这里有很多的 Id 只是为了搞续借功能。
115+
116+
## 考试安排
117+
118+
考试安排包括有时间的考试安排和暂无考试安排的科目。
119+
120+
| 名称 | 功能 | 格式 | 是否可空 |
121+
| -------- | ---------------------- | ----------- | ---------------------------- |
122+
| 考试科目 | 考试科目名称 | 字符串 | 否 |
123+
| 考试类型 | 开学考试/期中期末/补考 | 枚举/字符串 | 否 |
124+
| 开始时间 | 考试开始时间 | 日期 | 否 |
125+
| 结束时间 | 考试结束时间 | 日期 | 否 |
126+
| 考试地点 | 考试 | 整型数 | 是，万一是计算机导论考试之类 |
127+
| 座位号 | 考试座位号 | 字符串 | 是，万一是计算机导论考试之类 |
128+
129+
暂无考试科目仅需考虑科目名称和科目的教务处编号。
130+
131+
## 空闲教室
132+
133+
需要发送这些信息：
134+
135+
| 名称 | 功能 | 格式 | 是否可空 |
136+
| ---------- | ----------------------------------------- | ----------- | ------------------------ |
137+
| 教室地点 | 广研/杭研/北校区/南校区，同时只能满足一个 | 字符串 | 否 |
138+
| 查询日期 | 四位数年份-两位数月份-两位数日期字符串 | 枚举/字符串 | 否 |
139+
| 搜索关键词 | 搜索建筑物的关键词 | 字符串 | 否，就算没有也发空字符串 |
140+
141+
获得以下信息的数组：
142+
143+
| 名称 | 功能 | 格式 | 是否可空 |
144+
| -------- | ----------------------------------------- | ------ | -------- |
145+
| 教室名称 | 广研/杭研/北校区/南校区，同时只能满足一个 | 字符串 | 否 |
146+
| 1-2有课 | 第一节课到第二节课是否有课 | 布尔 | 否 |
147+
| 3-4有课 | 第三节课到第四节课是否有课 | 布尔 | 否 |
148+
| 5-6有课 | 第五节课到第六节课是否有课 | 布尔 | 否 |
149+
| 7-8有课 | 第七节课到第八节课是否有课 | 布尔 | 否 |
150+
| 9-10有课 | 第九节课到第十节课是否有课 | 布尔 | 否 |
151+
152+
## 电费和能源欠费
153+
154+
仅查询，就俩数的事情。
155+
156+
## 体育信息
157+
158+
体育课程信息分为上课教师记录和体测记录，乐跑计数不做。
159+
160+
体育课程信息是每学期选课的结果，暂时不融入日程表。
161+
162+
| 名称 | 功能 | 格式 | 是否可空 |
163+
| ------------ | ---------------------------------------- | ------ | -------- |
164+
| 学期名称 | 学期开始年份-学期结束年份-第几学期字符串 | 字符串 | 否 |
165+
| 课程名称 | 上课课程名称 | 字符串 | 否 |
166+
| 老师姓名 | 上课教师姓名 | 字符串 | 否 |
167+
| 上课星期 | 星期几上课，建议从1开始计数 | 整型 | 否 |
168+
| 开始上课时间 | 第几节课开始，建议从1开始计数 | 整型 | 否 |
169+
| 结束上课时间 | 第几节课结束，建议从1开始计数 | 整型 | 否 |
170+
| 课程成绩 | 如果结课，成绩多少 | 整型 | 是 |
171+
172+
体测成绩比较复杂，分为总信息，分项信息，最后加上所有体测的总成绩和等级，以及计算规则。
173+
174+
分项信息
175+
176+
| 名称 | 功能 | 格式 | 是否可空 |
177+
| -------- | -------------------------- | ----------- | -------- |
178+
| 项目名称 | 测试项目名称 | 字符串 | 否 |
179+
| 单位 | 该项目单位 | 字符串 | 否 |
180+
| 实际成绩 | 测试数值 | 字符串 | 否 |
181+
| 数值成绩 | 转换后的成绩 | 整型数 | 否 |
182+
| 等级 | 优秀/良好/中等/合格/不合格 | 枚举/字符串 | 否 |
183+
184+
总信息
185+
186+
| 名称 | 功能 | 格式 | 是否可空 |
187+
| ------------ | ---------------------------------------- | ------------ | -------- |
188+
| 测试年份 | 学期开始年份-学期结束年份-第几学期字符串 | 字符串 | 否 |
189+
| 总成绩 | 该年体测总成绩 | 字符串 | 否 |
190+
| 等级 | 体测等级 | 字符串 | 否 |
191+
| 分项信息数组 | 具体成绩信息 | 分项信息数组 | 否 |
192+
193+
## 物理实验信息
194+
195+
这玩意能搞就要搞
196+
197+
| 名称 | 功能 | 格式 | 是否可空 |
198+
| -------- | ------------------------ | ------ | ---------------- |
199+
| 名称 | 实验名称 | 字符串 | 否 |
200+
| 开始时间 | 实验开始时间 | 日期 | 否 |
201+
| 结束时间 | 实验结束时间 | 日期 | 否 |
202+
| 负责老师 | 该次实验负责老师 | 字符串 | 否 |
203+
| 地点 | 实验地点 | 字符串 | 否 |
204+
| 座位号 | 实验要填的座位号 | 字符串 | 否 |
205+
| 成绩 | 如果老师想起来记成绩的话 | 字符串 | 是，就怕老师忘了 |

0 commit comments

Comments
 (0)