Skip to content

Latest commit

Β 

History

277 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SentinelPH Logo

HealthWatch Mobile App: Community Intelligence Network for Early Outbreak Detection

React React Native TypeScript Vite Firebase NativeWind Cloudinary n8n

Login Screen Home Screen Report Screen Map Screen QR Screen


🎯 Problem Statement

The Philippines has no shortage of health dataβ€”it has a shortage of the right data at the right time. The current approach to outbreak detection is reactive, seeing outbreaks only after hospital admissions spikeβ€”when it's already too late for prevention. Communities themselvesβ€”the people who notice the first fever, the first child with diarrhea, the first neighbor who looks sickβ€”have no structured way to share what they see.

Current System Inefficiencies:

  • Manual Reporting Delays - Paper-based reports take weeks to process and reach health authorities
  • Health Center Bottlenecks - Long waiting times during outbreak investigations while cases multiply
  • Repetitive Data Collection - BHWs repeatedly ask the same questions during health visits, wasting valuable time
  • Information Silos - Resident health histories scattered across different systems with no centralized access
  • Delayed Response - Critical time lost between symptom onset and official health response

πŸ’‘ Solution

Healthwatch builds a community intelligence network that trains everyday Filipinosβ€”sari-sari store owners, tricycle drivers, market vendors, traditional hilots, and religious leadersβ€”to become the first line of outbreak detection in their neighborhoods. Each resident receives a unique QR code that health workers, partner clinics, and authorized healthcare providers can scan to instantly access complete health profiles, self-reported symptoms, verified health trends, and real-time pattern analysisβ€”transforming weeks of manual processing into seconds of digital intelligence with built-in safeguards that separate genuine signals from noise and misinformation.

Digital QR Health Passport: When residents visit potential healthcare partners (clinics, hospitals, pharmacies), their QR code provides instant access to their health dataβ€”eliminating repetitive questioning and enabling faster, more informed medical responses.

πŸ‘₯ Target Users

Primary Users (Community Sentinels):

  • Sari-Sari Store Owners & Market Vendors
  • Tricycle Drivers & PUV Operators
  • Barangay Tanods & Leaders
  • Religious Leaders & Church Workers
  • Traditional Healers & Hilots
  • Barangay Health Workers (BHWs)

Beneficiaries:

  • Entire Communities (faster detection = faster response)
  • Vulnerable Populations (elderly, children, pregnant women, PWDs)
  • Municipal & Provincial Health Officers
  • Department of Health & Epidemiologists

πŸ“± MVP Core Features (Mobile App)

The initial release of the SentinelPH mobile app focuses on providing a seamless and intuitive experience for community sentinels. The app is built as a Progressive Web App (PWA) for easy access and low-bandwidth resilience.

For Community Sentinels (Mobile App)

The app is designed around five core tabs, making navigation simple and intuitive:

🏠 Home Screen

  • Displays a personalized health summary and the user's current status
  • Provides a quick overview of recent activity and key health metrics for the user's household
  • Quick-access buttons for reporting and viewing history

βž• Report Symptom

  • A dedicated, easy-to-use form for quickly reporting health observations
  • Users can specify if the report is for themself or an observation of someone in the community
  • Captures key symptoms and basic location data to fuel the intelligence network
  • Offline-capable with auto-sync when connectivity returns

πŸ“œ Report History

  • A complete, chronological log of all symptoms and observations the user has previously reported
  • Allows users to track their own and their family's health trends over time
  • Serves as a personal health record that can be referenced during healthcare visits
  • Filterable by date, symptom type, and household member

πŸ“’ Announcements

  • A real-time information feed for receiving critical updates
  • Displays live announcements and outbreak alerts broadcast by Barangay Health Workers (BHWs)
  • Includes a directory of BHWs with direct hotlines and emergency contacts
  • Delivers push notifications for urgent health advisories

πŸ—ΊοΈ Public Map

  • An interactive, anonymized community intelligence tool
  • Shows a geographic visualization of recently verified reports in the area
  • Helps users see what symptoms are circulating in their community, promoting awareness and early precaution
  • Uses clustering to show the density of observations without compromising individual privacy
  • Color-coded heat layers for different symptom categories

πŸ“± QR Code Scanner

  • Scan QR codes for instant health profile access
  • View verified health information of family members
  • Share health data securely with healthcare providers
  • Quick check-in at partner clinics and pharmacies

πŸ₯ For Barangay Health Workers (BHW Dashboard)

To support the sentinel network, BHWs have access to a powerful web dashboard for managing and responding to community intelligence.

  • Sentinel Management - Approve or reject community sentinel applications
  • Real-time Observations - Live monitoring of incoming reports with trend analysis
  • QR Code Scanner - Scan a resident's QR code for instant access to their health profile and history
  • Interactive Mapping - Real-time outbreak visualization to identify emerging clusters
  • Community Announcements - Broadcast health advisories and alerts to residents in their jurisdiction

✨ Key Innovations

  • πŸ“± Mobile-First PWA - Works offline and is optimized for low-bandwidth environments
  • πŸ”’ AI-Powered Trust Scoring - Validates sentinel reliability (0-100 score) to filter noise
  • βœ… 3-Sentinel Rule - Requires multi-source validation from unrelated observers before triggering alerts
  • πŸ—ΊοΈ Observation Heatmaps - Real-time geographic clustering to visualize disease spread
  • πŸ”„ Two-Way Feedback Loop - Communities receive acknowledgments and advisories, closing the communication loop
  • πŸ›‘οΈ Multi-Layered Spam Prevention - Employs rate limiting, behavior monitoring, and AI filtering
  • 🎯 Proximal Intelligence - Catches outbreaks at the pre-clinic stage by tapping into community observations
  • πŸ† Incentive System - Motivates participation through load credits, recognition badges, and community rankings

