How seth0x41/seizure-detection works
Seizure-Detection combines an ESP32 sensing device, a Flask API and a Flutter monitoring app. The documented workflow measures heart rate and motion, detects falls and possible seizures, sends readings or alerts to the API, and presents heart-rate data and notifications to the user. The API retains the latest reading in memory and dispatches alerts through SMS, email and push helpers. The Flutter implementation and ESP32 source were not excerpted, so their internal calls and detailed UI flow are not mapped; documented links are identified as such.
Main entry points: app.py Flask API · device.ino ESP32 detector · main.dart Flutter app · send_sms.py SMS sender
Components 26
Sensing and detection
- ESP32 detector
device/device.ino - Heart and motion sensors
device/device.ino - Fall detection
device/device.ino - Seizure detection
device/device.ino
API and alert dispatch
- Flask API
api/app.py - Latest heart rate
api/app.py - Alert dispatch
api/app.py
Notification channels
- SMS sender
api/send_sms.py - Email sender
api/send_email.py - Push sender
api/firebase_send.py
Flutter monitoring
- Flutter app
flutter application/lib/main.dart - Local notifications
flutter application/lib/main.dart - Windows app host
flutter application/windows/runner/main.cpp - Flutter window
flutter application/windows/runner/flutter_window.h - Win32 window
flutter application/windows/runner/win32_window.h - Linux app host
flutter application/linux/main.cc - Linux application
flutter application/linux/my_application.h - macOS plugin registration
flutter application/macos/Flutter/GeneratedPluginRegistrant.swift - iOS app host
flutter application/ios/Runner/AppDelegate.swift - Linux plugin registration
flutter application/linux/flutter/generated_plugin_registrant.h - Windows plugin registration
flutter application/windows/flutter/generated_plugin_registrant.h
Other components
- Monitored person
- Twilio
- Mailgun
- Firebase messaging
- Caregiver / app user
Connections 22
- Monitored person → Heart and motion sensors: wears
README.md - Heart and motion sensors → ESP32 detector: provide readings
README.md - ESP32 detector → Fall detection: detects falls
README.md - ESP32 detector → Seizure detection: detects seizures
README.md - ESP32 detector → Flask API: sends readings and alerts
README.md - Flask API → Latest heart rate: stores reading
api/app.py - Flask API → Latest heart rate: returns reading
api/app.py - Flask API → Alert dispatch: routes alert
api/app.py - Alert dispatch → SMS sender: calls
api/app.py - Alert dispatch → Email sender: calls
api/app.py - Alert dispatch → Push sender: calls
api/app.py - SMS sender → Twilio: sends SMS
api/send_sms.py - Email sender → Mailgun: sends email
api/send_email.py - Push sender → Firebase messaging: sends push
README.md - Caregiver / app user → Flutter app: monitors
README.md - Flutter app → Flask API: fetches readings
README.md - Flutter app → Local notifications: displays alerts
README.md - Firebase messaging → Flutter app: delivers push
README.md - Windows app host → Flutter window: creates
flutter application/windows/runner/main.cpp - Flutter window → Win32 window: inherits
flutter application/windows/runner/flutter_window.h - Linux app host → Linux application: starts
flutter application/linux/main.cc - iOS app host → macOS plugin registration: registers plugins
flutter application/ios/Runner/AppDelegate.swift