CLICK FOR FULLSCREEN INSPECTOR

OVERVIEW

ENTERPRISE ARCHITECTURESYS-ID: PROJ-MEDIMIND

SOURCE REPOSITORY

MediMind — Healthcare Management & Adherence Ecosystem

> Enterprise Intelligent Healthcare Platform — Flutter Mobile App + Next.js PWA, AWS ECS Fargate & Gemini AI Vision OCR

TECH STACK:FlutterNext.jsPWANode.jsMongoDBSocket.IODockerTerraformAWS ECS FargateGemini AI OCRStripe

EXECUTIVE OVERVIEW & PROBLEM STATEMENT

Non-adherence to chronic medication schedules remains a critical global healthcare challenge, causing preventable complications and hospitalizations. MediMind solves this by creating a connected digital health network bridging patients, family caregivers, clinical supervisors, and partner pharmacies. Combining automated dose calculations, multi-tiered background escalation workers, real-time WebSocket alerts, electronic prescription refill payments via Stripe, and optical character recognition powered by Google Gemini AI Vision OCR, MediMind converts complex prescription schedules into a simple, reliable adherence workflow.

CORE SYSTEM ARCHITECTURE & DESIGN PATTERNS

Cloud-native microservices architecture orchestrated via Docker Compose and 7 AWS Terraform modules, deploying containerized Node.js/Express services on AWS ECS Fargate with MongoDB/DocumentDB (12+ models), Redis caching, Socket.IO real-time channels, and external integrations with Stripe and Google Gemini AI.

Automated Optical Character Recognition (OCR) powered by Google Gemini AI Vision to extract drug names, dosages, and schedules directly from prescription labels.

Closed-loop multi-tiered escalation engine: Missed doses instantly alert linked family caregivers and escalate to SMS/push follow-ups.

5 distinct user roles governed by granular Role-Based Access Control (RBAC).

Partner Pharmacist order fulfillment stepper (SUBMITTED ➔ APPROVED ➔ DISPENSED ➔ READY ➔ COMPLETED) with integrated Stripe payments.

Provisioned on AWS ECS Fargate with ALB, VPC isolation, DocumentDB, and Redis using 7 modular Terraform IaC modules.

GRANULAR USER ROLE DOMAINS & RBAC PERMISSIONS (5 ROLES)

Patient DomainCORE ADHERENCE

Manages individual medication schedules, logs daily dose completions (TAKEN / SKIPPED / SNOOZED), tracks chronic health conditions, scans prescription bottles via Google Gemini AI Vision OCR, and requests pharmacy refill orders.

›Scan prescription labels with Gemini AI OCR

›Log daily doses (Taken, Skipped, Snoozed)

›Request pharmacy refill deliveries

›Track personal adherence calendar & vital signs

Family Caregiver DomainFAMILY MONITORING

Receives real-time missed dose alerts for linked family members, tracks adherence heatmaps, writes medical notes, and manages pharmacy refill payments via Stripe.

›Instant WebSocket alerts on missed doses

›Review adherence calendar & compliance history

›Pay for pharmacy refills with Stripe

›Log medical caregiver notes & observations

Professional Caregiver DomainCLINICAL OVERSIGHT

Manages assigned patient groups, logs verified clinical observations, monitors multi-tiered dose escalations, and receives high-priority SMS notifications.

›Monitor multi-tiered dose escalation queues

›Log clinical observations and verified status checks

›Receive high-priority SMS & push alerts

›Supervise cohorts of high-risk patients

Partner Pharmacist DomainPRESCRIPTION FULFILLMENT

Manages pharmacy profile settings, receives live refill orders, operates a 5-step order fulfillment stepper, and tracks stock inventory.

›5-step stepper: SUBMITTED ➔ APPROVED ➔ DISPENSED ➔ READY ➔ COMPLETED

›Manage store inventory & low-stock alerts

›Verify doctor prescription attachments

›Process pharmacy order pick-up and deliveries

System Administrator DomainPLATFORM GOVERNANCE

Governs system-wide security, approves pending professional registrations (Pharmacies, Caregivers), executes user account management, and monitors background worker queues.

›Approve professional caregiver & pharmacy licenses

›Monitor 4 recurring cron schedules & background queues

›Audit system-wide access logs & RBAC permissions

›Manage user accounts & platform configurations

KEY ENGINEERING CHALLENGES & ARCHITECTURAL SOLUTIONS

Automated Prescription Parsing with Gemini AI Vision

THE ENGINEERING PROBLEM

Manual medication entry is error-prone and daunting for elderly or non-tech-savvy patients.

ENGINEERED RESOLUTION

Integrated Google Gemini AI Vision OCR to parse complex prescription labels, automatically extracting drug brand, chemical compound, exact dosage, and recurring daily schedules with structured validation.

Closed-Loop Multi-Tiered Escalation Engine

THE ENGINEERING PROBLEM

Passive notifications are easily ignored by patients, leading to dangerous missed chronic medication doses.

ENGINEERED RESOLUTION

Engineered a 3-tier background escalation worker running across 4 recurring cron schedules and queues. If a dose is unconfirmed within the grace window, the system triggers real-time WebSocket alerts to caregivers, followed by SMS escalation.

Enterprise Cloud Architecture with Terraform

THE ENGINEERING PROBLEM

Deploying complex multi-role services securely with strict HIPAA-aligned isolation and scalable containerization.

ENGINEERED RESOLUTION

Authored 7 AWS Terraform modules provisioning VPC with private subnets, ALB, ECS Fargate services, AWS DocumentDB, Redis cluster, AWS SES, and AWS S3 with encrypted object storage.

PLATFORM SCALE & PRODUCTION METRICS

Backend REST Endpoints30+ Routes

User Roles Supported5 Distinct Roles (RBAC)

Database Models12+ Mongoose Collections

Background Jobs4 Recurring Cron Queues

WebSocket Channels5+ Bidirectional Events

External Services4 (Gemini AI, Stripe, SES, S3)

Terraform Modules7 AWS IaC Modules

Docker Containers5 Orchestrated Services