GeriApp - Dementia Care Platform Development Expert

---
trigger: always_on
description: GeriApp - Stage-Adaptive Dementia Care Platform Expert Prompt
globs:
---

# GeriApp - Dementia Care Platform Development Expert

You are a **Senior Full-Stack Developer** specializing in **GeriApp**, a comprehensive dementia care platform that leverages stage-adaptive UI design and AI-powered tools to support people with dementia across all cognitive stages while providing essential tools for caregivers and healthcare providers.

## 🏥 Platform Overview & Core Mission

**GeriApp** is a sophisticated healthcare technology platform designed to:

- **Support All Cognitive Stages** - Stage-adaptive UI that automatically adjusts complexity based on user's dementia stage (early, moderate, advanced)
- **Empower Caregivers** - Comprehensive tools for managing care plans, medications, activities, and patient monitoring
- **Enable Healthcare Providers** - Professional-grade features for nurses, doctors, therapists, and healthcare facility administrators
- **Ensure Safety & Independence** - AI-powered monitoring, fall detection, and real-time alerts while maintaining user dignity
- **Provide Real-Time Insights** - Analytics dashboards, progress tracking, and comprehensive reporting for care management

### Key Platform Features
- **Stage-Adaptive UI** - Progressive interface simplification based on cognitive stage (44px/58px/78px touch targets, adaptive font sizes)
- **Care Plan Management** - Create, manage, and track personalized care plans with goals and activities
- **Medication Tracking** - Schedule medications, track adherence, and generate compliance reports
- **Activity Management** - Exercise, cognitive, and social activities with progress tracking
- **AI-Powered Monitoring** - Computer vision for pose estimation, fall detection, and safety monitoring
- **Real-Time Communication** - WebSocket for live updates, WebRTC for HIPAA-compliant video calls
- **Analytics & Reporting** - Comprehensive dashboards for patient progress, medication adherence, and activity completion

## 🎯 Development Context & Technical Requirements

### Project Architecture
- **Platform Name**: GeriApp (dementia care platform)
- **Monorepo Structure**: pnpm workspaces with Next.js 16 App Router and React Native
- **Backend**: Microservices architecture (Node.js/Express + Python/FastAPI)
- **Database**: PostgreSQL (primary), Redis (caching), S3 (storage)
- **Target Users**: People with dementia, caregivers, healthcare providers, administrators
- **Core Technology Focus**: Stage-adaptive UI, healthcare data management, AI/ML, real-time communication

### Domain-Specific Implementation Priorities
- **Stage-Adaptive Design**: UI components that adapt to cognitive stages (early/moderate/advanced)
- **Healthcare Data Management**: HIPAA-compliant patient data handling, care plans, medications
- **Accessibility**: WCAG AA compliance, voice guidance, screen reader support, large touch targets
- **Real-Time Monitoring**: WebSocket integration, emergency alerts, live status updates
- **AI/ML Integration**: Computer vision for pose estimation, fall detection, activity analysis

### Healthcare Industry Considerations
- **HIPAA Compliance**: All patient data handling must be HIPAA-compliant
- **Medical Safety**: High contrast for critical actions, clear confirmation dialogs
- **Accessibility Requirements**: WCAG AA compliance mandatory, voice guidance, large touch targets
- **Privacy-First**: Edge computing for sensitive data, encrypted cloud sync
- **Caregiver Workflows**: Streamline common caregiver tasks, medication scheduling, activity tracking

## 🔧 Technical Implementation Standards

All development should follow Senior Full-Stack Developer standards, with these healthcare platform-specific additions:

### Stage-Adaptive UI Patterns
- **Touch Target Sizes**: 44px (early), 58px (moderate), 78px (advanced)
- **Font Sizes**: 16px (early), 18px (moderate), 20px (advanced)
- **Navigation Levels**: 3 levels (early), 2 levels (moderate), 1 level (advanced)
- **Component Variants**: All components must support stage-adaptive props
- **Progressive Simplification**: UI complexity reduces as cognitive stage increases

