我不爱石光

一、问题提出

在大学校园，为丰富学生校园生活，提升学生综合素质能力和校园幸福感，学校经常组织学生参加实践活动，社团活动，团日活动等。然而，在日常校园实践中，我们发现了以下待解决的突出问题：

（1）校园活动参与渠道分散且效率低下：学生获取校园活动（如社团活动、学术讲座、志愿服务等）信息时，主要依赖各学院官网、社团QQ群、纸质海报等碎片化渠道。这些渠道存在信息更新滞后、覆盖范围狭窄的问题，导致学生活动参与意愿难以高效转化为实际行动。同时，活动报名流程繁琐（需线下填表、多次确认），活动通知依赖人工转发，进一步增加了沟通成本和时间消耗。大量有意义的校园活动因宣传不足或参与门槛过高，导致学生参与热情受挫，校园文化氛围活跃度受限。

（2）兴趣部落建设与归属感培养缺乏有效载体：学生寻找志同道合的兴趣部落时，经常面临部落信息不透明（如活动频次、成员构成信息模糊）、加入流程复杂等问题。现有校园社交平台中，部落信息混杂着大量无关内容，使学生难以快速定位目标部落，且部落内部交流缺乏规范化工具（如活动组织、资源共享平台），导致学生兴趣培养受阻，校园社交圈层构建效率低下，归属感难以有效建立。

（3）个人成长轨迹记录与展示体验欠佳：学生记录校园生活（如活动心得、学习成果、时长获取）时，现有工具（如“石光”类平台）存在操作卡顿（界面加载慢、发布流程易中断）、个性化展示不足等问题，缺乏持续成长的动力，校园生活价值感传递效率低下。

综上，虽然存在部分校园活动管理、社交互动平台，但它们往往功能分散（活动、社交、记录功能联系不紧密）、体验卡顿（响应速度慢、界面交互不流畅）、核心需求覆盖不足（缺乏活动-部落-成长的生态闭环），无法满足学生对“便捷参与、高效社交、系统成长”的校园生活核心诉求。

因此，我们组构建了一个集校园活动管理、兴趣部落运营、个人成长记录功能于一体的校园综合服务平台——“我不爱石光”，一个以流畅体验、生态闭环解决传统“卡、慢、散”问题的平台。意在通过数字化手段赋能校园生活，提升学生参与感、归属感与成长获得感，优化校园文化生态。

二、软件设计说明书

2.1系统架构图

我不爱石光系统构架图如图2-1所示。

图2-1 系统架构图

最底层是数据库层，我们选用PostgreSQL数据库，搭配异步驱动，通过连接池管理和自动重连机制，保障数据访问的稳定性；往上是数据访问层，通过 crud.py 实现用户、活动、部落等增删改查；中间是路由层，涵盖认证管理、用户管理、学时管理、二维码等八大模块，实现功能的模块化拆分；应用层基于FastAPI构建主应用，集成了CORS中间件、生命周期管理、定时任务等关键组件；最上层是客户端层，支持 Windows和Android双系统。这种分层架构让系统各模块各司其职，保证了开发效率。

三、用户手册

3.1 用户注册登录

3.1.1用户注册

图3-1-1 用户注册

这是用户注册界面，用户首次登陆需注册，并通过邮箱接收验证码验证身份。创建成功后，登陆即可进入系统。

3.1.2 用户登录

图 3-1-2 用户登录界面

这是APP登入界面，输入已注册的用户名和密码即可成功登入。若输入非法信息则会显示“登陆失败，请检查用户名和密码”。

3.1.3 管理员身份获取

图 3-1-3 用户权限更改

从个人主页进入权限更改界面，输入自己想要更改成为的身份并输入正确的密码即可修改为管理员身份。

3.2 活动参与流程

3.2.1 活动搜索

图3-2-1 活动搜索

在随上方搜索框中输入关键词即可找到相关活动。（支持模糊搜索）

3.2.2 活动报名

图 3-2-2 活动报名

查找到可参与活动后，点击“报名活动”即可参与活动

3.3 活动的创办流程（限管理员）

3.3.1 活动创建

图 3-3-1 活动的创建

进入个人界面，若拥有管理员身份即可点击‘创建活动’进行活动创建。根据活动要求自主设计添加活动相关内容，如：标题、概述、时间、参加范围、学时赋予类型、图片等。

3.3.2 活动状态设置

图 3-3-2 活动状态

管理员在个人页面，进入修改活动即可修改活动状态为“未开始”“签到”“签退”“已结束”。

3.3.3 活动签到签退

图3-3-3 管理员签到签退

当活动状态为签到签退时，管理员如图3-3-3所示，扫描活动成员的二维码进行签到签退

3.4 部落的操作

3.4.1部落的创建

图 3-4-1 部落创建

在个人页面，选择创建部落，填入部落相应信息即可创建。

3.4.2 部落的加入

图 3-4-2 加入部落

搜索你想加入的部落，点击“加入部落”，即可加入相应的部落。

3.5 学时操作

3.5.1 学时的交易

图 3-5-1 学时交易

学时界面右上角，点击学时赠送进入，在上方输入赠送目标UID并在下方调整学时交易种类与交易数量。

3.5.2 学时的抽奖

图 3-5-2 学时抽奖

学时界面右上角点击“学时抽奖”进入，输入投入的学时类别、数量，即可开始抽奖。若学时数量不够则会提醒报错。抽奖后用户获得相应倍数的学时，并失去投入学时。

3.5.3 学时的查询

图3-5-3 学时数据的查询

这个页面是学时查询界面，显示学时获得情况，包括思想成长、创新创业、文体发展、社会实践与志愿服务、工作履历与技能培训这五部分学时。本页统计了已获得的学时、相应的学分，在右侧以百分比形式显示学时收集完成度，并加以图标直观展示。

3.6 电脑端后台管理

3.6.1 注册用户信息统计

图 3-6-1 用户信息统计

统计已注册用户的学号、姓名、身份、年级、专业、班级、学院、部落等信息。

3.6.2 批量添加用户

图3-6-2 批量添加用户

在这个界面可以通过输入用户的信息并添加在下面待提交列表中来批量

导入用户，提高管理员工作效率。

四、数据分析

4.1可视化图表

4.1.1签到签退参与学院分分布图

图4-1-1 签到签退参与学院分分布图

4.1.2使用者学院分布图

图4-1-2 使用的学院分布图

4.1.3参与测试活动的学院分布图

图4-1-3 测试学院分布图

4.1.4参与测试部落参与的学院分布图

图4-1-4 参与测试部落参与的学院分布图

4.1.5日在线人数折线图

图4-1-5 日在线人数折线图

4.1.6日在线人数柱状图

图4-1-5 日在线人数折线图

六、小组分工

学号	姓名	分工
2509050218	孟锦程	整体Fastapi框架搭建、保底机制算法、基础数据库搭建、用户管理、活动管理
2509050202	李奕辰	数据库优化、部落管理、批量注册、权限认证、学时交易
2509050209	陈杰	用户日活、模糊查询、学时管理、学时抽奖、验证码
2509050219	孟圣钧	数据分析、文档撰写、ppt制作、图片管理

项目开源地址：溯道宛/CreditHourSystem