Skip to content

README.md

Latest commit

 

History

History
49 lines (33 loc) · 3.42 KB

README.md

File metadata and controls

49 lines (33 loc) · 3.42 KB

MediTrack

Chronic Medication Adherence & Care Coordination Application

MediTrack is a production-grade, highly secure, and mobile-responsive application built to address the critical challenges of medication non-adherence in patients managing chronic illnesses. Designed with accessibility in mind, the platform serves as a vital bridge between patients, family caregivers, and healthcare providers.

🎯 Purpose & Problem Statement

Over 50% of chronic disease patients miss medication doses, resulting in preventable health complications, higher hospitalization rates, and delayed clinical interventions. Existing solutions like standard phone alarms or physical pillboxes fail to keep caregivers informed or provide actionable data to doctors.

MediTrack provides an automated, intelligent ecosystem that ensures patients take the right medication at the right time, alerts family caregivers instantly if an essential dose is missed, and compiles structured adherence history reports for medical teams.

🚀 Main Features

1. Unified Patient Dashboard

  • Dynamic Checklist: A clean, high-contrast, daily interactive task list displaying medications scheduled for the current day.
  • Live Progress Indicators: Radial tracking graphics illustrating real-time daily adherence success.

2. Medication Scheduling Engine

  • Granular Trackers: Add, archive, or modify medications with comprehensive metadata including name, exact dosage, custom time frequencies, and tracking inventory fields.

3. Real-Time Telemetry & Tracking

  • Response Mechanisms: Interactive options allowing users to log active doses explicitly as "Taken", "Skipped", or "Snooze".
  • Time-Stamped Audits: Automatically appends precise metadata timestamps to every telemetry event for historical validation.

4. Caregiver Network Integration

  • Secure Invitations: Handles account handshake requests using a dedicated invitation status framework (pending, accepted).
  • Escalated Missed-Dose Alerts: Triggers notifications to verified family accounts if a patient fails to check off an emergency medication.

5. Automated Inventory Analytics

  • Refill Optimization: Calculates internal capsule depletion based on tracked ingestion logs and alerts users when inventory falls below a 7-day threshold.
  • Qualitative Health Logs: Tracks qualitative context entries, such as specific side effects experienced alongside standard time logs.

💻 Technology Stack

  • Frontend Interface Environment: * React (with TypeScript): Powers the modular component ecosystem, typing consistency, and user routing.

    • Tailwind CSS: Utilized to implement responsive layout states, high visual contrast components, and smooth interface adjustments.
    • Lovable Platform: Leveraged for advanced UI layouts, component skeletons, and agile front-to-back prototyping.

  • Backend Infrastructure & Database Engine:

    • Supabase Engine: Functions as the centralized BaaS tier handling structured relational tables.
    • PostgreSQL: Handles relational integrity, executing cascading lookups, and enforcing foreign key relationships between tables (profiles, medications, dose_logs, caregiver_links).
    • Supabase Authentication: Restricts platform entry via integrated secure user registration schemes.
    • Row Level Security (RLS): Secures personal healthcare data directly within the database engine (