# panaroma-finance-internal/coinexchange_cryptoexchange_java architecture

> Architecture diagram of the GitHub repository panaroma-finance-internal/coinexchange_cryptoexchange_java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/panaroma-finance-internal/coinexchange_cryptoexchange_java
- Repository: https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java

## Overview

##### Project type and purpose
- This is a full-stack, microservice-based cryptocurrency exchange platform (Java Spring Cloud).
- It supports trading (matching engine), market data/K-line service, user center, OTC, wallet RPC, chat, admin backend, two Vue frontends, and native mobile apps.

##### File structure
- 00_framework: the core microservices:
- cloud – Eureka service registry
- admin – Admin API
- exchange – In-memory matching engine
- market – Market data, K-line generation, depth & push
- ucenter-api – User authentication, profile, real-name, assets
- wallet – Kafka-driven wallet transaction service
- otc-api / otc-core – Fiat OTC trading
- chat – WebSocket/Netty-based messaging
- exchange-api / exchange-core – Order API and core modules
- bitrade-job – Scheduled jobs (daily stats, cleanup)
- core – Shared libraries, DAO, service, common utilities
- 01_wallet_rpc: separate microservices per blockchain (BTC, ETH, USDT, etc.) exposing JSON-RPC endpoints, each with own Kafka, Mongo, configuration.
- 02_App_Android & 03_App_IOS: native mobile apps (closed source).
- 04_Web_Admin & 05_Web_Front: Vue.js based admin and trading UIs.

##### Extract insights from README
- Uses Spring Cloud components: Eureka (discovery), RestTemplate for inter-service calls, Kafka for event bus, MongoDB/MySQL for persistence, Redis for caching.
- Architectural patterns: microservices, event-driven (Kafka), layered MVC (controller-service-dao), shared libraries (core).
- Deployment: each service packaged as a standalone JAR, deployed behind Nginx/load balancer.

##### Relationships & data flows
- Clients → Nginx/API Gateway → appropriate microservice (REST).
- Exchange publishes trade matches to a Kafka “trade” topic.
- Market & Wallet services subscribe to Kafka topics:
- Market: consume, persist market data, push via WebSocket.
- Wallet: consume, update balances in MySQL.
- User actions (login/register) → Ucenter-API writes to MySQL & Redis.
- Admin UI → Admin service → core services for management.
- Chat clients → Chat WebSocket → Chat service writes/reads from Mongo.
- RPC services monitor blockchains, produce deposit/withdraw events → Kafka → Wallet → Ucenter.

##### Architectural patterns & principles
- Microservices with Spring Cloud (each JAR self-contained).
- Service discovery (Eureka) and client-side load balancing.
- Event-driven architecture via Kafka for decoupling matching, persistence, wallet.
- Domain-driven layer separation: controllers, services, DAOs in each module.
- Shared core library for common DTOs, entities, utilities.

