How devil-thirupu/healthmate-ai works
HealthMate AI is a personal health-record vault and clinical document assistant. Patients authenticate, upload and review records, then use structured health insights and evidence-grounded assistance to prepare for care or share selected records. The graph also preserves nutrition, reminders, audit, and doctor-connection capabilities. Source excerpts establish app routing, authentication, startup, and storage behavior; several feature modules were not sampled, so their internal call paths are not inferred.
Main entry points: App.jsx Web application · AuthContext.jsx Authentication UI · documents.py Document ingestion · hybrid_rag_service.py Hybrid RAG
Components 25
Patient experience
- Web application
frontend/src/App.jsx - Authentication UI
frontend/src/context/AuthContext.jsx - API client
frontend/src/services/api.js - Records and reports
frontend/src/pages/MedicalRecordsPage.jsx - AI assistant
frontend/src/pages/AIAssistantPage.jsx
Records and intelligence
- Document ingestion
backend/app/api/documents.py - Secure file storage
backend/app/services/storage_service.py - Private cloud storage
backend/app/services/supabase_storage_service.py - Multi-tier OCR
backend/app/services/ocr_service.py - Clinical extraction
backend/app/services/clinical_extractor.py - Health intelligence
backend/app/services/health_intelligence_service.py - Hybrid RAG
backend/app/services/hybrid_rag_service.py - Evidence guard
backend/app/services/evidence_guard_service.py
Care planning
- Nutrition intelligence
backend/app/services/nutrition_service.py - Appointment preparation
backend/app/services/appointment_summary_service.py - Trilingual explanations
backend/app/services/multilingual_explanation_service.py - Medication reminders
backend/app/services/reminder_service.py - Doctor connections
frontend/src/pages/MyDoctorsPage.jsx
Privacy and access
- Patient-controlled sharing
backend/app/api/sharing.py - Audit logging
backend/app/services/audit_service.py - Authentication API
backend/app/api/auth.py
Application platform
- FastAPI application
backend/app/main.py - API routes
backend/app/api/api_router.py - Health record database
backend/app/core/database.py
Other components
- Patient
Connections 26
- Patient → Web application: uses
frontend/src/App.jsx - Web application → Authentication UI: provides auth
frontend/src/App.jsx - Web application → Records and reports: routes to
frontend/src/App.jsx - Web application → AI assistant: routes to
frontend/src/App.jsx - Authentication UI → API client: calls
frontend/src/context/AuthContext.jsx - Authentication UI → Authentication API: authenticates via
- Records and reports → Document ingestion: uploads records
- Document ingestion → Secure file storage: stores files
- Secure file storage → Private cloud storage: mirrors files
backend/app/services/storage_service.py - Document ingestion → Multi-tier OCR: processes documents
- Multi-tier OCR → Clinical extraction: extracts clinical data
- Clinical extraction → Health intelligence: informs insights
- AI assistant → API client: queries
- API client → Hybrid RAG: requests answers
- Hybrid RAG → Evidence guard: guards responses
backend/app/services/hybrid_rag_service.py - Hybrid RAG → Trilingual explanations: formats explanations
backend/app/services/hybrid_rag_service.py - Patient → Nutrition intelligence: explores nutrition
- Patient → Appointment preparation: prepares visit
- Patient → Patient-controlled sharing: controls sharing
- Patient → Audit logging: reviews activity
- Patient → Medication reminders: uses reminders
- Patient → Doctor connections: connects doctors
- FastAPI application → API routes: mounts routes
backend/app/main.py - FastAPI application → Health record database: initializes schema
backend/app/main.py - Authentication API → Health record database: queries users
backend/app/api/auth.py - Authentication API → Audit logging: records activity
backend/app/api/auth.py