How shiv0xparanoid/qvanta works
QVANTA is a multi-tenant quantum-computing education SaaS. Its principal workflow is user authentication, circuit authoring in the web builder/editor, a tier-checked simulation request, and results displayed to the learner; separate capabilities include saved circuits, lessons, an AI tutor, and subscription billing. The graph preserves documented product branches, but several web and API implementations were not sampled, so uncertain runtime links are omitted. Simulator routing and internal queue use are supported by the source index; API-to-simulator transport is documented only indirectly and is not asserted.
Main entry points: App.tsx Web Routes · CircuitBuilderPage.tsx Circuit Builder · prisma.ts Postgres Data · billing.service.ts Billing Service
Components 30
Learner Web App
- Web Routes
apps/web/src/App.tsx - Auth Screens
apps/web/src/pages/Login.tsx - Circuit Builder
apps/web/src/pages/CircuitBuilderPage.tsx - Circuit Scene
apps/web/src/components/circuit/CircuitScene3D.tsx - Qiskit Editor
apps/web/src/components/circuit/CodeEditorPanel.tsx - Simulation Results
apps/web/src/components/circuit/SimulationResults.tsx - Bloch Views
apps/web/src/components/circuit/BlochPanel.tsx - Tutor Experience
apps/web/src/pages/Tutor.tsx - Tutor Chat
apps/web/src/components/tutor/ChatPanel.tsx - Tutor Avatar
apps/web/src/components/tutor/AvatarScene.tsx - Dashboard
apps/web/src/pages/Dashboard.tsx - Billing Screen
apps/web/src/pages/Billing.tsx - Circuit Utilities
apps/web/src/lib/circuit.ts
Platform API
- API Router
apps/api/src/main.ts - Auth Routes
apps/api/src/modules/auth/auth.router.ts - Auth Service
apps/api/src/modules/auth/auth.service.ts - Access Guard
apps/api/src/modules/auth/auth.middleware.ts - Circuit Service
apps/api/src/modules/circuits/circuits.service.ts - Simulation Routes
apps/api/src/modules/simulations/simulations.router.ts - Usage Guard
apps/api/src/lib/billing/usage-guard.ts - Tutor Service
apps/api/src/modules/tutor/tutor.service.ts - Billing Service
apps/api/src/modules/billing/billing.service.ts - Tier Definitions
apps/api/src/lib/billing/tiers.ts - Postgres Data
apps/api/src/lib/prisma.ts
Quantum Simulator
- Simulation Engine
apps/simulator/app/routers/simulate.py - Simulation Queue
apps/simulator/app/queue.py - Simulator App
apps/simulator/app/main.py
Shared Packages
- Shared Types
packages/types/src/index.ts
Other components
- Learner
- Stripe
Connections 34
- Learner → Web Routes: uses
apps/web/src/App.tsx - Web Routes → Auth Screens: routes to
apps/web/src/App.tsx - Web Routes → Circuit Builder: routes to
apps/web/src/App.tsx - Web Routes → Tutor Experience: routes to
apps/web/src/App.tsx - Web Routes → Dashboard: routes to
apps/web/src/App.tsx - Web Routes → Billing Screen: routes to
apps/web/src/App.tsx - Circuit Builder → Circuit Scene: renders
- Circuit Builder → Qiskit Editor: syncs
README.md - Circuit Builder → Circuit Utilities: uses
- Circuit Builder → Simulation Routes: submits circuit
- Simulation Routes → Usage Guard: checks quota
apps/api/src/modules/simulations/simulations.router.ts - Usage Guard → Tier Definitions: checks limits
apps/api/src/lib/billing/usage-guard.ts - Simulation Engine → Simulation Queue: dispatches work
apps/simulator/app/routers/simulate.py - Simulator App → Simulation Engine: registers route
apps/simulator/app/main.py - Simulator App → Simulation Queue: uses queue
apps/simulator/app/main.py - Tutor Experience → Tutor Chat: renders
- Tutor Chat → Tutor Avatar: pairs with
README.md - Tutor Experience → Tutor Service: sends prompts
- Tutor Service → Postgres Data: reads course content
apps/api/src/modules/tutor/tutor.service.ts - Tutor Service → Postgres Data: persists conversations
apps/api/src/modules/tutor/tutor.service.ts - Auth Routes → Auth Service: calls
apps/api/src/modules/auth/auth.router.ts - Auth Service → Postgres Data: reads and writes
apps/api/src/modules/auth/auth.service.ts - Access Guard → Auth Routes: protects routes
- API Router → Auth Routes: mounts
apps/api/src/main.ts - API Router → Simulation Routes: mounts
apps/api/src/main.ts - API Router → Tutor Service: mounts tutor routes
- Circuit Service → Postgres Data: reads and writes
apps/api/src/modules/circuits/circuits.service.ts - Billing Screen → Billing Service: requests billing
- Billing Service → Stripe: creates checkout
apps/api/src/modules/billing/billing.service.ts - Billing Service → Postgres Data: updates subscriptions
apps/api/src/modules/billing/billing.service.ts - Billing Service → Tier Definitions: selects tier
apps/api/src/modules/billing/billing.service.ts - Simulation Results → Bloch Views: shows state
- Qiskit Editor → Circuit Utilities: parses circuit
- Circuit Builder → Circuit Service: saves circuits