Skip to content

Ad2m1109/Harmonia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Harmonia: A Research-Driven Assistive Framework for Alzheimer's Care

Dignity Through Decentralized Technology

alt text

1. Scientific Abstract

The increasing prevalence of Alzheimer's disease presents a significant socio-technical challenge: how can technology empower patients to maintain their independence and dignity without compromising their safety or data privacy? Existing digital health solutions often rely on centralized, cloud-based architectures that can be vulnerable to data breaches and may disempower users by removing their data ownership. Harmonia addresses this challenge by proposing a novel, privacy-first assistive framework. It is a mobile application designed as a decentralized support tool that operates entirely offline. By leveraging a local-first, CSV-based data architecture ("Decentralized Edge Storage"), Harmonia provides robust features—including cognitive support, family connection, and emergency alerts—while ensuring that all sensitive data remains exclusively on the user's device. This project serves as a research platform for investigating the efficacy of decentralized technology in enhancing the quality of life for individuals with cognitive decline, prioritizing user autonomy and dignity.

2. The Privacy Protocol: Dignity Through Decentralized Edge Storage

In dementia care, data privacy is not just a technical feature; it is a cornerstone of patient dignity. The choice to forgo cloud databases in favor of a local-first architecture is a deliberate design decision rooted in ethical considerations.

