# tewtiadhruv06/sentix-quant-mesh architecture

> Architecture diagram of the GitHub repository tewtiadhruv06/sentix-quant-mesh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tewtiadhruv06/sentix-quant-mesh
- Repository: https://github.com/tewtiadhruv06/sentix-quant-mesh

## Overview

Sentix Quant Mesh is a financial-analysis terminal: a user requests an equity analysis in the Angular dashboard, the Spring service gathers fundamentals and requests an ML prediction, and the API returns a unified analysis. Its valuation branch distinguishes bank CCA from corporate DCF, while the Python service builds technical features and serves model inference. The README documents these product capabilities; several implementation links are supported only by its architecture description or the source index, so unsampled internals are not expanded.

Main entry points: [`backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/controller/AnalysisController.java) (Analysis API), [`backend/src/main/java/com/sentix/quant/repository/EquityRepository.java`](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/repository/EquityRepository.java) (Equity repository), [`backend/src/main/java/com/sentix/quant/service/FmpDataService.java`](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/FmpDataService.java) (FMP fundamentals), [`sentix_ml_engine/data_ingestion.py`](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/data_ingestion.py) (Technical features)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_terminal["Analysis terminal"]
  node_dashboard["Analysis dashboard"]
end

subgraph group_middle["Valuation middle-office"]
  node_api["Analysis API"]
  node_valuation["Sector valuation"]
  node_records["Financial records"]
  node_equities["Equity services<br/>[EquityService.java]"]
  node_mlbridge["ML integration"]
  node_contracts["Analysis DTOs"]
  node_equityrepo["Equity repository"]
  node_recordrepo["Record repository"]
  node_equityentity["Equity entities<br/>[EquityEntity.java]"]
  node_recordentity["Financial entities"]
end

subgraph group_quant["Quant back-office"]
  node_mlservice["Prediction API<br/>[ml_service.py]"]
  node_features["Technical features<br/>[data_ingestion.py]"]
  node_xgb["Alpha classifier"]
  node_training["Training pipeline<br/>[train_model.py]"]
  node_dataset["Dataset builder<br/>[build_dataset.py]"]
  node_pythonworkers["Quant worker engines"]
  node_terminaltool["Python terminal<br/>[sentix_terminal.py]"]
end

subgraph group_data["Market data"]
  node_fmp["FMP fundamentals"]
end

node_investor(("Analyst"))
node_mysql[("MySQL")]
node_yfinance["yfinance market data"]
node_fmpservice["FMP service"]

node_investor -->|"requests analysis"| node_dashboard
node_dashboard -.->|"requests payload"| node_api
node_api -->|"resolves ticker"| node_equityrepo
node_api -->|"fetches records"| node_records
node_api -->|"fetches missing data"| node_fmp
node_api -->|"requests prediction"| node_mlbridge
node_api -->|"builds valuation"| node_valuation
node_valuation -->|"returns metrics"| node_contracts
node_records -->|"reads and writes"| node_recordrepo
node_equities -->|"queries equities"| node_equityrepo
node_equities -->|"searches ticker"| node_fmp
node_fmp -->|"maps statements"| node_contracts
node_mlbridge -->|"requests prediction"| node_mlservice
node_mlservice -->|"extracts features"| node_features
node_features -->|"downloads prices"| node_yfinance
node_mlservice -.->|"scores with model"| node_xgb
node_training -->|"uses features"| node_features
node_dataset -->|"builds from features"| node_features
node_fmp -->|"requests statements"| node_fmpservice
node_equityrepo -->|"persists entities"| node_equityentity
node_recordrepo -->|"persists records"| node_recordentity
node_equityrepo -.->|"stores equity data"| node_mysql
node_recordrepo -.->|"stores financial data"| node_mysql
node_pythonworkers -->|"includes terminal"| node_terminaltool
node_pythonworkers -.->|"supports DCF and CCA"| node_valuation

click node_dashboard "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/frontend/src/app/quant-dashboard/quant-dashboard.component.ts"
click node_api "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/controller/AnalysisController.java"
click node_valuation "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/ValuationService.java"
click node_records "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/FinancialRecordService.java"
click node_equities "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/EquityService.java"
click node_fmp "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/FmpDataService.java"
click node_mlbridge "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/MlIntegrationService.java"
click node_contracts "https://github.com/tewtiadhruv06/sentix-quant-mesh/tree/main/backend/src/main/java/com/sentix/quant/dto"
click node_equityrepo "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/repository/EquityRepository.java"
click node_recordrepo "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/repository/FinancialRecordRepository.java"
click node_equityentity "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/entity/EquityEntity.java"
click node_recordentity "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/entity/FinancialRecordEntity.java"
click node_mlservice "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/ml_service.py"
click node_features "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/data_ingestion.py"
click node_xgb "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/alpha_classifier.json"
click node_training "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/train_model.py"
click node_dataset "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/build_dataset.py"
click node_pythonworkers "https://github.com/tewtiadhruv06/sentix-quant-mesh/tree/main/python-workers/models"
click node_terminaltool "https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/python-workers/scripts/sentix_terminal.py"

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_dashboard toneBlue
class node_api,node_valuation,node_records,node_equities,node_mlbridge,node_contracts,node_equityrepo,node_recordrepo,node_equityentity,node_recordentity,node_mysql toneAmber
class node_mlservice,node_features,node_xgb,node_training,node_dataset,node_pythonworkers,node_terminaltool toneMint
class node_fmp toneRose
class node_investor,node_yfinance,node_fmpservice toneIndigo
```

## Components

### Analysis terminal

- [Analysis dashboard](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/frontend/src/app/quant-dashboard/quant-dashboard.component.ts): `frontend/src/app/quant-dashboard/quant-dashboard.component.ts`

### Valuation middle-office

- [Analysis API](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/controller/AnalysisController.java): `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`
- [Sector valuation](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/ValuationService.java): `backend/src/main/java/com/sentix/quant/service/ValuationService.java`
- [Financial records](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/FinancialRecordService.java): `backend/src/main/java/com/sentix/quant/service/FinancialRecordService.java`
- [Equity services](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/EquityService.java): `backend/src/main/java/com/sentix/quant/service/EquityService.java`
- [ML integration](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/MlIntegrationService.java): `backend/src/main/java/com/sentix/quant/service/MlIntegrationService.java`
- [Analysis DTOs](https://github.com/tewtiadhruv06/sentix-quant-mesh/tree/main/backend/src/main/java/com/sentix/quant/dto): `backend/src/main/java/com/sentix/quant/dto`
- [Equity repository](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/repository/EquityRepository.java): `backend/src/main/java/com/sentix/quant/repository/EquityRepository.java`
- [Record repository](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/repository/FinancialRecordRepository.java): `backend/src/main/java/com/sentix/quant/repository/FinancialRecordRepository.java`
- [Equity entities](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/entity/EquityEntity.java): `backend/src/main/java/com/sentix/quant/entity/EquityEntity.java`
- [Financial entities](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/entity/FinancialRecordEntity.java): `backend/src/main/java/com/sentix/quant/entity/FinancialRecordEntity.java`

### Quant back-office

- [Prediction API](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/ml_service.py): `sentix_ml_engine/ml_service.py`
- [Technical features](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/data_ingestion.py): `sentix_ml_engine/data_ingestion.py`
- [Alpha classifier](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/alpha_classifier.json): `sentix_ml_engine/alpha_classifier.json`
- [Training pipeline](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/train_model.py): `sentix_ml_engine/train_model.py`
- [Dataset builder](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/sentix_ml_engine/build_dataset.py): `sentix_ml_engine/build_dataset.py`
- [Quant worker engines](https://github.com/tewtiadhruv06/sentix-quant-mesh/tree/main/python-workers/models): `python-workers/models`
- [Python terminal](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/python-workers/scripts/sentix_terminal.py): `python-workers/scripts/sentix_terminal.py`

### Market data

- [FMP fundamentals](https://github.com/tewtiadhruv06/sentix-quant-mesh/blob/main/backend/src/main/java/com/sentix/quant/service/FmpDataService.java): `backend/src/main/java/com/sentix/quant/service/FmpDataService.java`

### Other components

- **Analyst**
- **MySQL**
- **yfinance market data**
- **FMP service**

## Connections

- Analyst → Analysis dashboard: requests analysis (evidence: `README.md`)
- Analysis dashboard → Analysis API: requests payload (evidence: `README.md`)
- Analysis API → Equity repository: resolves ticker (evidence: `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`)
- Analysis API → Financial records: fetches records (evidence: `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`)
- Analysis API → FMP fundamentals: fetches missing data (evidence: `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`)
- Analysis API → ML integration: requests prediction (evidence: `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`)
- Analysis API → Sector valuation: builds valuation (evidence: `backend/src/main/java/com/sentix/quant/controller/AnalysisController.java`)
- Sector valuation → Analysis DTOs: returns metrics (evidence: `backend/src/main/java/com/sentix/quant/service/ValuationService.java`)
- Financial records → Record repository: reads and writes (evidence: `backend/src/main/java/com/sentix/quant/service/FinancialRecordService.java`)
- Equity services → Equity repository: queries equities (evidence: `backend/src/main/java/com/sentix/quant/service/EquityService.java`)
- Equity services → FMP fundamentals: searches ticker (evidence: `backend/src/main/java/com/sentix/quant/service/EquityService.java`)
- FMP fundamentals → Analysis DTOs: maps statements (evidence: `backend/src/main/java/com/sentix/quant/service/FmpDataService.java`)
- ML integration → Prediction API: requests prediction (evidence: `backend/src/main/java/com/sentix/quant/service/MlIntegrationService.java`)
- Prediction API → Technical features: extracts features (evidence: `sentix_ml_engine/ml_service.py`)
- Technical features → yfinance market data: downloads prices (evidence: `sentix_ml_engine/data_ingestion.py`)
- Prediction API → Alpha classifier: scores with model (evidence: `README.md`)
- Training pipeline → Technical features: uses features (evidence: `sentix_ml_engine/train_model.py`)
- Dataset builder → Technical features: builds from features (evidence: `sentix_ml_engine/build_dataset.py`)
- FMP fundamentals → FMP service: requests statements (evidence: `backend/src/main/java/com/sentix/quant/service/FmpDataService.java`)
- Equity repository → Equity entities: persists entities (evidence: `backend/src/main/java/com/sentix/quant/repository/EquityRepository.java`)
- Record repository → Financial entities: persists records (evidence: `backend/src/main/java/com/sentix/quant/repository/FinancialRecordRepository.java`)
- Equity repository → MySQL: stores equity data (evidence: `README.md`)
- Record repository → MySQL: stores financial data (evidence: `README.md`)
- Quant worker engines → Python terminal: includes terminal (evidence: `python-workers/scripts/sentix_terminal.py`)
- Quant worker engines → Sector valuation: supports DCF and CCA (evidence: `README.md`)
