Initialise matching service

Author: SherwynNg

services/matching-service/.dockerignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.venv/
+venv/
+.git
+.gitignore

services/matching-service/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.venv/
+venv/
+.env

services/matching-service/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY ./app ./app
+
+EXPOSE 8000
+
+# Dev mode (reload)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

services/matching-service/Makefile

@@ -0,0 +1,2 @@
+run:
+	uvicorn app.main:app --reload --port 8000

services/matching-service/README.md

@@ -0,0 +1,13 @@
+Matching Service
+Overview
+The Matching Service is responsible for pairing users in PeerPrep based on selected topic, difficulty, and programming language. It manages user queues, handles match creation, and communicates with other services (User Service, Question Service, Collaboration Service).
+
+This service is built using FastAPI and is designed to be containerised using Docker.
+
+Features
+
+- Join a match queue for a specific topic, difficulty, and programming language
+- Automatic peer matching from the queue
+- Cancel a queue request
+- Integration points for collaboration sessions
+- Health check endpoint for service monitoring

services/matching-service/app/__init__.py

@@ -0,0 +1,10 @@
+from fastapi import FastAPI
+from app.routers import hello
+
+app = FastAPI()
+
+app.include_router(hello.router)
+
+@app.get("/")
+def root():
+    return {"message": "Matching Service is running"}

services/matching-service/app/main.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/hello")
+def hello():
+    return {"message": "Hello from Matching Service!"}