Our Privacy-by-Design protocol is implemented through a Decentralized Edge Storage model:

  • Architecture: All user-generated data—profiles, journal entries, photos, and voice logs—is stored directly on the device's local file system. There is no remote server communication, eliminating the risk of third-party data access or breaches.
  • Data Format: We utilize a transparent, non-proprietary CSV (Comma-Separated Values) format for storing structured data (profile.csv, journal_entries.csv). This ensures data portability and user ownership. The user or their legal guardian can access, export, or delete their information at any time without requiring our intervention.
  • Data Sovereignty: By keeping data on the "edge" (the user's device), we return full control to the individual. This offline-first approach guarantees functionality regardless of internet connectivity and empowers users with true ownership of their personal health information.
  • Security: Data is stored in the application's sandboxed directory, protected by the mobile operating system's security features. Sensitive settings are further protected by a PIN.

This model directly challenges the prevailing paradigm of data centralization in digital health, demonstrating a viable alternative that prioritizes the user's fundamental right to privacy.

3. Accessibility Engineering: A Human-Computer Interaction (HCI) Approach

Designing for users with cognitive decline requires a specialized HCI approach focused on reducing cognitive load and enhancing usability. The Harmonia interface is engineered based on established principles of geriatric UI/UX.

  • Framework: Built with Material Design 3, the UI adheres to modern accessibility standards while being specifically optimized for our target users.
  • Cognitive Load Reduction:
    • Large, High-Contrast Elements: Buttons, text, and interactive elements are designed to be large and clear, with high-contrast color schemes (including light and dark modes) to ensure readability for users with visual impairments.
    • Simple Navigation: The information architecture is intentionally shallow, with a clear, linear flow that minimizes confusion and prevents users from getting lost in complex menus.
  • Multimodal Interaction: Recognizing that text-based input can be challenging, Harmonia integrates:
    • Voice Control: For hands-free navigation and interaction.
    • Photo-Based Recognition: Family profiles are represented by large photos, leveraging visual memory cues over text.
    • Voice Memos: The digital journal supports audio recordings, allowing users to express themselves without typing.
  • Adjustable UI: Users can modify text sizes to suit their needs, ensuring a comfortable and strain-free experience.

Every UI/UX decision is made with the goal of creating an empowering and frustration-free environment that adapts to the user, not the other way around.

4. Therapeutic Engagement: Gamified Cognitive Stimulation

To support mental stimulation, Harmonia includes a suite of memory games framed as Gamified Cognitive Stimulation Therapy. Unlike generic brain-training apps, these games are personalized to be more effective and emotionally resonant.

  • Personalization Engine: The games integrate familiar faces, names, and memories sourced directly from the user's family profiles and digital journal. This approach is designed to trigger positive autobiographical memories and strengthen personal connections.
  • Adaptive Difficulty: The cognitive exercises are designed to be engaging but not stressful, with difficulty levels that can be adjusted to match the user's current cognitive state.
  • Goal: The primary objective is not to "test" the user but to provide gentle, enjoyable stimulation that supports cognitive function and emotional well-being.

5. Context-Aware Safety: An Intelligent, Unobtrusive Net

A key challenge in Alzheimer's care is balancing independence with safety. Harmonia's emergency features are designed to act as an Intelligent Safety Net that operates unobtrusively in the background.

  • Geofence Alerts: The system establishes a virtual "safe zone" (e.g., 100m radius from home). If the user moves beyond this boundary, a notification is automatically sent to pre-selected caregivers. This feature allows patients the freedom of movement within a familiar environment while providing caregivers with peace of mind.
  • Emergency SOS: A prominent, easily accessible SOS button allows the user to instantly contact trusted individuals in an emergency. This feature works offline and uses the device's native calling/messaging capabilities.

These features are designed to be a safety net, not a surveillance tool, thereby preserving the user's sense of autonomy.

6. System Architecture & Technical Specifications

Core Framework

  • Platform: Flutter (Dart)
  • Target: Android (APK)
  • Timezone: Configured for Tunisia (Africa/Tunis) for context-aware reminders.

Data Architecture: Local-First CSV Storage

  • Profile Data: profile.csv
  • Journal Entries: journal_entries.csv
  • Emergency Contacts: emergency.txt
  • Media: Profile images (.jpg) and audio recordings (.m4a) stored in the local app directory.
  • Preferences: App settings managed via shared_preferences.

Key Dependencies

  • shared_preferences: Manages app preferences and settings.
  • path_provider: Provides access to the local file system for data storage.
  • csv: Handles parsing and generation of CSV files.
  • url_launcher: Integrates with external email clients for support.
  • timezone: Ensures accurate, location-aware notifications.

7. Future Research Potential

Harmonia is not just an application but a platform for future research in digital health and assistive technologies. Potential research directions include:

  • AI-Driven Mood Analysis: The digital journal's voice logs are a rich source of unstructured data. Future work could involve developing on-device machine learning models to perform sentiment analysis, identifying patterns in mood and emotional well-being that could provide early warnings of depression or distress.
  • Wandering Behavior Pattern Recognition: By analyzing anonymized geofence alert data over time, it may be possible to identify patterns that precede wandering events. This could lead to proactive, rather than reactive, safety interventions.
  • Longitudinal Studies: The app could be used to conduct longitudinal studies on the impact of gamified cognitive therapy on the rate of cognitive decline, using data that is ethically sourced and user-owned.

8. Development & Implementation

Project Structure

lib/
├── main.dart                          # App entry point with notification setup
├── pages/
│   ├── welcome_page.dart             # Welcome screen
│   ├── onboarding_page.dart          # First-time user setup
│   ├── home_page.dart                # Main dashboard
│   └── content/
│       ├── reminders_page.dart       # Medication & task reminders
│       ├── journal_page.dart         # Daily mood & memory journal
│       ├── profiles_page.dart        # Family member profiles
│       ├── games_page.dart           # Memory exercises
│       └── settings/                 # Configuration pages
└── services/
    └── hourly_notification_service.dart # Background notification system

Setup

  1. Clone the repository.
  2. Run flutter pub get to install dependencies.
  3. Connect an Android device or start an emulator.
  4. Run flutter run to launch the app.

9. Installation

The application can be installed directly via the provided APK file.

  1. Download: Download APK
  2. Enable Installation: On your Android device, go to Settings → Security and enable "Install unknown apps."
  3. Install: Open the downloaded APK file and follow the on-screen prompts.

10. Development Team

  • Adem Youssfi - Team Leader and Developer
  • Chaima Dhouibi - Designer and Developer
  • Ayhem Belhassen - Developer and Tester

11. Contact & Collaboration

For technical inquiries, support, or research collaboration proposals, please contact us via email:

12. License

© 2025 Harmonia Development Team. All rights reserved. This project is proprietary and not licensed for distribution or modification without explicit permission.


Built with a commitment to ethical technology for families affected by Alzheimer's.

About

An AI-powered assistive platform designed for Alzheimer's patients and their caregivers. Featuring cognitive support tools, real-time monitoring, and an intuitive UI to enhance daily living and safety through integrated intelligent services.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages