小狐狸与小道士1. 项目背景与需求分析
高校社团作为学生课外活动的重要载体，近年来呈现出规模扩大化、活动多样化的趋势。以某高校为例，平均每个学期新增社团15-20个，单个大型社团成员可达200人以上，每周活动频次超过5场。传统的手工登记、Excel表格管理等模式已经暴露出三大核心痛点：
-
信息孤岛问题：社团资料、成员名单、活动记录分散在不同负责人手中，新老交接时经常出现资料丢失。我们调研发现，78%的社团换届时存在历史数据断层。
-
协同效率低下：活动报名需要线下填表，财务报销依赖纸质单据传递，管理员平均每周要花费6-8小时处理这些事务性工作。
-
数据统计困难：年终评优时，社团需要人工统计参与人次、经费使用等数据，误差率普遍超过15%。
针对这些痛点，我们设计开发了这套基于SpringBoot+Vue的社团管理系统。系统核心目标是通过数字化手段实现：
- 社团信息的集中化存储与版本管理
- 活动流程的线上化闭环（发布-报名-签到-评价）
- 财务收支的透明化记录与自动化统计
- 成员沟通的即时化通知渠道
关键设计原则：采用"低耦合+高内聚"的模块化设计，确保系统既能满足通用管理需求，又支持各社团的个性化扩展。例如街舞社需要视频展示功能，而学术社团更关注文献共享模块。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计
2.1 整体技术栈选型
前后端分离架构的选择基于以下考量：
-
前端Vue.js 3.x + Element Plus组合提供：
- 响应式布局适配PC/移动端（使用Flex+Grid布局方案）
- 组件化开发加速界面构建（封装了社团卡片、活动日历等20+业务组件）
- 状态管理采用Pinia替代Vuex，TypeScript支持提升代码健壮性
-
后端SpringBoot 2.7.x技术栈包含：
- 安全框架：Spring Security + JWT（访问令牌有效期2小时，刷新令牌7天）
- 持久层：MyBatis-Plus 3.5.x（简化CRUD操作，内置分页插件）
- 接口文档：Knife4j 3.0.x（自动生成Swagger文档）
- 缓存方案：Redis 6.x（缓存社团热门活动列表，TTL设置30分钟）
-
数据库MySQL 8.0关键优化：
- 使用InnoDB集群实现读写分离（1主2从架构）
- 针对高频查询建立复合索引，如
idx_activity_club_time(club_id, start_time) - 大文本字段（如社团详情）单独存放到
club_detail分表
2.2 系统分层架构
code复制表现层：Vue SPA
↓ (Axios HTTP请求)
应用层：SpringBoot REST API
↓ (Service调用)
业务层：社团核心逻辑处理
↓ (Mapper接口)
数据层：MySQL + Redis
↑
基础设施：JWT鉴权、日志审计、消息队列
典型请求流程示例：
- 前端发起活动查询请求：
GET /api/activities?clubId=5&page=1 - 网关层进行JWT校验和权限验证
- 业务层先查询Redis缓存（Key格式：
club:5:activities:page1） - 缓存未命中时查询数据库，并使用MyBatis-Plus分页插件（每页15条）
- 返回数据同时写入Redis（设置TTL）
- 前端收到响应后更新Pinia状态管