Django Portfolio Project

🚀 Django Portfolio Application

A portfolio web application built with Django, implementing common Django features and best practices. This application showcases a personal portfolio website with dynamic content management through Django's ORM.

🏗️ Architecture & Technical Stack

Core Technologies

• Django: Web framework for building the portfolio application
• Python: Core programming language
• SQLite3: Default database for development
• HTML5/CSS3: Frontend design and structure
• JavaScript: UI interactions and responsive design elements

System Architecture

• MTV Pattern (Model-Template-View): Django's architectural pattern for separation of concerns
• Multi-app Structure: Separation of functionality through dedicated Django apps:
  • app: Core portfolio functionality
  • Auth: Authentication functionality

⚙️ Technical Features

1. Data Modeling

• Relational Database Design: Portfolio data models with Django ORM
• Custom Field Validators: File size and type validation for media uploads
• Dynamic Media Path Generation: Organized file path management for uploaded assets

def user_image_path(instance, filename):
    # Dynamic path generation for user uploads
    _, ext = os.path.splitext(filename)
    return f'Author/{instance.username}{ext}'

2. Authentication & Security

• Django Admin Authentication: Admin interface for content management
• Form Validation: Form validation with Django
• CSRF Protection: Standard Django security features

3. Media Management

• Media File Organization: Structured media directories by content type
• Structured Asset Organization: Media categorized by type (Author, Projects, etc.)
• File Validation: Size and format validation for uploads

4. Template System

• Template Inheritance: Base template with extended content pages
• Context Processors: Template variables for media and request data
• Responsive Design: Mobile-friendly layout

5. Development Workflow

• Virtual Environment: Isolated Python environment for dependency management
• Custom Management Commands: Sample data generation for testing

python manage.py create_sample_data  # Populates database with sample portfolio content

🛠️ Project Structure

Django-Portfolio/
├── project/
│   ├── app/                # Core portfolio functionality
│   │   ├── models.py       # Data models (Author, Projects, Services, etc.)
│   │   ├── views.py        # View controllers
│   │   ├── urls.py         # URL routing
│   │   └── management/     # Custom Django management commands
│   │       └── commands/   
│   │           └── create_sample_data.py  # Data generation utility
│   ├── Auth/               # Authentication system
│   │   ├── models.py       # User models
│   │   ├── views.py        # Authentication views
│   │   └── urls.py         # Auth URL routing
│   ├── media/              # User uploaded content
│   ├── static/             # Static assets (CSS, JS, images)
│   ├── templates/          # HTML templates
│   └── project/            # Project configuration
│       ├── settings.py     # Django settings
│       ├── urls.py         # Main URL routing
│       └── wsgi.py         # WSGI application entry point
└── manage.py               # Django management script

📊 Data Models

The application implements a sophisticated data model with the following entities:

Author 1──┐
  │       │
  │       ├── Projects (many)
  │       │
  │       ├── Social Links (one)
  │       │
  │       ├── Testimonials (many)
  │       │
  │       ├── About (one)
  │       │
  │       ├── Education (many)
  │       │
  │       ├── Experience (many)
  │       │
  │       ├── Services (many)
  │       │
  └───────┴── Contact Information (one)

⚡ Key Features

Custom Management Commands

The project includes a custom management command for populating sample data:

# Creates sample portfolio data with relationships and media files
python manage.py create_sample_data

Dynamic Content Management

Portfolio content is database-driven, enabling updates through the admin interface:

• Projects section displays data from the Projects model
• Services section uses the Services model
• Testimonials pulled from the Testimonials model

Media Organization

File management includes:

• Organized path generation by content type
• Basic file validation (size limits, format restrictions)
• Structured media directory organization

🚀 Development Setup

Configuration

• Debug Mode: Development configuration with DEBUG=True
• Static Files: Configured for development environment
• Django Settings: Standard Django security middleware enabled

🔧 Installation & Setup

1. Clone the repository:

git clone https://github.com/Engg-Shishir/Django-Portfolio.git
cd Django-Portfolio/project

2. Create and activate virtual environment:

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

3. Install dependencies:

pip install django

4. Apply migrations:

python manage.py migrate

5. Create superuser:

python manage.py createsuperuser --username admin --email [email protected]

6. Load sample data:

python manage.py create_sample_data

7. Run development server:

python manage.py runserver

8. Access the application:
   • Website: http://127.0.0.1:8000/
   • Admin Panel: http://127.0.0.1:8000/admin/

🔄 Project Features

• Portfolio Showcase: Display projects and services
• About Section: Personal details and background
• Contact Information: Contact details and messaging
• Testimonials: Client testimonials section
• Admin Management: Content management through Django admin

---

If you find this project helpful for your Django learning journey, please star this repository!