# association

**Repository Path**: huxiqing/association

## Basic Information

- **Project Name**: association
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 高校社团管理系统

基于 PRD 实现的前后端分离网站，包含学生端、社团管理员端、指导老师端、总管理员端。

## 技术栈

- 前端：Vue 3、Vite、Pinia、Vue Router、Element Plus、ECharts、Axios
- 后端：Spring Boot 3、JDBC、JWT、MySQL
- 数据库：MySQL 8，默认库名 `association_db`

## 默认数据库

```text
host: localhost:3306
username: root
password: root
database: association_db
```

后端启动时会自动建表并写入演示数据。

## 演示账号

密码统一为 `123456`。

| 角色 | 账号 |
| --- | --- |
| 学生 | student |
| 社团管理员 | clubadmin |
| 指导老师 | teacher |
| 总管理员 | admin |

## 启动方式

后端：

```powershell
cd backend
mvn -q -DskipTests package
java -jar target\association-backend-1.0.0.jar
```

前端：

```powershell
cd frontend
$env:ComSpec='C:\Windows\System32\cmd.exe'
npm install
npm run dev
```

访问：

- 前端：http://localhost:5173/
- 后端：http://localhost:8080/
- Swagger：http://localhost:8080/swagger-ui.html

## 已实现功能

- 登录、JWT 鉴权、角色权限控制
- 社团列表、详情、申请加入
- 公告列表、公告详情、公告后台管理
- 活动列表、活动详情、报名与取消报名
- 社团论坛发帖、评论、帖子详情
- 学生个人中心
- 社团管理员审核入团申请、成员管理、公告/活动管理
- 指导老师维护社团资料、审核活动
- 总管理员用户管理、社团管理、分类字典、操作日志
- 图片上传：头像、社团 Logo、活动封面
- ECharts 数据统计图
- 搜索、筛选、分页
- 移动端基础适配

## 常见问题

如果 Windows 下 `npm install` 报 `ERR_INVALID_ARG_TYPE: The "file" argument must be of type string`，先设置：

```powershell
$env:ComSpec='C:\Windows\System32\cmd.exe'
```

再重新运行 `npm install`。