How vizzie8/safeguard works
SafeGuard is a personal-safety application with a React SPA and a standalone vanilla-JS prototype. The main user flow starts at the safety dashboard: users configure triggers and contacts, raise an SOS, share location and alert recipients, while authenticated events are logged for the admin dashboard. A separate WebRTC flow relays signaling through the Node server but sends media peer-to-peer. The README documents the prototype’s additional scream, impact, and device-close triggers, risk-zone map, and emergency-service alert tier; source excerpts chiefly evidence the React, API, and signaling paths.
Main entry points: Home.tsx Safety dashboard · server.ts REST and signaling · app.js Vanilla prototype · contactRoutes.ts Emergency contacts
Components 27
Safety clients
- React application
frontend/src/App.tsx - Safety dashboard
frontend/src/pages/Home.tsx - Safety settings
frontend/src/context/SettingsContext.tsx - Voice detection
frontend/src/hooks/useVoiceRecognition.ts - Impact detection
frontend/src/hooks/useFallDetection.ts - Location tracking
frontend/src/hooks/useLocationTracking.ts - Risk-zone map
frontend/src/components/Heatmap.tsx - Vanilla prototype
app.js - Prototype SOS
sos.js - Zone definitions
safety_zone.js - Prototype sensors
sensor.js - Prototype map
map.js
Application API
- Emergency contacts
backend-node/src/routes/contactRoutes.ts - Authentication
backend-node/src/routes/authRoutes.ts - JWT authorization
backend-node/src/middlewares/authMiddleware.ts - SOS event logging
backend-node/src/routes/sosRoutes.ts - REST and signaling
backend-node/src/server.ts - Relational database
backend-node/prisma/schema.prisma
Incident monitoring
- Admin dashboard
frontend/src/pages/Admin.tsx - Admin stats and logs
backend-node/src/routes/adminRoutes.ts - Victim media stream
frontend/src/hooks/useWebRTCStream.ts - Admin media receiver
frontend/src/hooks/useWebRTCAdmin.ts
Risk analysis
- Risk scoring stub
backend-ai/main.py
Other components
- Person at risk
- Emergency recipients
- Monitoring admin
- Direct peer media
Connections 37
- Person at risk → React application: uses
README.md - React application → Safety dashboard: routes to
frontend/src/App.tsx - Safety dashboard → Voice detection: uses
frontend/src/pages/Home.tsx - Safety dashboard → Impact detection: uses
frontend/src/pages/Home.tsx - Safety dashboard → Location tracking: uses
frontend/src/pages/Home.tsx - Safety dashboard → Safety settings: reads settings
frontend/src/pages/Home.tsx - Voice detection → Safety settings: reads settings
frontend/src/hooks/useVoiceRecognition.ts - Safety dashboard → Risk-zone map: renders
- Person at risk → Vanilla prototype: uses
README.md - Vanilla prototype → Prototype SOS: delegates SOS
- Vanilla prototype → Prototype sensors: uses sensors
- Vanilla prototype → Prototype map: uses map
- Prototype map → Zone definitions: uses zones
- Safety dashboard → Emergency contacts: loads contacts
- Safety dashboard → SOS event logging: posts event
README.md - Safety dashboard → Emergency recipients: opens SMS alerts
README.md - React application → Authentication: submits credentials
- REST and signaling → Authentication: mounts route
backend-node/src/server.ts - REST and signaling → Emergency contacts: mounts route
backend-node/src/server.ts - REST and signaling → SOS event logging: mounts route
backend-node/src/server.ts - REST and signaling → Admin stats and logs: mounts route
backend-node/src/server.ts - Authentication → Relational database: reads and writes
backend-node/src/routes/authRoutes.ts - Emergency contacts → JWT authorization: authenticates with
backend-node/src/routes/contactRoutes.ts - SOS event logging → JWT authorization: authenticates with
backend-node/src/routes/sosRoutes.ts - Admin stats and logs → JWT authorization: authenticates with
backend-node/src/routes/adminRoutes.ts - Emergency contacts → Relational database: reads and writes
backend-node/src/routes/contactRoutes.ts - SOS event logging → Relational database: writes event
backend-node/src/routes/sosRoutes.ts - Admin stats and logs → Relational database: reads stats and incidents
backend-node/src/routes/adminRoutes.ts - Monitoring admin → Admin dashboard: views incidents
README.md - Admin dashboard → Admin stats and logs: loads stats and logs
- Safety dashboard → Victim media stream: starts on SOS
frontend/src/pages/Home.tsx - Admin dashboard → Admin media receiver: uses receiver
frontend/src/pages/Admin.tsx - Victim media stream → REST and signaling: sends signaling
frontend/src/hooks/useWebRTCStream.ts - REST and signaling → Admin media receiver: relays signaling
backend-node/src/server.ts - Victim media stream → Direct peer media: streams media
README.md - Direct peer media → Admin media receiver: delivers media
README.md - Person at risk → Risk scoring stub: requests risk score