# achrafaitibba/track-coumpounding-trades architecture

> Architecture diagram of the GitHub repository achrafaitibba/track-coumpounding-trades, 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/achrafaitibba/track-coumpounding-trades
- Repository: https://github.com/achrafaitibba/track-coumpounding-trades

## Overview

##### Main System Components

a) Client Layer
- External client applications that consume the REST API

b) API Layer
- Controllers package (`AccountController`, `EnumController`, `TargetController`, `TradeController`)
- REST endpoints grouping

c) Security Layer
- JWT Authentication/Authorization components
- Security filters
- Token management

d) Service Layer
- Business logic services (`AccountService`, `TradeService`, `TargetService`)
- Trade calculation and target computation logic

e) Repository Layer
- Data access layer with all repositories
- Entity relationships

f) Database Layer
- MySQL database
- Entity tables and relationships

##### Component Relationships and Interactions

a) Authentication Flow:
**Client → JwtAuthenticationFilter → SecurityConfigurationFilter → AccountService → TokenRepository**

b) Trade Management Flow:
**Client → TradeController → TradeService → TradeRepository → Database**

c) Target Calculation Flow:
**Client → TargetController → TargetService → CompoundingPeriodRepository/TargetRepository → Database**

##### Specific Implementation Details

Important architectural elements:

a) Security Components:
**JwtAuthenticationFilter ↔ JwtService ↔ TokenRepository**
**SecurityConfigurationFilter → LogoutService**

b) Data Model Relationships:
**Account → User → Trade**
**Trade → CompoundingPeriod**
**Target → Account**

c) DTO Flow:
**Request DTOs → Controllers → Services → Entities → Repositories**

##### Technical Stack Indicators

- Spring Boot 3.x
- Java 17
- MySQL
- JWT
- Hibernate
- Spring Security

##### Deployment Context

Deployment-related components:
- Tomcat container
- Application properties profiles (local/prod)
- Database connection pool

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef client fill:#E1F5FE,stroke:#01579B
    classDef controller fill:#90CAF9,stroke:#1565C0
    classDef security fill:#A5D6A7,stroke:#2E7D32
    classDef service fill:#FFF59D,stroke:#F57F17
    classDef repository fill:#FFCC80,stroke:#EF6C00
    classDef database fill:#E0E0E0,stroke:#424242
    classDef model fill:#CE93D8,stroke:#6A1B9A
    classDef config fill:#B0BEC5,stroke:#37474F

    %% Client Layer
    Client[Client Applications]:::client

    %% API Layer
    subgraph API
        AC[AccountController]:::controller
        TC[TradeController]:::controller
        TGC[TargetController]:::controller
        EC[EnumController]:::controller
    end

    %% Security Layer
    subgraph Security
        JAF[JwtAuthenticationFilter]:::security
        SCF[SecurityConfigurationFilter]:::security
        LS[LogoutService]:::security
        JS[JwtService]:::security
    end

    %% Service Layer
    subgraph Services
        AS[AccountService]:::service
        TS[TradeService]:::service
        TGS[TargetService]:::service
    end

    %% Repository Layer
    subgraph Repositories
        AR[AccountRepository]:::repository
        TR[TradeRepository]:::repository
        TGR[TargetRepository]:::repository
        CPR[CompoundingPeriodRepository]:::repository
        TokenR[TokenRepository]:::repository
    end

    %% Data Models
    subgraph Models
        Account[Account]:::model
        Trade[Trade]:::model
        Target[Target]:::model
        CP[CompoundingPeriod]:::model
        Token[Token]:::model
    end

    %% Database
    DB[(MySQL Database)]:::database

    %% Exception Handling
    EH[AppExceptionHandler]:::config

    %% Relationships
    Client --> AC & TC & TGC & EC
    
    %% Authentication Flow
    Client --> JAF --> SCF --> AS
    JAF --> JS --> TokenR
    SCF --> LS

    %% Service Flows
    AC --> AS --> AR
    TC --> TS --> TR
    TGC --> TGS --> TGR & CPR

    %% Repository to Database
    AR & TR & TGR & CPR & TokenR --> DB

    %% Model Relationships
    Account --> Trade
    Trade --> CP
    Target --> Account
    
    %% Click Events
    click AC "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/controller/AccountController.java"
    click TC "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/controller/TradeController.java"
    click TGC "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/controller/TargetController.java"
    click EC "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/controller/EnumController.java"
    click JAF "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/authenticationConfiguration/JwtAuthenticationFIlter.java"
    click SCF "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/authenticationConfiguration/SecurityConfigurationFilter.java"
    click LS "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/authenticationConfiguration/LogoutService.java"
    click JS "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/token/JwtService.java"
    click TokenR "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/token/TokenRepository.java"
    click AS "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/service/AccountService.java"
    click TS "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/service/TradeService.java"
    click TGS "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/service/TargetService.java"
    click AR "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/repository/AccountRepository.java"
    click TR "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/repository/TradeRepository.java"
    click TGR "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/repository/TargetRepository.java"
    click CPR "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/repository/CompoundingPeriodRepository.java"
    click Account "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/model/Account.java"
    click Trade "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/model/Trade.java"
    click Target "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/model/Target.java"
    click CP "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/model/CompoundingPeriod.java"
    click Token "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/configuration/token/Token.java"
    click EH "https://github.com/achrafaitibba/track-coumpounding-trades/blob/main/src/main/java/com/achrafaitibba/trackcompoundingtrades/exception/AppExceptionHandler.java"
```
