# anushkagoyal-11/she-secure architecture

> Architecture diagram of the GitHub repository anushkagoyal-11/she-secure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anushkagoyal-11/she-secure
- Repository: https://github.com/anushkagoyal-11/she-secure

## Overview

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: [`android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt) (SOS coordinator), [`android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt`](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt) (Main screen), [`backend/src/services/alert/alert.service.ts`](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/alert/alert.service.ts) (Alert processing), [`dashboard/src/services/api.ts`](https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/services/api.ts) (Dashboard API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android safety app"]
  node_main_activity["Main screen<br/>[MainActivity.kt]"]
  node_motion_detection["Motion detection"]
  node_audio_detection["Audio detection<br/>[AudioSosService.kt]"]
  node_voice_sentinel["Voice sentinel"]
  node_sos_handler["SOS coordinator"]
  node_countdown["SOS countdown"]
  node_contacts_ui["Contact management"]
  node_safe_route_ui["Safe route screen"]
end

subgraph group_mobile_data["Mobile data and services"]
  node_safe_route_search["Police station search"]
  node_nominatim["Nominatim service"]
  node_contact_store[("Offline contact database<br/>[ContactDao.kt]")]
  node_settings["Safety settings<br/>[SettingsManager.kt]"]
  node_location["Location provider"]
  node_sms_dispatch["SMS dispatch<br/>[SmsDispatcher.kt]"]
  node_email_dispatch["Email dispatch<br/>[EmailDispatcher.kt]"]
  node_siren["Siren and vibration"]
end

subgraph group_backend["Authority API"]
  node_alert_routes["Alert API routes<br/>[alert.routes.ts]"]
  node_alert_controller["Alert controller"]
  node_alert_service["Alert processing<br/>[alert.service.ts]"]
  node_alert_repository[("Alert persistence")]
  node_audit_service["Audit logging<br/>[audit.service.ts]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.ts]"]
  node_auth_controller["Authentication controller<br/>[auth.controller.ts]"]
  node_auth_service["Authentication service<br/>[auth.service.ts]"]
  node_authority_repository[("Authority records")]
end

subgraph group_dashboard["Authority dashboard"]
  node_dashboard_app["Dashboard router<br/>[App.tsx]"]
  node_dashboard_auth["Dashboard session<br/>[AuthContext.tsx]"]
  node_dashboard_api["Dashboard API client<br/>[api.ts]"]
end

subgraph group_simulator["Browser simulator"]
  node_simulator_app["Interactive simulator<br/>[app.js]"]
end

node_phone_user(("Mobile user"))
node_authority_user(("Authority operator"))

node_phone_user -->|"uses"| node_main_activity
node_main_activity -->|"triggers SOS"| node_sos_handler
node_motion_detection -->|"triggers SOS"| node_sos_handler
node_audio_detection -->|"triggers SOS"| node_sos_handler
node_voice_sentinel -->|"triggers SOS"| node_sos_handler
node_sos_handler -->|"opens countdown"| node_countdown
node_sos_handler -->|"requests location"| node_location
node_sos_handler -->|"reads contacts"| node_contact_store
node_sos_handler -->|"dispatches SMS"| node_sms_dispatch
node_sos_handler -->|"dispatches email"| node_email_dispatch
node_sos_handler -->|"starts alarm"| node_siren
node_contacts_ui -.->|"manages contacts"| node_contact_store
node_safe_route_ui -.->|"requests search"| node_safe_route_search
node_safe_route_search -.->|"queries stations"| node_nominatim
node_main_activity -->|"reads settings"| node_settings
node_motion_detection -.->|"checks threshold"| node_settings
node_audio_detection -->|"checks threshold"| node_settings
node_authority_user -->|"uses dashboard"| node_dashboard_app
node_dashboard_app -->|"provides session"| node_dashboard_auth
node_dashboard_auth -->|"calls API client"| node_dashboard_api
node_alert_routes -->|"routes requests"| node_alert_controller
node_alert_controller -->|"processes alerts"| node_alert_service
node_alert_service -->|"stores alerts"| node_alert_repository
node_alert_service -->|"records activity"| node_audit_service
node_auth_routes -->|"routes requests"| node_auth_controller
node_auth_controller -->|"handles authentication"| node_auth_service
node_auth_service -->|"loads authority"| node_authority_repository
node_dashboard_api -.->|"requests alerts"| node_alert_routes
node_dashboard_api -.->|"requests authentication"| node_auth_routes
node_phone_user -->|"tests safety flows"| node_simulator_app

click node_main_activity "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt"
click node_motion_detection "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt"
click node_audio_detection "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt"
click node_voice_sentinel "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt"
click node_sos_handler "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt"
click node_countdown "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/SosCountdownActivity.kt"
click node_contacts_ui "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/ContactsActivity.kt"
click node_safe_route_ui "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/SafeRouteActivity.kt"
click node_safe_route_search "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/repository/SafeRouteRepository.kt"
click node_nominatim "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/api/NominatimApiService.kt"
click node_contact_store "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/local/ContactDao.kt"
click node_settings "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/pref/SettingsManager.kt"
click node_location "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/LocationProvider.kt"
click node_sms_dispatch "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/SmsDispatcher.kt"
click node_email_dispatch "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/EmailDispatcher.kt"
click node_siren "https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/AlarmSirenManager.kt"
click node_dashboard_app "https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/App.tsx"
click node_dashboard_auth "https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/context/AuthContext.tsx"
click node_dashboard_api "https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/services/api.ts"
click node_alert_routes "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/routes/alert.routes.ts"
click node_alert_controller "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/controllers/alert.controller.ts"
click node_alert_service "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/alert/alert.service.ts"
click node_alert_repository "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/repositories/alert.repository.ts"
click node_audit_service "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/audit/audit.service.ts"
click node_auth_routes "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/routes/auth.routes.ts"
click node_auth_controller "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/controllers/auth.controller.ts"
click node_auth_service "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/authentication/auth.service.ts"
click node_authority_repository "https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/repositories/authority.repository.ts"
click node_simulator_app "https://github.com/anushkagoyal-11/she-secure/blob/main/app_simulator/app.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main_activity,node_motion_detection,node_audio_detection,node_voice_sentinel,node_sos_handler,node_countdown,node_contacts_ui,node_safe_route_ui,node_phone_user toneBlue
class node_safe_route_search,node_nominatim,node_contact_store,node_settings,node_location,node_sms_dispatch,node_email_dispatch,node_siren toneAmber
class node_alert_routes,node_alert_controller,node_alert_service,node_alert_repository,node_audit_service,node_auth_routes,node_auth_controller,node_auth_service,node_authority_repository toneMint
class node_dashboard_app,node_dashboard_auth,node_dashboard_api toneRose
class node_simulator_app,node_authority_user toneIndigo
```

## Components

### Android safety app

- [Main screen](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt): `android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt`
- [Motion detection](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt): `android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt`
- [Audio detection](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt): `android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt`
- [Voice sentinel](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt): `android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt`
- [SOS coordinator](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt): `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`
- [SOS countdown](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/SosCountdownActivity.kt): `android/app/src/main/java/org/shesecure/app/ui/SosCountdownActivity.kt`
- [Contact management](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/ContactsActivity.kt): `android/app/src/main/java/org/shesecure/app/ui/ContactsActivity.kt`
- [Safe route screen](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/ui/SafeRouteActivity.kt): `android/app/src/main/java/org/shesecure/app/ui/SafeRouteActivity.kt`

### Mobile data and services

- [Police station search](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/repository/SafeRouteRepository.kt): `android/app/src/main/java/org/shesecure/app/data/repository/SafeRouteRepository.kt`
- [Nominatim service](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/api/NominatimApiService.kt): `android/app/src/main/java/org/shesecure/app/data/api/NominatimApiService.kt`
- [Offline contact database](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/local/ContactDao.kt): `android/app/src/main/java/org/shesecure/app/data/local/ContactDao.kt`
- [Safety settings](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/data/pref/SettingsManager.kt): `android/app/src/main/java/org/shesecure/app/data/pref/SettingsManager.kt`
- [Location provider](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/LocationProvider.kt): `android/app/src/main/java/org/shesecure/app/service/LocationProvider.kt`
- [SMS dispatch](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/SmsDispatcher.kt): `android/app/src/main/java/org/shesecure/app/service/SmsDispatcher.kt`
- [Email dispatch](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/EmailDispatcher.kt): `android/app/src/main/java/org/shesecure/app/service/EmailDispatcher.kt`
- [Siren and vibration](https://github.com/anushkagoyal-11/she-secure/blob/main/android/app/src/main/java/org/shesecure/app/service/AlarmSirenManager.kt): `android/app/src/main/java/org/shesecure/app/service/AlarmSirenManager.kt`

### Authority API

- [Alert API routes](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/routes/alert.routes.ts): `backend/src/routes/alert.routes.ts`
- [Alert controller](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/controllers/alert.controller.ts): `backend/src/controllers/alert.controller.ts`
- [Alert processing](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/alert/alert.service.ts): `backend/src/services/alert/alert.service.ts`
- [Alert persistence](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/repositories/alert.repository.ts): `backend/src/repositories/alert.repository.ts`
- [Audit logging](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/audit/audit.service.ts): `backend/src/services/audit/audit.service.ts`
- [Authentication routes](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Authentication controller](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Authentication service](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/services/authentication/auth.service.ts): `backend/src/services/authentication/auth.service.ts`
- [Authority records](https://github.com/anushkagoyal-11/she-secure/blob/main/backend/src/repositories/authority.repository.ts): `backend/src/repositories/authority.repository.ts`

### Authority dashboard

- [Dashboard router](https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/App.tsx): `dashboard/src/App.tsx`
- [Dashboard session](https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/context/AuthContext.tsx): `dashboard/src/context/AuthContext.tsx`
- [Dashboard API client](https://github.com/anushkagoyal-11/she-secure/blob/main/dashboard/src/services/api.ts): `dashboard/src/services/api.ts`

### Browser simulator

- [Interactive simulator](https://github.com/anushkagoyal-11/she-secure/blob/main/app_simulator/app.js): `app_simulator/app.js`

### Other components

- **Mobile user**
- **Authority operator**

## Connections

- Mobile user → Main screen: uses (evidence: `README.md`)
- Main screen → SOS coordinator: triggers SOS (evidence: `android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt`)
- Motion detection → SOS coordinator: triggers SOS (evidence: `android/app/src/main/java/org/shesecure/app/service/MotionSosService.kt`)
- Audio detection → SOS coordinator: triggers SOS (evidence: `android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt`)
- Voice sentinel → SOS coordinator: triggers SOS (evidence: `android/app/src/main/java/org/shesecure/app/service/VoiceSentinelService.kt`)
- SOS coordinator → SOS countdown: opens countdown (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- SOS coordinator → Location provider: requests location (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- SOS coordinator → Offline contact database: reads contacts (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- SOS coordinator → SMS dispatch: dispatches SMS (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- SOS coordinator → Email dispatch: dispatches email (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- SOS coordinator → Siren and vibration: starts alarm (evidence: `android/app/src/main/java/org/shesecure/app/control/SosActionHandler.kt`)
- Contact management → Offline contact database: manages contacts (evidence: `README.md`)
- Safe route screen → Police station search: requests search
- Police station search → Nominatim service: queries stations
- Main screen → Safety settings: reads settings (evidence: `android/app/src/main/java/org/shesecure/app/ui/MainActivity.kt`)
- Motion detection → Safety settings: checks threshold (evidence: `README.md`)
- Audio detection → Safety settings: checks threshold (evidence: `android/app/src/main/java/org/shesecure/app/service/AudioSosService.kt`)
- Authority operator → Dashboard router: uses dashboard (evidence: `dashboard/src/App.tsx`)
- Dashboard router → Dashboard session: provides session (evidence: `dashboard/src/App.tsx`)
- Dashboard session → Dashboard API client: calls API client (evidence: `dashboard/src/context/AuthContext.tsx`)
- Alert API routes → Alert controller: routes requests (evidence: `backend/src/routes/alert.routes.ts`)
- Alert controller → Alert processing: processes alerts (evidence: `backend/src/controllers/alert.controller.ts`)
- Alert processing → Alert persistence: stores alerts (evidence: `backend/src/services/alert/alert.service.ts`)
- Alert processing → Audit logging: records activity (evidence: `backend/src/services/alert/alert.service.ts`)
- Authentication routes → Authentication controller: routes requests
- Authentication controller → Authentication service: handles authentication (evidence: `backend/src/controllers/auth.controller.ts`)
- Authentication service → Authority records: loads authority (evidence: `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 (evidence: `README.md`)
