How mb-cyberx/orginx works
OrginX is a quantum-inspired digital-signature threat detection application. Users submit a payload and scenario in the live-session UI; the backend runs quantum observations and statistical detection, returns a verdict and evidence, and persists session records for later review. Separate UI and API capabilities expose calibration, historical analysis, ledger verification, and settings. Edges are limited to calls, storage actions, and HTTP routes supported by excerpts, the source index, or the README; several unsampled subsystem details are represented at their exact directories.
Main entry points: client.ts API client · db.py Database access · App.tsx Route composition · main.py FastAPI app
Components 23
User interface
- Live session
frontend/src/pages/LiveSessionPage.tsx - Evidence review
frontend/src/pages/EvidencePage.tsx - Analysis view
frontend/src/pages/AnalysisPage.tsx - Ledger view
frontend/src/pages/LedgerPage.tsx - Settings view
frontend/src/pages/SettingsPage.tsx - API client
frontend/src/api/client.ts - Route composition
frontend/src/App.tsx
HTTP API
- Session routes
backend/app/api/routes_sessions.py - Analysis routes
backend/app/api/routes_analysis.py - Calibration routes
backend/app/api/routes_calibration.py - Ledger routes
backend/app/api/routes_ledger.py - Settings routes
backend/app/api/routes_settings.py - FastAPI app
backend/app/main.py
Session detection
- Detection pipeline
backend/app/detection/pipeline.py - Verdict decision
backend/app/detection/decision.py
Quantum and statistics
- Quantum engines
backend/app/quantum - Session observations
backend/app/quantum/engine_base.py - Detection statistics
backend/app/stats - Monte Carlo analysis
backend/app/analysis/monte_carlo.py
Configuration and persistence
- Runtime configuration
backend/app/core/config.py - Database access
backend/app/core/db.py - SQLite store
Other components
- Analyst
Connections 39
- Analyst → Live session: submits payload
- Live session → API client: runs session
frontend/src/pages/LiveSessionPage.tsx - Evidence review → API client: loads evidence
frontend/src/pages/EvidencePage.tsx - Analysis view → API client: requests analysis
frontend/src/api/client.ts - Ledger view → API client: requests ledger
frontend/src/api/client.ts - Settings view → API client: updates settings
frontend/src/api/client.ts - Route composition → Live session: routes to
frontend/src/App.tsx - Route composition → Evidence review: routes to
frontend/src/App.tsx - Route composition → Analysis view: routes to
frontend/src/App.tsx - Route composition → Ledger view: routes to
frontend/src/App.tsx - Route composition → Settings view: routes to
frontend/src/App.tsx - API client → Session routes: HTTP requests
frontend/src/api/client.ts - API client → Analysis routes: HTTP requests
frontend/src/api/client.ts - API client → Ledger routes: HTTP requests
frontend/src/api/client.ts - API client → Calibration routes: HTTP requests
frontend/src/api/client.ts - API client → Settings routes: HTTP requests
frontend/src/api/client.ts - FastAPI app → Session routes: registers routes
backend/app/main.py - FastAPI app → Analysis routes: registers routes
backend/app/main.py - FastAPI app → Calibration routes: registers routes
backend/app/main.py - FastAPI app → Ledger routes: registers routes
backend/app/main.py - FastAPI app → Settings routes: registers routes
backend/app/main.py - Session routes → Detection pipeline: runs pipeline
backend/app/api/routes_sessions.py - Session routes → Database access: reads sessions
backend/app/api/routes_sessions.py - Detection pipeline → Quantum engines: runs simulation
backend/app/detection/pipeline.py - Quantum engines → Session observations: returns observations
backend/app/quantum/engine_base.py - Detection pipeline → Detection statistics: computes tests
backend/app/detection/pipeline.py - Detection pipeline → Verdict decision: evaluates evidence
backend/app/detection/pipeline.py - Detection pipeline → Database access: writes records
backend/app/detection/pipeline.py - Quantum engines → Runtime configuration: reads parameters
backend/app/quantum/pauli_frame_engine.py - Analysis routes → Monte Carlo analysis: runs analysis
backend/app/api/routes_analysis.py - Monte Carlo analysis → Quantum engines: simulates trials
backend/app/analysis/monte_carlo.py - Monte Carlo analysis → Detection statistics: computes metrics
backend/app/analysis/monte_carlo.py - Analysis routes → Database access: stores job data
backend/app/api/routes_analysis.py - Calibration routes → Detection statistics: runs calibration
backend/app/api/routes_calibration.py - Calibration routes → Database access: stores calibration
backend/app/api/routes_calibration.py - Ledger routes → Database access: reads ledger
backend/app/api/routes_ledger.py - Settings routes → Runtime configuration: updates thresholds
backend/app/api/routes_settings.py - Settings routes → Database access: persists settings
backend/app/api/routes_settings.py - Database access → SQLite store: reads and writes
backend/app/core/db.py