Personal-Safety-SOS-Companion

Using phone's built-in sensor APIs together (not one sensor alone), handling permissions for each, and combining their data into one logic.

Solo commuters/students lack a quick way to alert emergency contacts when they fall, get into an accident, or feel unsafe while alone.

Students/individuals who frequently travel or walk alone.

Automatically detects potential incidents (fall/shake) and sends location + alert to emergency contact without manual dialing.

• Real-time accelerometer-based fall/shake detection
• GPS location capture triggered on incident
• Countdown screen with cancel option (avoid false alarm)
• Emergency contact input & validation
• SMS/notification alert sent automatically to emergency contact
• Incident history stored and loaded through the REST backend (time, location, status)
• Permission handling (location, sensors, microphone)
• Loading, empty, and error states on all screens
• Microphone amplitude threshold as secondary trigger

• Accelerometer-based fall/shake detection
• GPS location capture on trigger
• Microphone amplitude threshold as secondary trigger
• Countdown + cancel (avoid false alarm)
• Local incident history log
• SMS/notification alert to 1 emergency contact

• Multiple emergency contacts
• Multi-user accounts
• Real speech recognition (only amplitude threshold)
• Wearable device integration

• Aplikasi berhasil mendeteksi shake/fall pattern via accelerometer
• GPS location berhasil diambil otomatis saat incident terdeteksi
• Countdown + cancel berfungsi (tidak trigger alert jika dibatalkan)
• Alert/notifikasi berhasil terkirim ke emergency contact
• Riwayat insiden tersimpan dan dimuat melalui API backend
• Semua permission (lokasi, sensor, mic) ditangani dengan benar
• APK dapat diinstal dan didemokan end-to-end tanpa crash

1. Home Screen → user set emergency contact (first time only)
2. User tap "Start Monitoring" → Monitoring Screen aktif (accelerometer + mic jalan)
3. Sensor deteksi shake/fall → auto-navigate ke Incident Detected Screen
4. Countdown 10 detik muncul:
   • Jika dibatalkan → kembali ke Monitoring Screen
   • Jika tidak dibatalkan → GPS diambil → Alert terkirim ke emergency contact
5. Incident tersimpan ke History Screen (waktu, lokasi, status)

The repository includes a small REST backend for local end-to-end demos. Start it with Node.js 20 or newer:

node backend/server.mjs

The backend listens on http://0.0.0.0:8080; incident data is stored in the ignored file backend/data/incidents.json. The Android emulator can reach the host machine at http://10.0.2.2:8080/api, which is the app's default API URL. For Flutter web or desktop, configure http://localhost:8080/api. For a physical device, use the computer's LAN IP. For a deployed HTTPS backend, configure the base URL at launch. In each case the app appends /incidents:

flutter run --dart-define=API_BASE_URL=https://your-deployed-api.example/api

This backend is intended for local demos and testing only. It has no authentication and is not a publicly deployed service.

The API contract used by the app is:

• GET /incidents returns a JSON array of incidents (an empty array means no history).
• POST /incidents accepts and returns one incident as a JSON object.
• PATCH /incidents/{id} accepts an updated incident object.
• DELETE /incidents/{id} removes the incident.

Incident objects use id, timestamp (ISO 8601), latitude, longitude, and status (sent, cancelled, or pending). History displays loading, empty, error, and success states, and allows retrying a failed load.

Run the focused API/model unit tests with:

flutter test test/incident_api_test.dart

Run the backend tests with:

node --test backend/server.test.mjs