From 2ba292ccdc44a4c3cd14e0c79c7e9f30dd0c08e2 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 1 Feb 2026 22:11:51 +0000 Subject: [PATCH 1/2] Initial plan From e4bc61a7b9f7f5af81d41d496cb3caad50e9dc1c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 1 Feb 2026 22:14:06 +0000 Subject: [PATCH 2/2] Update README to reflect current repository structure Co-authored-by: ruskovin <42189406+ruskovin@users.noreply.github.com> --- README.md | 173 ++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 110 insertions(+), 63 deletions(-) diff --git a/README.md b/README.md index ce3df54..c890046 100644 --- a/README.md +++ b/README.md @@ -6,27 +6,41 @@ ## Overview -**Django-Projects** is a collection of my projects built using Django, showcasing different features and integrations of the Django web framework. The repository includes a range of project examples, from basic templates to more advanced applications with frontend and backend code. +**Django-Projects** is a collection of Django projects showcasing different features and integrations of the Django web framework. This repository contains five distinct applications, each demonstrating various aspects of Django development, from basic CRUD operations to more advanced features like APIs and e-commerce functionality. -## Repository Highlights +## Projects in This Repository -- **Django-based backend**: Core logic and APIs implemented with Python and Django. -- **Rich frontend**: Projects utilize JavaScript, SCSS, and CSS for interactive and responsive user interfaces. -- **Sample scripts**: Utilities and setup scripts in PowerShell and Batchfile, aiding development and deployment. +### 1. Blog +A full-featured blog application with a Django backend and Bootstrap frontend. +- **Location**: `/Blog` +- **Features**: Blog post creation, reading, and management with API support -## Language Breakdown +### 2. Ecommerce +An e-commerce platform built with Django. +- **Location**: `/Ecommerce` +- **Features**: Product catalog, shopping cart functionality -| Language | Percentage | -| ----------- | ---------- | -| JavaScript | 50.9% | -| SCSS | 26.4% | -| CSS | 16.7% | -| PowerShell | 2.3% | -| HTML | 1.9% | -| Python | 1.7% | -| Batchfile | 0.1% | +### 3. Social Network +A social networking application. +- **Location**: `/social_network/social` +- **Features**: User profiles, social interactions -> *Note: This repository focuses heavily on frontend implementations with Django as the backend.* +### 4. Todo List +A simple todo list application. +- **Location**: `/todo-list/todolist` +- **Features**: Task management with create, read, update, and delete operations + +### 5. Weather App +A weather information application that displays weather data for cities worldwide. +- **Location**: `/weather_app/weatherApp` +- **Features**: City weather lookup using Django + +## Technology Stack + +- **Backend**: Python, Django +- **Frontend**: HTML, CSS, JavaScript, Bootstrap +- **Database**: SQLite (default Django database) +- **Additional Tools**: Node.js and npm for frontend dependencies (in some projects) ## Getting Started @@ -34,73 +48,106 @@ - [Python 3.x](https://www.python.org/) - [Django](https://www.djangoproject.com/) -- [Node.js and npm](https://nodejs.org/) (for frontend assets) -- Optionally: [Sass](https://sass-lang.com/) for SCSS compilation +- [Node.js and npm](https://nodejs.org/) (for frontend assets in some projects) ### Installation +Each project in this repository is a standalone Django application. To run any project: + 1. **Clone the repository** ```bash git clone https://github.com/ruskovin/Django-Projects.git cd Django-Projects ``` -2. **Backend setup** - - Create and activate a virtual environment: - ```bash - python -m venv venv - source venv/bin/activate # On Windows: venv\Scripts\activate - ``` - - Install Python dependencies: - ```bash - pip install -r requirements.txt - ``` - - Set up your database (migrations): - ```bash - python manage.py migrate - ``` - -3. **Frontend setup** - - Install frontend dependencies: - ```bash - npm install - ``` - - (If using SCSS) Compile styles: - ```bash - npm run build-css - # or manually using sass: - sass static/scss:static/css - ``` - -4. **Run the server** +2. **Navigate to the project you want to run** + ```bash + # For Blog project: + cd Blog + + # For Ecommerce project: + cd Ecommerce + + # For Social Network: + cd social_network/social + + # For Todo List: + cd todo-list/todolist + + # For Weather App: + cd weather_app/weatherApp + ``` + +3. **Set up a virtual environment** (recommended) + ```bash + python -m venv venv + source venv/bin/activate # On Windows: venv\Scripts\activate + ``` + +4. **Install dependencies** ```bash + # Install Django and project-specific dependencies + pip install django + # Some projects may have a requirements.txt file + pip install -r requirements.txt # if available + + # For projects with frontend dependencies (Blog, Todo List): + npm install # if package.json exists + ``` + +5. **Run migrations and start the server** + ```bash + python manage.py migrate python manage.py runserver ``` +6. **Access the application** + Open your browser and navigate to `http://127.0.0.1:8000/` + ## Usage -- Access the Django server at `http://127.0.0.1:8000/` -- Explore different project folders for application-specific details. -- Each project may have its own README and setup instructions. +Each project is independent and can be run separately: + +1. Navigate to the project folder you want to explore +2. Follow the installation steps above for that specific project +3. Access the application at `http://127.0.0.1:8000/` +4. Some projects may have their own README files with additional details ## Folder Structure ``` Django-Projects/ │ -├── project_1/ -│ ├── ... -├── project_2/ -│ ├── ... -├── static/ -│ ├── js/ -│ ├── scss/ -│ ├── css/ -├── templates/ -│ ├── ... -├── requirements.txt -├── manage.py -└── ... +├── Blog/ # Blog application +│ ├── manage.py +│ ├── BlogAPP/ +│ ├── myblog/ +│ └── myblog_api/ +│ +├── Ecommerce/ # E-commerce application +│ ├── manage.py +│ ├── Ecommerce/ +│ ├── e_commerce_app/ +│ └── templates/ +│ +├── social_network/ # Social networking app +│ └── social/ +│ ├── manage.py +│ └── social/ +│ +├── todo-list/ # Todo list application +│ └── todolist/ +│ ├── manage.py +│ ├── tasks/ +│ └── todolist/ +│ +├── weather_app/ # Weather information app +│ └── weatherApp/ +│ ├── manage.py +│ ├── weather/ +│ └── weatherApp/ +│ +└── README.md ``` ## Contributing @@ -120,7 +167,7 @@ This repository is for educational and demonstration purposes. See individual pr ## Acknowledgments - [Django](https://www.djangoproject.com/) -- [Sass](https://sass-lang.com/) +- [Bootstrap](https://getbootstrap.com/) - [Node.js](https://nodejs.org/) ---