How tamoziit/browser-based-ide-poc works
Browser-based-IDE-PoC is a browser IDE for starting read-only/execute or read-write labs, editing workspace files, running code in a terminal, and submitting work for evaluation. The principal flow runs from lab selection through session provisioning to file editing and execution; backend services provide access control, evaluation, and session lifecycle management. The graph includes documented-by-source-index snapshot and cleanup branches. Evidence is limited to the README and supplied excerpts/index; unsampled implementation details are not assumed.
Main entry points: k8s.service.ts Lab provisioning · LabPage.tsx Lab workspace · server.ts HTTP server · App.tsx App routing
Components 34
Browser IDE
- App routing
frontend/src/App.tsx - Auth context
frontend/src/context/AuthContext.tsx - Socket context
frontend/src/context/SocketContext.tsx - Lab selection
frontend/src/pages/LabSelectionPage.tsx - Lab workspace
frontend/src/pages/LabPage.tsx - File tree
frontend/src/components/FileTree.tsx - Code editor
frontend/src/components/MonacoEditor.tsx - Terminal UI
frontend/src/components/Terminal.tsx - Result panel
frontend/src/components/ResultPanel.tsx - Lab API client
frontend/src/services/lab.api.ts
API and access
- HTTP server
backend/src/server.ts - Lab and file routes
backend/src/routes/lab.routes.ts - File routes
backend/src/routes/file.routes.ts - Authentication
backend/src/middlewares/auth.middleware.ts - Workspace permissions
backend/src/middlewares/permissions.middleware.ts - Lab operations
backend/src/controllers/lab.controller.ts - File operations
backend/src/controllers/file.controller.ts - Terminal operations
backend/src/controllers/terminal.controller.ts - Terminal socket
backend/src/socket/terminal.socket.ts
Lab runtime
- Lab provisioning
backend/src/services/k8s.service.ts - Pod file access
backend/src/utils/fileHandlerUtils.ts - Kubernetes client
backend/src/config/k8s.ts - Lab evaluation
backend/src/services/evaluation.service.ts - Evaluation rules
backend/src/utils/evaluators.ts
Session lifecycle
- Session records
backend/src/models/session.model.ts - Session cache
backend/src/config/redis.ts - Snapshot service
backend/src/services/snapshot.service.ts - Snapshot scheduler
backend/src/workers/snapshot.cron.ts - Session cleanup
backend/src/workers/cleanup.worker.ts - Cleanup operations
backend/src/utils/cleanupUtils.ts
Other components
- Learner
- MongoDB
- Kubernetes
- MinIO storage
Connections 47
- Learner → App routing: uses
- App routing → Auth context: provides
frontend/src/App.tsx - App routing → Socket context: provides
frontend/src/App.tsx - App routing → Lab selection: routes to
frontend/src/App.tsx - App routing → Lab workspace: routes to
frontend/src/App.tsx - Lab selection → Lab API client: requests labs
frontend/src/pages/LabSelectionPage.tsx - Lab workspace → Lab API client: calls
frontend/src/pages/LabPage.tsx - Lab workspace → File tree: renders
frontend/src/pages/LabPage.tsx - Lab workspace → Code editor: renders
frontend/src/pages/LabPage.tsx - Lab workspace → Terminal UI: renders
frontend/src/pages/LabPage.tsx - Lab workspace → Result panel: renders
frontend/src/pages/LabPage.tsx - Lab workspace → Socket context: uses socket
frontend/src/pages/LabPage.tsx - File tree → Lab API client: loads files
frontend/src/components/FileTree.tsx - Auth context → Socket context: supplies identity
frontend/src/context/SocketContext.tsx - Lab API client → HTTP server: HTTP requests
- HTTP server → Lab and file routes: mounts
backend/src/server.ts - HTTP server → File routes: mounts
backend/src/server.ts - HTTP server → Terminal socket: initializes
backend/src/server.ts - Lab and file routes → Authentication: authenticates
backend/src/routes/lab.routes.ts - Lab and file routes → Lab operations: dispatches
backend/src/routes/lab.routes.ts - File routes → Authentication: authenticates
backend/src/routes/file.routes.ts - File routes → Workspace permissions: checks access
backend/src/routes/file.routes.ts - File routes → File operations: dispatches
backend/src/routes/file.routes.ts - Lab operations → Lab provisioning: manages sessions
backend/src/controllers/lab.controller.ts - Lab operations → Lab evaluation: evaluates submission
backend/src/controllers/lab.controller.ts - File operations → Pod file access: accesses pod files
backend/src/controllers/file.controller.ts - File operations → Lab provisioning: refreshes session
backend/src/controllers/file.controller.ts - Workspace permissions → Lab provisioning: checks session
backend/src/middlewares/permissions.middleware.ts - Terminal socket → Terminal operations: dispatches events
backend/src/socket/terminal.socket.ts - Terminal operations → Lab provisioning: executes and refreshes
backend/src/controllers/terminal.controller.ts - Terminal operations → Kubernetes: executes commands
backend/src/controllers/terminal.controller.ts - Lab provisioning → Kubernetes client: uses client
backend/src/services/k8s.service.ts - Lab provisioning → Session records: records sessions
backend/src/services/k8s.service.ts - Lab provisioning → Session cache: caches sessions
backend/src/services/k8s.service.ts - Lab provisioning → Kubernetes: provisions pods
backend/src/services/k8s.service.ts - Lab evaluation → Lab provisioning: runs in lab
backend/src/services/evaluation.service.ts - Lab evaluation → Evaluation rules: applies rules
backend/src/services/evaluation.service.ts - HTTP server → MongoDB: connects
backend/src/server.ts - HTTP server → MinIO storage: ensures buckets
backend/src/server.ts - Lab provisioning → MinIO storage: seeds workspace
backend/src/services/k8s.service.ts - Snapshot scheduler → Snapshot service: schedules
backend/src/workers/snapshot.cron.ts - Snapshot service → Session records: reads session
backend/src/services/snapshot.service.ts - Snapshot service → MinIO storage: stores snapshot
backend/src/services/snapshot.service.ts - Session cleanup → Cleanup operations: starts worker
backend/src/workers/cleanup.worker.ts - Cleanup operations → Lab provisioning: stops lab
backend/src/utils/cleanupUtils.ts - Cleanup operations → Session cache: checks cache
backend/src/utils/cleanupUtils.ts - Cleanup operations → Session records: reads session
backend/src/utils/cleanupUtils.ts