# sumitkr0843/trading-signal-tracking-application architecture

> Architecture diagram of the GitHub repository sumitkr0843/trading-signal-tracking-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sumitkr0843/trading-signal-tracking-application
- Repository: https://github.com/sumitkr0843/trading-signal-tracking-application

## Overview

This Spring Boot REST API lets users register or log in, then manage cryptocurrency trading signals. Signal requests are validated, mapped into persisted records, and returned through the API; users can refresh a signal using Binance prices, while a scheduler evaluates signal status and ROI automatically. JWT authentication protects authenticated workflows. The README also documents PostgreSQL/Flyway persistence and Swagger/OpenAPI documentation. Relationships are based on the supplied source excerpts, SOURCE INDEX references, or README; unsampled wiring is omitted or marked unverified.

Main entry points: [`src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java) (Signal Operations), [`src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java`](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java) (Auth Endpoints), [`src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java`](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java) (Signal Endpoints), [`src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java`](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java) (Signal Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth Endpoints"]
  node_signal_controller["Signal Endpoints"]
  node_signal_dto["Signal DTOs"]
  node_openapi["OpenAPI Setup<br/>[OpenApiConfig.java]"]
  node_errors["API Error Handling"]
end

subgraph group_identity["Identity &amp; Security"]
  node_auth_service["Registration"]
  node_user_details["User Lookup"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
  node_jwt_filter["JWT Filter"]
  node_user_entity["User Model<br/>[User.java]"]
end

subgraph group_signals["Signal Domain"]
  node_signal_service["Signal Operations"]
  node_validator["Signal Validation"]
  node_mapper["Signal Mapping<br/>[SignalMapper.java]"]
  node_signal_entity["Signal Model<br/>[TradingSignal.java]"]
end

subgraph group_market["Market Evaluation"]
  node_scheduler["Status Scheduler"]
  node_evaluator["Status &amp; ROI"]
  node_binance["Binance Client<br/>[BinanceClient.java]"]
end

subgraph group_persistence["Persistence"]
  node_signal_repo["Signal Repository"]
  node_user_repo["User Repository"]
end

node_user(("API User"))
node_binance_service["Binance API"]
node_database[("PostgreSQL")]

node_user -->|"registers or logs in"| node_auth_controller
node_user -->|"manages signals"| node_signal_controller
node_auth_controller -->|"registers through"| node_auth_service
node_auth_controller -->|"loads user"| node_user_details
node_auth_controller -->|"creates token"| node_jwt
node_auth_service -->|"saves user"| node_user_repo
node_user_details -->|"looks up user"| node_user_repo
node_user_repo -->|"loads users"| node_user_entity
node_jwt_filter -->|"validates token"| node_jwt
node_jwt_filter -->|"loads identity"| node_user_details
node_signal_controller -->|"dispatches operations"| node_signal_service
node_signal_controller -->|"accepts and returns"| node_signal_dto
node_signal_service -.->|"validates requests"| node_validator
node_signal_service -->|"maps signals"| node_mapper
node_signal_service -->|"reads and writes"| node_signal_repo
node_signal_service -->|"fetches current price"| node_binance
node_signal_service -->|"evaluates refresh"| node_evaluator
node_mapper -->|"creates and converts"| node_signal_entity
node_signal_repo -->|"persists signals"| node_signal_entity
node_scheduler -->|"fetches prices"| node_binance
node_scheduler -->|"evaluates status"| node_evaluator
node_scheduler -->|"loads and saves"| node_signal_repo
node_binance -.->|"requests prices"| node_binance_service
node_signal_repo -.->|"persists records"| node_database
node_user_repo -.->|"persists accounts"| node_database
node_signal_controller -.->|"returns API errors"| node_errors
node_user -->|"views API docs"| node_openapi

click node_auth_controller "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java"
click node_signal_controller "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java"
click node_signal_dto "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/dto/CreateSignalRequest.java"
click node_auth_service "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/AuthServiceImpl.java"
click node_user_details "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/AppUserDetailsService.java"
click node_jwt "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/JwtService.java"
click node_jwt_filter "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/filter/JwtAuthenticationFilter.java"
click node_signal_service "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java"
click node_validator "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/validation/SignalRequestValidator.java"
click node_mapper "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/mapper/SignalMapper.java"
click node_signal_entity "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/entity/TradingSignal.java"
click node_scheduler "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java"
click node_evaluator "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/SignalEvaluator.java"
click node_binance "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/client/BinanceClient.java"
click node_signal_repo "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java"
click node_user_repo "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/repository/UserRepository.java"
click node_user_entity "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/entity/User.java"
click node_openapi "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/config/OpenApiConfig.java"
click node_errors "https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/exception/GlobalExceptionHandler.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_controller,node_signal_controller,node_signal_dto,node_openapi,node_errors,node_user toneBlue
class node_auth_service,node_user_details,node_jwt,node_jwt_filter,node_user_entity,node_database toneAmber
class node_signal_service,node_validator,node_mapper,node_signal_entity,node_binance_service toneMint
class node_scheduler,node_evaluator,node_binance toneRose
class node_signal_repo,node_user_repo toneIndigo
```

## Components

### REST API

- [Auth Endpoints](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java`
- [Signal Endpoints](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java`
- [Signal DTOs](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/dto/CreateSignalRequest.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/dto/CreateSignalRequest.java`
- [OpenAPI Setup](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/config/OpenApiConfig.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/config/OpenApiConfig.java`
- [API Error Handling](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/exception/GlobalExceptionHandler.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/exception/GlobalExceptionHandler.java`

### Identity & Security

- [Registration](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/AuthServiceImpl.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/service/AuthServiceImpl.java`
- [User Lookup](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/AppUserDetailsService.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/service/AppUserDetailsService.java`
- [JWT Service](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/JwtService.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/service/JwtService.java`
- [JWT Filter](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/filter/JwtAuthenticationFilter.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/filter/JwtAuthenticationFilter.java`
- [User Model](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/entity/User.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/entity/User.java`

### Signal Domain

- [Signal Operations](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`
- [Signal Validation](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/validation/SignalRequestValidator.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/validation/SignalRequestValidator.java`
- [Signal Mapping](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/mapper/SignalMapper.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/mapper/SignalMapper.java`
- [Signal Model](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/entity/TradingSignal.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/entity/TradingSignal.java`

### Market Evaluation

- [Status Scheduler](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java`
- [Status & ROI](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/service/SignalEvaluator.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/service/SignalEvaluator.java`
- [Binance Client](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/client/BinanceClient.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/client/BinanceClient.java`

### Persistence

- [Signal Repository](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java`
- [User Repository](https://github.com/sumitkr0843/trading-signal-tracking-application/blob/main/src/main/java/com/sumit/tradingsignaltrackingapplication/repository/UserRepository.java): `src/main/java/com/sumit/tradingsignaltrackingapplication/repository/UserRepository.java`

### Other components

- **API User**
- **Binance API**
- **PostgreSQL**

## Connections

- API User → Auth Endpoints: registers or logs in (evidence: `README.md`)
- API User → Signal Endpoints: manages signals (evidence: `README.md`)
- Auth Endpoints → Registration: registers through (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java`)
- Auth Endpoints → User Lookup: loads user (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java`)
- Auth Endpoints → JWT Service: creates token (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/AuthController.java`)
- Registration → User Repository: saves user (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/AuthServiceImpl.java`)
- User Lookup → User Repository: looks up user (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/AppUserDetailsService.java`)
- User Repository → User Model: loads users (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/repository/UserRepository.java`)
- JWT Filter → JWT Service: validates token (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/filter/JwtAuthenticationFilter.java`)
- JWT Filter → User Lookup: loads identity (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/filter/JwtAuthenticationFilter.java`)
- Signal Endpoints → Signal Operations: dispatches operations (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java`)
- Signal Endpoints → Signal DTOs: accepts and returns (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/controller/TradingSignalController.java`)
- Signal Operations → Signal Validation: validates requests
- Signal Operations → Signal Mapping: maps signals (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`)
- Signal Operations → Signal Repository: reads and writes (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`)
- Signal Operations → Binance Client: fetches current price (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`)
- Signal Operations → Status & ROI: evaluates refresh (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/service/TradingSignalService.java`)
- Signal Mapping → Signal Model: creates and converts (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/mapper/SignalMapper.java`)
- Signal Repository → Signal Model: persists signals (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/repository/TradingSignalRepository.java`)
- Status Scheduler → Binance Client: fetches prices (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java`)
- Status Scheduler → Status & ROI: evaluates status (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java`)
- Status Scheduler → Signal Repository: loads and saves (evidence: `src/main/java/com/sumit/tradingsignaltrackingapplication/scheduler/SignalScheduler.java`)
- Binance Client → Binance API: requests prices (evidence: `README.md`)
- Signal Repository → PostgreSQL: persists records (evidence: `README.md`)
- User Repository → PostgreSQL: persists accounts (evidence: `README.md`)
- Signal Endpoints → API Error Handling: returns API errors
- API User → OpenAPI Setup: views API docs (evidence: `README.md`)
