How rachitnaruzu/codearena works
Project Type & Purpose
• Full‐stack Django web application for assessing student coding skills by scraping multiple coding platforms, ranking users, managing problem sets, and optionally providing Discourse SSO integration.
Main Components
a. Client (Browser)
– Static assets (HTML/CSS/JS) from codearena/static and templates/
b. Reverse Proxy
– Nginx (codearena_nginx.conf + uwsgi_params)
c. Application Server
– uWSGI (codearena_uwsgi.ini + codearena_uwsgi.conf)
d. Web Application
– Django project “codearena” (settings.py, urls.py, views.py)
– “codelabs” app (models, views, forms, admin, tasks.py, webscrape.py, pydiscourse for Discourse SSO)
e. Task Queue
– RabbitMQ broker (BROKER_URL in settings.py)
– Celery workers (configured in codearena/celery.py, tasks in codelabs/tasks.py)
f. Scheduler
– Cron job (codearena_webscrape script invoked daily via /etc/cron.daily)
g. Data Store
– PostgreSQL database (django.db.backends.postgresql_psycopg2)
h. External Systems
– Coding platforms (CodeChef, Hackerrank, TopCoder, InterviewBit, GeeksforGeeks)
– Optional Discourse forum (via pydiscourse SSO client)
i. Initialization Scripts
– seed.py (initial admin user), update.py
Component Relationships & Data Flows
• Browser →(HTTPS)→ Nginx → uWSGI → Django
• Django ←→ PostgreSQL (SQL queries)
• Django → RabbitMQ (AMQP enqueue) → Celery Workers → Django (DB updates, email tasks)
• Cron → codearena_webscrape → enqueues scraping tasks into RabbitMQ
• Celery Workers → External Coding Platforms (HTTP scraping) → Update DB → Trigger points allotment
• Django Web UI → Discourse SSO endpoint → Discourse API (OAuth‐like handshake)
Architectural Patterns & Principles
• MVC (Models → Views → Templates) in Django
• Layered architecture:
– Presentation (templates + static files)
– Application / Business logic (Django, codelabs)
– Data access (ORM → PostgreSQL)
– Background processing (Celery + RabbitMQ)
• Asynchronous processing for scraping & email sending
• Cron‐driven scheduling for periodic data refresh
• External integrations abstracted via service adapters (codelabs/pydiscourse, webscrape.py)
Technologies & Frameworks
• Python 3, Django
• Celery, RabbitMQ
• PostgreSQL
• Nginx, uWSGI
• Cron
• jQuery, particle.js, custom JS in codearena/static/js
• pydiscourse (Discourse SSO client)