🗂️ Task Manager Web Application

A modern, full-stack task management solution built with Django and MongoDB

Features • Demo • Installation • Tech Stack • Contributing

---

📋 Table of Contents

• Overview
• Features
• Screenshots
• Tech Stack
• Architecture
• Installation
• Usage
• API Documentation
• Roadmap
• Contributing
• License
• Author

---

🎯 Overview

Task Manager is a production-ready web application designed to streamline personal and team productivity. Built with modern web technologies, it offers a seamless experience for creating, organizing, and tracking tasks with enterprise-grade security and scalability.

Why Task Manager?

• 🔐 Secure Authentication - Built on Django's robust authentication system
• 🚀 High Performance - Leveraging MongoDB's NoSQL capabilities for fast data operations
• 📱 Responsive Design - Beautiful UI that works flawlessly across all devices
• 🎨 Modern Interface - Clean, intuitive design with Tailwind CSS
• 🔒 Data Isolation - Complete privacy with user-specific task management

---

✨ Features

🔐 Authentication & Security

• User registration with validation
• Secure login/logout functionality
• Session-based authentication
• Protected routes with @login_required decorator
• Password encryption and secure storage

📝 Task Management

• Full CRUD Operations - Create, Read, Update, and Delete tasks effortlessly
• Rich Task Attributes - Title, description, priority levels, and due dates
• Status Tracking - Toggle between Completed and Pending states
• Priority Levels - Low, Medium, and High priority classification
• Bulk Operations - Clear all completed tasks in one click

📊 Dashboard & Analytics

• Real-time Statistics - Live counters for total, pending, and completed tasks
• Smart Filtering - Filter by status (All, Pending, Completed) and priority (High)
• Visual Indicators - Color-coded priority badges and status markers
• Progress Tracking - Monitor task completion rates at a glance

🎨 User Experience

• Responsive Design - Optimized for desktop, tablet, and mobile devices
• Modern UI - Gradient accents and smooth transitions
• Toast Notifications - Instant feedback for all user actions
• Intuitive Navigation - Clean, user-friendly interface

---

📸 Screenshots

🔑 Authentication

Secure Login Interface

User Registration

📊 Dashboard & Task Management

Analytics Dashboard

Task Management Interface

🗄️ Database Architecture

MongoDB Compass - Database View

---

🛠️ Tech Stack

Frontend

Backend

Database

Tools & DevOps

Technology Details

Layer	Technology	Purpose
Frontend	HTML5, Tailwind CSS, JavaScript	Responsive UI with modern styling
Backend	Django 5.0, Python 3.10+	RESTful API and business logic
Database	MongoDB 4.4+	NoSQL document storage for tasks
Authentication	Django Auth + SQLite	User management and sessions
Driver	PyMongo	MongoDB integration

---

🏗️ Architecture

System Design

┌─────────────────────────────────────────────────────────┐
│                     Client Browser                      │
│                   (HTML/CSS/JS)                         │
└────────────────────┬────────────────────────────────────┘
                     │ HTTP/HTTPS
                     ▼
┌─────────────────────────────────────────────────────────┐
│                   Django Backend                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │   Views      │  │  Middleware  │  │   Forms      │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└────────────┬────────────────────────────────┬───────────┘
             │                                │
             ▼                                ▼
┌────────────────────────┐      ┌────────────────────────┐
│   SQLite Database      │      │   MongoDB Database     │
│  (User Auth/Sessions)  │      │   (Task Documents)     │
└────────────────────────┘      └────────────────────────┘

Key Architecture Decisions

• Hybrid Database Approach - SQLite for Django authentication, MongoDB for task data
• Direct PyMongo Integration - No ORM overhead for maximum performance
• RESTful API Design - Clean separation between frontend and backend
• Session-based Authentication - Secure user sessions with Django middleware

---

🚀 Installation

Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.10 or higher - Download Python
• MongoDB Community Server - Download MongoDB
• Git - Download Git
• pip (Python package manager)

Step-by-Step Setup

1️⃣ Clone the Repository

git clone https://github.com/yourusername/task-manager.git
cd task-manager

2️⃣ Create Virtual Environment

Windows:

python -m venv venv
venv\Scripts\activate

macOS/Linux:

python3 -m venv venv
source venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Configure MongoDB

Ensure MongoDB is running on your system:

# Check if MongoDB is running
mongosh

Update config/settings.py if needed:

# MongoDB Configuration
MONGODB_URI = "mongodb://localhost:27017"
MONGODB_NAME = "task_manager_db"

5️⃣ Run Migrations

python manage.py makemigrations
python manage.py migrate

6️⃣ Create Superuser (Optional)

python manage.py createsuperuser

Follow the prompts to create an admin account.

7️⃣ Start Development Server

python manage.py runserver

🎉 Success! Open your browser and navigate to:

👉 http://127.0.0.1:8000/

---

💻 Usage

Quick Start Guide

1. Register an Account - Create your user profile
2. Login - Access your personal dashboard
3. Create Tasks - Add tasks with title, description, priority, and due date
4. Manage Tasks - Update status, edit details, or delete tasks
5. Filter & Organize - Use filters to focus on specific task categories
6. Track Progress - Monitor your productivity with dashboard statistics

Task Creation

// Example task structure
{
  "title": "Complete Project Documentation",
  "description": "Write comprehensive README and API docs",
  "priority": "High",
  "due_date": "2024-12-31",
  "status": "Pending",
  "user_id": "user@example.com"
}

---

📚 API Documentation

Authentication Endpoints

Method	Endpoint	Description
POST	/register/	Create new user account
POST	/login/	Authenticate user
GET	/logout/	End user session

Task Management Endpoints

Method	Endpoint	Description
GET	/tasks/	Retrieve all tasks
POST	/tasks/create/	Create new task
PUT	/tasks/<id>/update/	Update existing task
DELETE	/tasks/<id>/delete/	Delete task
POST	/tasks/<id>/toggle/	Toggle task completion

---

🗺️ Roadmap

Version 2.0 (Upcoming)

• 🏷️ Task categories and custom tags
• 📧 Email verification and notifications
• 🎯 Drag-and-drop task reordering
• 👥 Team collaboration features
• 📱 Progressive Web App (PWA) support
• 🐳 Docker containerization
• 📊 Advanced analytics and reporting
• 🔄 Task recurring/repetition
• 💾 Export tasks to CSV/PDF
• 🌙 Dark mode theme

Long-term Goals

• Mobile native applications (iOS/Android)
• Integration with calendar services
• AI-powered task suggestions
• Real-time collaboration with WebSockets

---

🤝 Contributing

Contributions are what make the open-source community amazing! Any contributions you make are greatly appreciated.

How to Contribute

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow PEP 8 style guide for Python code
• Write meaningful commit messages
• Add comments for complex logic
• Update documentation for new features
• Test thoroughly before submitting PR

---

📄 License

Distributed under the MIT License. See LICENSE file for more information.

---

👨‍💻 Author

Vivek

• GitHub: @VivekGhule
• LinkedIn: vivekghule7
• Email: vivekghule777@gmail.com

---

🙏 Acknowledgments

• Django Documentation
• MongoDB Documentation
• Tailwind CSS
• Font Awesome for icons
• All contributors who help improve this project

---

⭐ Star this repository if you find it helpful!

Built with ❤️ using Django and MongoDB

Report Bug • Request Feature