rrt-app.md

Rapid Response Team (RRT)

1. Purpose of the App
   Rapid Response Team (RRT) is a community-driven emergency alert application that enables a person in distress to instantly notify nearby people within the same district and receive rapid assistance.

2. First-Time App Usage (Minimal Onboarding)
   On first-time app usage only, the user is required to fill a simple form:

• Name
• Mobile number

This is a one-time step and is required only to enable meaningful emergency communication.

3. No Login, No OTP, No Authentication Friction
   The app does not require:

• Login
• OTP verification
• Passwords
• Email or account creation

Identity is device-based, ensuring:

• Zero delay during emergencies
• No dependency on OTP delivery
• Maximum accessibility under stress

4. Automatic District Mapping Using Device Location
   The app uses the device’s location only to determine the user’s district.
   The district is:

• Automatically mapped by the system
• Shown as read-only to the user
• Used strictly for alert routing

The user does not manually select a district.

5. Intentional SOS Activation
   An SOS can be initiated only through deliberate user actions (unlock gesture + press-and-hold), ensuring alerts are never triggered accidentally.

6. District-Only SOS Broadcast (Critical Rule)
   When an SOS is raised:

• The alert is broadcast only to users mapped to the same district
• Users in any other district do not receive the alert
• There is no city-wide, state-wide, or global broadcast

This ensures:

• Faster local response
• Reduced noise
• Strong privacy boundaries

7. Immediate High-Priority Push Notification
   District users receive a high-priority push notification that:

• Appears as a heads-up pop-up
• Works when the app is closed
• Works when the phone is locked
• Behaves like Swiggy / Zomato / Uber notifications

8. Push Notification Content (Privacy-Safe)
   Push notifications expose only:

• Name of the person in distress
• Approximate location (area / street)

Push notifications never expose:

• Phone number
• Exact GPS coordinates
• Any sensitive personal information

This is enforced at backend level, not UI.

9. Siren Activation on SOS
   At the moment an SOS is initiated:

• A loud siren plays for 10 seconds
• Siren plays even if the phone is locked
• Designed to attract immediate nearby attention and indicate urgency

10. Siren Mute Controls (In-App & Lock Screen)
    The siren can be muted via:

• Mute Siren button inside the app
• Mute Siren action directly on the lock-screen notification

Muting:

• Stops the siren immediately
• Does not stop or resolve the SOS

11. Phone Number Visibility Rules
    The phone number of the person in distress:

• Is never shown in push notifications
• Is visible only inside the Alerts screen
• Is visible only while SOS status is ACTIVE

Once SOS is resolved:

• Phone number is hidden immediately
• Call option is disabled
• Backend stops returning the phone number

12. Live Location During Active SOS
    While SOS is ACTIVE:

• Live location updates are shared continuously
• Responders can track movement and assist effectively

Live location sharing stops immediately once SOS is resolved.

13. External Navigation via Installed Maps App
    Navigation is handled outside the RRT app:

• Tapping Get Directions opens the phone’s installed Maps app
  • Google Maps (Android)
  • Apple Maps (future iOS)
• Navigation experience is identical to Ola / Uber
• RRT only passes destination coordinates

14. Updates During SOS
    The person in distress can add short text updates describing the situation.
    These updates:

• Are visible to responders
• Help clarify the nature of help required

15. Alerts Screen Behaviour
    The Alerts screen:

• Shows only ACTIVE SOS alerts from the same district
• Displays:
  • Name
  • Location
  • Distance
  • Phone number (only while ACTIVE)
• Allows calling and external navigation

16. Explicit SOS Resolution
    An SOS remains active until the user explicitly confirms resolution, preventing premature or accidental termination.

17. Immediate Shutdown After Resolution
    When SOS is resolved:

• Siren stops
• Live location stops
• Phone number is hidden
• Alert is removed from active lists
• Final “SOS resolved” notification is sent

18. Designed for Stress, Speed & Reliability
    The app is designed to:

• Work under panic situations
• Require minimal interaction
• Function reliably under poor connectivity
• Prioritise safety, speed, and privacy above all else