portfolio-v2.0/ ├── 📁 Root Files & Configuration │ ├── manage.py # Django management script │ ├── requirements.txt # Python dependencies │ ├── db.sqlite3 # SQLite database (auto-generated) │ ├── .env # Environment variables (create this) │ ├── .gitignore # Git ignore rules │ ├── README.md # Project documentation │ ├── SETUP.md # Detailed setup guide │ ├── CONTRIBUTING.md # Contribution guidelines │ ├── CODE_QUALITY.md # Code standards & best practices │ ├── SECURITY.md # Security policy & vulnerability reporting │ ├── deploye_key # SSH deploy key (if needed) │ └── deploye_key.pub # SSH public key (if needed) │ ├── 📁 Django Apps │ ├── config/ # Main Django project settings │ │ ├── __init__.py │ │ ├── settings.py # Django configuration │ │ ├── urls.py # URL routing │ │ ├── wsgi.py # WSGI application │ │ └── asgi.py # ASGI application (async support) │ │ │ ├── portfolio/ # Main portfolio application │ │ ├── models.py # Database models (Projects, Skills, etc.) │ │ ├── views.py # View logic │ │ ├── urls.py # URL patterns │ │ ├── admin.py # Django admin configuration │ │ ├── forms.py # Django forms │ │ ├── context_processors.py # Context processors │ │ ├── sitemaps.py # SEO sitemaps │ │ ├── migrations/ # Database migrations │ │ └── templatetags/ # Custom template tags │ │ │ ├── blog/ # Blog system │ │ ├── models.py # Blog models (Post, Comment, Category) │ │ ├── views.py # Blog views │ │ ├── urls.py # Blog URL patterns │ │ ├── admin.py # Blog admin interface │ │ ├── sitemaps.py # Blog SEO │ │ └── migrations/ # Blog database migrations │ │ │ ├── ai/ # AI Assistant (Gemini API) │ │ ├── models.py # AI conversation models │ │ ├── views.py # AI API endpoints │ │ ├── llm_utils.py # AI utility functions │ │ ├── utils.py # Helper functions │ │ ├── urls.py # AI URL patterns │ │ └── templates/ai/ # AI chat templates │ │ │ ├── music/ # Spotify Integration │ │ ├── models.py # Music models (Playlist, Track) │ │ ├── views.py # Music views │ │ ├── spotify_service.py # Spotify API service │ │ ├── urls.py # Music URL patterns │ │ ├── static/ # Music app static files │ │ └── templates/music/ # Music templates │ │ │ ├── auth_app/ # Authentication System │ │ ├── models.py # User models (if extended) │ │ ├── views.py # Auth views (login, signup, etc.) │ │ ├── urls.py # Auth URL patterns │ │ └── migrations/ # Auth migrations │ │ │ ├── notifications/ # Email & Notification System │ │ ├── models.py # Notification models │ │ ├── views.py # Notification views │ │ ├── services.py # Email services │ │ ├── signals.py # Django signals │ │ └── migrations/ # Notification migrations │ │ │ └── roshan/ # Personal Resources App │ ├── models.py # Resource models │ ├── views.py # Resource views │ ├── forms.py # Resource forms │ ├── urls.py # Resource URL patterns │ ├── templates/ # Resource templates │ └── migrations/ # Resource migrations │ ├── 📁 Testing Infrastructure │ ├── tests/ # Test utilities and factories │ │ ├── __init__.py │ │ ├── factories.py # Factory Boy test data generators │ │ └── utils.py # Test utilities and base classes │ │ │ ├── requirements-test.txt # Testing dependencies │ ├── pytest.ini # Pytest configuration │ ├── config/test_settings.py # Test-specific Django settings │ └── TESTING.md # Comprehensive testing documentation │ ├── 📁 Frontend Assets │ ├── static/ # Static files (served in production) │ │ ├── css/ # Compiled CSS files │ │ ├── js/ # JavaScript files │ │ └── images/ # Static images │ │ │ ├── templates/ # HTML Templates │ │ ├── base.html # Base template │ │ ├── home.html # Homepage │ │ ├── aboutme.html # About page │ │ ├── projects.html # Projects listing │ │ ├── project-dtl.html # Project detail │ │ ├── blogs.html # Blog listing │ │ ├── blog-dtl.html # Blog detail │ │ ├── experience.html # Experience page │ │ ├── experience-dtl.html # Experience detail │ │ ├── achievements.html # Achievements page │ │ ├── resources.html # Resources page │ │ ├── resource-detail.html # Resource detail │ │ ├── skill-dtl.html # Skill detail │ │ ├── robots.txt # SEO robots file │ │ ├── auth_app/ # Auth templates │ │ ├── emails/ # Email templates │ │ └── legal/ # Legal pages (privacy, terms) │ │ │ └── media/ # User uploaded files (auto-generated) │ ├── achievements/ # Achievement images │ ├── avatars/ # User avatars │ ├── blog_covers/ # Blog cover images │ ├── project_covers/ # Project cover images │ ├── project_images/ # Project gallery images │ ├── resume/ # Resume files (PDF, etc.) │ └── tech_icons/ # Technology icons │ ├── 📁 Development & Documentation │ ├── screenshots/ # Project screenshots for README │ ├── logs/ # Application logs (auto-generated) │ └── .vscode/ # VS Code settings (optional) │ └── 📁 Deployment & CI/CD └── .github/ # GitHub workflows (if using GitHub Actions)

