System Requirements Document (SRD)

Project Name: Silent-Platform

1. Introduction

Silent-Platform is an AI-powered healthcare platform designed to help users understand medical reports and take real-world action. The system focuses on converting medical data into actionable insights, enabling users to make informed health decisions without overcomplicating the process.

This document outlines the system requirements for Silent-Platform, incorporating Gitmushtaq's recent updates to use a simple rule-based risk engine with configurable thresholds and implement saved reports using frontend local storage for the MVP phase.

2. System Overview

Silent-Platform is a full-stack healthcare solution tailored for users in India (IN). The platform simplifies medical report analysis and provides actionable recommendations, such as risk levels, doctor suggestions, and nearby hospital details.

Key Features:

• Medical Report Upload: Users can upload PDFs or images of their medical reports.
• Risk Analysis: A rule-based engine evaluates biomarkers and assigns risk levels (Low, Medium, High).
• Doctor Recommendations: Maps biomarkers to appropriate specialists.
• Hospital Integration: Displays nearby hospitals using Google Maps Places API.
• Action System: Enables users to call hospitals or navigate to them.
• Saved Reports: Stores analyzed reports locally for easy access and follow-up.

Locale-Specific Defaults:

• Currency: INR
• Timezone: IST (Indian Standard Time)
• Language: English

3. Functional Requirements

As User:

• I should be able to upload a medical report (PDF/image).
• I should be able to see the analysis progress after uploading a report.
• I should receive a simplified explanation of my report.
• I should understand my risk level (Low, Medium, High).
• I should get doctor recommendations based on biomarkers.
• I should see nearby hospitals with details like rating, distance, address, and phone number.
• I should be able to call a hospital directly or navigate to it using Google Maps.
• I should be able to save my analyzed report locally and return to it later.

4. User Personas

1. Primary User:

• Description: Individuals seeking to understand their medical reports and take actionable steps.
• Goals: Simplified report analysis, actionable recommendations, and easy follow-up.
• Technical Proficiency: Moderate (comfortable with basic app usage).

2. Secondary User:

• Description: Caregivers or family members assisting primary users.
• Goals: Help analyze reports and coordinate actions like hospital visits.
• Technical Proficiency: Moderate to high.

5. Visuals Colors and Theme

Color Palette:

Silent-Platform's design will evoke trust, clarity, and professionalism.

• Background: #F5F9FC (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Navy Blue)
• Accent: #FF6F61 (Warm Coral Red)
• Muted Tones: #BDC3C7 (Soft Gray)

6. Signature Design Concept

Interactive Health Dashboard with Dynamic Biomarker Visualization

The homepage will feature an interactive health dashboard that visually represents analyzed biomarkers as dynamic, glowing orbs. Each orb will pulse gently to indicate its risk level (green for low, yellow for medium, red for high).

Key Features:

• Hover Interaction: Users can hover over orbs to see detailed biomarker values and explanations.
• Risk Animation: Orbs will subtly expand and contract based on risk severity, creating a living, breathing effect.
• Doctor Mapping: Clicking an orb will display the recommended doctor type and nearby hospitals in a side panel.
• Progressive Loading: As the analysis progresses, orbs will appear one by one, creating a sense of anticipation.

This design will make the platform visually engaging and memorable, while maintaining clarity and professionalism.

7. Non-Functional Requirements

• Performance: The system should analyze reports within 5 seconds for MVP.
• Scalability: The architecture should support future integration of advanced AI models and cloud storage.
• Security: Ensure secure handling of uploaded files and local storage data.
• Usability: The UI should be intuitive and accessible to users with moderate technical proficiency.
• Localization: Default settings tailored for India (IN), including INR currency and IST timezone.

8. Tech Stack

Frontend:

• React (Vite) for web development.
• Tailwind CSS for styling.
• React Router for navigation.

Backend:

• FastAPI (Python) for API development.

Database:

• RDBMS: MySQL or MariaDB (using Alembic for migrations).

AI Models:

• OCR for text extraction.
• Rule-based risk detection engine.

Local Orchestration:

• Docker and docker-compose for containerization.

9. Assumptions and Constraints

Assumptions:

• Users will upload medical reports in standard formats (PDF or image).
• Local storage will suffice for saved reports during MVP.
• Rule-based risk thresholds will be stored in a configurable file for easy updates.

Constraints:

• No heavy ML models for MVP.
• No authentication system or cloud storage in Phase 1.
• Limited to Google Maps Places API for hospital integration.

10. Glossary

• Biomarker: A measurable indicator of biological state or condition (e.g., LDL, hemoglobin).
• Risk Level: Categorization of health risk based on biomarker thresholds (Low, Medium, High).
• Doctor Recommendation: Suggested specialist based on biomarker analysis.
• Local Storage: Browser-based storage for saving user data locally.
• OCR: Optical Character Recognition, used for extracting text from images or PDFs.

This updated SRD reflects the latest decisions and priorities for Silent-Platform's MVP phase. Let me know if further refinements are needed!