Skip to content

nova728/Healthcare-APP

BranchesTags

Repository files navigation

Health Guardian - Elderly Health Management Platform

Android Kotlin Jetpack Compose Material Design Gradle Gemini

English | 简体中文

Project Overview

Health Guardian App is an extension of the Holographic Safety Guardian project, designed to provide convenient health data management and intelligent health consultation services for the elderly. Through modern UI design and intelligent AI technology, health management becomes simple and intuitive.

Key Features

  • Secure User System: Local account management based on Room database, supporting account registration, login verification, and password encryption storage.

  • AI Health Assistant: Integrated Google Gemini API with text and image recognition, providing intelligent health consultation services.

  • Data Visualization: Real-time heart rate monitoring and multi-dimensional health data display using Vico chart library.

  • Voice Message Board: Support voice/text recording with convenient health diary function and secure local data storage.

Quick Start

Requirements

  • Android Device: Android 6.0 (API 26) and above
  • Development Environment: Android Studio Iguana 2023.2.1+
  • Build Tools: Gradle 8.4
  • Programming Language: Kotlin
  • UI Framework: Jetpack Compose

Installation

Method 1: Direct APK Installation (Recommended for Users)

For Android Devices:

  1. Download the APK

    • Download app-debug.apk from the project root directory

  2. Enable Installation from Unknown Sources

    • Go to Settings → Security → Enable Unknown Sources
    • Or for newer Android versions: Settings → Apps → Special Access → Install Unknown Apps → Select your browser/file manager → Allow

  3. Install the APK

    • Open the downloaded APK file
    • Tap Install and wait for the installation to complete
    • Tap Open to launch the app

Using ADB (for developers):

# Connect your device via USB with USB debugging enabled
# Install the APK using ADB
adb install app-debug.apk

# If you get "INSTALL_FAILED_UPDATE_INCOMPATIBLE" error, uninstall first
adb uninstall com.example.myapp
adb install app-debug.apk

Method 2: Build from Source (For Developers)

Prerequisites:

  • Android Studio Iguana (2023.2.1) or later
  • JDK 17 or later
  • Android SDK with API 26+
  • Gradle 8.4

Steps:

# 1. Clone the repository
git clone https://github.com/nova728/Healthcare-APP.git
cd Healthcare-APP

# 2. Open project in Android Studio
# File → Open → Select the Healthcare-APP folder

# 3. Sync Gradle dependencies
# Android Studio will automatically prompt to sync

# 4. Build the APK
./gradlew assembleDebug
# APK will be generated at: app/build/outputs/apk/debug/app-debug.apk

# 5. Install on connected device
./gradlew installDebug

# Or run directly from Android Studio
# Click the "Run" button (green triangle) or press Shift+F10

Build Release APK:

./gradlew assembleRelease
# Release APK at: app/build/outputs/apk/release/app-release.apk

Project Architecture

app/
├── data/                    # Data processing layer
│   ├── chat/               # Chatbot data
│   ├── health/             # Health data
│   └── user/               # User data
├── database/               # Database layer
│   ├── module/             # Data entities and interfaces
│   ├── AppDatabase.kt      # Database configuration
│   └── repositories/       # Data repositories
├── domain/                 # Business logic layer
│   ├── audio/              # Audio processing
│   └── recording/          # Recording logic
├── presentation/           # Presentation layer
│   ├── component/          # UI components
│   ├── viewmodel/          # View models
│   └── screen/             # Screen layouts
├── services/               # Service layer
└── utils/                  # Utility classes

Tech Stack

Jetpack Compose
Jetpack Compose
UI Framework 		Room
Room Database
Local Storage 		Gemini
Gemini API
AI Conversation
Material Design 3
Material Design 3
Design System 		Coroutines
Coroutines
Async Processing 		Vico
Vico Charts
Data Visualization

Feature Showcase

1. User Authentication System

Login & Registration

  • Account password verification mechanism
  • Room database local storage
  • Password matching detection
  • Error feedback prompts
  • Secure password encryption

First Time Setup:

  1. Launch the app
  2. Tap "Register" to create a new account
  3. Enter username, password, and confirm password
  4. Tap "Sign Up" to complete registration
  5. Use your credentials to login

2. Personal Information Management

Editable Information

  • User avatar (with permission request + real-time sync)
  • Nickname modification
  • Address information
  • Phone number display
  • Profile customization

How to Update Profile:

  1. Navigate to "Profile" section
  2. Tap on any field to edit
  3. For avatar: Tap avatar icon → Select from gallery → Grant storage permission
  4. Changes are saved automatically to local database

