eLearnHub is a full-stack eLearning platform that enables teachers to create courses and students to enroll, interact, and submit assignments. Features:
✅ Django & PostgreSQL Backend for robust data management
✅ Next.js Frontend with TailwindCSS for a modern UI
✅ JWT Authentication with role-based access for teachers & students
✅ WebSockets (Django Channels + Redis) for real-time chat & notifications
✅ Google Drive API Integration for secure course material storage
✅ OpenAPI (Swagger) Documentation for easy API access
✅ Celery Task Queue for background processing
Frontend: Next.js (React), TailwindCSS
Backend: Django, Django REST Framework, PostgreSQL
Real-time: Django Channels, Redis, WebSockets
Authentication: JWT, Django Authentication
File Storage: Google Drive API
Asynchronous Processing: Celery, Redis
👨🏫 Teachers: Create, manage courses, and upload course materials.
🎓 Students: Enroll in courses, submit assignments, and participate in discussions.
📚 Course Creation & Enrollment: Teachers create courses; students can enroll.
📂 Course Materials: Upload videos, PDFs, and more via Google Drive API.
📑 Assignments & Submissions: Teachers assign tasks; students submit work.
💬 Real-time Chat & Notifications: Powered by Django Channels + Redis.
🔔 Live Updates: Notifications for enrollments, messages, and announcements.
📜 RESTful API: Built with Django REST Framework.
📖 OpenAPI & Swagger Docs: Auto-generated API documentation.
- Python 3.3+ & Node.js 18+
- PostgreSQL & Redis
- Google Cloud Service Account (for Google Drive API)
# Clone the repository
git clone https://github.com/KELVI23/elearnhub.git && cd elearnhub
# Create virtual environment & activate it
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Set environment variables (Update .env file)
cp .env.example .env # Update with your values
# Apply database migrations
python manage.py migrate
# Create a superuser (admin)
python manage.py createsuperuser
# Run Celery Worker
celery -A config worker --loglevel=info
# Start Redis (if not already running)
redis-server
# Start Django server
python manage.py runservercd core/elearning-ui # Navigate to frontend
# Install dependencies
npm install
# Start Next.js frontend
npm run dev📌 Generate OpenAPI Schema & Swagger UI
python manage.py spectacular --color --file openapi-schema.ymlAccess API Docs at:
- Swagger UI:
http://127.0.0.1:8000/api/docs/ - Redoc:
http://127.0.0.1:8000/api/redoc/
- Containerized Deployment: Docker + Docker Compose
- CI/CD Pipeline: GitHub Actions for automated testing & deployment
- Cloud Hosting: AWS/GCP for scalability
This project is licensed under the MIT License.
👤 Kelvin Musodza
🔗 GitHub: @KELVI23
Contributions are welcome! Feel free to submit issues or pull requests. 🚀