# gitbitex/gitbitex-new architecture

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

- Interactive diagram: https://gitdiagram.com/gitbitex/gitbitex-new
- Repository: https://github.com/gitbitex/gitbitex-new

## Overview

##### Main Components

a) Core Components:
- Matching Engine (Central component)
- Market Data System
- Order Management System
- Feed/WebSocket System
- OpenAPI/REST Interface
- Persistence Layer (MongoDB, Redis, Kafka)

b) Supporting Components:
- Authentication System
- Wallet Integration Points
- Monitoring System (Prometheus metrics)

##### Detailed Component Breakdown

A. Matching Engine Layer:
- In-memory matching engine as the core component
- Command processing system (CommandSerializer, CommandDeserializer)
- Snapshot management system
- Order book management
- Account book integration

B. Market Data Layer:
- Order book snapshots
- Candle/Ticker generation
- Trade persistence
- Account persistence

C. Communication Layer:
- WebSocket feed system
- REST API endpoints
- Authentication interceptors

D. Storage Layer:
- MongoDB for persistent storage
- Redis for caching
- Kafka for event streaming

##### Data Flow Representation

- Order flow: API → Matching Engine → Market Data
- WebSocket feed distribution
- Snapshot creation and storage
- Market data updates
- Command replay mechanism

**[Client Layer]**
- ↓ ↑
**[API Layer (REST + WebSocket)]**
- ↓ ↑
**[Command Processing Layer]**
- ↓ ↑
**[Matching Engine Core]**
- ↓ ↑
**[Market Data Processing]**
- ↓ ↑
**[Persistence Layer]**

##### Implementation Details

- Queue representations for high-throughput areas
- Redundancy/failover capabilities
- Snapshot points and recovery mechanisms

##### Critical Notes

- In-memory nature of the matching engine
- Standby deployment capability
- Command replay mechanisms
- Monitoring points for performance metrics
- Wallet integration points

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and classes
    classDef client fill:#E1F5FE,stroke:#01579B
    classDef api fill:#E8F5E9,stroke:#1B5E20
    classDef core fill:#E3F2FD,stroke:#0D47A1
    classDef data fill:#FFF3E0,stroke:#E65100
    classDef persistence fill:#FCE4EC,stroke:#880E4F
    classDef auth fill:#F3E5F5,stroke:#4A148C
    
    %% Client Layer
    subgraph ClientLayer
        WEB[Web Interface]:::client
        WSC[WebSocket Clients]:::client
        REST[REST Clients]:::client
    end

    %% API Gateway Layer
    subgraph APILayer
        WSHAND[WebSocket Handler]:::api
        RESTC[REST Controllers]:::api
        AUTH[Authentication]:::auth
    end

    %% Service Layer
    subgraph CoreServices
        ME[Matching Engine]:::core
        MDS[Market Data System]:::core
        OMS[Order Management]:::core
        FEED[Feed System]:::core
    end

    %% Data Layer
    subgraph DataStores
        MONGO[(MongoDB)]:::persistence
        REDIS[(Redis)]:::persistence
        KAFKA[(Kafka)]:::persistence
    end

    %% Wallet Integration
    WALLET[Wallet Integration]:::api

    %% Relationships
    WEB --> RESTC
    WSC --> WSHAND
    REST --> RESTC
    
    RESTC --> AUTH
    WSHAND --> AUTH
    
    AUTH --> ME
    AUTH --> OMS
    
    ME --> MDS
    MDS --> FEED
    OMS --> ME
    
    ME --> KAFKA
    MDS --> MONGO
    OMS --> REDIS
    FEED --> REDIS
    
    OMS --> WALLET

    %% Click events
    click ME "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/matchingengine/"
    click MDS "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/marketdata/"
    click FEED "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/feed/"
    click WSHAND "https://github.com/gitbitex/gitbitex-new/blob/main/src/main/java/com/gitbitex/feed/FeedTextWebSocketHandler.java"
    click RESTC "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/openapi/controller/"
    click MONGO "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/middleware/mongodb/"
    click REDIS "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/middleware/redis/"
    click KAFKA "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/middleware/kafka/"
    click AUTH "https://github.com/gitbitex/gitbitex-new/blob/main/src/main/java/com/gitbitex/openapi/AuthInterceptor.java"
    click WALLET "https://github.com/gitbitex/gitbitex-new/tree/main/src/main/java/com/gitbitex/wallet/"
    click OMS "https://github.com/gitbitex/gitbitex-new/blob/main/src/main/java/com/gitbitex/marketdata/manager/OrderManager.java"
```
