Lusan Sapkota | Full Stack Portfolio

Professional portfolio showcasing expertise in Full Stack Development & AI/ML Engineering

🚀 About

A comprehensive portfolio website featuring a modern, responsive design with advanced CMS capabilities. Built with enterprise-grade architecture and optimized for performance, SEO, and user experience.

✨ Key Features

🎯 Core Functionality

• Multi-domain Architecture - Main site with specialized subdomains (wiki, git, donation, store)
• Advanced CMS - Complete admin panel for content management
• SEO Optimized - 100/100 SEO score with structured data and meta optimization
• Responsive Design - Mobile-first approach with modern UI/UX

🔧 Technical Features

• Database-driven - Dynamic content with PostgreSQL backend
• Real-time Updates - AJAX-powered admin interface
• Email Integration - Newsletter system and contact form automation
• GitHub Integration - Live repository data and project showcasing
• Performance Optimized - Redis caching and CDN integration

🛠️ Technology Stack

Backend

• Framework: Flask 2.3+ with Blueprint architecture
• Database: PostgreSQL with SQLAlchemy ORM
• Caching: Redis for session management and rate limiting
• Authentication: Flask-Login with secure session handling
• Email: SMTP integration for notifications and newsletters
• API Integration: GitHub API for repository data

Frontend

• Languages: HTML5, CSS3, JavaScript (ES6+)
• Framework: Bootstrap 5 with custom components
• Icons: Font Awesome 6
• Animations: Custom CSS transitions and JavaScript interactions
• Forms: AJAX-powered with real-time validation

DevOps & Infrastructure

• Web Server: Nginx with SSL/TLS termination
• Application Server: Gunicorn with multiple workers
• Process Management: Systemd services
• Monitoring: Custom health checks and performance tracking
• Backup: Automated database and file system backups
• Deployment: Git-based CI/CD with automated testing

Security

• Rate Limiting: Flask-Limiter with Redis backend
• Input Validation: Comprehensive sanitization and CSRF protection
• SSL/TLS: Let's Encrypt certificates with auto-renewal
• Headers: Security headers including CSP and HSTS
• Authentication: Secure password hashing with Werkzeug

Third-party Services

• CDN: Cloudflare for global performance
• DNS: Cloudflare DNS with proxy protection
• Analytics: Google Analytics integration (optional)
• Monitoring: Custom monitoring with email alerts

� Quick Start

Prerequisites

Python 3.11+, PostgreSQL, Redis (optional for caching)

Local Development (use dev branch)

# Clone repository
git clone hhttps://github.com/Lusan-sapkota/portfolio/tree/dev
cd portfolio

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Create database and run
python create_database.py
python create_admin.py
python app.py

Production Branch Updates

Please refer to the main branch for all production changes. Multiple files have been updated—check the commit history for detailed insights, especially if the development branch is incomplete.

Production Deployment

For complete production setup with Oracle Cloud + Cloudflare, see DEPLOYMENT_GUIDE.md

🌐 Live Website

Main Site: lusansapkota.com.np

Subdomains:

• Wiki: wiki.lusansapkota.com.np
• Git: git.lusansapkota.com.np
• Donation: donation.lusansapkota.com.np
• Store: store.lusansapkota.com.np

� Performance & SEO

• SEO Score: 100/100 ✅
• Performance: Optimized with CDN and caching
• Accessibility: WCAG 2.1 compliant
• Security: A+ SSL rating with security headers
• Mobile: Fully responsive design

📞 Contact

Professional Inquiries: contact@lusansapkota.com.np

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

© 2025 Lusan Sapkota | Full Stack Developer & AI/ML Engineer

🇳🇵 Made with ❤️ in Nepal