⚡ OL-Tager (NeoPulse)

A modern, full-stack e-commerce platform for healthcare & medical supplies — built with Flask, PostgreSQL, and a premium glassmorphism UI.

📖 Overview

OL-Tager (branded as NeoPulse) is a full-featured e-commerce web application designed for browsing, managing, and purchasing medical and healthcare products. It features a sleek, modern storefront with dark/light theme support and a comprehensive admin dashboard for complete store management.

✨ Features

🛍️ Customer-Facing Storefront

• Landing Page — Hero section, featured products, certifications, user reviews, and contact form
• Product Catalog — Dynamic product grid with category filtering, sorting, and search
• Product Detail Modal — Rich product details in a full-screen modal overlay
• Shopping Cart — Slide-out cart sidebar with checkout flow
• Dark / Light Theme — System-aware theme toggle with localStorage persistence

🔐 Authentication System

• User Registration — With strong password validation:
• Minimum 8 characters
• At least one uppercase letter, one number, and one special character
• Duplicate username/email detection
• Email format validation via regex
• User Login / Logout — Session-based auth with 30-day cookie support
• Password Security — Werkzeug generate_password_hash / check_password_hash
• CSRF Protection — Flask-WTF CSRF tokens on all forms

🛠️ Admin Dashboard

• Dashboard Overview — Revenue, orders, active users, and conversion rate metrics
• Product Management — Full CRUD: add, edit, delete products with image upload
• User Management — View all registered users
• Activity Logs — Comprehensive audit trail logging:
• User registrations, logins (success/failure)
• Admin logins (success/failure)
• Product updates
• IP address tracking via api.ipify.org
• Admin Auth — Separate admin login system with session-based access control

🎨 UI / UX

• Glassmorphism Design — Frosted glass effects with backdrop-filter: blur()
• Responsive Layout — Mobile-first design with hamburger menu and adaptive grids
• Micro-Animations — Hover transitions, scale effects, and smooth scroll behavior
• Modern Typography — Google Fonts (Outfit family)
• TailwindCSS — Utility-first styling via CDN

🗄️ Database Schema

The app uses PostgreSQL with four tables, auto-created on startup:

🏗️ Project Structure

OL-Tager/
├── main.py                # Flask application entry point & all routes
├── requirements.txt       # Python dependencies
├── .env                   # Environment variables (DB credentials)
├── .gitignore             # Git ignore rules
├── README.md              # This file
├── static/
│   └── img/               # Product images & assets
│       └── default.png    # Default product placeholder
└── templates/
    ├── index.html          # Landing page (public storefront)
    ├── products.html       # Product catalog (authenticated users)
    ├── login.html          # User login page
    ├── register.html       # User registration page
    ├── 404.html            # Custom 404 error page
    ├── _messages.html      # Flash message partial
    ├── admin_login.html    # Admin login page
    ├── admin_dashboard.html# Admin dashboard with metrics
    ├── admin_products.html # Product management (CRUD)
    ├── admin_users.html    # User list view
    ├── admin_logs.html     # Activity logs viewer
    └── admin_analytics.html# Analytics page

🚀 Getting Started

Prerequisites

• Python 3.10+
• PostgreSQL (running locally or remote)
• pip (Python package manager)

1. Clone the Repository

git clone https://github.com/Mhkh2642009/OL-Tager.git
cd OL-Tager

2. Create a Virtual Environment

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

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

Create a .env file in the project root with your PostgreSQL credentials:

DB_HOST=localhost
DB_PORT=5432
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password

5. Run the Application

python main.py

The server will start at http://0.0.0.0:5000 (or the port specified by the PORT env variable).

🔑 Admin Access

Navigate to /admin/login to access the admin panel.

Default admin credentials are hardcoded in main.py. It is strongly recommended to change these or move them to environment variables before deploying to production.

📦 Dependencies

🗺️ API Routes

Public Routes

Admin Routes

🔒 Security Features

• ✅ Password hashing with Werkzeug (PBKDF2)
• ✅ CSRF protection on all forms (Flask-WTF)
• ✅ Server-side sessions (filesystem-backed)
• ✅ HTTP-only session cookies
• ✅ SameSite=Lax cookie policy
• ✅ File upload validation with secure_filename()
• ✅ 16 MB max upload size limit
• ✅ Input validation (email regex, password strength)
• ✅ Activity logging with IP tracking

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is open source and available under the MIT License.

Made with ❤️ by the OL-Tager Team