# dhreety613/rishmatrix architecture

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

- Interactive diagram: https://gitdiagram.com/dhreety613/rishmatrix
- Repository: https://github.com/dhreety613/rishmatrix

## Overview

RiskMatrix takes a company ticker through risk extraction, scoring, and treatment classification, then supports Monte Carlo loss simulation. The React app provides signup/signin and processing screens; Flask exposes authentication and a ticker-processing route, while a separate API module serves risk data and simulation. The README describes the intended end-to-end flow, but the sampled code shows mismatched API routes and module paths, so those runtime connections are not assumed to work as written.

Main entry points: [`montecarlo/main_api.py`](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/main_api.py) (Auth and pipeline API), [`frontend/src/App.jsx`](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/App.jsx) (Page router), [`frontend/src/pages/SignIn.jsx`](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/SignIn.jsx) (Sign in), [`montecarlo/api.py`](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/api.py) (Risk data API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React frontend"]
  node_app["Page router<br/>[App.jsx]"]
  node_signup["Sign up<br/>[SignUp.jsx]"]
  node_signin["Sign in<br/>[SignIn.jsx]"]
  node_loading["Ticker processing<br/>[Loading.jsx]"]
  node_simulator_ui["Risk simulator UI<br/>[Simulator.jsx]"]
end

subgraph group_service["Flask services"]
  node_auth_api["Auth and pipeline API<br/>[main_api.py]"]
  node_users[("User records<br/>[main_api.py]")]
  node_risk_api["Risk data API<br/>[api.py]"]
end

subgraph group_risk["Risk analysis"]
  node_extract["Risk extraction<br/>[final.py]"]
  node_score["Risk scoring"]
  node_classify["3T classification"]
  node_risk_files[("Risk data files")]
end

subgraph group_simulation["Simulation"]
  node_simulator["Monte Carlo engine<br/>[simulator.py]"]
  node_reports[("Simulation risk CSV")]
end

node_user(("User"))
node_sec["SEC EDGAR"]
node_gemini["Gemini model"]

node_user -->|"registers"| node_signup
node_user -->|"signs in"| node_signin
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_signin
node_app -->|"routes to"| node_loading
node_app -->|"routes to"| node_simulator_ui
node_signup -->|"posts signup"| node_auth_api
node_signin -->|"posts signin"| node_auth_api
node_auth_api -->|"reads and writes"| node_users
node_signin -->|"navigates to"| node_loading
node_loading -->|"posts ticker"| node_auth_api
node_auth_api -->|"calls extraction"| node_extract
node_extract -->|"downloads filings"| node_sec
node_auth_api -->|"calls scoring"| node_score
node_auth_api -->|"calls preparation"| node_classify
node_extract -->|"saves risks"| node_risk_files
node_score -->|"reads and saves"| node_risk_files
node_score -->|"scores with"| node_gemini
node_classify -->|"reads matrix"| node_risk_files
node_classify -->|"writes report CSV"| node_reports
node_simulator_ui -->|"requests risks"| node_risk_api
node_simulator_ui -->|"posts simulation"| node_risk_api
node_risk_api -->|"reads CSV"| node_reports
node_risk_api -->|"calls simulation"| node_simulator
node_auth_api -->|"calls simulation"| node_simulator

click node_app "https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/App.jsx"
click node_signup "https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/SignUp.jsx"
click node_signin "https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/SignIn.jsx"
click node_loading "https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/Loading.jsx"
click node_simulator_ui "https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/Simulator.jsx"
click node_auth_api "https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/main_api.py"
click node_users "https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/main_api.py"
click node_risk_api "https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/api.py"
click node_extract "https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/final.py"
click node_score "https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/risk_matrix_generator.py"
click node_classify "https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/prepare_3T_from_ticker.py"
click node_simulator "https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/simulator.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_app,node_signup,node_signin,node_loading,node_simulator_ui,node_user toneBlue
class node_auth_api,node_users,node_risk_api toneAmber
class node_extract,node_score,node_classify,node_risk_files toneMint
class node_simulator,node_reports toneRose
class node_sec,node_gemini toneIndigo
```

## Components

### React frontend

- [Page router](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign up](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/SignUp.jsx): `frontend/src/pages/SignUp.jsx`
- [Sign in](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/SignIn.jsx): `frontend/src/pages/SignIn.jsx`
- [Ticker processing](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/Loading.jsx): `frontend/src/pages/Loading.jsx`
- [Risk simulator UI](https://github.com/dhreety613/rishmatrix/blob/main/frontend/src/pages/Simulator.jsx): `frontend/src/pages/Simulator.jsx`

### Flask services

- [Auth and pipeline API](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/main_api.py): `montecarlo/main_api.py`
- [User records](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/main_api.py): `montecarlo/main_api.py`
- [Risk data API](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/api.py): `montecarlo/api.py`

### Risk analysis

- [Risk extraction](https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/final.py): `risk-extraction/final.py`
- [Risk scoring](https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/risk_matrix_generator.py): `risk-extraction/risk_matrix_generator.py`
- [3T classification](https://github.com/dhreety613/rishmatrix/blob/main/risk-extraction/prepare_3T_from_ticker.py): `risk-extraction/prepare_3T_from_ticker.py`
- **Risk data files**

### Simulation

- [Monte Carlo engine](https://github.com/dhreety613/rishmatrix/blob/main/montecarlo/simulator.py): `montecarlo/simulator.py`
- **Simulation risk CSV**

### Other components

- **User**
- **SEC EDGAR**
- **Gemini model**

## Connections

- User → Sign up: registers (evidence: `frontend/src/pages/SignUp.jsx`)
- User → Sign in: signs in (evidence: `frontend/src/pages/SignIn.jsx`)
- Page router → Sign up: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Sign in: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Ticker processing: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Risk simulator UI: routes to (evidence: `frontend/src/App.jsx`)
- Sign up → Auth and pipeline API: posts signup (evidence: `frontend/src/pages/SignUp.jsx`)
- Sign in → Auth and pipeline API: posts signin (evidence: `frontend/src/pages/SignIn.jsx`)
- Auth and pipeline API → User records: reads and writes (evidence: `montecarlo/main_api.py`)
- Sign in → Ticker processing: navigates to (evidence: `frontend/src/pages/SignIn.jsx`)
- Ticker processing → Auth and pipeline API: posts ticker (evidence: `frontend/src/pages/Loading.jsx`)
- Auth and pipeline API → Risk extraction: calls extraction (evidence: `montecarlo/main_api.py`)
- Risk extraction → SEC EDGAR: downloads filings (evidence: `README.md`)
- Auth and pipeline API → Risk scoring: calls scoring (evidence: `montecarlo/main_api.py`)
- Auth and pipeline API → 3T classification: calls preparation (evidence: `montecarlo/main_api.py`)
- Risk extraction → Risk data files: saves risks (evidence: `README.md`)
- Risk scoring → Risk data files: reads and saves (evidence: `risk-extraction/risk_matrix_generator.py`)
- Risk scoring → Gemini model: scores with (evidence: `risk-extraction/risk_matrix_generator.py`)
- 3T classification → Risk data files: reads matrix (evidence: `risk-extraction/prepare_3T_from_ticker.py`)
- 3T classification → Simulation risk CSV: writes report CSV (evidence: `risk-extraction/prepare_3T_from_ticker.py`)
- Risk simulator UI → Risk data API: requests risks (evidence: `frontend/src/pages/Simulator.jsx`)
- Risk simulator UI → Risk data API: posts simulation (evidence: `frontend/src/pages/Simulator.jsx`)
- Risk data API → Simulation risk CSV: reads CSV (evidence: `montecarlo/api.py`)
- Risk data API → Monte Carlo engine: calls simulation (evidence: `montecarlo/api.py`)
- Auth and pipeline API → Monte Carlo engine: calls simulation (evidence: `montecarlo/main_api.py`)
