How shlok926/quantum-flow-pqc-platform works
Quantum Flow is a PQC discovery and risk-assessment platform: users register targets or submit source material, run staged assessments, review a cryptographic inventory and QVI risk, and export reports. The map preserves both enterprise-console and public-scanner capabilities, plus the API, worker, collectors, correlation, scoring, and persistence layers. Edges use the excerpts, SOURCE INDEX references, or README; unsampled endpoint internals are represented only where documented.
Main entry points: assessment_service.py Assessment orchestration · App.tsx Enterprise console · api.ts Web API client · job_service.py Job coordination
Components 27
User interfaces
- Enterprise console
apps/web/src/app/App.tsx - Target management
apps/web/src/features/targets/TargetManagement.tsx - Source upload
apps/web/src/features/discovery/SourceUpload.tsx - Assessment review
apps/web/src/features/assessments/AssessmentDetail.tsx - Public scanner
apps/web/src/features/public/ScannerPage.tsx - Public scan results
apps/web/src/features/public/ScanResultsPage.tsx
API and orchestration
- Web API client
apps/web/src/services/api.ts - FastAPI application
services/api/app/main.py - API v1 routes
services/api/app/api/v1/router.py - Domain endpoints
services/api/app/api/v1/endpoints - Assessment orchestration
services/api/app/services/assessment_service.py - Job coordination
services/api/app/services/job_service.py - Background worker
services/worker/app/worker.py
Discovery and analysis
- Discovery collectors
packages/scanner - Process containment
packages/scanner/safety/containment.py - Source findings
packages/scanner/source/models.py - CBOM correlation
packages/cbom/correlator.py - QVI risk engine
packages/risk/engine.py - Report export
packages/reports/exporter.py
Assessment records
- Database sessions
services/api/app/db/session.py - Assessment records
services/api/app/db/models/assessment.py - Cryptographic assets
services/api/app/db/models/cryptographic_asset.py - Risk records
services/api/app/db/models/risk_assessment.py - Discovery jobs
services/api/app/db/models/discovery_job.py - Evidence and target models
services/api/app/db/models
Other components
- Enterprise user
- Public visitor
Connections 28
- Enterprise user → Enterprise console: uses
- Public visitor → Public scanner: submits scan
- Enterprise console → Target management: renders
apps/web/src/app/App.tsx - Enterprise console → Source upload: renders
apps/web/src/app/App.tsx - Enterprise console → Assessment review: renders
apps/web/src/app/App.tsx - Target management → Web API client: calls
apps/web/src/features/targets/TargetManagement.tsx - Assessment review → Web API client: calls
apps/web/src/features/assessments/AssessmentDetail.tsx - Public scanner → Public scan results: routes to
apps/web/src/app/App.tsx - Public scan results → Web API client: calls
apps/web/src/features/public/ScanResultsPage.tsx - Web API client → FastAPI application: HTTP requests
- FastAPI application → API v1 routes: mounts
services/api/app/main.py - API v1 routes → Domain endpoints: registers
services/api/app/api/v1/router.py - Domain endpoints → Assessment orchestration: orchestrates
- Assessment orchestration → Job coordination: creates jobs
services/api/app/services/assessment_service.py - Background worker → Job coordination: claims jobs
services/worker/app/worker.py - Background worker → Assessment orchestration: executes assessments
services/worker/app/worker.py - Assessment orchestration → Discovery collectors: runs collectors
services/api/app/services/assessment_service.py - Discovery collectors → Process containment: uses boundaries
- Assessment orchestration → CBOM correlation: correlates findings
services/api/app/services/assessment_service.py - Assessment orchestration → QVI risk engine: evaluates risk
services/api/app/services/assessment_service.py - Assessment orchestration → Report export: exports reports
- CBOM correlation → Cryptographic assets: creates assets
packages/cbom/correlator.py - QVI risk engine → Risk records: produces scores
packages/risk/engine.py - Assessment orchestration → Database sessions: persists lifecycle
- Database sessions → Assessment records: database sessions
services/api/app/db/session.py - Job coordination → Discovery jobs: stores jobs
services/api/app/services/job_service.py - Assessment records → Evidence and target models: relates evidence
services/api/app/db/models/assessment.py - Cryptographic assets → Evidence and target models: relates observations
services/api/app/db/models/cryptographic_asset.py