# tadija-skugor/easyflat architecture

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

- Interactive diagram: https://gitdiagram.com/tadija-skugor/easyflat
- Repository: https://github.com/tadija-skugor/easyflat

## Overview

##### Main Components

a) Frontend Layer:
- React-based Single Page Application (SPA)
- Key components:
- Authentication interface
- Discussion board
- Voting system
- User profile management
- Meeting scheduler

b) Backend Layer:
- Node.js with Express server
- Authentication middleware
- Route handlers for different functionalities
- Database connection management

c) Database Layer:
- PostgreSQL database
- Backup system (as evidenced by dbBackups folder)

d) External Services:
- Google OAuth for authentication
- Ngrok for domain hosting

##### User Interface → API Layer
- RESTful API endpoints from the routes folder
- Authentication flow
- Public vs private routes

##### API Layer → Database
- Data persistence flow
- Backup processes

##### External Services Integration
- Google OAuth flow
- Ngrok routing

##### Specific Implementation Details

- Blue rectangles for frontend components
- Green rectangles for backend services
- Purple clouds for external services

##### Architectural Patterns to Highlight

- MVC pattern in the frontend (components, pages structure)
- Middleware-based authentication
- RESTful API architecture
- Stateless authentication using JWT (implied by auth middleware)

##### Important Elements

- Security boundaries
- Authentication flow
- Public vs private routes
- Data backup flow
- Discussion and voting system flow
- Real-time communication paths (if any)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Frontend Application"
        App["Main App"]:::frontend
        Router["Router"]:::frontend
        Header["Header"]:::frontend
        Footer["Footer"]:::frontend
        
        subgraph "User Interface Components"
            Profile["User Profile"]:::frontend
            Contact["Contact/Support"]:::frontend
            SignUp["Registration"]:::frontend
        end
    end

    subgraph "Backend Services"
        Server["Express Server"]:::backend
        DBConn["Database Connection"]:::backend
        AuthMiddleware["Auth Middleware"]:::backend
        
        subgraph "API Routes"
            AuthRoutes["Authentication Routes"]:::api
            OAuthRoutes["OAuth Routes"]:::api
            DiscussionRoutes["Discussion Routes"]:::api
            VotingRoutes["Voting Routes"]:::api
            UserRoutes["User Data Routes"]:::api
            AdminRoutes["Admin Routes"]:::api
            LogoutRoute["Logout Route"]:::api
        end
    end

    subgraph "Data Layer"
        DB[(PostgreSQL)]:::database
        Backup["Backup System"]:::backend
    end

    subgraph "External Services"
        GoogleOAuth["Google OAuth"]:::external
        Ngrok["Ngrok Domain"]:::external
    end

    %% Connections
    Browser --> App
    App --> Router
    Router --> Profile
    Router --> Contact
    Router --> SignUp
    App --> Header
    App --> Footer

    Browser --> AuthRoutes
    Browser --> OAuthRoutes
    
    AuthMiddleware --> DiscussionRoutes
    AuthMiddleware --> VotingRoutes
    AuthMiddleware --> UserRoutes
    AuthMiddleware --> AdminRoutes
    AuthMiddleware --> LogoutRoute

    Server --> DBConn
    DBConn --> DB
    DB --> Backup

    OAuthRoutes --> GoogleOAuth
    Browser --> Ngrok
    Ngrok --> Server

    %% Click Events
    click App "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/App.js"
    click Router "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/components/Router.js"
    click Profile "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/pages/KorisnikInfo.js"
    click Contact "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/pages/Contact.js"
    click SignUp "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/pages/Signup.js"
    click Header "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/components/Header.js"
    click Footer "https://github.com/Tadija-Skugor/EasyFlat/blob/main/frontend/src/components/Footer.js"
    click Server "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/index.js"
    click DBConn "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/db.js"
    click AuthMiddleware "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/middleware/auth.js"
    click Backup "https://github.com/Tadija-Skugor/EasyFlat/tree/main/backend/dbBackups/"
    click AuthRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/authentifikacija.js"
    click OAuthRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/oauth.js"
    click DiscussionRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/discussionData.js"
    click VotingRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/glasanjeSlanje.js"
    click UserRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/userData.js"
    click AdminRoutes "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/admin.js"
    click LogoutRoute "https://github.com/Tadija-Skugor/EasyFlat/blob/main/backend/routes/logout.js"

    %% Styling
    classDef frontend fill:#2196F3,color:white
    classDef backend fill:#4CAF50,color:white
    classDef api fill:#FF9800,color:white
    classDef database fill:#FFC107,color:black
    classDef external fill:#9C27B0,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        Backend["Backend Service"]:::backend
        API["API Route"]:::api
        Database["Database"]:::database
        External["External Service"]:::external
    end
```
