System Requirements Document (SRD)

Project Name: mellow-medication

1. Introduction

mellow-medication is a smart monitoring and alert system designed to track patient medication adherence, detect missed or incorrect doses, and provide timely reminders and reports to prevent silent treatment failure. This project aims to address the critical issue of medication adherence, which is essential for successful treatment outcomes, especially for chronic diseases.

This document outlines the system requirements for the mellow-medication project, which will be developed using Django REST Framework for the backend and React.js for the frontend. The solution will feature a professional and modern UI, ensuring ease of use and scalability for long-term treatments.

2. System Overview

The mellow-medication system will consist of the following components:

• Backend: Built using Django REST Framework, the backend will handle APIs for medication schedules, adherence tracking, reminders, and reporting.
• Frontend: Developed using React.js, the frontend will provide a professional and modern user interface for patients, caregivers, and healthcare providers.
• Core Features: Medication schedule management, adherence tracking, automated reminders, non-adherence pattern analysis, and reporting dashboards.
• Datasets: Integration of synthetic datasets like MIMIC-III and MEMS sample data for adherence pattern analysis.

The system will be scalable, secure, and optimized for chronic and long-term treatments.

3. Functional Requirements

As User:

• As User, I should be able to create and manage my medication schedule.
• As User, I should be able to receive automated reminders for my medication.
• As User, I should be able to view my adherence score and compliance history.
• As User, I should be able to log missed or incorrect doses.

As Admin:

• As Admin, I should be able to monitor patient adherence data.
• As Admin, I should be able to generate reports for caregivers or doctors.
• As Admin, I should be able to analyze non-adherence patterns across multiple patients.

As Caregiver:

• As Caregiver, I should be able to view reports and dashboards for patients under my supervision.
• As Caregiver, I should be able to receive alerts for critical non-adherence events.

4. User Personas

1. Patient (User)

• Description: Individuals managing their medication schedules and adherence.
• Needs: Easy-to-use interface, timely reminders, adherence tracking, and compliance history.

2. Caregiver

• Description: Family members or healthcare providers monitoring patient adherence.
• Needs: Access to reports, dashboards, and alerts for critical non-adherence events.

3. Admin

• Description: System administrators managing patient data and generating insights.
• Needs: Tools for monitoring adherence data, generating reports, and analyzing patterns.

5. Visuals Colors and Theme

Unique Color Palette:

• Background: #F4F9F9 (Soft Mint Green)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Dark Charcoal Gray)
• Accent: #FF6F61 (Warm Coral Red)
• Muted Tones: #B0BEC5 (Cool Gray Blue)

Theme Direction:

The theme will be clean, professional, and calming, reflecting the healthcare domain. The use of soft greens and warm accents will create a sense of trust and reliability.

6. Signature Design Concept

Interactive Medication Timeline

The homepage will feature an Interactive Medication Timeline that visually represents the user's medication schedule.

• Design:

  • A horizontal timeline with animated pills or capsules representing medication doses.
  • Each pill will change color based on adherence status (e.g., green for taken, red for missed).
  • Hovering over a pill will display details like medication name, dosage, and time.

• Animations:

  • Smooth transitions when scrolling through the timeline.
  • Pills will "pop" slightly when hovered over, creating a tactile feel.

• Micro-Interactions:

  • Clicking on a pill will allow users to log adherence or missed doses.
  • Alerts will appear as subtle notifications on the timeline for missed doses.

This bold and engaging design will make the homepage instantly fascinating and user-friendly, encouraging interaction and adherence.

7. Non-Functional Requirements

• Scalability: The system must handle large datasets and multiple users simultaneously.
• Security: Ensure data encryption and secure authentication mechanisms.
• Performance: The system should respond to user actions within 2 seconds.
• Accessibility: The UI must be accessible to users with disabilities (e.g., WCAG compliance).
• Localization: Support for Indian locale defaults (e.g., IST timezone, INR currency).

8. Tech Stack

Frontend:

• React.js

Backend:

• Django REST Framework

Database:

• MySQL (preferred for relational data)
• MongoDB (for non-relational data)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work

AI Tools:

• Langchain
• Litellm for LLM Routing

Orchestration:

• Docker and docker-compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

• Assumptions:

  • Patients will actively log their medication adherence.
  • Caregivers will regularly monitor dashboards and reports.

• Constraints:

  • The system must comply with healthcare data regulations (e.g., HIPAA).
  • Limited internet connectivity in rural areas may impact real-time alerts.

10. Glossary

• Adherence: The degree to which a patient follows their prescribed medication schedule.
• Compliance Score: A metric representing how well a patient adheres to their medication schedule.
• Dashboard: A visual interface for monitoring and analyzing data.
• MIMIC-III: A synthetic dataset containing electronic health records for research purposes.
• MEMS: Medication Event Monitoring System, a tool for tracking medication intake.

This document provides a comprehensive overview of the mellow-medication project, ensuring clarity and alignment for development and deployment. Let me know if you'd like further refinements or additional details, Kirtan!