##### Essential elements
- Frontend clients on top, hitting Nginx or API Gateway.
- Eureka registry connecting to all services.
- Kafka cluster in the center with topics: trade, deposit, market, chat.
- Data stores attached to each service.
- Blockchain RPC modules on the side feeding Kafka.
- External integrations (OSS, SMS, Captcha) connected to Ucenter-API & Admin.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Clients
    AdminWeb["Admin Web UI"]:::frontend
    TradeWeb["Trading Web UI"]:::frontend
    MobileApps["Mobile Apps"]:::frontend

    %% Entry Point
    Nginx["Nginx/API Gateway"]:::external

    %% Service Registry
    subgraph "Service Registry & Config"
      Eureka["Eureka Service Registry"]:::service
    end

    %% Microservices
    subgraph "Microservices"
      UcenterAPI["Ucenter-API\n(User Center)"]:::service
      ExchangeAPI["Exchange-API\n(Order API)"]:::service
      ExchangeCore["Exchange-Core\n(Order Core)"]:::service
      ExchangeEngine["Exchange\n(Matching Engine)"]:::service
      Market["Market\n(Data & K-Line)"]:::service
      WalletSrv["Wallet\n(Transaction Service)"]:::service
      OTCAPI["OTC-API\n(Fiat OTC API)"]:::service
      OTCCore["OTC-Core\n(Fiat OTC Core)"]:::service
      ChatSrv["Chat\n(WebSocket Messaging)"]:::service
      AdminSvc["Admin Backend\n(Management)"]:::service
      JobSched["Bitrade-Job\n(Scheduled Jobs)"]:::service
      CoreLib["Core Libs & Utilities"]:::service
    end

    %% Messaging
    KafkaZK["Kafka & Zookeeper"]:::messaging

    %% Blockchain Adapters
    BlockchainRPCs["Blockchain RPC Services"]:::external

    %% Data Stores
    MySQL["MySQL\n(Core Data)"]:::db
    Redis["Redis\n(Cache)"]:::db
    Mongo["MongoDB\n(History & Market)"]:::db

    %% External Integrations
    AliOSS["Ali OSS"]:::external
    SMS["SMS/Email/Captcha"]:::external

    %% Frontend to Gateway
    AdminWeb -->|HTTP| Nginx
    TradeWeb -->|HTTP| Nginx
    MobileApps -->|HTTP| UcenterAPI
    MobileApps -->|HTTP| ExchangeAPI
    MobileApps -->|HTTP| OTCAPI
    MobileApps -->|WS| ChatSrv

    %% Gateway to Services
    Nginx -->|HTTP| UcenterAPI
    Nginx -->|HTTP| ExchangeAPI
    Nginx -->|HTTP| OTCAPI
    Nginx -->|HTTP| ChatSrv
    Nginx -->|HTTP| AdminSvc

    %% Service Discovery
    UcenterAPI -.-> Eureka
    ExchangeAPI -.-> Eureka
    ExchangeCore -.-> Eureka
    ExchangeEngine -.-> Eureka
    Market -.-> Eureka
    WalletSrv -.-> Eureka
    OTCAPI -.-> Eureka
    OTCCore -.-> Eureka
    ChatSrv -.-> Eureka
    AdminSvc -.-> Eureka
    JobSched -.-> Eureka

    %% Synchronous Calls
    ExchangeAPI -->|delegates orders| ExchangeCore
    AdminSvc -->|uses| CoreLib
    UcenterAPI -->|reads/writes| MySQL
    UcenterAPI -->|caches| Redis
    AdminSvc -->|reads/writes| MySQL
    Market -->|writes| Mongo
    Market -->|writes| MySQL
    WalletSrv -->|writes| MySQL
    ChatSrv -->|writes/reads| Mongo
    JobSched -->|reads/writes| MySQL

    %% Asynchronous Event Flows
    ExchangeEngine -->|publish trade| KafkaZK
    BlockchainRPCs -->|publish deposit/withdraw| KafkaZK
    KafkaZK -->|consume trade| Market
    KafkaZK -->|consume trade| WalletSrv
    KafkaZK -->|consume events| UcenterAPI

    %% External Integrations
    UcenterAPI -->|store avatars| AliOSS
    UcenterAPI -->|send SMS/Email/Captcha| SMS
    AdminSvc -->|send notifications| SMS

    %% Click Events
    click Eureka "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/cloud"
    click AdminSvc "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/admin"
    click ExchangeEngine "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/exchange"
    click ExchangeAPI "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/exchange-api"
    click ExchangeCore "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/exchange-core"
    click Market "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/market"
    click UcenterAPI "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/ucenter-api"
    click WalletSrv "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/wallet"
    click OTCAPI "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/otc-api"
    click OTCCore "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/otc-core"
    click ChatSrv "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/chat"
    click JobSched "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/bitrade-job"
    click CoreLib "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/00_framework/core"
    click BlockchainRPCs "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/01_wallet_rpc"
    click AdminWeb "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/04_Web_Admin"
    click TradeWeb "https://github.com/panaroma-finance-internal/coinexchange_cryptoexchange_java/tree/master/05_Web_Front"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#90CAF9
    classDef service fill:#BBDEFB,stroke:#64B5F6
    classDef db fill:#C8E6C9,stroke:#388E3C
    classDef messaging fill:#FFE0B2,stroke:#FB8C00
    classDef external fill:#CFD8DC,stroke:#757575
```
