JellyJobs – Admin Backend for Workforce Management (Django REST API)

🚀 Product Overview

JellyJobs is a powerful Django-based backend system built for managing workers, job requests, and uniform logistics within a workforce platform. Designed with scalability, clarity, and RESTful standards in mind, this backend is the perfect solution for developers or businesses looking to save months of development on a worker management system.

This product includes a fully functional Django REST API, ready to be connected to your own frontend (React or any other framework). Every endpoint is well-documented with Swagger, and the code is modular and easy to extend.

⚠️ Disclaimer: This is a development-ready project, but it may contain minor bugs or incomplete validations. While tested and functional, it is recommended to review and adjust it for production environments.

🧰 Key Features

• ✅ Authentication via JWT
  Includes login, token validation, and password/email update endpoints.
• 🧾 Worker Management
  • Register, list, update, and delete workers
  • Filter by name, status, and profession
  • Handle pending states and uniform statuses
• 📬 Notifications System
  • Automatic polling-based notifications
  • Tracks new worker registrations and incoming job requests
  • Real-time updates every 30 seconds
• 📝 Job Request Handling
  • Create and manage work requests
  • Track pending requests via /solicitudes-pendientes-num/
• 👕 Uniform Ordering System
  • Submit orders for workers without uniforms
  • Choose size, sleeve type, company, address, and more
  • Enforces ordering time restrictions with clear error responses
  • Automatically updates the worker’s status
• 🌍 Locality & Profession Catalogs
  Endpoints to dynamically fetch all available professions and localities.
• 🔐 Security-First Approach
  All sensitive routes are protected with basic auth and/or JWT.
• 📖 Integrated Swagger UI (drf-yasg)
  Browse and test all API endpoints with full Swagger 2.0 documentation.
• 🚀 Runs on Port 9001
  Fully isolated and clearly defined port for backend use.

🔗 Swagger Endpoint List (v2.0)

Here's a snapshot of the available endpoints as seen in Swagger:

These endpoints follow Django REST conventions and are accessible via a fully integrated Swagger UI included in the project.

📂 File Structure

Cleanly organized Django project with:

• /app – Main Django app with all views, serializers, and URLs
• Swagger setup preconfigured
• .env support for easy configuration
• No frontend bundled – backend-only (for API deployments)

🖥️ Perfect For:

• Developers building custom admin dashboards
• Startups needing an MVP for job platforms
• Agencies selling workforce tools
• Teams with a React or mobile frontend looking for a plug-and-play backend

🔧 Requirements

• Python 3.10+
• Django 4+
• PostgreSQL or SQLite
• (Optional) Railway or similar for deployment
• Swagger extension is already included

📦 What You Get

• Full Django project (backend only)
• Preconfigured endpoints with serializers & models
• Swagger API documentation
• Instructions to run the project locally
• Database seeded with sample (fake) data

📘 Documentation Included

• README.md with full setup guide
• Swagger UI for in-browser testing
• Description of all API routes and example requests

📌 Notes

• This is a backend-only product. No frontend is included.
• If you want the frontend version (React + Ant Design), check out the Frontend version or the Bundle (Frontend + Backend).