AssociationHUB

AssociationHUB is a web application designed to help manage and organize the activities of an association. This application allows administrators to manage users, events, news, achievements, and more. Members of the association can view upcoming events, news updates, and other relevant information.

AssociationHUB - Live Demo of the website

Introduction
Story
Features
Tech Used
Getting Started
- Prerequisites
- Installation
Usage
- Admin Panel
- User Interaction
Contributing
- Route Examples
- Small Explanation
Video Demo
License

Story

We met with a local community association to explore potential projects. They shared their struggles with managing their workflow efficiently. Inspired by their needs, we decided to develop AssociationHub, a web app designed to streamline and simplify association management. AssociationHub will help associations manage their tasks, members, and events more effectively, making their operations smoother and more organized.

Features

User Management
Event Management
News Management
Achievement Tracking
Contact Messaging
Reports and Attendance Tracking

Tech Used

Flask
MySQL
Python
Bootstrap
Free Deployement Thanks To PythonAnywhere

Getting Started

Follow these instructions to set up and run the AssociationHUB application on your local machine.

Prerequisites

Python 3.x
Flask
SQLAlchemy
MySQL

Installation

Clone the repository.
Install the required dependencies.
Create a database with install.sql.
Run the application:
```
flask run
```
Access the application at http://127.0.0.1:5000.

Note: Deploying to PythonAnywhere need some extra tweaks, more info here

Usage

Admin Panel

Admins can log in and access the admin panel to manage users, events, news, achievements, and more.

User Interaction

Users can view the list of events, news updates, achievements, and contact the association via the contact form.

Contributing

Route Exemples

# User routes
@admin_bp.route('/users', methods=['POST'])
@login_required
def create_user():
    if not current_user.is_admin:
        flash('You do not have permission to create users.', 'error')
        return redirect(url_for('main.home'))
    
    username = request.form.get('username')
    email = request.form.get('email')
    password = request.form.get('password')
    is_admin = request.form.get('is_admin') == 'on'
    section = request.args.get('section', 'users')
    # Checking required fields
    if not username or not email or not password:
        flash('Username, email, and password are required fields.', 'error')
        return redirect(url_for('admin.dashboard', section='users'))

    # Checking the uniqueness of the email
    existing_user = User.query.filter_by(email=email).first()
    if existing_user:
        flash('Email address is already in use. Please use a different email.', 'error')
        return redirect(url_for('admin.dashboard', section='users'))

    # Creation of the new user
    new_user = User(username=username, email=email, is_admin=is_admin)
    new_user.set_password(password)
    
    # Add to database
    db.session.add(new_user)
    db.session.commit()

    flash('New user added successfully.', 'success')
    return redirect(url_for('admin.dashboard', section='users'))

Small Explanation

Defines a route /users with a POST method within the admin_bp blueprint.
Checks if the current user is an admin.
Retrieves user input from the form.
Validates required fields (username, email, password).
Checks if the email address is already in use by querying the database.
Creates a new User object with the provided username, email, and is_admin status.
Sets the password for the new user.
Adds the new user to the database session and commits the session.
Displays a success message.
Redirects to the admin dashboard, showing the 'users' section.

Video Demo

Note: You will leave this page if you click the picture.

License

This project is made by Salim Abdessamad and Ahmed Sahbeddine.

vapeasnl/AssociationHUB