🎓 EduTrack – Microlearning Platform

EduTrack is a lightweight, multi-language microservices-based platform that allows users to:

• Register and log in
• Browse public micro-courses
• Track course completion
• Receive weekly progress email summaries

This project demonstrates core DevOps and backend concepts using a polyglot architecture (Node.js, Go, Python), RESTful services, and async messaging via RabbitMQ.

---

🧱 Architecture Overview

🧩 Microservices

Service	Language	Description	Protocol
auth-service	Python (FastAPI)	Handles user registration & login	REST
course-service	Go	Serves course data (title, desc, etc.)	REST
progress-service	Node.js	Tracks user progress on lessons	REST
notifier-service	Python (FastAPI)	Sends weekly progress summary emails	Async (RabbitMQ)
api-gateway	Node.js	Acts as the entry point for the system	REST (HTTP)
frontend	Optional	React or plain HTML UI (optional)	HTTP

---

🗃️ Tech Stack

• Languages: Python, Go, Node.js
• Databases:
  • PostgreSQL: User accounts and progress data
  • MongoDB: Courses data (flexible schema for content)
• Message Broker: RabbitMQ (for email notifications)
• Auth: JWT (JSON Web Tokens)
• Containerization: Docker
• Orchestration: Docker Compose

---

🗂️ Project Structure

edutrack/
├── services/                      # All microservices live here
│   ├── auth-service/              # Python (FastAPI) - JWT Auth
│   │   ├── app/                   # FastAPI app logic
│   │   ├── tests/
│   │   ├── requirements.txt
│   │   └── Dockerfile
│   ├── course-service/           # Go - Course catalog
│   │   ├── cmd/
│   │   ├── internal/
│   │   ├── go.mod
│   │   └── Dockerfile
│   ├── progress-service/         # Node.js (Express) - Tracks progress
│   │   ├── src/
│   │   ├── tests/
│   │   ├── package.json
│   │   └── Dockerfile
│   ├── notifier-service/         # Python - Async email worker
│   │   ├── app/
│   │   ├── consumer.py
│   │   ├── Dockerfile
│   │   └── requirements.txt
│   └── api-gateway/              # Node.js Express or NGINX-based Gateway
│       ├── routes/
│       ├── middleware/
│       ├── package.json
│       └── Dockerfile

├── frontend/                     # Optional React or static frontend
│   ├── public/
│   ├── src/
│   ├── package.json
│   └── Dockerfile

├── infra/                        # Infrastructure-as-Code (IaC)
│   ├── docker/                   # Docker + Compose
│   │   ├── docker-compose.yml
│   │   ├── .env
│   │   └── volumes/
│   ├── k8s/                      # Kubernetes manifests
│   │   ├── base/
│   │   ├── overlays/dev/
│   │   ├── overlays/prod/
│   │   └── secrets/
│   ├── terraform/                # Optional: Infra provisioning (cloud)
│   │   ├── main.tf
│   │   └── variables.tf
│   └── vault/                    # Optional: Secrets as code
│       └── policy.hcl

├── scripts/                      # Dev/CI helper scripts
│   ├── dev-start.sh
│   ├── build-images.sh
│   └── test-all.sh

├── shared/                       # Shared libraries or proto files
│   ├── utils/
│   ├── logger/
│   └── proto/                    # For gRPC messages if used

├── .env                          # Global env variables (dev only)
├── README.md
└── Makefile                      # Task runner for dev tasks

---

🚀 Getting Started

Prerequisites

• Docker & Docker Compose
• Git

Run Locally

git clone https://github.com/yourusername/edutrack.git
cd edutrack
docker-compose up --build

Services will be accessible via the API Gateway:

http://localhost:8080/

---

🔐 API Authentication

• auth-service issues JWT tokens on login
• Each service validates the token (middleware layer in Node/Go/Python)

---

🛠️ Core Endpoints (Gateway Routed)

Sample endpoints (via API Gateway on port 8080):

Auth

• POST /auth/register
• POST /auth/login

Courses

• GET /courses/
• GET /courses/:id

Progress

• POST /progress/complete
• GET /progress/:user_id

---

📨 Notifications (Async)

• The progress-service publishes to RabbitMQ when users complete lessons.
• The notifier-service consumes weekly and sends summary emails.

---

📦 Database Design

PostgreSQL

• users: id, username, email, hashed_password
• progress: id, user_id, course_id, lesson_id, completed_at

MongoDB

• courses: id, title, description, lessons: [{id, title, content}]

---

🧪 Testing

Each service has isolated unit/integration tests:

# Inside any service
npm test      # Node.js
go test ./... # Go
pytest        # Python

---

📈 Future Improvements

• OAuth2 integration
• Admin panel for course creation
• In-app notifications
• Rust-based analytics service
• Rate limiting on API Gateway

---

🙌 Contributing

1. Fork the repo
2. Create your branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -am 'Add my feature')
4. Push (git push origin feature/my-feature)
5. Create a PR

---

📄 License

MIT License © 2025 [manupanand-freelance-developer]