How anushkagoyal-11/she-secure works
SheSecure is a women’s safety platform spanning a native Android app, an authority-facing web dashboard and API, and a browser simulator. The primary mobile workflow is a manual or sensor-triggered SOS, a cancellable countdown, then location/contact-based alert dispatch and siren. Other documented capabilities include offline contact management, safe-route search, authority authentication, alert review, and audit logs. Some links to unsampled subsystems are documented in the README; dashboard-to-backend wiring is not established by the excerpts, so it is not shown.
Main entry points: SosActionHandler.kt SOS coordinator · MainActivity.kt Main screen · alert.service.ts Alert processing · api.ts Dashboard API client
Components 31
Android safety app
- Main screen
android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt - Motion detection
android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt - Audio detection
android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt - Voice sentinel
android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt - SOS coordinator
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS countdown
android/app/src/main/java/org/shesecure/app/ui/SosCountdownActivity.kt - Contact management
android/app/src/main/java/org/shesecure/app/ui/ContactsActivity.kt - Safe route screen
android/app/src/main/java/org/shesecure/app/ui/SafeRouteActivity.kt
Mobile data and services
- Police station search
android/app/src/main/java/org/shesecure/app/data/repository/SafeRouteRepository.kt - Nominatim service
android/app/src/main/java/org/shesecure/app/data/api/NominatimApiService.kt - Offline contact database
android/app/src/main/java/org/shesecure/app/data/local/ContactDao.kt - Safety settings
android/app/src/main/java/org/shesecure/app/data/pref/SettingsManager.kt - Location provider
android/app/src/main/java/org/shesecure/app/service/LocationProvider.kt - SMS dispatch
android/app/src/main/java/org/shesecure/app/service/SmsDispatcher.kt - Email dispatch
android/app/src/main/java/org/shesecure/app/service/EmailDispatcher.kt - Siren and vibration
android/app/src/main/java/org/shesecure/app/service/AlarmSirenManager.kt
Authority API
- Alert API routes
backend/src/routes/alert.routes.ts - Alert controller
backend/src/controllers/alert.controller.ts - Alert processing
backend/src/services/alert/alert.service.ts - Alert persistence
backend/src/repositories/alert.repository.ts - Audit logging
backend/src/services/audit/audit.service.ts - Authentication routes
backend/src/routes/auth.routes.ts - Authentication controller
backend/src/controllers/auth.controller.ts - Authentication service
backend/src/services/authentication/auth.service.ts - Authority records
backend/src/repositories/authority.repository.ts
Authority dashboard
- Dashboard router
dashboard/src/App.tsx - Dashboard session
dashboard/src/context/AuthContext.tsx - Dashboard API client
dashboard/src/services/api.ts
Browser simulator
- Interactive simulator
app_simulator/app.js
Other components
- Mobile user
- Authority operator
Connections 30
- Mobile user → Main screen: uses
README.md - Main screen → SOS coordinator: triggers SOS
android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt - Motion detection → SOS coordinator: triggers SOS
android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt - Audio detection → SOS coordinator: triggers SOS
android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt - Voice sentinel → SOS coordinator: triggers SOS
android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt - SOS coordinator → SOS countdown: opens countdown
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS coordinator → Location provider: requests location
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS coordinator → Offline contact database: reads contacts
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS coordinator → SMS dispatch: dispatches SMS
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS coordinator → Email dispatch: dispatches email
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - SOS coordinator → Siren and vibration: starts alarm
android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt - Contact management → Offline contact database: manages contacts
README.md - Safe route screen → Police station search: requests search
- Police station search → Nominatim service: queries stations
- Main screen → Safety settings: reads settings
android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt - Motion detection → Safety settings: checks threshold
README.md - Audio detection → Safety settings: checks threshold
android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt - Authority operator → Dashboard router: uses dashboard
dashboard/src/App.tsx - Dashboard router → Dashboard session: provides session
dashboard/src/App.tsx - Dashboard session → Dashboard API client: calls API client
dashboard/src/context/AuthContext.tsx - Alert API routes → Alert controller: routes requests
backend/src/routes/alert.routes.ts - Alert controller → Alert processing: processes alerts
backend/src/controllers/alert.controller.ts - Alert processing → Alert persistence: stores alerts
backend/src/services/alert/alert.service.ts - Alert processing → Audit logging: records activity
backend/src/services/alert/alert.service.ts - Authentication routes → Authentication controller: routes requests
- Authentication controller → Authentication service: handles authentication
backend/src/controllers/auth.controller.ts - Authentication service → Authority records: loads authority
backend/src/services/authentication/auth.service.ts - Dashboard API client → Alert API routes: requests alerts
- Dashboard API client → Authentication routes: requests authentication
- Mobile user → Interactive simulator: tests safety flows
README.md