# golabisib/divar-reactjs- architecture

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

- Interactive diagram: https://gitdiagram.com/golabisib/divar-reactjs-
- Repository: https://github.com/golabisib/divar-reactjs-

## Overview

##### Main Components

A. Frontend Layer (React.js):
- Components (templates, modules)
- Services (auth, admin, main, user)
- Router
- State Management (React Query)
- Utils (cookies, numbers)

B. Backend Layer (Node.js):
- API Routes (auth, category, option, post, user)
- Controllers
- Services
- Models (MongoDB schemas)
- Common (guards, exceptions, utils)
- Config (mongoose, swagger)

C. Database Layer:
- MongoDB instance with collections:
- Users
- Posts
- Categories
- Options

D. External Services/Middleware:
- Authentication/Authorization
- File Upload (Multer)
- Exception Handlers
- Swagger Documentation

##### Connection Flow

- Frontend → Backend (REST API calls)
- Backend → Database (Mongoose ODM)
- Frontend ↔ Auth Service (JWT/Cookie-based auth)
- Backend ↔ File Storage (for uploads)

##### Specific Implementation Details

Technical aspects:
- React Query for API state management
- JWT/Cookie authentication flow
- File upload handling
- API documentation with Swagger
- MongoDB connection
- Error handling middleware

##### Component Relationships

Key interactions:
- User authentication flow
- Post creation/management
- Category management
- File upload process
- API request/response cycle

##### Additional Elements

- Environment configurations
- Public assets
- Build tools (Vite)
- Static file serving

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Frontend["Frontend Layer (React.js)"]
        direction TB
        FComponents["Components"]:::frontend
        FServices["Services"]:::frontend
        FRouter["Router"]:::frontend
        FState["State Management"]:::frontend
        FUtils["Utils"]:::frontend
        
        subgraph FComponentsDetail["Components Detail"]
            Templates["Templates"]:::frontend
            Modules["Modules"]:::frontend
        end
        
        subgraph FServicesDetail["Services Detail"]
            AdminService["Admin Service"]:::frontend
            AuthService["Auth Service"]:::frontend
            MainService["Main Service"]:::frontend
            UserService["User Service"]:::frontend
        end
        
        subgraph FUtilsDetail["Utils Detail"]
            Cookies["Cookie Utils"]:::frontend
            Numbers["Number Utils"]:::frontend
        end
    end
    
    subgraph Backend["Backend Layer (Node.js)"]
        direction TB
        BRoutes["API Routes"]:::backend
        BControllers["Controllers"]:::backend
        BServices["Services"]:::backend
        BModels["Models"]:::backend
        BCommon["Common"]:::backend
        BConfig["Config"]:::backend
        
        subgraph BRoutesDetail["API Routes Detail"]
            AuthRoutes["Auth Routes"]:::backend
            CategoryRoutes["Category Routes"]:::backend
            OptionRoutes["Option Routes"]:::backend
            PostRoutes["Post Routes"]:::backend
            UserRoutes["User Routes"]:::backend
        end
        
        subgraph BCommonDetail["Common Detail"]
            Guards["Authorization Guard"]:::backend
            Exceptions["Exception Handler"]:::backend
            FileUpload["File Upload (Multer)"]:::backend
        end
    end
    
    subgraph Database["Database Layer"]
        MongoDB[(MongoDB)]:::database
        Users[("Users")]:::database
        Posts[("Posts")]:::database
        Categories[("Categories")]:::database
        Options[("Options")]:::database
    end
    
    subgraph External["External Services"]
        SwaggerDocs["Swagger Documentation"]:::external
        AuthMiddleware["Auth Middleware"]:::external
    end
    
    %% Connections
    Frontend --> Backend
    Backend --> MongoDB
    MongoDB --> Users & Posts & Categories & Options
    Frontend <--> AuthMiddleware
    Backend <--> FileUpload
    Backend <--> SwaggerDocs
    
    %% Click Events
    click FComponents "https://github.com/golabisib/divar-ReactJS-/tree/main/frontEnd/src/components"
    click Templates "https://github.com/golabisib/divar-ReactJS-/tree/main/frontEnd/src/components/templates"
    click Modules "https://github.com/golabisib/divar-ReactJS-/tree/main/frontEnd/src/components/modules"
    click AdminService "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/services/admin.js"
    click AuthService "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/services/auth.js"
    click MainService "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/services/main.js"
    click UserService "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/services/user.js"
    click FRouter "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/router/Router.jsx"
    click Cookies "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/utils/cookie.js"
    click Numbers "https://github.com/golabisib/divar-ReactJS-/blob/main/frontEnd/src/utils/numbers.js"
    click AuthRoutes "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/modules/auth/auth.routes.js"
    click CategoryRoutes "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/modules/category/category.routes.js"
    click OptionRoutes "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/modules/option/option.routes.js"
    click PostRoutes "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/modules/post/post.routes.js"
    click UserRoutes "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/modules/user/user.routes.js"
    click BControllers "https://github.com/golabisib/divar-ReactJS-/tree/main/backEnd/src/modules"
    click BServices "https://github.com/golabisib/divar-ReactJS-/tree/main/backEnd/src/modules"
    click BModels "https://github.com/golabisib/divar-ReactJS-/tree/main/backEnd/src/modules"
    click Guards "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/common/guard/authorization.guard.js"
    click Exceptions "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/common/exception/all-exception.handler.js"
    click FileUpload "https://github.com/golabisib/divar-ReactJS-/blob/main/backEnd/src/common/utils/multer.js"
    click BConfig "https://github.com/golabisib/divar-ReactJS-/tree/main/backEnd/src/config"
    
    %% Styling
    classDef frontend fill:#2196F3,stroke:#1565C0,color:white
    classDef backend fill:#4CAF50,stroke:#2E7D32,color:white
    classDef database fill:#FFC107,stroke:#FFA000,color:black
    classDef external fill:#9E9E9E,stroke:#616161,color:white
    
    %% Legend
    subgraph Legend
        Frontend_L["Frontend"]:::frontend
        Backend_L["Backend"]:::backend
        Database_L["Database"]:::database
        External_L["External Services"]:::external
    end
```
