# saiteja8326/fortix architecture

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

- Interactive diagram: https://gitdiagram.com/saiteja8326/fortix
- Repository: https://github.com/saiteja8326/fortix

## Overview

FortiX combines a UPI fraud-detection API, graph-model development tools, and a Streamlit analyst dashboard. The documented graph workflow models accounts as nodes and transactions as edges, then classifies suspicious nodes and transactions. In the sampled runtime API, clients authenticate, submit transactions, and retrieve risk scores or explanations; however, its predictor is explicitly a random demo rather than the trained GNN. The dashboard and several analysis capabilities are documented or present in the tree, but sampled excerpts do not establish their wiring to the API. The preprocessing and data-loading relationships are likewise not shown.

Main entry points: [`backend/server.py`](https://github.com/saiteja8326/fortix/blob/main/backend/server.py) (HTTP API), [`backend/storage.py`](https://github.com/saiteja8326/fortix/blob/main/backend/storage.py) (Transaction Store), [`frontend/app.py`](https://github.com/saiteja8326/fortix/blob/main/frontend/app.py) (Dashboard App), [`backend/fraud.py`](https://github.com/saiteja8326/fortix/blob/main/backend/fraud.py) (Demo Fraud Scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Fraud API"]
  node_api_server["HTTP API<br/>[server.py]"]
  node_authentication["JWT Authentication<br/>[auth.py]"]
  node_transaction_store[("Transaction Store<br/>[storage.py]")]
  node_demo_scoring["Demo Fraud Scoring<br/>[fraud.py]"]
end

subgraph group_analysis["Graph Analysis"]
  node_synthetic_data["Synthetic Transactions"]
  node_data_loader["Data Loading<br/>[data_loader.py]"]
  node_data_inspection["Data Inspection<br/>[data_inspection.py]"]
  node_preprocessing["Data Preprocessing<br/>[preprocessing.py]"]
  node_feature_engineering["Feature Engineering"]
  node_graph_visualization["User-Centric Graphs<br/>[visualize_graph.py]"]
end

subgraph group_model["GNN Modeling"]
  node_gnn_models["Node and Edge GNNs"]
  node_model_training["Model Training<br/>[train.py]"]
end

subgraph group_dashboard["Analyst Dashboard"]
  node_streamlit_app["Dashboard App<br/>[app.py]"]
  node_dashboard_components["Dashboard Components<br/>[components.py]"]
  node_dashboard_utils["Dashboard Utilities<br/>[utils.py]"]
  node_graph_interactions["Graph Interactions<br/>[utils.js]"]
end

subgraph group_capabilities["Documented Capabilities"]
  node_guardian_mode["Guardian Mode"]
  node_upi_integration["UPI App Integration"]
  node_fraud_tracing["Fraud Tracing"]
end

node_client(("UPI Client"))
node_analyst(("Analyst"))

node_client -->|"submits transactions"| node_api_server
node_api_server -->|"authenticates requests"| node_authentication
node_api_server -->|"stores and retrieves"| node_transaction_store
node_api_server -->|"scores and explains"| node_demo_scoring
node_transaction_store -->|"scores saved transaction"| node_demo_scoring
node_model_training -->|"trains models"| node_gnn_models
node_analyst -.->|"uses dashboard"| node_streamlit_app
node_analyst -.->|"reviews transaction graph"| node_graph_visualization
node_analyst -.->|"uses protection mode"| node_guardian_mode
node_upi_integration -.->|"integrates securely"| node_api_server
node_streamlit_app -.->|"supports investigation"| node_fraud_tracing

click node_api_server "https://github.com/saiteja8326/fortix/blob/main/backend/server.py"
click node_authentication "https://github.com/saiteja8326/fortix/blob/main/backend/auth.py"
click node_transaction_store "https://github.com/saiteja8326/fortix/blob/main/backend/storage.py"
click node_demo_scoring "https://github.com/saiteja8326/fortix/blob/main/backend/fraud.py"
click node_synthetic_data "https://github.com/saiteja8326/fortix/blob/main/feature_extraction.py"
click node_data_loader "https://github.com/saiteja8326/fortix/blob/main/data_loader.py"
click node_data_inspection "https://github.com/saiteja8326/fortix/blob/main/data_inspection.py"
click node_preprocessing "https://github.com/saiteja8326/fortix/blob/main/preprocessing.py"
click node_feature_engineering "https://github.com/saiteja8326/fortix/blob/main/feature_extraction.py"
click node_gnn_models "https://github.com/saiteja8326/fortix/blob/main/models/gnn_fraud_detection.py"
click node_model_training "https://github.com/saiteja8326/fortix/blob/main/train.py"
click node_graph_visualization "https://github.com/saiteja8326/fortix/blob/main/visualize_graph.py"
click node_streamlit_app "https://github.com/saiteja8326/fortix/blob/main/frontend/app.py"
click node_dashboard_components "https://github.com/saiteja8326/fortix/blob/main/frontend/components.py"
click node_dashboard_utils "https://github.com/saiteja8326/fortix/blob/main/frontend/utils.py"
click node_graph_interactions "https://github.com/saiteja8326/fortix/blob/main/lib/bindings/utils.js"
click node_guardian_mode "https://github.com/saiteja8326/fortix/tree/main/frontend"
click node_upi_integration "https://github.com/saiteja8326/fortix/tree/main/backend"
click node_fraud_tracing "https://github.com/saiteja8326/fortix/tree/main/frontend"

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_api_server,node_authentication,node_transaction_store,node_demo_scoring,node_client toneBlue
class node_synthetic_data,node_data_loader,node_data_inspection,node_preprocessing,node_feature_engineering,node_graph_visualization toneAmber
class node_gnn_models,node_model_training toneMint
class node_streamlit_app,node_dashboard_components,node_dashboard_utils,node_graph_interactions toneRose
class node_guardian_mode,node_upi_integration,node_fraud_tracing,node_analyst toneIndigo
```

## Components

### Fraud API

- [HTTP API](https://github.com/saiteja8326/fortix/blob/main/backend/server.py): `backend/server.py`
- [JWT Authentication](https://github.com/saiteja8326/fortix/blob/main/backend/auth.py): `backend/auth.py`
- [Transaction Store](https://github.com/saiteja8326/fortix/blob/main/backend/storage.py): `backend/storage.py`
- [Demo Fraud Scoring](https://github.com/saiteja8326/fortix/blob/main/backend/fraud.py): `backend/fraud.py`

### Graph Analysis

- [Synthetic Transactions](https://github.com/saiteja8326/fortix/blob/main/feature_extraction.py): `feature_extraction.py`
- [Data Loading](https://github.com/saiteja8326/fortix/blob/main/data_loader.py): `data_loader.py`
- [Data Inspection](https://github.com/saiteja8326/fortix/blob/main/data_inspection.py): `data_inspection.py`
- [Data Preprocessing](https://github.com/saiteja8326/fortix/blob/main/preprocessing.py): `preprocessing.py`
- [Feature Engineering](https://github.com/saiteja8326/fortix/blob/main/feature_extraction.py): `feature_extraction.py`
- [User-Centric Graphs](https://github.com/saiteja8326/fortix/blob/main/visualize_graph.py): `visualize_graph.py`

### GNN Modeling

- [Node and Edge GNNs](https://github.com/saiteja8326/fortix/blob/main/models/gnn_fraud_detection.py): `models/gnn_fraud_detection.py`
- [Model Training](https://github.com/saiteja8326/fortix/blob/main/train.py): `train.py`

### Analyst Dashboard

- [Dashboard App](https://github.com/saiteja8326/fortix/blob/main/frontend/app.py): `frontend/app.py`
- [Dashboard Components](https://github.com/saiteja8326/fortix/blob/main/frontend/components.py): `frontend/components.py`
- [Dashboard Utilities](https://github.com/saiteja8326/fortix/blob/main/frontend/utils.py): `frontend/utils.py`
- [Graph Interactions](https://github.com/saiteja8326/fortix/blob/main/lib/bindings/utils.js): `lib/bindings/utils.js`

### Documented Capabilities

- [Guardian Mode](https://github.com/saiteja8326/fortix/tree/main/frontend): `frontend`
- [UPI App Integration](https://github.com/saiteja8326/fortix/tree/main/backend): `backend`
- [Fraud Tracing](https://github.com/saiteja8326/fortix/tree/main/frontend): `frontend`

### Other components

- **UPI Client**
- **Analyst**

## Connections

- UPI Client → HTTP API: submits transactions (evidence: `backend/server.py`)
- HTTP API → JWT Authentication: authenticates requests (evidence: `backend/server.py`)
- HTTP API → Transaction Store: stores and retrieves (evidence: `backend/server.py`)
- HTTP API → Demo Fraud Scoring: scores and explains (evidence: `backend/server.py`)
- Transaction Store → Demo Fraud Scoring: scores saved transaction (evidence: `backend/storage.py`)
- Model Training → Node and Edge GNNs: trains models (evidence: `train.py`)
- Analyst → Dashboard App: uses dashboard (evidence: `README.md`)
- Analyst → User-Centric Graphs: reviews transaction graph (evidence: `README.md`)
- Analyst → Guardian Mode: uses protection mode (evidence: `README.md`)
- UPI App Integration → HTTP API: integrates securely (evidence: `README.md`)
- Dashboard App → Fraud Tracing: supports investigation (evidence: `README.md`)