πŸ—οΈ Tech Stack

Frontend:

  • React 18.3 + TypeScript 5.6
  • Vite 6.0
  • Tailwind CSS + Framer Motion
  • Progressive Web App (PWA)
  • Axios for HTTP requests

Backend & Database:

  • Firebase (Authentication, Firestore, Cloud Functions, Hosting)
  • Real-time data synchronization

AI/ML Components:

  • Trust Score Engine
  • DBSCAN Spatial Clustering
  • NLP for observation categorization (GPT API)
  • Anomaly Detection & Spam Classification

Integrations:

  • Google Maps API (observation heatmaps)
  • Twilio API (SMS alerts)
  • Cloudinary (Image upload & management)
  • Telecom partnerships (for load credit incentives)

πŸ“‚ Project Structure

Sentinel-PH-App/
β”œβ”€β”€ @types/                    # TypeScript type definitions
β”œβ”€β”€ assets/                    # Static assets
β”‚   β”œβ”€β”€ fonts/                # Custom fonts (Inter)
β”‚   └── logo/                 # App logo
β”œβ”€β”€ components/               # Reusable components
β”‚   β”œβ”€β”€ camera/              # Camera components
β”‚   β”‚   β”œβ”€β”€ IDScannerCamera.tsx
β”‚   β”‚   └── SelfieCamera.tsx
β”‚   β”œβ”€β”€ registration/        # Multi-step registration components
β”‚   β”‚   β”œβ”€β”€ PersonalDetailsStep.tsx
β”‚   β”‚   β”œβ”€β”€ DocumentVerificationStep.tsx
β”‚   β”‚   β”œβ”€β”€ CredentialsStep.tsx
β”‚   β”‚   β”œβ”€β”€ RegistrationModals.tsx
β”‚   β”‚   └── index.ts
β”‚   β”œβ”€β”€ screens/             # Screen components
β”‚   β”‚   └── SplashScreen.tsx
β”‚   └── ui/                  # UI components
β”‚       β”œβ”€β”€ Alert.tsx
β”‚       β”œβ”€β”€ Avatar.tsx
β”‚       β”œβ”€β”€ Badge.tsx
β”‚       β”œβ”€β”€ Button.tsx
β”‚       β”œβ”€β”€ Card.tsx
β”‚       β”œβ”€β”€ Checkbox.tsx
β”‚       β”œβ”€β”€ Divider.tsx
β”‚       β”œβ”€β”€ Input.tsx
β”‚       β”œβ”€β”€ Spinner.tsx
β”‚       β”œβ”€β”€ StepIndicator.tsx
β”‚       β”œβ”€β”€ Switch.tsx
β”‚       └── index.ts
β”œβ”€β”€ config/                   # Configuration files
β”‚   └── firebase.ts          # Firebase config
β”œβ”€β”€ constants/               # App constants
β”œβ”€β”€ context/                 # React context providers
β”‚   β”œβ”€β”€ AuthContext.tsx      # Authentication context
β”‚   └── index.ts
β”œβ”€β”€ hooks/                   # Custom React hooks
β”œβ”€β”€ lib/                     # Library integrations
β”‚   └── firebase.ts         # Firebase initialization
β”œβ”€β”€ navigation/              # Navigation setup
β”œβ”€β”€ screens/                 # App screens
β”‚   β”œβ”€β”€ LoginScreen.tsx
β”‚   β”œβ”€β”€ RegisterScreen.tsx
β”‚   β”œβ”€β”€ MultiStepRegisterScreen.tsx
β”‚   └── index.ts
β”œβ”€β”€ services/                # API services
β”œβ”€β”€ theme/                   # Theme configuration
β”œβ”€β”€ utils/                   # Utility functions
β”œβ”€β”€ App.tsx                  # Main app component
β”œβ”€β”€ app.json                 # Expo configuration
β”œβ”€β”€ tailwind.config.js       # TailwindCSS config
└── package.json             # Dependencies

πŸš€ Getting Started

Prerequisites

  • Node.js (v18+)
  • pnpm
  • A Firebase project

Installation

  1. Clone the repository:
git clone https://github.com/your-username/sentinelph.git
cd sentinelph
  1. Install frontend dependencies:
pnpm install
  1. Set up environment variables:
# Copy .env.example to .env
# Fill in your Firebase and other service credentials
  1. Run the development server:
pnpm run dev

πŸ’° Revenue Model

LGU & Health System Subscriptions (85%):

  • Barangay Plan: β‚±300/month (up to 20 sentinels)
  • Municipal Plan: β‚±1,500/month (unlimited sentinels, advanced analytics)
  • Provincial Plan: β‚±4,000/month (regional pattern detection, API access)

Partnerships & Services (15%):

  • Telecom partnerships (load credit revenue share)
  • NGO health program integration
  • Corporate CSR sponsorship
  • Training & certification services

🎨 Design System

Colors

  • Primary: #1B365D (Navy Blue)
  • Secondary: #20A0D8 (Sky Blue)
  • Background: #FFFFFF (White)

Typography

  • Font Family: Inter
    • Light (18pt)
    • Medium (18pt)
    • SemiBold (24pt)

πŸ“ Scripts

pnpm start          # Start development server
pnpm run dev        # Start development server
pnpm android        # Run on Android
pnpm ios            # Run on iOS
pnpm web            # Run on web
pnpm lint           # Lint code
pnpm format         # Format code with Prettier

About

HealthWatch is a mobile-first network that enables early outbreak detection by verifying local health observations in real time, transforming community data into actionable public health intelligence.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages