# abc

**Repository Path**: zzxu/abc

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园社团网站 (Campus Club Website)

这是一个基于 Python Flask 和 MySQL 开发的校园社团管理系统。采用 B/S 架构，旨在为高校提供便捷的社团信息展示、成员管理和活动组织平台。

## 功能特性

### 1. 用户模块
- **注册与登录**：学生可以注册账号并登录系统。
- **个人中心**：查看个人信息及参与的社团和活动。

### 2. 社团管理
- **社团展示**：浏览所有社团，查看社团详情（简介、负责人等）。
- **创建社团**：注册用户可以申请创建新社团（自动成为社长）。
- **社团编辑**：社长可以编辑社团的基本信息。

### 3. 成员管理
- **申请加入**：用户可以申请加入感兴趣的社团。
- **成员审核**：社长可以查看入团申请，进行批准或拒绝操作。
- **成员管理**：社长可以查看当前成员列表，并移除成员。

### 4. 活动中心
- **活动发布**：社长可以发布社团活动（标题、内容、时间、地点）。
- **活动展示**：所有用户均可浏览近期活动。
- **活动报名**：用户可以在线报名参加活动，或取消报名。

## 技术栈

- **后端**：Python 3.12, Flask 3.x
- **数据库**：MySQL 8.0
- **ORM**：SQLAlchemy
- **前端**：HTML5, CSS3, Bootstrap 5
- **包管理**：uv

## 快速开始

### 1. 环境准备

确保本地已安装以下工具：
- [Docker](https://www.docker.com/) (用于运行 MySQL)
- [uv](https://github.com/astral-sh/uv) (Python 包管理工具)

### 2. 启动数据库

使用 Docker Compose 启动 MySQL 数据库：

```bash
docker-compose up -d
```

### 3. 安装依赖

使用 `uv` 安装项目依赖：

```bash
uv sync
```

### 4. 初始化数据

运行种子脚本以创建数据库表并填充测试数据（包含 30+ 用户、8+ 社团及相关活动）：

```bash
uv run python seed.py
```

> **注意**：默认管理员账号为 `admin`，密码为 `password`。

### 5. 运行应用

启动 Flask 开发服务器：

```bash
uv run python run.py
```

访问浏览器：[http://localhost:5000](http://localhost:5000)

## 项目结构

```
.
├── app/
│   ├── activities/      # 活动模块
│   ├── auth/            # 认证模块
│   ├── clubs/           # 社团模块
│   ├── static/          # 静态文件 (CSS, JS)
│   ├── templates/       # HTML 模板
│   ├── __init__.py      # 应用工厂
│   ├── config.py        # 配置类
│   └── models.py        # 数据库模型
├── docs/                # 文档目录
├── config.toml          # 配置文件
├── docker-compose.yml   # Docker 配置
├── pyproject.toml       # 依赖配置
├── run.py               # 启动脚本
└── seed.py              # 数据填充脚本
```