How axiaaa/ft_transcendance works
Project type and purpose
• This is a full-stack, containerized web application (“ft_transcendance” aka “Windows XPong”) that provides a Windows XP–style desktop environment in the browser, real-time multiplayer Pong, chat, profiles, matchmaking/tournaments, AI opponents, and social features.
• It uses micro-service–style backend components, a static/TS-based rich frontend, an Nginx reverse proxy, and a full observability/logging/monitoring stack.
File structure
• Top-level:
• docker-compose.yaml – orchestrates all containers
• nginx/ – Nginx reverse-proxy container
• backend/ – three small API services plus a DB service
• frontend/ – static HTML/CSS/TS app plus Pong AI model
• services/ – monitoring & logging stack (Prometheus, Grafana, ELK, cAdvisor, Alertmanager, etc.)
• backend/ is split into:
• db/ – database initialization (SQL), packaged as its own container
• user-route/, upload-route/, matchs-route/ – three isolated TypeScript API services (each with its own Dockerfile, package.json, routes folder, rate limiting middleware)
• frontend/ contains a TS-based UI (XP desktop, start menu, apps, Pong integration) and static assets (CSS, fonts, images).
• services/ holds multiple Dockerfiles and configuration for observability:
• Prometheus + Alertmanager
• Elasticsearch, Logstash, Filebeat, Kibana (ELK)
• Grafana + dashboards
• cAdvisor, certificate generation scripts, etc.
• nginx/config/nginx.conf is the entry-point that routes HTTPS traffic to frontend and API services.
README for additional insights
• Outlines use of NestJS (backend framework), PostgreSQL or SQLite (database), Docker & Docker Compose, TypeScript (frontend + backend), BabylonJS for 3D, and a full monitoring stack.
• Describes features: authentication, profile customization, real-time chat, matchmaking, AI opponents, tournaments, responsive XP theme.