How cfgbengaluru24/team-25 works
Project Type and Purpose
• Full-stack, multi‐service training/assessment platform built during a hackathon.
• Components:
– React/Vite SPA (“frontend”) for Admin/Trainer/Trainee UIs
– Node.js/Express REST API (“backend”) managing users, trainers, room-requests, sessions
– MongoDB (implied by Mongoose-style models, populate scripts)
– Microservices in Python Flask (“flask” and “maudio3” folders) for audio-based ML tasks
– Streamlit apps (“assessment” and “streamlit” folders) for quizzes, critical thinking exercises, and trainee stats
File-Structure Analysis
• Top-level directories reveal a microservice-style layout:
– frontend
– backend
– flask (audio ML endpoint)
– maudio3 (alternate audio/ML demo)
– streamlit (data visualization & assessments)
– assessment (two Streamlit assessments: quiz & critical-thinking)
• backend uses MVC:
– Routes → controllers → services → models → database
• Configuration & utility files:
– backend/db/connect.js, populate scripts, .env implied
– frontend/vite.config.js, tailwind.config.js
– streamlit/config.toml, Flask requirements
1. User-Facing SPA (React/Vite frontend)
2. API Gateway (Node.js/Express backend)
3. Data Store (MongoDB)
4. ML Services (Flask “flask/app.py” & “maudio3/app.py”)
5. Assessment Apps (Streamlit: quiz, critical-thinking, traineestats)
6. External Services (Geocoding API, Airport data, Email/SMS gateway)
– SPA → REST API (login, CRUD on trainers/sessions/requests)
– REST API → MongoDB (read/write)
– REST API → Flask ML Service (audio classification endpoints)
– REST API → External APIs (geocode, findDistance, airportFinder)
– REST API → SMTP/email service (using Handlebars templates)
– Users (Admin/Trainer/Trainee) ↔ Streamlit Apps (via browser)
c. Architectural Patterns & Principles:
– Backend: MVC + middleware (auth, error-handler)
– Microservices for ML keep audio model in isolated Flask apps
– SPA decouples presentation from API
– Assessment tools as separate UIs (Streamlit) for rapid prototyping
d. Key Technologies & Frameworks:
– Frontend: React, Vite, Tailwind CSS
– Backend: Node.js, Express, Mongoose, Handlebars
– Database: MongoDB
– ML/Audio: Python Flask, pickled models
– Assessment/Analytics: Streamlit, Python