# lohit30/tor-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/lohit30/tor-analysis
- Repository: https://github.com/lohit30/tor-analysis

## Overview

Tor-Trace is a forensic web application for ingesting PCAP or demo traffic, correlating packet patterns with Tor relay data, and presenting case results and reports. Analysts use the frontend to manage sessions and nodes, run analysis, inspect timelines and probable circuits, and generate reports. The backend routers own requests and persistence; analysis invokes the correlation engine, while session ingestion invokes PCAP parsing or demo generation. The README is empty, so capabilities are inferred from the source index and excerpts; unsampled router/service internals are represented conservatively.

Main entry points: [`Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/App.jsx) (Web app), [`Tor-Tracezip/Tor-Trace/backend/main.py`](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/main.py) (API application), [`Tor-Tracezip/Tor-Trace/frontend/src/services/api.js`](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/services/api.js) (API client), [`Tor-Tracezip/Tor-Trace/backend/database.py`](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/database.py) (Database access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Analyst interface"]
  node_webapp["Web app<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_nodeview["Relay nodes<br/>[Nodes.jsx]"]
  node_timeline["Packet timeline<br/>[Timeline.jsx]"]
  node_analysisview["Analysis view<br/>[Analysis.jsx]"]
  node_reportsview["Reports view<br/>[Reports.jsx]"]
  node_table["Data table<br/>[DataTable.jsx]"]
  node_analysisviz["Analysis visuals<br/>[NetworkGraph.jsx]"]
  node_confidence["Confidence gauge"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_backend["API application<br/>[main.py]"]
  node_sessions["Session routes<br/>[sessions.py]"]
  node_nodes["Node routes<br/>[nodes.py]"]
  node_analysis_routes["Analysis routes<br/>[analysis.py]"]
  node_reports["Report routes<br/>[reports.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
end

subgraph group_analysis["Forensic processing"]
  node_pcap["PCAP parser<br/>[pcap_analyzer.py]"]
  node_simulator["Traffic simulator<br/>[tor_simulator.py]"]
  node_correlation["Correlation engine"]
  node_reportgen["Report generator"]
end

subgraph group_state["Case records"]
  node_dbaccess["Database access<br/>[database.py]"]
  node_sqlite[("Forensics database<br/>[forensics.db]")]
end

node_analyst(("Analyst"))

node_analyst -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_nodeview
node_webapp -->|"routes to"| node_timeline
node_webapp -->|"routes to"| node_analysisview
node_webapp -->|"routes to"| node_reportsview
node_dashboard -->|"requests data"| node_api_client
node_nodeview -->|"requests nodes"| node_api_client
node_timeline -->|"requests packets"| node_api_client
node_analysisview -->|"submits analysis"| node_api_client
node_reportsview -->|"requests reports"| node_api_client
node_nodeview -->|"renders"| node_table
node_timeline -->|"renders"| node_table
node_reportsview -->|"renders"| node_table
node_analysisview -->|"renders circuit"| node_analysisviz
node_analysisview -->|"renders score"| node_confidence
node_api_client -->|"calls API"| node_backend
node_backend -->|"registers routes"| node_sessions
node_backend -->|"registers routes"| node_nodes
node_backend -->|"registers routes"| node_analysis_routes
node_backend -->|"registers routes"| node_reports
node_sessions -->|"generates demo"| node_simulator
node_sessions -->|"parses upload"| node_pcap
node_sessions -->|"stores sessions"| node_dbaccess
node_nodes -->|"reads and writes"| node_dbaccess
node_analysis_routes -->|"runs scoring"| node_correlation
node_analysis_routes -->|"loads and saves"| node_dbaccess
node_reports -->|"generates report"| node_reportgen
node_reports -->|"reads and writes"| node_dbaccess
node_backend -->|"initializes store"| node_dbaccess
node_dbaccess -->|"connects to"| node_sqlite
node_sessions -.->|"uses data models"| node_schemas
node_analysis_routes -->|"validates requests"| node_schemas

click node_webapp "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/App.jsx"
click node_dashboard "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx"
click node_nodeview "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx"
click node_timeline "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx"
click node_analysisview "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx"
click node_reportsview "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx"
click node_table "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/DataTable.jsx"
click node_analysisviz "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/NetworkGraph.jsx"
click node_confidence "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/ConfidenceGauge.jsx"
click node_api_client "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/services/api.js"
click node_backend "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/main.py"
click node_sessions "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/sessions.py"
click node_nodes "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/nodes.py"
click node_analysis_routes "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/analysis.py"
click node_reports "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/reports.py"
click node_pcap "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/pcap_analyzer.py"
click node_simulator "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/tor_simulator.py"
click node_correlation "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/correlation_engine.py"
click node_reportgen "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/report_generator.py"
click node_schemas "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/models/schemas.py"
click node_dbaccess "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/database.py"
click node_sqlite "https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/forensics.db"

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_webapp,node_dashboard,node_nodeview,node_timeline,node_analysisview,node_reportsview,node_table,node_analysisviz,node_confidence,node_api_client toneBlue
class node_backend,node_sessions,node_nodes,node_analysis_routes,node_reports,node_schemas toneAmber
class node_pcap,node_simulator,node_correlation,node_reportgen toneMint
class node_dbaccess,node_sqlite toneRose
class node_analyst toneIndigo
```

## Components

### Analyst interface

- [Web app](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/App.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`
- [Dashboard](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx`
- [Relay nodes](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx`
- [Packet timeline](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx`
- [Analysis view](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx`
- [Reports view](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx`
- [Data table](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/DataTable.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/components/DataTable.jsx`
- [Analysis visuals](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/NetworkGraph.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/components/NetworkGraph.jsx`
- [Confidence gauge](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/components/ConfidenceGauge.jsx): `Tor-Tracezip/Tor-Trace/frontend/src/components/ConfidenceGauge.jsx`
- [API client](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/frontend/src/services/api.js): `Tor-Tracezip/Tor-Trace/frontend/src/services/api.js`

### Backend API

- [API application](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/main.py): `Tor-Tracezip/Tor-Trace/backend/main.py`
- [Session routes](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/sessions.py): `Tor-Tracezip/Tor-Trace/backend/routers/sessions.py`
- [Node routes](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/nodes.py): `Tor-Tracezip/Tor-Trace/backend/routers/nodes.py`
- [Analysis routes](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/analysis.py): `Tor-Tracezip/Tor-Trace/backend/routers/analysis.py`
- [Report routes](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/routers/reports.py): `Tor-Tracezip/Tor-Trace/backend/routers/reports.py`
- [API schemas](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/models/schemas.py): `Tor-Tracezip/Tor-Trace/backend/models/schemas.py`

### Forensic processing

- [PCAP parser](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/pcap_analyzer.py): `Tor-Tracezip/Tor-Trace/backend/services/pcap_analyzer.py`
- [Traffic simulator](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/tor_simulator.py): `Tor-Tracezip/Tor-Trace/backend/services/tor_simulator.py`
- [Correlation engine](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/correlation_engine.py): `Tor-Tracezip/Tor-Trace/backend/services/correlation_engine.py`
- [Report generator](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/services/report_generator.py): `Tor-Tracezip/Tor-Trace/backend/services/report_generator.py`

### Case records

- [Database access](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/backend/database.py): `Tor-Tracezip/Tor-Trace/backend/database.py`
- [Forensics database](https://github.com/lohit30/tor-analysis/blob/main/Tor-Tracezip/Tor-Trace/forensics.db): `Tor-Tracezip/Tor-Trace/forensics.db`

### Other components

- **Analyst**

## Connections

- Analyst → Web app: uses (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Web app → Dashboard: routes to (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Web app → Relay nodes: routes to (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Web app → Packet timeline: routes to (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Web app → Analysis view: routes to (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Web app → Reports view: routes to (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/App.jsx`)
- Dashboard → API client: requests data (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx`)
- Relay nodes → API client: requests nodes (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx`)
- Packet timeline → API client: requests packets (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx`)
- Analysis view → API client: submits analysis (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx`)
- Reports view → API client: requests reports (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx`)
- Relay nodes → Data table: renders (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx`)
- Packet timeline → Data table: renders (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx`)
- Reports view → Data table: renders (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx`)
- Analysis view → Analysis visuals: renders circuit (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx`)
- Analysis view → Confidence gauge: renders score (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx`)
- API client → API application: calls API (evidence: `Tor-Tracezip/Tor-Trace/frontend/src/services/api.js`)
- API application → Session routes: registers routes (evidence: `Tor-Tracezip/Tor-Trace/backend/main.py`)
- API application → Node routes: registers routes (evidence: `Tor-Tracezip/Tor-Trace/backend/main.py`)
- API application → Analysis routes: registers routes (evidence: `Tor-Tracezip/Tor-Trace/backend/main.py`)
- API application → Report routes: registers routes (evidence: `Tor-Tracezip/Tor-Trace/backend/main.py`)
- Session routes → Traffic simulator: generates demo (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/sessions.py`)
- Session routes → PCAP parser: parses upload (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/sessions.py`)
- Session routes → Database access: stores sessions (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/sessions.py`)
- Node routes → Database access: reads and writes (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/nodes.py`)
- Analysis routes → Correlation engine: runs scoring (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/analysis.py`)
- Analysis routes → Database access: loads and saves (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/analysis.py`)
- Report routes → Report generator: generates report (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/reports.py`)
- Report routes → Database access: reads and writes (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/reports.py`)
- API application → Database access: initializes store (evidence: `Tor-Tracezip/Tor-Trace/backend/main.py`)
- Database access → Forensics database: connects to (evidence: `Tor-Tracezip/Tor-Trace/backend/database.py`)
- Session routes → API schemas: uses data models
- Analysis routes → API schemas: validates requests (evidence: `Tor-Tracezip/Tor-Trace/backend/routers/analysis.py`)
