System Requirements Document (SRD)

Project Name: project-fc442b2f

1. Introduction

The purpose of this document is to outline the system requirements for project-fc442b2f, a modern and professional digital platform designed for medical students preparing for the Israeli IMLE exam. The platform will include both a website and a mobile application, offering comprehensive study materials, clinical case-based questions, and interactive features to enhance the learning experience.

This project is tailored to meet the needs of medical students in Israel, with a focus on providing high-quality educational resources in both English and Russian. The system will incorporate a professional medical design aesthetic, extended clinical scenarios, and question content inspired by trusted sources like Dr. Mada.

2. System Overview

project-fc442b2f will serve as a centralized platform for IMLE exam preparation, offering:

• A structured and professional eBook divided into key medical specialties (Internal Medicine, Pediatrics, Obstetrics & Gynecology, Surgery, and Psychiatry).
• A Qbank with 5000 clinical case-based questions, designed to match IMLE standards, including detailed explanations for correct and incorrect answers.
• A user-friendly interface with features such as exam history tracking, personalized profiles, and "next step" guidance for clinical scenarios.
• A bilingual experience (English and Russian) to cater to a diverse user base.

The platform will be accessible via a responsive website and a mobile application, ensuring seamless usability across devices.

3. Functional Requirements

• As a User, I should be able to register and log in using my email.
• As a User, I should be able to access a structured eBook divided into medical specialties.
• As a User, I should be able to practice 5000 clinical case-based questions with detailed explanations.
• As a User, I should be able to view my exam history and track my progress.
• As a User, I should be able to see the "next step" guidance for clinical scenarios.
• As a User, I should be able to understand why incorrect options are wrong.
• As a User, I should be able to switch between English and Russian versions of the content.
• As a User, I should be able to access long-form clinical scenarios similar to IMLE standards.
• As an Admin, I should be able to manage user accounts and content updates.

4. User Personas

1. Medical Student

• Description: A student preparing for the IMLE exam, seeking high-quality study materials and practice questions.
• Goals: To pass the IMLE exam with a strong understanding of clinical knowledge.
• Needs: Access to structured content, detailed explanations, and progress tracking.

2. Admin

• Description: A system administrator responsible for managing the platform.
• Goals: To ensure the platform runs smoothly and content is up-to-date.
• Needs: Tools for user management and content updates.

5. Visuals Colors and Theme

Color Palette

The design will feature a professional medical aesthetic with the following unique color palette:

• Background: #F7FAFC (Soft White)
• Surface: #E2E8F0 (Light Gray-Blue)
• Text: #2D3748 (Charcoal Gray)
• Accent: #3182CE (Medical Blue)
• Muted Tones: #A0AEC0 (Muted Gray)

This palette ensures a clean, calming, and professional look, suitable for a medical education platform.

6. Signature Design Concept

Interactive Clinical Lab Homepage

The homepage will simulate a virtual clinical lab environment, immersing users in a professional medical setting. Key features include:

• 3D Interactive Elements: A rotating stethoscope or anatomical model that users can interact with.
• Dynamic Case Scenarios: A "Case of the Day" section that animates onto the screen, presenting a clinical scenario with a timer for users to solve.
• Animated Transitions: Smooth transitions between sections, resembling the opening of medical charts.
• Personalized Dashboard: A sleek dashboard with a "progress thermometer" that visually tracks the user's study progress.
• Micro-Interactions: Subtle animations, such as a heartbeat effect when hovering over buttons or icons.

This design will make the platform visually engaging and memorable while maintaining a professional tone.

7. Non-Functional Requirements

• The system must support both English and Russian languages.
• The platform must be mobile-responsive and compatible with iOS and Android devices.
• The system must handle up to 10,000 concurrent users without performance degradation.
• The Qbank must load questions and explanations within 2 seconds.
• User data must be securely stored and comply with GDPR regulations.

8. Tech Stack

Frontend

• React for the website.
• React Native for the mobile application.

Backend

• Python with FastAPI for API development.

Database

• MySQL for structured data storage (e.g., user accounts, exam history).
• MongoDB for unstructured data (e.g., clinical scenarios).

AI Models

• GPT 5.4 for generating user-friendly explanations.
• Claude 4.6 Opas for academic and coding-related content.

AI Tools

• LangChain for managing AI workflows.
• Litellm for LLM routing.

Orchestration

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

9. Assumptions and Constraints

• The platform will primarily target medical students in Israel.
• The system will require an internet connection for accessing content and features.
• The initial launch will include 5000 questions, with plans for future updates.
• The platform will not include live tutoring or video content in the initial release.

10. Glossary

• IMLE: Israeli Medical Licensing Exam.
• Qbank: A question bank containing practice questions for exam preparation.
• Clinical Scenario: A case-based question simulating real-life medical situations.
• Next Step: Guidance on the next action to take in a clinical scenario.
• Progress Thermometer: A visual representation of a user's study progress.