How r-976/parental works
SafeGuard is a parental-monitoring system: parents pair a child Android device, the app gathers device activity and location, and sends telemetry or real-time events to a multi-tenant Flask server for parent/admin dashboards. The server also dispatches remote commands and supports live-media signaling. The graph preserves documented monitoring, media, notifications, and administration capabilities; some implementation details are represented by their exact enclosing directories because those modules were not sampled. Edges are limited to relationships shown by excerpts, the source index, or the README.
Main entry points: routes Monitoring APIs · socket_server.py Realtime service · DaemonService.kt Background daemon · database.py Database engine
Components 27
Android client
- Background daemon
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Command dispatcher
app/src/main/java/com/safeguard/client/managers/CommandDispatcher.kt - Location capture
app/src/main/java/com/safeguard/client/managers/LocationManager.kt - Route tracking
app/src/main/java/com/safeguard/client/managers/RouteTrackingManager.kt - Boundary monitoring
app/src/main/java/com/safeguard/client/services/BoundaryMonitoringService.kt - Device monitoring
app/src/main/java/com/safeguard/client/managers - Live media client
app/src/main/java/com/safeguard/client/webrtc/WebRtcManager.kt - Client telemetry cache
app/src/main/java/com/safeguard/client/database/TelemetryDatabase.kt - Route cache
app/src/main/java/com/safeguard/client/database/RouteTrackingDatabase.kt
Server transport
- HTTP client
app/src/main/java/com/safeguard/client/network/ApiClient.kt - Socket client
app/src/main/java/com/safeguard/client/network/SocketManager.kt
Server application
- Flask application
server/app.py - Monitoring APIs
server/routes - Command lifecycle
server/routes/command_routes.py - Realtime service
server/socket_server.py - Admin operations
server/routes/admin_routes.py - Push notifications
server/utils/fcm.py
Data and security
- Domain records
server/models - Database engine
server/database.py - Activity auditing
server/utils/audit.py - Identity and access
server/utils/auth_helper.py - Device authentication
server/utils/device_token.py - Encrypted messaging
server/encryption.py
Parent and admin
- Web dashboard
server/static/js/main.js
Other components
- Parent or admin
- Child device
- Push service
Connections 38
- Child device → Background daemon: runs app
- Background daemon → Socket client: connects and dispatches
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Socket client → Command dispatcher: dispatches commands
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Background daemon → Location capture: uses capture
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Location capture → Client telemetry cache: stores telemetry
app/src/main/java/com/safeguard/client/managers/LocationManager.kt - Location capture → HTTP client: uploads location
app/src/main/java/com/safeguard/client/managers/LocationManager.kt - Background daemon → Route tracking: starts tracking
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Route tracking → Route cache: stores route state
app/src/main/java/com/safeguard/client/managers/RouteTrackingManager.kt - Route tracking → HTTP client: uploads route data
app/src/main/java/com/safeguard/client/managers/RouteTrackingManager.kt - Route tracking → Socket client: sends realtime data
app/src/main/java/com/safeguard/client/managers/RouteTrackingManager.kt - Background daemon → Device monitoring: starts monitoring
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Background daemon → Live media client: manages live sessions
app/src/main/java/com/safeguard/client/services/DaemonService.kt - Boundary monitoring → Location capture: uses location
app/src/main/java/com/safeguard/client/services/BoundaryMonitoringService.kt - HTTP client → Flask application: HTTP requests
- Socket client → Realtime service: socket events
- Parent or admin → Web dashboard: uses dashboard
- Web dashboard → Realtime service: realtime dashboard
- Flask application → Monitoring APIs: registers routes
server/app.py - Flask application → Realtime service: initializes realtime
server/app.py - Monitoring APIs → Domain records: uses records
server/routes/location_routes.py - Monitoring APIs → Database engine: queries data
server/routes/location_routes.py - Monitoring APIs → Identity and access: checks access
server/routes/location_routes.py - Monitoring APIs → Device authentication: validates devices
server/routes/location_routes.py - Monitoring APIs → Activity auditing: records activity
server/routes/location_routes.py - Flask application → Database engine: configures database
server/app.py - Command lifecycle → Database engine: queues commands
server/routes/command_routes.py - Realtime service → Database engine: updates device state
server/socket_server.py - Realtime service → Encrypted messaging: verifies encrypted packets
server/socket_server.py - Realtime service → Command lifecycle: handles command data
server/routes/command_routes.py - Admin operations → Identity and access: checks access
server/routes/admin_routes.py - Admin operations → Activity auditing: records actions
server/routes/admin_routes.py - Admin operations → Realtime service: manages realtime state
server/routes/admin_routes.py - Monitoring APIs → Push notifications: sends push alerts
server/routes/location_routes.py - Push notifications → Push service: delivers notifications
server/utils/fcm.py - Database engine → Domain records: persists records
server/database.py - Parent or admin → Admin operations: administers accounts
- Parent or admin → Monitoring APIs: views child activity
- Parent or admin → Command lifecycle: issues commands