Skip to content

About

Full-stack Agent & Task Management system built with MERN stack, TypeScript, and Tailwind CSS. Supports role-based authentication (Admin/Agent), bulk task upload via CSV/XLSX, automated task distribution, and real-time dashboard management.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

47 Commits

Folders and files

Repository files navigation

πŸš€ Agents & Task Management System

A scalable full-stack web application for managing agents and distributing tasks efficiently using automated logic. Built with MERN + TypeScript + Tailwind CSS, featuring role-based access, bulk task processing, and a modern dashboard UI.


🌐 Live Demo

Frontend: https://agents-and-task-management-v1.vercel.app
Backend: https://agentsandtaskmanagement-v1.onrender.com


πŸ“Œ Overview

This system solves real-world task allocation problems in team environments.

Admins can:

  • Manage agents
  • Upload tasks in bulk (CSV/XLSX)
  • Automatically distribute tasks
  • Monitor workflows

Agents can:

  • Access only assigned tasks
  • View personal dashboard

✨ Core Features

πŸ” Authentication & Authorization

  • JWT-based authentication
  • Role-based access (Admin / Agent)
  • Protected API routes

πŸ‘¨β€πŸ’Ό Admin Capabilities

  • Create / deactivate agents
  • Create / delete admins
  • Upload tasks via CSV / XLSX
  • Automatic task distribution
  • Delete individual / all tasks
  • Monitor agents & tasks

πŸ‘¨β€πŸ’» Agent Capabilities

  • Secure login
  • Personal dashboard
  • View assigned tasks only
  • Profile management

πŸ“‚ Task Management

  • Bulk upload support (CSV, XLSX)
  • File validation (headers + schema)
  • Balanced distribution algorithm
  • Automatic reassignment

🧠 Task Distribution Logic

Balanced round-robin algorithm:

  • Tasks divided equally among active agents
  • Extra tasks distributed sequentially
  • Rebalancing happens when agents deactivate

Example: 25 Tasks + 5 Agents β†’ Each gets 5 tasks


πŸ›  Tech Stack

Frontend

  • React (Vite)
  • TypeScript
  • Tailwind CSS
  • Axios
  • React Router

Backend

  • Node.js
  • Express.js
  • TypeScript
  • JWT Authentication
  • Multer (file upload)
  • Joi (validation)

Database

  • MongoDB
  • Mongoose

πŸ— Project Structure

project-root/
β”‚
β”œβ”€β”€ backend/
β”‚ β”œβ”€β”€ controllers/
β”‚ β”œβ”€β”€ services/
β”‚ β”œβ”€β”€ models/
β”‚ β”œβ”€β”€ routes/
β”‚ β”œβ”€β”€ validators/
β”‚ └── utils/
β”‚
β”œβ”€β”€ frontend/
β”‚ β”œβ”€β”€ components/
β”‚ β”œβ”€β”€ pages/
β”‚ β”œβ”€β”€ api/
β”‚ β”œβ”€β”€ context/
β”‚ └── layout/
β”‚
└── README.md

βš™οΈ Environment Variables

Backend .env

NODE_ENV=production
PORT=5000

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret

ADMIN_EMAIL=your_admin_email
ADMIN_PASSWORD=your_admin_password

πŸš€ Getting Started

1. Clone Repository

git clone https://github.com/Vivek-DK/AgentsAndTaskManagement-v1.git
cd AgentsAndTaskManagement-v1

2. Backend Setup

cd backend
npm install
npm run dev

Build for production:

npm run build
npm start

3. Frontend Setup

cd frontend
npm install
npm run dev

πŸ“¦ File Upload Format

Supported formats:

  • .csv
  • .xlsx

Required headers: FirstName, Phone, Notes


πŸ”Œ API Overview

Auth

  • POST /api/auth/login

Agents

  • GET /api/agents
  • POST /api/agents
  • DELETE /api/agents/:id

Tasks

  • GET /api/tasks/my-tasks
  • GET /api/upload/tasks
  • DELETE /api/tasks/:id
  • DELETE /api/tasks

Upload

  • POST /api/upload

πŸ” Security

  • JWT Authentication
  • Role-Based Access Control
  • Rate Limiting
  • Input Validation (Joi)
  • MongoDB Sanitization

🎯 UI/UX Highlights

  • Glassmorphism UI
  • Fully Responsive Design
  • Smooth Animations
  • Loading States & Feedback
  • Real-time UI Updates

πŸ“Έ Screenshots

Landing Page

image alt


Admin Dashboard

image alt


Agent Dashboard

image alt


πŸ“ˆ Future Improvements

  • Task Status Tracking
  • Notification System
  • Analytics Dashboard
  • Pagination & Performance Optimization
  • Agent Performance Metrics

πŸ‘¨β€πŸ’» Author

Vivek DK
Full Stack Developer

Tech Stack:
React β€’ Node.js β€’ MongoDB β€’ TypeScript


⭐ Support

If you found this project useful:

  • ⭐ Star the repository
  • 🍴 Fork the repository

About

Full-stack Agent & Task Management system built with MERN stack, TypeScript, and Tailwind CSS. Supports role-based authentication (Admin/Agent), bulk task upload via CSV/XLSX, automated task distribution, and real-time dashboard management.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages