How hmug12/openclass-box works
OpenClass-Box is a portable Windows classroom-device operations toolkit. A staff member uses its React interface to inspect a machine, run classroom checks or repairs, and manage tools; the frontend calls Python through the documented API boundary. A separate LAN workflow pairs A/B devices so the teacher machine can issue jobs and transfer files. The map also preserves documented security, media, scheduling, plugin, knowledge-base, and remote-Web capabilities. Some subsystem links are README-documented because their implementation was not sampled; those limits are reflected by omitting uncertain internal calls.
Main entry points: api.py Python API · remote_admin.py Remote admin Web · server.py Teacher LAN server · client.py Managed-device client
Components 30
Desktop interface
- React interface
frontend/src/App.tsx - Frontend API
frontend/src/api.ts - Python API
backend/api.py
Device operations
- System monitoring
backend/core/monitor.py - Hardware details
backend/core/hardware_detail.py - Classroom checks
backend/core/classroom.py - Health checks
backend/core/health.py - Preflight checks
backend/core/preflight.py - Diagnostic results
backend/core/diag_result.py - Repair actions
backend/core/repair.py
LAN and remote management
- Managed-device client
backend/net/client.py - Teacher LAN server
backend/net/server.py - LAN protocol
backend/net/proto.py - LAN discovery
backend/net/discovery.py - Remote admin Web
backend/core/remote_admin.py - Tunneling
backend/core/tunnel.py - Phone Web console
backend/core/webconsole.py
Tools and user features
- Tool registry
backend/core/registry.py - Plugin market
backend/core/market.py - Security monitoring
backend/core/security.py - Scheduled tasks
backend/core/tasks.py - Music playback
backend/core/music.py - Wallpaper manager
backend/core/wallpaper.py - Compatibility knowledge
backend/core/kb.py - Temporary transfer
backend/core/chat.py
Runtime foundation
- Desktop host
backend/main.py - Configuration
backend/core/config.py - Data paths
backend/core/paths.py - Application logging
backend/core/applog.py
Other components
- Staff user
Connections 30
- Staff user → React interface: uses
README.md - React interface → Frontend API: calls
frontend/src/App.tsx - Frontend API → Python API: invokes
README.md - Desktop host → Python API: hosts
backend/main.py - Python API → System monitoring: reads metrics
backend/api.py - Python API → Hardware details: reads details
backend/api.py - Python API → Health checks: runs checks
backend/api.py - Python API → Classroom checks: runs checks
backend/api.py - Python API → Preflight checks: runs checks
backend/api.py - Health checks → Diagnostic results: normalizes
backend/core/health.py - Python API → Repair actions: runs repair
backend/api.py - Python API → Teacher LAN server: starts server
backend/api.py - Managed-device client → LAN discovery: discovers server
backend/net/client.py - Managed-device client → LAN protocol: exchanges messages
backend/net/client.py - Teacher LAN server → LAN protocol: uses protocol
backend/net/server.py - Remote admin Web → Teacher LAN server: manages devices
backend/core/remote_admin.py - Remote admin Web → Tunneling: checks tunnel
backend/core/remote_admin.py - Python API → Remote admin Web: controls service
backend/api.py - Python API → Phone Web console: serves console
backend/api.py - Python API → Tool registry: launches tools
backend/api.py - Python API → Plugin market: manages plugins
backend/api.py - Python API → Security monitoring: exposes controls
backend/api.py - Python API → Scheduled tasks: exposes tasks
backend/api.py - Python API → Music playback: exposes playback
README.md - Python API → Wallpaper manager: exposes wallpaper
README.md - Python API → Compatibility knowledge: exposes knowledge
README.md - Python API → Temporary transfer: exposes transfer
README.md - Configuration → Data paths: stores under
backend/core/config.py - Application logging → Data paths: writes under
backend/core/applog.py - Desktop host → Application logging: installs logging
backend/main.py