How gabr1eeeel/iagym works
Project type and purpose
• This is a full-stack web application called IAGym, an intelligent gym management system.
• Purpose: provide CRUD operations for students (“alunos”), record check-ins, manage plans, and use a Random Forest model to predict churn risk.
File structure
• Top-level:
• backend/: Python API and worker code
• frontend/: React + TypeScript UI
• docker-compose.yml: orchestration of containers
• Backend substructure:
• app/routes/: REST endpoints (FastAPI)
• app/models/: SQLAlchemy entities (Aluno, Checkin, Plano)
• app/services/: business logic (e.g., churn_predictor)
• app/workers/: async processing via RabbitMQ
• app/database.py: DB connection
• app/rabbitmq.py: broker setup
• Frontend substructure:
• src/pages/: five page components (Home, Alunos, Checkin, Frequencia, Churn)
• src/api.ts: wrapper around REST calls
• src/components/: shared UI (Navbar)
README for additional insights
• Tech stack: FastAPI, SQLAlchemy, PostgreSQL, scikit-learn, RabbitMQ, React, Material-UI
• Architecture callout: REST API, ML model, message broker, Docker containers
• Async flows: check-ins produce events to RabbitMQ, workers consume and update churn analysis