System Requirements Document (SRD) for Jolly-Healthcare

1. Introduction

Welcome to the System Requirements Document (SRD) for Jolly-Healthcare, a modern, AI-integrated medical image diagnosis platform designed to support both doctors and patients. This document outlines the functional and non-functional requirements, user personas, design concepts, and technical specifications for the development of the platform.

Jolly-Healthcare aims to provide a secure, scalable, and intuitive solution for medical diagnostics, ensuring trust, usability, and accessibility for users in India and beyond. The platform will leverage cutting-edge AI capabilities to enhance diagnostic workflows while maintaining the highest standards of data security and user experience.

2. System Overview

Jolly-Healthcare is a web-based application that facilitates seamless interaction between doctors and patients for medical image diagnosis. The platform will include:

• Role-based Dashboards: Separate interfaces for doctors and patients with tailored functionality.
• AI Integration: Advanced AI capabilities for image/report-based record retrieval and diagnostic suggestions.
• Secure Authentication: Role-specific login, logout, and sign-up flows.
• Medical Image and Report Management: Patients can upload, preview, and track medical images and reports, while doctors can analyze and annotate them.
• Communication Tools: Secure messaging between patients and their assigned doctors.
• Hybrid Role Management: Admin-assigned doctor-patient relationships initially, with later support for patient-selected doctors and doctor acceptance/rejection of requests.

The system will be API-ready, responsive across devices, and built with a focus on security, scalability, and user-centric design.

3. Functional Requirements

As User:

• I should be able to register, log in, and securely manage my account.
• I should be able to upload medical images (X-rays, MRI, CT scans) and reports (PDF, images).
• I should be able to preview uploaded files before submission.
• I should be able to view my diagnosis results and track my medical history.
• I should be able to communicate with my assigned doctor.

As Doctor:

• I should be able to log in and access my dashboard to view assigned patient cases.
• I should be able to analyze uploaded medical images and reports.
• I should be able to add diagnosis notes and manage patient records.
• I should be able to accept or reject patient requests for consultation.

As Admin:

• I should be able to assign doctors to patients for structured onboarding.

AI-Specific Features:

• As User, I should be able to log in using an uploaded image or report to retrieve associated records.
• As Doctor, I should be able to view AI-assisted diagnostic suggestions for uploaded images/reports, clearly marked as supportive insights.

4. User Personas

1. Patient

• Description: Individuals seeking medical diagnosis and consultation.
• Key Actions: Register, upload medical images/reports, view diagnosis results, track history, communicate with doctors.

2. Doctor

• Description: Medical professionals analyzing patient cases and providing diagnoses.
• Key Actions: Log in, view assigned cases, analyze images/reports, add notes, manage patient records, accept/reject patient requests.

3. Admin

• Description: System administrators managing user roles and assignments.
• Key Actions: Assign doctors to patients, oversee platform operations.

5. Visuals Colors and Theme

Color Palette:

• Background: #F8F9FA (soft white for a clean, healthcare-friendly look)
• Surface: #FFFFFF (pure white for cards and modals)
• Text: #333333 (dark gray for readability)
• Accent: #007BFF (calming blue for interactive elements like buttons and links)
• Muted: #6C757D (subtle gray for secondary text and icons)

Theme:

The theme will emphasize clarity, trust, and professionalism, with a clean layout, ample white space, and intuitive navigation.

6. Signature Design Concept

Interactive Medical Dashboard with AI-Driven Insights

The homepage will feature an interactive medical dashboard that immediately immerses users in the platform's capabilities. Key elements include:

• Dynamic AI Visualization: A rotating 3D medical model (e.g., a human body or organ system) that highlights areas based on uploaded images/reports. For example, if a patient uploads a chest X-ray, the model will zoom into the chest area, visually linking the uploaded file to the diagnostic process.
• AI Insights Panel: A side panel displaying AI-generated suggestions in real-time, with clear disclaimers that these are supportive insights for doctors to review.
• Seamless Transitions: Smooth animations as users navigate between sections, such as file uploads, diagnosis results, and communication tools.
• Micro-Interactions: Subtle feedback on user actions, like button clicks, file uploads, and progress indicators.

This design will create a memorable first impression, showcasing the platform's innovation and user-centric approach.

7. Non-Functional Requirements

• Security: Implement JWT for secure authentication and encrypted file uploads.
• Scalability: Support concurrent users with scalable backend architecture.
• Accessibility: Ensure WCAG 2.1 compliance for all user interfaces.
• Performance: Optimize for fast load times and responsive interactions.
• Localization: Default to Indian locale settings (e.g., date formats, time zones).

8. Tech Stack

Frontend:

• React for Web
• React Native for Mobile App

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work
• Gemini 3.1 Pro for friendly responses
• Google Nano Banana for image generation

AI Tools:

• Litellm for LLM Routing
• Langchain

Orchestration:

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

9. Assumptions and Constraints

• Assumptions:

  • Users will have access to modern devices and stable internet connections.
  • AI models will be pre-trained and integrated via APIs.
  • Admins will manage initial doctor-patient assignments.

• Constraints:

  • Compliance with Indian healthcare data regulations (e.g., HIPAA-equivalent standards).
  • Limited to English and Hindi language support initially.

10. Glossary

• AI: Artificial Intelligence
• JWT: JSON Web Token
• WCAG: Web Content Accessibility Guidelines
• HIPAA: Health Insurance Portability and Accountability Act
• RDBMS: Relational Database Management System