# student_union

**Repository Path**: wjx157/student_union

## Basic Information

- **Project Name**: student_union
- **Description**: 计算机学院学生会网站
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-14
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 青岛软件学院、计算机科学与技术学院学生会管理系统

一个现代化的学生会管理网站，采用 React + Vite + Ant Design 构建，界面美观，适合答辩展示。专为软件学院和计算机学院的学生会工作场景设计，包含项目管理、活动管理、成员管理等核心功能。

## 技术栈

- **前端框架**: React 18
- **构建工具**: Vite
- **UI 组件库**: Ant Design 5
- **图表库**: ECharts
- **路由**: React Router v6

## 功能模块

### 1. 数据看板 (Dashboard)
- 统计卡片展示（成员数、项目数、活动数、获奖数）
- 月度活动统计柱状图
- 部门成员分布饼图
- 项目完成趋势折线图

### 2. 项目管理 (Project)
- 项目列表展示
- 项目状态管理（进行中、已完成、计划中）
- 项目进度可视化
- 项目搜索功能
- *后续可扩展：项目详情、任务分配、进度跟踪等后端功能*

### 3. 活动管理 (Activity)
- 活动列表展示
- 活动信息（时间、地点、参与人数）
- 活动状态管理
- 活动搜索功能

### 4. 成员管理 (Member)
- 成员列表展示
- 成员信息管理（姓名、学号、部门、职位等）
- 部门分类标签
- 成员搜索功能

## 快速开始

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

访问 http://localhost:3000

### 构建生产版本

```bash
npm run build
```

### 预览生产构建

```bash
npm run preview
```

## 项目结构

```
student_union/
├── public/              # 静态资源
├── src/
│   ├── components/     # 公共组件
│   ├── layouts/        # 布局组件
│   │   └── AppLayout.jsx
│   ├── pages/          # 页面组件
│   │   ├── Dashboard/  # 数据看板
│   │   ├── Project/    # 项目管理
│   │   ├── Activity/   # 活动管理
│   │   └── Member/     # 成员管理
│   ├── router/         # 路由配置
│   │   └── AppRouter.jsx
│   ├── styles/         # 样式文件
│   ├── App.jsx         # 根组件
│   └── main.jsx        # 入口文件
├── index.html
├── package.json
└── vite.config.js
```

## 后续开发计划

- [ ] 后端 API 接口开发
- [ ] 用户登录认证
- [ ] 项目管理详细功能（任务分配、进度跟踪）
- [ ] 活动报名系统
- [ ] 成员权限管理
- [ ] 数据导出功能
- [ ] 消息通知系统

## 注意事项

- 当前版本使用模拟数据，后续需要对接后端 API
- 项目管理模块已预留接口，方便后续完善后端功能
- 所有编辑、删除等操作目前为前端演示，需要后端支持