项目简介

校园社团管理与发展态势分析系统是一套面向高校社团管理场景的 Web 系统，采用 Spring Boot + Vue2 + MySQL 的前后端分离架构开发。

系统包含前台用户端和后台管理员端。前台用于学生浏览社团、活动、公告和发展排行，后台用于管理员维护用户、社团、活动、成员、经费、公告、反馈等数据，并通过图表分析社团发展态势。

功能概览

端	功能
通用入口	登录、注册、角色识别跳转
前台用户端	社团大厅、活动日程、公告通知、发展排行
后台管理员端	数据概览、用户管理、社团分类、社团管理、成员管理、活动管理、经费管理、公告管理、反馈分析
数据分析	活动趋势、社团分类结构、成员增长、经费收支、满意度排行、发展指数、发展建议

技术栈

层级	技术	说明
后端	Java 1.8	后端开发语言
后端	Spring Boot 2.6.13	Web 服务框架
后端	Spring JDBC	数据访问
后端	Maven	项目构建和依赖管理
前端	Vue 2.7.16	页面开发
前端	Vue Router 3.6.5	前端路由
前端	Axios 0.27.2	接口请求
前端	ECharts 5.4.3	数据可视化图表
数据库	MySQL	数据持久化

项目结构

.
├── pom.xml                         # 后端 Maven 配置
├── README.md                       # 项目说明文档
├── sql                             # 数据库脚本
│   ├── 01_schema.sql               # 建库建表脚本
│   └── 02_data.sql                 # 初始化数据脚本
├── src
│   └── main
│       ├── java/com/jay/campusclub # 后端业务代码
│       │   ├── common              # 通用响应和分页对象
│       │   ├── config              # 跨域和异常处理配置
│       │   ├── controller          # 接口控制层
│       │   ├── dto                 # 请求和响应数据对象
│       │   ├── repository          # 数据访问层
│       │   ├── service             # 业务逻辑层
│       │   └── util                # 工具类
│       └── resources
│           └── application.yml     # 后端运行配置
└── frontend                        # Vue 前端工程
    ├── package.json                # 前端依赖和脚本
    ├── vue.config.js               # 前端端口和接口代理配置
    ├── public
    │   └── index.html              # 前端入口页面
    └── src
        ├── api                     # 接口封装
        ├── assets                  # 全局样式资源
        ├── router                  # 前端路由
        └── views                   # 页面组件

环境要求

• JDK 1.8
• Maven 3.6+
• MySQL 5.7+ 或 MySQL 8.0+
• Node.js 16
• npm

数据库初始化

数据库名称为 campus_club。数据库脚本位于 sql 目录，执行顺序如下：

1. 执行 sql/01_schema.sql 创建数据库和数据表。
2. 执行 sql/02_data.sql 导入初始化数据。

命令行导入示例：

mysql -u root -p --default-character-set=utf8mb4 < sql/01_schema.sql
mysql -u root -p --default-character-set=utf8mb4 < sql/02_data.sql

两个 SQL 文件均已设置 SET NAMES utf8mb4;，建议数据库和客户端导入时统一使用 utf8mb4 编码，避免中文数据乱码。

后端数据库连接配置位于 src/main/resources/application.yml，默认连接本地 MySQL：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/campus_club?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true
    username: root
    password: root

如果本地 MySQL 账号或密码不同，需要先修改 username 和 password。

后端启动

在项目根目录执行：

mvn spring-boot:run

后端默认端口为 8080，启动后接口地址为：

http://localhost:8080

前端启动

进入前端目录并安装依赖：

cd frontend
npm install

启动前端开发服务：

npm run serve

前端默认访问地址为：

http://localhost:8081

前端开发环境通过 frontend/vue.config.js 将 /api 请求代理到后端 http://localhost:8080。

默认账号

初始化数据中已提供以下登录账号，默认密码均为 123456。

角色	用户名	密码	说明
管理员	admin	123456	登录后进入后台管理员端
管理员	teacher01	123456	可作为指导老师或管理人员账号使用
学生用户	student01	123456	登录后进入前台用户端

功能模块说明

通用入口

模块	页面路径	功能
登录注册	/login	用户登录、学生注册、按角色跳转

前台用户端

模块	页面路径	功能
用户门户	/portal	展示社团大厅、活动日程、公告通知和发展排行

后台管理员端

模块	页面路径	功能
数据概览	/admin/dashboard	查看核心指标、趋势图、分类结构、满意度排行和发展指数
用户管理	/admin/module/users	维护用户账号、角色、学院、专业、年级和状态
社团分类	/admin/module/categories	维护社团分类名称、说明、主题色、排序和状态
社团管理	/admin/module/clubs	维护社团资料、负责人、指导老师、简介、等级和状态
成员管理	/admin/module/members	维护社团成员、职务、加入日期、活跃积分和成员状态
活动管理	/admin/module/activities	维护活动标题、类型、地点、时间、容量、预算和活动状态
经费管理	/admin/module/finance	维护经费收入支出、金额、来源、说明、审核人和审核状态
公告管理	/admin/module/announcements	维护通知公告标题、内容、发布人、发布时间、发布范围和状态
反馈分析	/admin/module/feedback	维护用户反馈、满意度评分、管理员回复和处理状态
发展态势	/admin/development-trend	结合成员增长、经费收支、反馈评分和发展指数生成分析建议

作者信息

@作者：Jay
@定制联系vx：Jay8059
@开发日期：2026年

本项目支持二次开发和定制扩展，可根据实际需求调整功能模块、页面样式、数据库字段和部署方式。如需定制开发或远程部署，可通过微信 Jay8059 联系。