How prabhath1403/cyphersite works
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: pipeline.py Unified Pipeline · source_scan_tasks.py Source Scan Tasks · client.js API Client · App.jsx Console Shell
Components 26
Web Console
- Console Shell
frontend/src/App.jsx - Project Scope
frontend/src/context/ProjectScopeContext.jsx - Crypto Inventory
frontend/src/pages/CryptoInventory.jsx - Topology View
frontend/src/pages/DependencyGraph.jsx - Migration Roadmap
frontend/src/pages/MigrationRoadmap.jsx - Live Monitor
frontend/src/pages/GitLiveMonitor.jsx - API Client
frontend/src/api/client.js
API And Jobs
- FastAPI Service
backend/app/main.py - Scan Tasks
backend/app/tasks/scan_tasks.py - Source Scan Tasks
backend/app/tasks/source_scan_tasks.py
Discovery And Analysis
- Python AST Scanner
backend/app/core/source_scanner/python_scanner.py - Container Scanner
backend/app/core/container_scanner - Binary Scanner
backend/app/core/binary_scanner - Network Discovery
backend/app/core/scanner/discovery.py - Unified Pipeline
backend/app/core/pipeline/pipeline.py - Sensitivity Inference
backend/app/core/sensitivity/inference.py
Risk And Outputs
- PQC Risk Assessment
backend/app/core/pqc/assessor.py - CBOM Builder
backend/app/core/cbom/builder.py - AI Explainer
backend/app/core/ai/explainer.py - GitHub Remediation
backend/app/core/github/issue_creator.py - Topology Engine
backend/app/core/graph/engine.py
Persistence And Integrations
- Neo4j Store
backend/app/core/graph/neo4j_client.py - Application Database
backend/app/database.py - Crypto Asset Records
backend/app/models/crypto_asset.py
Other components
- Operator
- GitHub
Connections 33
- Operator → Console Shell: uses
- Console Shell → Crypto Inventory: routes to
frontend/src/App.jsx - Console Shell → Topology View: routes to
frontend/src/App.jsx - Console Shell → Migration Roadmap: routes to
frontend/src/App.jsx - Console Shell → Live Monitor: routes to
frontend/src/App.jsx - Project Scope → API Client: fetches scans
frontend/src/context/ProjectScopeContext.jsx - Crypto Inventory → API Client: requests inventory
frontend/src/pages/CryptoInventory.jsx - Topology View → API Client: requests graph
frontend/src/pages/DependencyGraph.jsx - Migration Roadmap → API Client: requests data
frontend/src/pages/MigrationRoadmap.jsx - Live Monitor → API Client: requests data
frontend/src/pages/GitLiveMonitor.jsx - API Client → FastAPI Service: calls API
- FastAPI Service → Scan Tasks: registers routes
backend/app/main.py - FastAPI Service → Source Scan Tasks: registers routes
backend/app/main.py - Scan Tasks → Network Discovery: scans network
backend/app/tasks/scan_tasks.py - Scan Tasks → PQC Risk Assessment: assesses risk
backend/app/tasks/scan_tasks.py - Scan Tasks → CBOM Builder: builds CBOM
backend/app/tasks/scan_tasks.py - Source Scan Tasks → Python AST Scanner: scans source
backend/app/tasks/source_scan_tasks.py - Source Scan Tasks → Container Scanner: scans container
backend/app/tasks/source_scan_tasks.py - Source Scan Tasks → Binary Scanner: scans binaries
backend/app/tasks/source_scan_tasks.py - Source Scan Tasks → GitHub: fetches repository
backend/app/tasks/source_scan_tasks.py - Python AST Scanner → Unified Pipeline: normalizes findings
backend/app/core/pipeline/pipeline.py - Container Scanner → Unified Pipeline: normalizes findings
backend/app/core/pipeline/pipeline.py - Binary Scanner → Unified Pipeline: normalizes findings
backend/app/core/pipeline/pipeline.py - Unified Pipeline → Sensitivity Inference: enriches findings
backend/app/core/pipeline/pipeline.py - Unified Pipeline → CBOM Builder: generates CBOM
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
backend/app/core/graph/engine.py - Scan Tasks → Application Database: persists scan
backend/app/tasks/scan_tasks.py - Source Scan Tasks → Crypto Asset Records: creates records
backend/app/tasks/source_scan_tasks.py - Crypto Asset Records → Application Database: maps records
backend/app/models/crypto_asset.py