# cfgbengaluru24/team-25 architecture

> Architecture diagram of the GitHub repository cfgbengaluru24/team-25, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cfgbengaluru24/team-25
- Repository: https://github.com/cfgbengaluru24/team-25

## Overview

##### 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

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        ReactUI["React/Vite SPA"]:::ui
        QuizUI["Quiz Assessment App"]:::ui
        CritUI["Critical Thinking App"]:::ui
        StatsUI["Trainee Stats App"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        subgraph "Express API Server"
            ExpressAPI["Express API Server"]:::service
            ConnectDB["DB Connect Module"]:::service
            RoutesDir["Routes"]:::service
            ControllersDir["Controllers"]:::service
            ServicesDir["Services"]:::service
            ModelsDir["Models"]:::service
            MiddlewareDir["Middleware"]:::service
            ErrorsDir["Error Handlers"]:::service
            UtilsDir["Utilities"]:::service
            ViewsDir["Email Templates"]:::service
        end

        subgraph "ML Microservices"
            FlaskA["Flask Audio ML Service A"]:::service
            FlaskB["Flask Audio ML Service B"]:::service
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        MongoDB["MongoDB"]:::db
        Populate["Populate Scripts"]:::db
    end

    %% External Integrations
    subgraph "Third-Party Services"
        Geocode["Geocoding API"]:::ext
        FindDist["Distance API"]:::ext
        AirportFinder["Airport Finder API"]:::ext
        AirportsData["Airports Data (JSON)"]:::ext
        EmailSvc["SMTP/Email Service"]:::ext
    end

    %% Connections
    ReactUI -->|"REST API calls"| ExpressAPI
    ExpressAPI -->|"read/write"| MongoDB
    ExpressAPI -->|"execute"| ConnectDB
    ConnectDB -->|connects to| MongoDB
    ExpressAPI -->|"HTTP calls"| FlaskA
    ExpressAPI -->|"HTTP calls"| FlaskB
    ExpressAPI -->|"requests"| Geocode
    ExpressAPI -->|"requests"| FindDist
    ExpressAPI -->|"requests"| AirportFinder
    ExpressAPI -->|"reads"| AirportsData
    ExpressAPI -->|"sends emails"| EmailSvc

    ReactUI --- QuizUI
    ReactUI --- CritUI
    ReactUI --- StatsUI

    MongoDB -->|seed data| Populate

    %% Click Events
    click ReactUI "https://github.com/cfgbengaluru24/team-25/tree/main/frontend/"
    click ReactUI "https://github.com/cfgbengaluru24/team-25/tree/main/frontend/src/"
    click ReactUI "https://github.com/cfgbengaluru24/team-25/blob/main/frontend/vite.config.js"
    click ReactUI "https://github.com/cfgbengaluru24/team-25/blob/main/frontend/tailwind.config.js"

    click ExpressAPI "https://github.com/cfgbengaluru24/team-25/blob/main/backend/server.js"
    click RoutesDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/Routes/"
    click ControllersDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/controllers/"
    click ServicesDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/services/"
    click ModelsDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/models/"
    click ConnectDB "https://github.com/cfgbengaluru24/team-25/blob/main/backend/db/connect.js"
    click MiddlewareDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/middleware/"
    click ErrorsDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/Errors/"
    click UtilsDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/utils/"
    click ViewsDir "https://github.com/cfgbengaluru24/team-25/tree/main/backend/views/"

    click ModelsDir "https://github.com/cfgbengaluru24/team-25/blob/main/backend/models/Club.js"
    click ModelsDir "https://github.com/cfgbengaluru24/team-25/blob/main/backend/models/RoomRequest.js"
    click ModelsDir "https://github.com/cfgbengaluru24/team-25/blob/main/backend/models/Trainer.js"
    click ModelsDir "https://github.com/cfgbengaluru24/team-25/blob/main/backend/models/User.js"
    click Populate "https://github.com/cfgbengaluru24/team-25/blob/main/backend/populate/populate_trainers.js"
    click Populate "https://github.com/cfgbengaluru24/team-25/blob/main/backend/populate/mock_trainers.json"

    click FlaskA "https://github.com/cfgbengaluru24/team-25/blob/main/flask/app.py"
    click FlaskA "https://github.com/cfgbengaluru24/team-25/blob/main/flask/app1.py"
    click FlaskA "https://github.com/cfgbengaluru24/team-25/blob/main/flask/model.pkl"
    click FlaskA "https://github.com/cfgbengaluru24/team-25/blob/main/flask/audio.wav"
    click FlaskA "https://github.com/cfgbengaluru24/team-25/blob/main/flask/requirements.txt"

    click FlaskB "https://github.com/cfgbengaluru24/team-25/blob/main/maudio3/app.py"
    click FlaskB "https://github.com/cfgbengaluru24/team-25/blob/main/maudio3/templates/index.html"
    click FlaskB "https://github.com/cfgbengaluru24/team-25/blob/main/maudio3/templates/result.html"
    click FlaskB "https://github.com/cfgbengaluru24/team-25/blob/main/maudio3/requirements.txt"

    click QuizUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/quiz/app.py"
    click QuizUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/quiz/quiz_data.json"
    click QuizUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/quiz/requirements.txt"
    click QuizUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/quiz/.streamlit/config.toml"

    click CritUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/Crirical_thinking/app.py"
    click CritUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/Crirical_thinking/requirements.txt"
    click CritUI "https://github.com/cfgbengaluru24/team-25/blob/main/assessment/Crirical_thinking/.streamlit/config.toml"

    click StatsUI "https://github.com/cfgbengaluru24/team-25/blob/main/streamlit/traineestats.py"
    click StatsUI "https://github.com/cfgbengaluru24/team-25/blob/main/streamlit/.streamlit/config.toml"

    click Geocode "https://github.com/cfgbengaluru24/team-25/blob/main/backend/services/geocode.js"
    click FindDist "https://github.com/cfgbengaluru24/team-25/blob/main/backend/services/findDistance.js"
    click AirportFinder "https://github.com/cfgbengaluru24/team-25/blob/main/backend/services/airportFinder.js"
    click AirportFinder "https://github.com/cfgbengaluru24/team-25/blob/main/backend/services/findAirportCoordinates.js"
    click AirportsData "https://github.com/cfgbengaluru24/team-25/blob/main/backend/services/airports_data.json"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef service fill:#90EE90,stroke:#333,stroke-width:1px
    classDef db fill:#FFD580,stroke:#333,stroke-width:1px
    classDef ext fill:#D3D3D3,stroke:#333,stroke-width:1px
```