3. AI Health Consultation (Gemini)

Features

  • Natural language health Q&A
  • Image recognition and analysis (upload medical reports, pills, etc.)
  • Health data interpretation
  • Personalized health recommendations
  • Requires network connection (VPN recommended for stable connection)

Usage Example

User: "Is this blood pressure reading normal?"
Gemini: "Based on your blood pressure data analysis..."

User: [Uploads image of medication]
Gemini: "This medication is used for..."

How to Use:

  1. Navigate to "AI Assistant" section
  2. Type your health question or tap camera icon to upload image
  3. Wait for Gemini to analyze and respond
  4. Chat history is saved locally

Network Requirement: Gemini API requires internet connection. If you experience connection issues, try using a VPN or check your network settings.

4. Health Data Recording

Heart Rate Monitoring

  • Real-time data addition
  • Daily change line chart visualization
  • Weekly average bar chart
  • Historical data details with timestamps
  • Intelligent status tips (low/normal/high)
  • Trend analysis

How to Add Heart Rate Data:

  1. Go to "Health Data" → "Heart Rate"
  2. Tap "+" button
  3. Enter your heart rate value (BPM)
  4. Data is automatically saved with timestamp
  5. View trends in chart format

Other Health Metrics

  • Temperature Recording: Track body temperature with fever detection
  • Blood Pressure Monitoring: Systolic and diastolic readings with status indicators
  • Blood Glucose Tracking: Pre/post-meal glucose levels
  • Step Counting: Daily activity tracking

5. Voice Message Board

Functions

  • Voice recording with high-quality audio
  • Text notes and memos
  • Local Room database storage
  • Health diary function
  • Timestamp for each entry
  • Easy search and filter

How to Create a Note:

  1. Navigate to "Message Board"
  2. Tap "+" to create new entry
  3. Choose "Voice" or "Text" mode
  4. Record your message or type notes
  5. Tap "Save" to store locally

Note: Current version is a standalone notepad function. Future updates will include cloud sync and family sharing features.

Technical Highlights

1. Modern UI Design

  • Built with Jetpack Compose declarative UI
  • Material Design 3 design language
  • Smooth animations and interactive experience
  • Responsive layout adaptation

2. Intelligent AI Integration

  • Google Gemini Pro model
  • Multimodal interaction (text + image)
  • Intelligent health data analysis

3. Data Visualization

  • Vico chart library
  • Real-time data updates
  • Multi-dimensional data display

4. Local Data Management

  • Room database persistence
  • Data security encryption
  • Offline functionality support

Development Notes

⚠️ Known Issues

1. Login Module

  • May crash in emulator environment
  • Normal on physical devices

2. Feature Limitations

  • Some functional modules are not fully implemented
  • Certain sections are not clickable yet

Future Improvements

  • Complete all functional modules
  • Optimize emulator compatibility
  • Implement real mobile internet message board with family sharing
  • Add data synchronization functionality (cloud backup)
  • Enhance data analysis capabilities with AI insights
  • Multi-language support (Chinese, English, etc.)
  • Dark mode support
  • Export health reports as PDF
  • Integration with wearable devices
  • Medication reminder system
  • Emergency contact quick dial
  • Video call feature for telemedicine

Screenshots

Main Interface Preview

Login & Register Home AI Assistant
Login & Register Home AI Assistant
User login and registration Main navigation interface AI health consultation
Health Data Data Charts Profile
Health Data Data Charts Profile
Health data recording Data visualization charts Personal information

Contributing

We welcome contributions to improve the Health Guardian app! Here's how you can help:

Reporting Bugs

  1. Check if the bug has already been reported in Issues
  2. Create a new issue with detailed description
  3. Include screenshots and device information
  4. Specify steps to reproduce

Suggesting Features

  1. Open a new issue with the "Feature Request" label
  2. Describe the feature and its benefits
  3. Provide mockups or examples if possible

Pull Requests

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'add feature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Code Style

  • Follow Kotlin coding conventions
  • Use meaningful variable and function names
  • Add comments for complex logic
  • Write unit tests for new features

Contact

If you have questions or suggestions, feel free to reach out:

📄 License

This project is open source under the MIT License. See LICENSE file for details.

MIT License

Copyright (c) 2024 Shi Jialing

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

⭐ If this project helps you, please give it a Star! ⭐

Made with ❤️ for Elderly Health Management

Report Bug · Request Feature · Documentation

About

No description, website, or topics provided.

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages