How preety5123/surakshavikas-ar works
SurakshaVikas AR is a mobile-first vocational safety-training product with offline support, interactive fire/gas practice, assessments, certificates, and an administrative dashboard with public certificate verification. The principal workflow moves from worker onboarding and language selection through simulation, assessment, certificate issuance, and verification; queued training records sync to the backend when online. A separate browser-based PASS trainer implements WebXR/simulation extinguisher practice. Source excerpts establish the backend, mobile engine, and web trainer wiring; dashboard internals and several mobile screens are documented in the README but not sampled.
Main entry points: main.js Browser Practice · App.js Training App · fire.js Fire Hazard · store.js Queued Sync
Components 23
Mobile Training
- Training App
mobile-app/App.js - Offline Store
mobile-app/src/engine/store.js - Localization
mobile-app/src/engine/i18n.js - Assessment Engine
mobile-app/src/engine/assessment.js - Session Results
mobile-app/App.js - Queued Sync
mobile-app/src/engine/store.js
Browser PASS Trainer
- Browser Practice
web-pass-trainer/js/main.js - AR Session
web-pass-trainer/js/session.js - Training State
web-pass-trainer/js/fsm.js - Extinguisher Model
web-pass-trainer/js/extinguisher.js - Fire Hazard
web-pass-trainer/js/fire.js - Sweep Tracking
web-pass-trainer/js/sweep.js - Particle Effects
web-pass-trainer/js/particles.js - Synth Audio
web-pass-trainer/js/audio.js - Trainer UI
web-pass-trainer/js/ui.js
Backend Services
- Training API
backend/server.js - JSON Records
backend/db.js - Certificate Verification
backend/server.js
Administration
- Admin Dashboard
admin-dashboard/index.html
Other components
- Worker
- Administrator
- Certificate Checker
- HTTP Network
Connections 26
- Worker → Training App: uses
README.md - Training App → Localization: translates
mobile-app/App.js - Training App → Offline Store: loads and saves
mobile-app/App.js - Training App → Assessment Engine: assesses
README.md - Training App → Session Results: records progress
mobile-app/App.js - Offline Store → Queued Sync: queues records
mobile-app/src/engine/store.js - Training App → Queued Sync: starts sync
mobile-app/App.js - Queued Sync → HTTP Network: posts queued data
mobile-app/src/engine/store.js - HTTP Network → Training API: sends requests
README.md - Training API → JSON Records: loads and saves
backend/server.js - Administrator → Admin Dashboard: reviews stats
README.md - Admin Dashboard → Training API: fetches records
README.md - Certificate Checker → Certificate Verification: checks certificate
backend/server.js - Certificate Verification → JSON Records: reads certificates
backend/server.js - Worker → Browser Practice: practices PASS
- Browser Practice → AR Session: updates session
web-pass-trainer/js/main.js - Browser Practice → Training State: wires state
web-pass-trainer/js/main.js - Browser Practice → Extinguisher Model: creates controller
web-pass-trainer/js/main.js - Browser Practice → Fire Hazard: places hazard
web-pass-trainer/js/main.js - Browser Practice → Sweep Tracking: updates tracker
web-pass-trainer/js/main.js - Browser Practice → Synth Audio: controls audio
web-pass-trainer/js/main.js - Browser Practice → Trainer UI: binds controls
web-pass-trainer/js/main.js - Extinguisher Model → Particle Effects: emits spray
web-pass-trainer/js/extinguisher.js - Fire Hazard → Particle Effects: renders effects
web-pass-trainer/js/fire.js - Fire Hazard → Sweep Tracking: uses damage
web-pass-trainer/js/fire.js - Fire Hazard → Synth Audio: stops fire sound
web-pass-trainer/js/fire.js