# anwarmoussaoui/makefriends architecture

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

- Interactive diagram: https://gitdiagram.com/anwarmoussaoui/makefriends
- Repository: https://github.com/anwarmoussaoui/makefriends

## Overview

##### Project Type & Purpose
- Full-stack social media platform (“MakeFriends”).
- Frontend: Next.js (React, SSR/CSR).
- Backend: Spring Boot microservice with REST controllers, JWT security, WebSocket chat, file storage, and a relational database.

##### File Structure
- front/
– Next.js app, pages, components, API calls
- back/ (Maven)
– src/main/java/com/workshop/back:
- Controller: REST endpoints (AuthenticationRequest/Response, UserController, PostController, MessageController, ProfileController, etc.)
- Service: Business logic layers (AuthenticationService, UserService, PostService, MessageService, ProfileService, StorageService)
- Repository: Spring Data JPA Repos for Entities (User, Post, Comment, Like, Message, FileData, ImageData, ProfileSett, etc.)
- Entity/DTO: JPA Entities and Data Transfer Objects
- config: Spring Security (JwtService, JwtAuthenticationFilter, SecurityConfig), CORS config, WebSocketConfig & ChatWebSocketHandler
– resources/application.properties: DB and JWT settings

##### Key Architectural Patterns
- Layered (Controller → Service → Repository → DB)
- JWT-based stateless authentication filter
- WebSocket for real-time chat
- File storage (blob/images via StorageService and StorageRepository)

##### Main Components
A. Frontend (Next.js client)
B. API Gateway / Backend REST Service (Spring Boot)
1. Authentication Controller (login/signup)
2. User/Post/Comment/Follow Controllers
3. Business Services
4. Data Repositories
C. WebSocket Chat Service
D. Database (e.g., MySQL/PostgreSQL)
E. File Storage (local disk or cloud blob store)

##### Relationships & Data Flow
- HTTP(S) calls: Next.js → Spring Boot REST controllers → Services → Repositories → Database
- JWT flow: Login request → JwtAuthentificationFilter → JwtService issues token → Token sent with each API call → SecurityConfig validates
- WebSocket: Next.js WS client ↔ ChatWebSocketHandler → MessageService → MessagRepository
- File upload/download: Next.js → StorageService → StorageRepository → File system / Blob

##### Final Checklist
– Call out JWT auth flow next to the SecurityConfig block
– Group Controllers, Services, Repositories inside the Spring Boot boundary

## Diagram (Mermaid)

```mermaid
graph TB
    %% Frontend
    subgraph "Frontend"
        FN["Next.js Client"]:::frontend
    end

    %% Backend Application Entry
    BA["BackApplication"]:::service

    %% REST API Layer
    subgraph "REST API Layer"
        AC["Authentication Controller"]:::service
        UC["UserController"]:::service
        PC["PostController"]:::service
        MC["MessageController"]:::service
        PrC["ProfileController"]:::service
        PsC["ProfileSetController"]:::service
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        AS["AuthenticationService"]:::service
        US["UserService"]:::service
        PS["PostService"]:::service
        MS["MessageService"]:::service
        PrS["ProfileService"]:::service
        StS["StorageService"]:::service
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        CR["CommentRepo"]:::persistence
        PR["PostRepo"]:::persistence
        LR["LikeRepo"]:::persistence
        MR["MessagRepository"]:::persistence
        SR["StorageRepository"]:::persistence
        FDR["FileDataRepository"]:::persistence
        UR["UserRepository"]:::persistence
        ENT["Entities & DTOs"]:::persistence
    end

    %% Config Layer
    subgraph "Config & Security"
        JS["JwtService"]:::config
        JF["JwtAuthentificationFilter"]:::config
        SC["SecurityConfig"]:::config
        CC["CorsConfig"]:::config
        ACf["ApplicationConfig"]:::config
    end

    %% WebSocket Layer
    subgraph "WebSocket Chat Service"
        WC["WebSocketConfig"]:::websocket
        CH["ChatWebSocketHandler"]:::websocket
    end

    %% Data Stores
    subgraph "Data Stores"
        DB[(Database)]:::datastore
        FS[(File Storage)]:::datastore
    end

    %% Flows
    FN -->|"HTTP/HTTPS"| AC
    FN -->|"HTTP/HTTPS"| UC
    FN -->|"HTTP/HTTPS"| PC
    FN -->|"HTTP/HTTPS"| MC
    FN -->|"HTTP/HTTPS"| PrC
    FN -->|"HTTP/HTTPS"| PsC

    AC -->|"calls"| AS
    UC -->|"calls"| US
    PC -->|"calls"| PS
    MC -->|"calls"| MS
    PrC -->|"calls"| PrS
    PsC -->|"calls"| PrS
    PC -->|"calls"| StS

    AS --> CR
    US --> UR
    PS --> PR
    PS --> CR
    PS --> LR
    MS --> MR
    StS --> SR
    StS --> FDR

    AS --> JS
    FN -->|WS| CH
    CH -->|invokes| MS
    MS --> MR

    CR --> DB
    PR --> DB
    LR --> DB
    MR --> DB
    UR --> DB

    FDR --> FS
    SR --> FS

    %% JWT Flow
    FN -->|JWT token| JF
    JF --> JS
    SC --> JF

    %% Config connections
    CC --> FN
    ACf --> AS

    %% Click Events
    click FN "https://github.com/anwarmoussaoui/makefriends/tree/main/front/"
    click BA "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/BackApplication.java"
    click UC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Controller/UserController.java"
    click PC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Controller/PostController.java"
    click MC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Controller/MessageController.java"
    click PrC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Controller/ProfileController.java"
    click PsC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Controller/ProfileSetController.java"
    click AS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/AuthenticationService.java"
    click US "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/UserService.java"
    click PS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/PostService.java"
    click MS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/MessageService.java"
    click PrS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/ProfileService.java"
    click StS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Service/StorageService.java"
    click CR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/CommentRepo.java"
    click PR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/PostRepo.java"
    click LR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/LikeRepo.java"
    click MR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/MessagRepository.java"
    click SR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/StorageRepository.java"
    click FDR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Repository/FileDataRepository.java"
    click UR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/users/UserRepository.java"
    click ENT "https://github.com/anwarmoussaoui/makefriends/tree/main/back/src/main/java/com/workshop/back/Entity/"
    click ENT "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/DTO/PostDTO.java"
    click JS "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/JwtService.java"
    click JF "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/JwtAuthentificationFilter.java"
    click SC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/SecurityConfig.java"
    click CC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/CorsConfig.java"
    click ACf "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/ApplicationConfig.java"
    click WC "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/WebSocketConfig.java"
    click CH "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/config/ChatWebSocketHandler.java"
    click FDR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Entity/FileData.java"
    click FDR "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/Entity/ImageData.java"
    click ENT "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/java/com/workshop/back/util/ImageUtils.java"
    click DB "https://github.com/anwarmoussaoui/makefriends/blob/main/back/src/main/resources/application.properties"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef service fill:#98FB98,stroke:#333,stroke-width:1px
    classDef persistence fill:#FFFFE0,stroke:#333,stroke-width:1px
    classDef config fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef websocket fill:#FA8072,stroke:#333,stroke-width:1px
    classDef datastore fill:#FFA500,stroke:#333,stroke-width:1px,shape:cylinder
```
