# lidorbenhamo26/webteam architecture

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

- Interactive diagram: https://gitdiagram.com/lidorbenhamo26/webteam
- Repository: https://github.com/lidorbenhamo26/webteam

## Overview

##### Project type and purpose
- It consists of a React-based client (in HM2/client) and an Express.js-based backend (in HM2/backend), with Mongoose-style models under “models” and REST endpoints under “routes/controllers.”
- It provides functionality for students and teachers: authentication, exercises, theory, progress tracking, reports, and even an external “gemini” AI integration.

##### File structure
- Top-level:
- /backend – Express server, controllers, models, routes, seed scripts, .env, vercel.json
- /client – React app with public/index.html, component tree (shared, student, teacher), context, services calling backend APIs, Tailwind config, vercel.json
- package.json at root (likely scripts to run simultaneously or monorepo tools)
- Architectural patterns:
- Backend follows MVC (models/controllers/routes)
- Frontend follows component-based UI plus service layer for API calls plus React Context for theme, private routing
- External service integration: geminiController & geminiService
- Deployment: Both tiers have vercel.json → likely deployed on Vercel (two separate projects or monorepo deploy).

##### README for additional insights
- The README only lists team members. No architectural overview—so we must infer architecture solely from the file structure.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% React Client Tier
    subgraph "React Client" 
        direction TB
        idx["index.js"]:::frontend
        app["App.jsx"]:::frontend
        shared["Shared UI Components"]:::frontend
        studentComp["Student UI Components"]:::frontend
        teacherComp["Teacher UI Components"]:::frontend
        context["Theme & Auth Context"]:::frontend
        subgraph "Service Layer"
            direction TB
            authS["AuthService"]:::frontend
            exS["ExerciseService"]:::frontend
            thS["TheoryService"]:::frontend
            thpS["TheoryProgressService"]:::frontend
            stS["StudentService"]:::frontend
            teS["TeacherService"]:::frontend
            helpS["HelpService"]:::frontend
            repS["ReportService"]:::frontend
            progS["ProgressService"]:::frontend
            gemS["GeminiService"]:::frontend
        end
        public["Public Assets"]:::frontend
        vercelFE["vercel.json"]:::frontend
    end

    %% Backend API Tier
    subgraph "Express API" 
        direction TB
        server["server.js"]:::backend
        env[".env"]:::backend
        vercelBE["vercel.json"]:::backend
        subgraph "Routes"
            direction TB
            authR["auth.js"]:::backend
            exR["exercises.js"]:::backend
            thR["theory.js"]:::backend
            thpR["theoryProgress.js"]:::backend
            progR["progress.js"]:::backend
            helpR["help.js"]:::backend
            repR["reports.js"]:::backend
            stR["students.js"]:::backend
            teR["teachers.js"]:::backend
            gemR["gemini.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            authC["authController.js"]:::backend
            exC["exerciseController.js"]:::backend
            thC["theoryController.js"]:::backend
            thpC["theoryProgressController.js"]:::backend
            progC["progressController.js"]:::backend
            helpC["helpController.js"]:::backend
            repC["reportController.js"]:::backend
            stC["studentController.js"]:::backend
            teC["teacherController.js"]:::backend
            gemC["geminiController.js"]:::backend
        end
        subgraph "Models"
            direction TB
            stM["Student.js"]:::backend
            teM["Teacher.js"]:::backend
            exM["Exercise.js"]:::backend
            thM["Theory.js"]:::backend
            thpM["TheoryProgress.js"]:::backend
            spM["StudentProgress.js"]:::backend
            helpM["Help.js"]:::backend
            repM["Report.js"]:::backend
        end
        subgraph "Seed Scripts"
            direction TB
            seedTh["seed-theory.js"]:::backend
            seedEx["seedExercises.js"]:::backend
        end
    end

    %% Data & External Services
    db[(MongoDB)]:::database
    gemini["Gemini AI Service"]:::external

    %% Flow Connections
    Browser --> idx
    idx --> app
    app --> shared
    app --> studentComp
    app --> teacherComp
    app --> context
    app --> public
    app --> authS
    app --> exS
    app --> thS
    app --> thpS
    app --> stS
    app --> teS
    app --> helpS
    app --> repS
    app --> progS
    app --> gemS

    authS -->|"calls /api/auth"| authR
    exS -->|"calls /api/exercises"| exR
    thS -->|"calls /api/theory"| thR
    thpS -->|"calls /api/theoryProgress"| thpR
    progS -->|"calls /api/progress"| progR
    helpS -->|"calls /api/help"| helpR
    repS -->|"calls /api/reports"| repR
    stS -->|"calls /api/students"| stR
    teS -->|"calls /api/teachers"| teR
    gemS -->|"calls /api/gemini"| gemR

    server --> authR
    server --> exR
    server --> thR
    server --> thpR
    server --> progR
    server --> helpR
    server --> repR
    server --> stR
    server --> teR
    server --> gemR
    server --> env
    server --> vercelBE

    authR --> authC
    exR --> exC
    thR --> thC
    thpR --> thpC
    progR --> progC
    helpR --> helpC
    repR --> repC
    stR --> stC
    teR --> teC
    gemR --> gemC

    authC --> authM
    exC --> exM
    thC --> thM
    thpC --> thpM
    progC --> spM
    helpC --> helpM
    repC --> repM
    stC --> stM
    teC --> teM
    gemC --> gemini

    authC --> db
    exC --> db
    thC --> db
    thpC --> db
    progC --> db
    helpC --> db
    repC --> db
    stC --> db
    teC --> db

    seedTh --> thM
    seedEx --> exM

    %% Click Events
    click idx "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/index.js"
    click app "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/App.jsx"
    click shared "https://github.com/lidorbenhamo26/webteam/tree/main/HM2/client/src/components/shared"
    click studentComp "https://github.com/lidorbenhamo26/webteam/tree/main/HM2/client/src/components/student"
    click teacherComp "https://github.com/lidorbenhamo26/webteam/tree/main/HM2/client/src/components/teacher"
    click context "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/contexts/ThemeContext.jsx"
    click authS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/authService.js"
    click exS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/exerciseService.js"
    click thS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/theoryService.js"
    click thpS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/theoryProgressService.js"
    click stS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/studentService.js"
    click teS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/teacherService.js"
    click helpS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/helpService.js"
    click repS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/reportService.js"
    click progS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/progressService.js"
    click gemS "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/client/src/services/geminiService.js"
    click public "https://github.com/lidorbenhamo26/webteam/tree/main/HM2/client/public"
    click server "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/server.js"
    click env "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/.env"
    click vercelBE "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/vercel.json"
    click authR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/auth.js"
    click exR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/exercises.js"
    click thR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/theory.js"
    click thpR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/theoryProgress.js"
    click progR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/progress.js"
    click helpR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/help.js"
    click repR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/reports.js"
    click stR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/students.js"
    click teR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/teachers.js"
    click gemR "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/routes/gemini.js"
    click authC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/authController.js"
    click exC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/exerciseController.js"
    click thC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/theoryController.js"
    click thpC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/theoryProgressController.js"
    click progC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/progressController.js"
    click helpC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/helpController.js"
    click repC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/reportController.js"
    click stC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/studentController.js"
    click teC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/teacherController.js"
    click gemC "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/controllers/geminiController.js"
    click stM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Student.js"
    click teM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Teacher.js"
    click exM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Exercise.js"
    click thM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Theory.js"
    click thpM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/TheoryProgress.js"
    click spM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/StudentProgress.js"
    click helpM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Help.js"
    click repM "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/models/Report.js"
    click seedTh "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/scripts/seed-theory.js"
    click seedEx "https://github.com/lidorbenhamo26/webteam/blob/main/HM2/backend/scripts/seedExercises.js"

    %% Styles
    classDef frontend fill:#BBDEFB,stroke:#0D47A1;
    classDef backend fill:#C8E6C9,stroke:#1B5E20;
    classDef database fill:#FFE0B2,stroke:#E65100,shape:cylinder;
    classDef external fill:#F3E5F5,stroke:#4A148C,shape:cloud;
```
