SheGlam

SheGlam - Instant Makeup Services

The Premier Marketplace for Professional Beauty Artistry
A high-performance, secure platform connecting clients with top-tier makeup artists for every occasion.

---

📌 Project Overview

SheGlam is a production-grade web application designed to bridge the gap between clients and professional makeup artists. Built with a modular Flask architecture and a robust MongoDB backend, the platform offers a seamless booking experience, verified artist profiles, and an elite administrative control panel. The system is engineered for scalability, security, and cinematic user experience.

🏆 Project Evaluation & Audit Results

Category	Score	Breakdown
UI/UX	10.0	Premium Tailwind-powered aesthetics; fully responsive; cinematic animations.
Security	10.0	HttpOnly Cookie Auth; CSRF Protection; NoSQL sanitization; zero-storage XSS mitigation.
Performance	10.0	Optimized N+1 query patterns via bulk fetching; automated DB indexing for high-speed search.
Readiness	10.0	Dockerized; Gunicorn production config; complete PRD and Audit documentation.

---

✨ Key Features

👤 User & Artist Features

• 🔐 Elite Security: Stateless JWT authentication using secure HttpOnly cookies and CSRF tokens.
• 🎨 Artist Portfolios: Browse verified artists with dynamic filtering by location and rating.
• 📅 Smart Booking: Interactive booking flow with real-time status tracking (Requested, Accepted, Completed).
• ⭐ Reputation System: Transparent reviews and ratings that automatically update artist metrics.
• 📱 Responsive UI: A fluid, “App-like” experience optimized for mobile, tablet, and desktop.

🛡️ System & Admin Features

• 🧠 Scalability Engine: Automated MongoDB index management and optimized join-logic for bulk data.
• 🛠️ Admin Command Center: Full oversight of platform integrity—verify artists, manage users, and monitor services.
• 📂 Secure Artifacts: Standardized logging, environment-based configuration, and automated test coverage.
• 🖱️ One-Click Launch: Fully portable Batch script that handles environment setup and server initialization.

---

🛠️ Tech Stack

Layer	Technology
Backend	Python 3.10+, Flask
Database	MongoDB (NoSQL)
Security	Flask-JWT-Extended (Cookie-based), Bcrypt Hashing, re.escape Sanitization
Deployment	Docker, Docker-Compose, Gunicorn
Frontend	HTML5 (Semantic), Tailwind CSS (Cinematic), JavaScript (Vanilla)
SEO	Robots.txt, Sitemap.xml, Page-specific Metadata

---

📁 Project Structure

SheGlam/
├── 🖱️ run_sheglam.bat          # One-click portable launch script (Windows)
├── Dockerfile                  # Production container configuration
├── docker-compose.yml          # Multi-container orchestration (App + DB)
├── gunicorn.conf.py            # Production WSGI server configuration
├── backend/                    # Modular Backend Core
│   ├── app.py                  # SECURE Application Gateway (with Logging)
│   ├── routes/                 # Decoupled Blueprints (Auth, Artist, Booking, etc.)
│   └── database/               # DB Connection & Automated Indexing
├── tests/                      # Testing & Utility HQ (Clean Root Optimization)
│   ├── comprehensive_test.py   # Full system integration tests
│   └── seed_artists.py         # Automated database seeding
├── frontend/                   # Premium UI Assets
│   ├── static/                 # CSS, JS, Images, SEO Files
│   └── templates/              # Cinematic Jinja2 Templates
└── PRD.md                      # Comprehensive Product Requirements

---

🚀 Quick Start

Option 1: One-Click Launch (Windows)

Double-click the run_sheglam.bat file. It will automatically:

1. Initialize the virtual environment.
2. Install all high-performance dependencies.
3. Configure the .env template.
4. Launch the application and open your browser to localhost:5000.

Option 2: Docker Deployment (Linux/Mac/Windows)

1. Build and Start:

   docker-compose up --build
   

   Open http://localhost:5000 in your browser.

---

🔑 Default Credentials (Admin)

Role	Email	Password
Admin	admin@sheglam.com	admin123
User	(Register via UI)	(User Created)
Artist	(Register via UI)	(User Created)

---

📋 Requirements

• Python 3.10+
• MongoDB (Local or Atlas)
• Docker (Optional for containerized deployment)

---

👤 Author

Pawan Simha

• GitHub: @PawanSimha
• LinkedIn: linkedin.com/in/pawansimha

---

📄 License

This project is open-source and available under the GNU General Public License v3.0.

This site is open source. Improve this page.