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.
Frontend: https://agents-and-task-management-v1.vercel.app
Backend: https://agentsandtaskmanagement-v1.onrender.com
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
- JWT-based authentication
- Role-based access (Admin / Agent)
- Protected API routes
- Create / deactivate agents
- Create / delete admins
- Upload tasks via CSV / XLSX
- Automatic task distribution
- Delete individual / all tasks
- Monitor agents & tasks
- Secure login
- Personal dashboard
- View assigned tasks only
- Profile management
- Bulk upload support (CSV, XLSX)
- File validation (headers + schema)
- Balanced distribution algorithm
- Automatic reassignment
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
- React (Vite)
- TypeScript
- Tailwind CSS
- Axios
- React Router
- Node.js
- Express.js
- TypeScript
- JWT Authentication
- Multer (file upload)
- Joi (validation)
- MongoDB
- Mongoose
project-root/
β
βββ backend/
β βββ controllers/
β βββ services/
β βββ models/
β βββ routes/
β βββ validators/
β βββ utils/
β
βββ frontend/
β βββ components/
β βββ pages/
β βββ api/
β βββ context/
β βββ layout/
β
βββ README.md
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
git clone https://github.com/Vivek-DK/AgentsAndTaskManagement-v1.git
cd AgentsAndTaskManagement-v1cd backend
npm install
npm run devBuild for production:
npm run build
npm start
cd frontend
npm install
npm run devSupported formats:
.csv.xlsx
Required headers: FirstName, Phone, Notes
- POST /api/auth/login
- GET /api/agents
- POST /api/agents
- DELETE /api/agents/:id
- GET /api/tasks/my-tasks
- GET /api/upload/tasks
- DELETE /api/tasks/:id
- DELETE /api/tasks
- POST /api/upload
- JWT Authentication
- Role-Based Access Control
- Rate Limiting
- Input Validation (Joi)
- MongoDB Sanitization
- Glassmorphism UI
- Fully Responsive Design
- Smooth Animations
- Loading States & Feedback
- Real-time UI Updates
- Task Status Tracking
- Notification System
- Analytics Dashboard
- Pagination & Performance Optimization
- Agent Performance Metrics
Vivek DK
Full Stack Developer
Tech Stack:
React β’ Node.js β’ MongoDB β’ TypeScript
If you found this project useful:
- β Star the repository
- π΄ Fork the repository


