🛠 Features

• ✔ Secure User Registration & Email Verification
• ✔ Password Hashing & User Authentication
• ✔ Forgot Password
• ✔ OAuth Authentication (Google & GitHub)
• ✔ Role-Based Access Control (RBAC) – Admin, Editor, User
• ✔ Custom Error Pages (404 & 500)
• ✔ Logging & Monitoring – Tracks user activity and errors
• ✔ Database Migrations & Seeders for easy setup
• ✔ Modular & Scalable Architecture

🛠 Technical Details

• 🔹 Framework: Flask
• 🔹 Authentication: OAuth (Google & GitHub), Email Verification
• 🔹 Session Management: Flask-Login
• 🔹 Database: SQLite (default), PostgreSQL, MySQL
• 🔹 Dependencies: Flask-Mail, Flask-Migrate, Flask-Limiter, Flask-WTF, etc.

📌 Installation & Setup

1️⃣ Download Zip File and Change Directory

cd flask-auth-system-paid

2️⃣ Create a Virtual Environment

python -m venv venv
source venv/bin/activate   # On macOS/Linux
venv\Scripts\activate      # On Windows

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Configure Environment Variables

Create a .env file and add:

FLASK_APP=run.py
FLASK_ENV=development
SECRET_KEY=your-secret-key
SQLALCHEMY_DATABASE_URI=sqlite:///app.db
MAIL_SERVER=smtp.your-email.com
MAIL_PORT=587
MAIL_USERNAME=your-email@example.com
MAIL_PASSWORD=your-email-password
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret

5️⃣ Database Setup

flask db init
flask db migrate -m "Initial migration"
flask db upgrade

To seed the database with default roles and test users:

python seeder/run_seeder.py

6️⃣ Run the Application

flask run  # or python run.py

The app will be available at http://127.0.0.1:5000/