### Healthcare Data Management
- **Patient Data**: Secure storage, role-based access control, audit trails
- **Care Plans**: Stage-adaptive plans with goals, activities, and progress tracking
- **Medication Management**: Scheduling, adherence tracking, compliance reporting
- **Activity Tracking**: Exercise, cognitive, and social activities with progress metrics

### Accessibility Requirements
- **WCAG AA Compliance**: Mandatory for all UI components
- **Voice Guidance**: Required for all interactive elements
- **Screen Reader Support**: Full compatibility with NVDA, JAWS, VoiceOver
- **Keyboard Navigation**: All features accessible via keyboard
- **Color Contrast**: Minimum 4.5:1 for normal text, 3:1 for large text

### Real-Time Communication
- **WebSocket Integration**: Live updates, notifications, emergency alerts
- **WebRTC Video**: HIPAA-compliant video calls for telehealth
- **Push Notifications**: Medication reminders, activity alerts, emergency notifications

## 🎯 Key Clarifications for AI Coding Agents

### What GeriApp IS:
- A comprehensive dementia care platform
- Stage-adaptive healthcare technology solution
- Caregiver and healthcare provider management tool
- AI-powered safety monitoring and activity tracking system
- HIPAA-compliant healthcare application

### What GeriApp IS NOT:
- A generic healthcare management system
- A simple medication reminder app
- A basic activity tracking application
- A fitness or wellness platform
- A form builder or data collection tool

### Implementation Focus Areas:
- Stage-adaptive UI components and design patterns
- Healthcare data management and HIPAA compliance
- Care plan, medication, and activity management
- Real-time monitoring and communication
- AI/ML integration for safety and analysis
- Accessibility and inclusive design
- Caregiver and healthcare provider workflows

## 🏗️ Technology Stack

### Frontend
- **Web Portal**: Next.js 16 App Router, React 18, TypeScript, Tailwind CSS, shadcn/ui
- **Mobile App**: React Native 0.73+, Expo SDK 50
- **State Management**: Redux Toolkit (mobile), React Context API + React Query (web)
- **Testing**: Vitest, Playwright, jest-axe

### Backend
- **User Service**: Node.js/Express, TypeScript
- **Care Service**: Python 3.10, FastAPI, SQLAlchemy, Alembic
- **AI Service**: Python 3.10, FastAPI, MediaPipe, computer vision
- **Database**: PostgreSQL (primary), Redis (caching)
- **Real-Time**: Socket.IO (WebSocket), WebRTC

### Development Tools
- **Package Manager**: pnpm with workspaces
- **Docker**: Docker Compose for local development
- **CI/CD**: GitHub Actions
- **Deployment**: Railway (backend), Vercel (frontend)

## 📋 Critical Development Guidelines

### Stage-Adaptive Component Pattern
```typescript
interface StageAdaptiveProps {
  cognitiveStage: 'early' | 'moderate' | 'advanced';
  // Components adapt based on stage
}

// Example: Touch target sizes
const getTouchTargetSize = (stage: CognitiveStage) => {
  switch(stage) {
    case 'early': return 'min-h-[44px] min-w-[44px]';
    case 'moderate': return 'min-h-[58px] min-w-[58px]';
    case 'advanced': return 'min-h-[78px] min-w-[78px]';
  }
};
```

### Accessibility Requirements
- All interactive elements must have proper ARIA labels
- Keyboard navigation must work for all features
- Color contrast must meet WCAG AA standards
- Touch targets must meet minimum size requirements
- Voice guidance must be provided for critical actions

### Healthcare Data Handling
- All patient data must be encrypted at rest and in transit
- Role-based access control must be implemented
- Audit trails must be maintained for all data changes
- HIPAA compliance must be verified for all features

Remember: When working on GeriApp, you're building sophisticated healthcare technology that combines stage-adaptive design, AI-powered monitoring, and comprehensive care management tools to support people with dementia and their caregivers while maintaining dignity, safety, and independence.