# prabhath1403/cyphersite architecture

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

- Interactive diagram: https://gitdiagram.com/prabhath1403/cyphersite
- Repository: https://github.com/prabhath1403/cyphersite

## Overview

CipherSight discovers cryptographic assets across network, source, container, and binary targets, then normalizes findings, assesses post-quantum exposure, and exposes inventory, CBOMs, topology, and remediation through a web console. Users initiate scans and inspect results; background tasks own scan execution and persistence. The README documents several capabilities whose internal wiring was not sampled, so those relationships are cited to the README rather than inferred from module names. Other unsampled router details are represented only where app registration is visible.

Main entry points: [`backend/app/core/pipeline/pipeline.py`](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/pipeline/pipeline.py) (Unified Pipeline), [`backend/app/tasks/source_scan_tasks.py`](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/tasks/source_scan_tasks.py) (Source Scan Tasks), [`frontend/src/api/client.js`](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/api/client.js) (API Client), [`frontend/src/App.jsx`](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/App.jsx) (Console Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web Console"]
  node_app_ui["Console Shell<br/>[App.jsx]"]
  node_project_scope["Project Scope"]
  node_inventory_ui["Crypto Inventory"]
  node_graph_ui["Topology View"]
  node_roadmap_ui["Migration Roadmap"]
  node_git_ui["Live Monitor<br/>[GitLiveMonitor.jsx]"]
  node_api_client["API Client<br/>[client.js]"]
end

subgraph group_api["API And Jobs"]
  node_service["FastAPI Service<br/>[main.py]"]
  node_scan_jobs["Scan Tasks<br/>[scan_tasks.py]"]
  node_source_jobs["Source Scan Tasks"]
end

subgraph group_discovery["Discovery And Analysis"]
  node_source_scanner["Python AST Scanner<br/>[python_scanner.py]"]
  node_container_scanner["Container Scanner"]
  node_binary_scanner["Binary Scanner"]
  node_network_discovery["Network Discovery<br/>[discovery.py]"]
  node_pipeline["Unified Pipeline<br/>[pipeline.py]"]
  node_sensitivity["Sensitivity Inference<br/>[inference.py]"]
end

subgraph group_intelligence["Risk And Outputs"]
  node_risk["PQC Risk Assessment<br/>[assessor.py]"]
  node_cbom["CBOM Builder<br/>[builder.py]"]
  node_ai["AI Explainer<br/>[explainer.py]"]
  node_remediation["GitHub Remediation<br/>[issue_creator.py]"]
  node_graph_engine["Topology Engine<br/>[engine.py]"]
end

subgraph group_state["Persistence And Integrations"]
  node_neo4j[("Neo4j Store<br/>[neo4j_client.py]")]
  node_database[("Application Database<br/>[database.py]")]
  node_crypto_assets["Crypto Asset Records<br/>[crypto_asset.py]"]
end

node_operator(("Operator"))
node_github["GitHub"]

node_operator -->|"uses"| node_app_ui
node_app_ui -->|"routes to"| node_inventory_ui
node_app_ui -->|"routes to"| node_graph_ui
node_app_ui -->|"routes to"| node_roadmap_ui
node_app_ui -->|"routes to"| node_git_ui
node_project_scope -->|"fetches scans"| node_api_client
node_inventory_ui -->|"requests inventory"| node_api_client
node_graph_ui -->|"requests graph"| node_api_client
node_roadmap_ui -->|"requests data"| node_api_client
node_git_ui -->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_service
node_service -->|"registers routes"| node_scan_jobs
node_service -->|"registers routes"| node_source_jobs
node_scan_jobs -->|"scans network"| node_network_discovery
node_scan_jobs -->|"assesses risk"| node_risk
node_scan_jobs -->|"builds CBOM"| node_cbom
node_source_jobs -->|"scans source"| node_source_scanner
node_source_jobs -->|"scans container"| node_container_scanner
node_source_jobs -->|"scans binaries"| node_binary_scanner
node_source_jobs -->|"fetches repository"| node_github
node_source_scanner -->|"normalizes findings"| node_pipeline
node_container_scanner -->|"normalizes findings"| node_pipeline
node_binary_scanner -->|"normalizes findings"| node_pipeline
node_pipeline -->|"enriches findings"| node_sensitivity
node_pipeline -->|"generates CBOM"| node_cbom
node_pipeline -.->|"evaluates readiness"| node_risk
node_risk -->|"prioritizes fixes"| node_remediation
node_risk -->|"explains exposure"| node_ai
node_pipeline -->|"constructs topology"| node_graph_engine
node_graph_engine -->|"queries graph"| node_neo4j
node_scan_jobs -->|"persists scan"| node_database
node_source_jobs -->|"creates records"| node_crypto_assets
node_crypto_assets -->|"maps records"| node_database

click node_app_ui "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/App.jsx"
click node_project_scope "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/context/ProjectScopeContext.jsx"
click node_inventory_ui "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/CryptoInventory.jsx"
click node_graph_ui "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/DependencyGraph.jsx"
click node_roadmap_ui "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/MigrationRoadmap.jsx"
click node_git_ui "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/GitLiveMonitor.jsx"
click node_api_client "https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/api/client.js"
click node_service "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/main.py"
click node_scan_jobs "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/tasks/scan_tasks.py"
click node_source_jobs "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/tasks/source_scan_tasks.py"
click node_source_scanner "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/source_scanner/python_scanner.py"
click node_container_scanner "https://github.com/prabhath1403/cyphersite/tree/main/backend/app/core/container_scanner"
click node_binary_scanner "https://github.com/prabhath1403/cyphersite/tree/main/backend/app/core/binary_scanner"
click node_network_discovery "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/scanner/discovery.py"
click node_pipeline "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/pipeline/pipeline.py"
click node_sensitivity "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/sensitivity/inference.py"
click node_risk "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/pqc/assessor.py"
click node_cbom "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/cbom/builder.py"
click node_ai "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/ai/explainer.py"
click node_remediation "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/github/issue_creator.py"
click node_graph_engine "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/graph/engine.py"
click node_neo4j "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/graph/neo4j_client.py"
click node_database "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/database.py"
click node_crypto_assets "https://github.com/prabhath1403/cyphersite/blob/main/backend/app/models/crypto_asset.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_ui,node_project_scope,node_inventory_ui,node_graph_ui,node_roadmap_ui,node_git_ui,node_api_client toneBlue
class node_service,node_scan_jobs,node_source_jobs toneAmber
class node_source_scanner,node_container_scanner,node_binary_scanner,node_network_discovery,node_pipeline,node_sensitivity toneMint
class node_risk,node_cbom,node_ai,node_remediation,node_graph_engine toneRose
class node_neo4j,node_database,node_crypto_assets,node_operator,node_github toneIndigo
```

## Components

### Web Console

- [Console Shell](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Project Scope](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/context/ProjectScopeContext.jsx): `frontend/src/context/ProjectScopeContext.jsx`
- [Crypto Inventory](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/CryptoInventory.jsx): `frontend/src/pages/CryptoInventory.jsx`
- [Topology View](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/DependencyGraph.jsx): `frontend/src/pages/DependencyGraph.jsx`
- [Migration Roadmap](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/MigrationRoadmap.jsx): `frontend/src/pages/MigrationRoadmap.jsx`
- [Live Monitor](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/pages/GitLiveMonitor.jsx): `frontend/src/pages/GitLiveMonitor.jsx`
- [API Client](https://github.com/prabhath1403/cyphersite/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### API And Jobs

- [FastAPI Service](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/main.py): `backend/app/main.py`
- [Scan Tasks](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/tasks/scan_tasks.py): `backend/app/tasks/scan_tasks.py`
- [Source Scan Tasks](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/tasks/source_scan_tasks.py): `backend/app/tasks/source_scan_tasks.py`

### Discovery And Analysis

- [Python AST Scanner](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/source_scanner/python_scanner.py): `backend/app/core/source_scanner/python_scanner.py`
- [Container Scanner](https://github.com/prabhath1403/cyphersite/tree/main/backend/app/core/container_scanner): `backend/app/core/container_scanner`
- [Binary Scanner](https://github.com/prabhath1403/cyphersite/tree/main/backend/app/core/binary_scanner): `backend/app/core/binary_scanner`
- [Network Discovery](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/scanner/discovery.py): `backend/app/core/scanner/discovery.py`
- [Unified Pipeline](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/pipeline/pipeline.py): `backend/app/core/pipeline/pipeline.py`
- [Sensitivity Inference](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/sensitivity/inference.py): `backend/app/core/sensitivity/inference.py`

### Risk And Outputs

- [PQC Risk Assessment](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/pqc/assessor.py): `backend/app/core/pqc/assessor.py`
- [CBOM Builder](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/cbom/builder.py): `backend/app/core/cbom/builder.py`
- [AI Explainer](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/ai/explainer.py): `backend/app/core/ai/explainer.py`
- [GitHub Remediation](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/github/issue_creator.py): `backend/app/core/github/issue_creator.py`
- [Topology Engine](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/graph/engine.py): `backend/app/core/graph/engine.py`

### Persistence And Integrations

- [Neo4j Store](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/core/graph/neo4j_client.py): `backend/app/core/graph/neo4j_client.py`
- [Application Database](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/database.py): `backend/app/database.py`
- [Crypto Asset Records](https://github.com/prabhath1403/cyphersite/blob/main/backend/app/models/crypto_asset.py): `backend/app/models/crypto_asset.py`

### Other components

- **Operator**
- **GitHub**

## Connections

- Operator → Console Shell: uses
- Console Shell → Crypto Inventory: routes to (evidence: `frontend/src/App.jsx`)
- Console Shell → Topology View: routes to (evidence: `frontend/src/App.jsx`)
- Console Shell → Migration Roadmap: routes to (evidence: `frontend/src/App.jsx`)
- Console Shell → Live Monitor: routes to (evidence: `frontend/src/App.jsx`)
- Project Scope → API Client: fetches scans (evidence: `frontend/src/context/ProjectScopeContext.jsx`)
- Crypto Inventory → API Client: requests inventory (evidence: `frontend/src/pages/CryptoInventory.jsx`)
- Topology View → API Client: requests graph (evidence: `frontend/src/pages/DependencyGraph.jsx`)
- Migration Roadmap → API Client: requests data (evidence: `frontend/src/pages/MigrationRoadmap.jsx`)
- Live Monitor → API Client: requests data (evidence: `frontend/src/pages/GitLiveMonitor.jsx`)
- API Client → FastAPI Service: calls API
- FastAPI Service → Scan Tasks: registers routes (evidence: `backend/app/main.py`)
- FastAPI Service → Source Scan Tasks: registers routes (evidence: `backend/app/main.py`)
- Scan Tasks → Network Discovery: scans network (evidence: `backend/app/tasks/scan_tasks.py`)
- Scan Tasks → PQC Risk Assessment: assesses risk (evidence: `backend/app/tasks/scan_tasks.py`)
- Scan Tasks → CBOM Builder: builds CBOM (evidence: `backend/app/tasks/scan_tasks.py`)
- Source Scan Tasks → Python AST Scanner: scans source (evidence: `backend/app/tasks/source_scan_tasks.py`)
- Source Scan Tasks → Container Scanner: scans container (evidence: `backend/app/tasks/source_scan_tasks.py`)
- Source Scan Tasks → Binary Scanner: scans binaries (evidence: `backend/app/tasks/source_scan_tasks.py`)
- Source Scan Tasks → GitHub: fetches repository (evidence: `backend/app/tasks/source_scan_tasks.py`)
- Python AST Scanner → Unified Pipeline: normalizes findings (evidence: `backend/app/core/pipeline/pipeline.py`)
- Container Scanner → Unified Pipeline: normalizes findings (evidence: `backend/app/core/pipeline/pipeline.py`)
- Binary Scanner → Unified Pipeline: normalizes findings (evidence: `backend/app/core/pipeline/pipeline.py`)
- Unified Pipeline → Sensitivity Inference: enriches findings (evidence: `backend/app/core/pipeline/pipeline.py`)
- Unified Pipeline → CBOM Builder: generates CBOM (evidence: `backend/app/core/pipeline/pipeline.py`)
- Unified Pipeline → PQC Risk Assessment: evaluates readiness
- PQC Risk Assessment → GitHub Remediation: prioritizes fixes
- PQC Risk Assessment → AI Explainer: explains exposure
- Unified Pipeline → Topology Engine: constructs topology
- Topology Engine → Neo4j Store: queries graph (evidence: `backend/app/core/graph/engine.py`)
- Scan Tasks → Application Database: persists scan (evidence: `backend/app/tasks/scan_tasks.py`)
- Source Scan Tasks → Crypto Asset Records: creates records (evidence: `backend/app/tasks/source_scan_tasks.py`)
- Crypto Asset Records → Application Database: maps records (evidence: `backend/app/models/crypto_asset.py`)