# Clone the project git clone https://github.com/logicbyroshan/portfolio-v2.0.git cd portfolio-v2.0 # Verify you're in the right directory ls # Should show manage.py, requirements.txt, etc.

# Create missing directories that might cause errors mkdir logs # For application logs mkdir media # For uploaded files (if not exists) mkdir static # For static files (if not exists) # Create media subdirectories (Windows) mkdir media\achievements, media\avatars, media\blog_covers, media\project_covers, media\project_images, media\resume, media\tech_icons # Create media subdirectories (macOS/Linux) mkdir -p media/{achievements,avatars,blog_covers,project_covers,project_images,resume,tech_icons}

# Create virtual environment python -m venv venv # Activate virtual environment # Windows (PowerShell) venv\Scripts\Activate.ps1 # Windows (Command Prompt)  venv\Scripts\activate.bat # macOS/Linux source venv/bin/activate # Verify activation (should show (venv) in prompt) which python # Should point to venv/Scripts/python or venv/bin/python

# Upgrade pip first python -m pip install --upgrade pip # Install requirements pip install -r requirements.txt # Verify installation pip list # Should show Django, etc.

# Create .env file # Windows echo. > .env # macOS/Linux touch .env

# Create initial migrations (if needed) python manage.py makemigrations # Apply migrations python manage.py migrate # Create superuser (optional - for admin access) python manage.py createsuperuser

# Collect static files python manage.py collectstatic --noinput

# Run development server python manage.py runserver # Or specify port python manage.py runserver 8000

# ✅ Solution: Create the logs directory mkdir logs

# ✅ Solution: Make sure you're in the project root directory pwd # Should show .../portfolio-v2.0 ls # Should show manage.py

# ✅ Solution: Enable script execution in PowerShell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # Then activate venv venv\Scripts\Activate.ps1

# ✅ Solution: Use a different port python manage.py runserver 8001 # Or find and kill the process using port 8000 # Windows netstat -ano | findstr :8000 taskkill /PID <PID_NUMBER> /F # macOS/Linux  lsof -ti:8000 | xargs kill -9

# ✅ Solution: Generate Gmail App Password # 1. Enable 2-Factor Authentication on Gmail # 2. Go to Google Account Settings → Security → App Passwords # 3. Generate password for "Mail" # 4. Use this password in EMAIL_HOST_PASSWORD (not your regular password)

# ✅ Solution: Collect static files again python manage.py collectstatic --clear --noinput # Ensure DEBUG=True in .env for development

git clone https://github.com/logicbyroshan/portfolio-v2.0.git && cd portfolio-v2.0 && mkdir -p logs media static media/{achievements,avatars,blog_covers,project_covers,project_images,resume,tech_icons} && python -m venv venv && source venv/bin/activate && pip install -r requirements.txt && python manage.py migrate && python manage.py runserver

# Install testing dependencies pip install -r requirements-test.txt # Run all tests pytest # Run tests with coverage pytest --cov=. # Run specific test categories pytest -m models # Model tests only pytest -m views # View tests only pytest -m security # Security tests only