1. 项目背景与意义
随着高校社团数量和学生参与度的不断提升，传统的人工管理方式在社团活动组织、成员信息维护、活动报名统计等方面暴露出效率低、易出错、信息不透明等问题。校园社团活动管理系统旨在通过信息化手段，为社团管理员、社团负责人和普通学生提供一个统一、高效、可追溯的活动管理平台。
本系统的设计与实现具有以下现实意义：
- 提升管理效率：将活动发布、报名、审核、签到等流程线上化，减少人工统计和重复沟通成本。
- 信息透明共享：学生可实时查看社团动态和活动安排，避免信息滞后或遗漏。
- 数据沉淀分析：系统自动记录活动参与数据，为社团考核和活动效果评估提供数据支撑。
- 锻炼工程能力：作为典型的Java Web综合项目，覆盖前端交互、后端业务、数据库设计和系统部署全流程，适合课程设计和毕业设计实践。
2. 系统技术栈
本系统采用经典的Java Web分层架构，前后端分离与服务器端渲染相结合，兼顾开发效率与维护性。核心技术栈如下：
| 层次 | 技术选型 | 说明 |
|---|---|---|
| 前端页面 | HTML、CSS、JavaScript、JSP | 使用JSP作为视图层，配合Bootstrap框架实现响应式页面布局 |
| 后端框架 | Spring、Spring MVC、MyBatis | SSM经典组合，实现控制层、业务层与持久层解耦 |
| 数据库 | MySQL 8.0 | 存储用户、社团、活动、报名等核心业务数据 |
| 服务器 | Tomcat 9 | Java Web应用部署容器 |
| 构建工具 | Maven | 统一管理项目依赖与构建流程 |
| 其他 | Lombok、FastJSON、PageHelper | 简化实体类开发、JSON数据交互与分页查询 |
3. 系统功能模块设计
系统面向三类角色设计，分别为系统管理员、社团管理员和普通学生，各角色拥有不同的功能权限。
3.1 学生端功能
- 用户注册与登录：支持学号注册、密码加密存储、登录状态校验。
- 社团浏览与加入：查看社团列表和详情，在线提交加入申请。
- 活动浏览与报名：查看活动公告、活动详情，在线报名并查看报名状态。
- 个人中心：管理个人信息、查看我的社团、我的活动报名记录。
3.2 社团管理员功能
- 社团信息管理：维护社团简介、logo、成员名单。
- 活动发布与管理：创建活动、设置活动时间地点和人数上限、编辑或取消活动。
- 报名审核：查看报名列表，审核通过或拒绝学生报名。
- 活动签到管理：发布签到码或扫码签到，记录实际参与人员。
3.3 系统管理员功能
- 用户管理：查询、禁用、启用学生账号和社团管理员账号。
- 社团审核：审核新社团的创建申请，监督社团运行状态。
- 数据统计：按社团、按月份统计活动数量与参与人次，生成简单报表。
- 系统公告管理：发布平台级通知公告。
4. 数据库设计
系统核心数据表包括用户表、社团表、社团成员表、活动表、活动报名表和公告表。以下为主要表结构说明：
| 表名 | 主要字段 | 说明 |
|---|---|---|
| t_user | id、username、password、real_name、role、phone、status | 用户表，role区分学生、社团管理员、系统管理员 |
| t_club | id、club_name、description、logo_url、president_id、status | 社团表，president_id关联社团负责人 |
| t_club_member | id、club_id、user_id、join_time、status | 社团成员关系表 |
| t_activity | id、club_id、title、content、location、start_time、max_people、status | 活动表，status区分草稿、报名中、已结束 |
| t_activity_signup | id、activity_id、user_id、signup_time、status | 活动报名表，status区分待审核、已通过、已拒绝 |
| t_notice | id、title、content、create_time、publisher_id | 系统公告表 |
5. 核心代码实现
本节选取系统中最具代表性的三个核心功能进行代码说明：用户登录拦截、活动发布与报名审核。
5.1 用户登录与拦截器
系统使用Spring MVC拦截器统一校验用户登录状态，未登录用户访问受保护资源时自动跳转到登录页面。
public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); User user = (User) session.getAttribute("loginUser"); if (user == null) { // 未登录，重定向到登录页 response.sendRedirect(request.getContextPath() + "/login"); return false; } return true; } }在Spring MVC配置文件中注册拦截器，并指定需要拦截的URL路径：
<mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/register"/> <mvc:exclude-mapping path="/static/**"/> <bean class="com.club.interceptor.LoginInterceptor"/> </mvc:interceptor> </mvc:interceptors>5.2 活动发布功能
社团管理员登录后，通过表单提交活动信息，后端Controller接收参数并调用Service层完成活动创建。以下为Controller层核心代码：
@Controller @RequestMapping("/activity") public class ActivityController { @Autowired private ActivityService activityService; @PostMapping("/publish") @ResponseBody public Result publish(@RequestBody Activity activity, HttpSession session) { User user = (User) session.getAttribute("loginUser"); activity.setClubId(user.getClubId()); activity.setStatus(1); // 1表示报名中 boolean success = activityService.publishActivity(activity); return success ? Result.success("活动发布成功") : Result.error("活动发布失败"); } }Service层负责业务校验，包括活动时间不能早于当前时间、活动人数上限必须大于0等：
@Service public class ActivityServiceImpl implements ActivityService { @Autowired private ActivityMapper activityMapper; @Override public boolean publishActivity(Activity activity) { if (activity.getStartTime().before(new Date())) { throw new BusinessException("活动开始时间不能早于当前时间"); } if (activity.getMaxPeople() == null || activity.getMaxPeople() <= 0) { throw new BusinessException("活动人数上限必须大于0"); } return activityMapper.insert(activity) > 0; } }5.3 活动报名与人数校验
学生报名活动时，系统需要校验活动状态、是否重复报名以及报名人数是否已满。以下为报名核心逻辑：
@Service public class SignupServiceImpl implements SignupService { @Autowired private ActivityMapper activityMapper; @Autowired private SignupMapper signupMapper; @Override @Transactional(rollbackFor = Exception.class) public boolean signUp(Integer activityId, Integer userId) { // 1. 查询活动信息 Activity activity = activityMapper.selectById(activityId); if (activity == null || activity.getStatus() != 1) { throw new BusinessException("活动不存在或不在报名时间内"); } // 2. 校验是否重复报名 int count = signupMapper.countByActivityAndUser(activityId, userId); if (count &gt; 0) { throw new BusinessException("您已报名该活动，请勿重复报名"); } // 3. 校验报名人数是否已满 int signedCount = signupMapper.countByActivity(activityId); if (signedCount &gt;= activity.getMaxPeople()) { throw new BusinessException("活动报名人数已满"); } // 4. 插入报名记录 Signup signup = new Signup(); signup.setActivityId(activityId); signup.setUserId(userId); signup.setStatus(0); // 0表示待审核 return signupMapper.insert(signup) &gt; 0; } }上述代码使用@Transactional注解保证报名操作的原子性，避免并发情况下出现超员报名的问题。
6. 系统测试与总结
系统开发完成后，分别进行了功能测试、接口测试和简单的并发测试。功能测试覆盖了学生注册登录、社团加入、活动报名、管理员审核等核心流程，测试结果均符合预期。接口测试使用Postman对活动发布、报名、审核等关键接口进行了验证，返回数据格式统一。
本系统基于Java Web技术栈，采用SSM框架实现了校园社团活动管理的基本业务闭环，具备良好的扩展性。后续可在此基础上进一步引入Redis缓存热点数据、使用WebSocket实现活动消息实时推送，以及基于ECharts完善数据可视化报表，使系统更加完善和实用。
