How saisankarbommala/qois works
QOIS is a web platform for composing quantum jobs, submitting them to IBM Quantum, and monitoring results. Users enter through the React application, authenticate, create and inspect jobs, then submit them through the backend; a background worker polls IBM and broadcasts status changes. The README also describes circuit building, OpenQASM editing, backend recommendations, and predictive queue analytics. Those capabilities are represented where the tree supports them, but unsampled implementations and their wiring are not assumed; dashed links mark documented or unverified connections.
Main entry points: App.jsx React app · server.js API server · jobController.js Job controller · jobWorker.js Job worker
Components 25
Web experience
- React app
frontend/src/App.jsx - Circuit workspace
frontend/src/pages/Home.jsx - Execution dashboard
frontend/src/pages/Dashboard.jsx - Job dashboard
frontend/src/pages/HiringDashboard.jsx - Job composer
frontend/src/pages/JobSubmission.jsx - Job details
frontend/src/pages/JobDetails.jsx
Identity
- Auth context
frontend/src/context/AuthContext.jsx - Auth client
frontend/src/authApi.js - Auth routes
backend/routes/authRoutes.js - Auth controller
backend/controllers/AuthController.js - User records
backend/models/User.js - OTP records
backend/models/Otp.js
Job lifecycle
- Job routes
backend/routes/jobRoutes.js - Job controller
backend/controllers/jobController.js - Job records
backend/models/Job.js - Job worker
backend/services/jobWorker.js
Quantum intelligence
- Circuit intelligence
backend/utils/circuitIntelligence.js - Scheduling optimization
backend/services/optimizationService.js - Job estimation
backend/services/estimationService.js
Runtime platform
- API server
backend/server.js - Live updates
backend/utils/socket.js - IBM adapter
backend/services/ibmService.js
Other components
- Quantum user
- MongoDB
- IBM Quantum
Connections 29
- Quantum user → React app: uses
README.md - React app → Circuit workspace: routes to
frontend/src/App.jsx - React app → Execution dashboard: routes to
frontend/src/App.jsx - React app → Job dashboard: routes to
frontend/src/App.jsx - React app → Job composer: routes to
frontend/src/App.jsx - React app → Job details: routes to
frontend/src/App.jsx - React app → Auth context: provides auth
frontend/src/App.jsx - Auth context → Auth client: loads user
frontend/src/context/AuthContext.jsx - Auth client → Auth routes: calls API
README.md - API server → Auth routes: mounts
backend/server.js - Auth routes → Auth controller: dispatches
backend/routes/authRoutes.js - Auth controller → User records: reads/writes
backend/controllers/AuthController.js - Auth controller → OTP records: reads/writes
backend/controllers/AuthController.js - API server → Job routes: mounts
backend/server.js - Job routes → Job controller: dispatches
backend/routes/jobRoutes.js - Job controller → Job records: reads/writes
backend/controllers/jobController.js - Job controller → IBM adapter: submits jobs
backend/controllers/jobController.js - Job controller → Live updates: emits updates
backend/controllers/jobController.js - API server → Job worker: starts worker
backend/server.js - Job worker → Job records: reads/writes
backend/services/jobWorker.js - Job worker → IBM adapter: polls status
backend/services/jobWorker.js - Job worker → Live updates: emits updates
backend/services/jobWorker.js - API server → Live updates: initializes
backend/server.js - IBM adapter → IBM Quantum: calls runtime
backend/services/ibmService.js - API server → MongoDB: connects
backend/server.js - Execution dashboard → Live updates: receives updates
README.md - Job composer → Circuit intelligence: uses analysis
- Circuit intelligence → Scheduling optimization: supports scheduling
- Scheduling optimization → Job estimation: informs estimates