NEET PG OPD Simulator

An interactive, AI-powered Outpatient Department (OPD) simulator designed specifically for NEET PG aspirants to practice clinical reasoning and diagnostic skills.

📑 Table of Contents

• Overview
• Features
• Live Demo
• Getting Started
  • Prerequisites
  • Installation
• How It Works
• Technology Stack
• Project Structure
• Contributing
• License
• Acknowledgements

🔍 Overview

The NEET PG OPD Simulator is an educational platform that allows medical students and postgraduate aspirants to practice clinical reasoning in a risk-free environment. Users interact with virtual patients, recommend diagnostic tests, and formulate diagnoses based on clinical presentations, receiving real-time feedback from an AI-powered consultant.

✨ Features

• Immersive 3D Interface: Engaging medical-themed visualization with DNA helix model
• Interactive Patient Simulations: Engage with 10 diverse virtual patients presenting various clinical scenarios
• Specialized Clinical Cases: Cases covering cardiology, neurology, gastroenterology, and more
• Diagnostic Test Selection: Recommend appropriate diagnostic tests based on patient symptoms
• Diagnostic Reasoning: Formulate clinical diagnoses based on symptoms and test results
• Real-time AI Feedback: Receive immediate, educational feedback on your clinical decisions
• Performance Tracking: Monitor your diagnostic skills with detailed scoring and feedback
• Responsive Design: Seamless experience across desktop and mobile devices
• Medical-themed UI: Interface designed specifically for medical professionals with relevant terminology and visuals

🌐 Live Demo

Try the application at https://neetpg-opd-simulator.com

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn

Installation

1. Clone the repository:

   bash
   git clone https://github.com/yourusername/neetpg-opd-simulator.git
   cd neetpg-opd-simulator
   

2. Install dependencies:

   bash
   npm install
   # or
   yarn install
   

3. Start the development server:

   bash
   npm run dev
   # or
   yarn dev
   

4. Open your browser and navigate to http://localhost:5173

🔄 How It Works

1. Welcome Screen: Interactive 3D introduction to the simulator and educational objectives
2. Patient Selection: Choose from 10 diverse patient cases spanning different medical specialties
3. Patient Encounter: Presentation of a virtual patient with medical history and symptoms
4. Diagnostic Tests: Recommend appropriate tests for the patient's condition
5. Test Evaluation: Receive feedback on your test selection
6. Diagnosis Phase: Formulate a diagnosis based on symptoms and test results
7. Diagnostic Evaluation: Get detailed feedback on your diagnostic reasoning
8. Case Summary: Review the entire case with expert insights
9. Progress Tracking: View your performance across multiple patient encounters

💻 Technology Stack

• Frontend: React, TypeScript, Tailwind CSS
• UI Components: shadcn/ui
• 3D Visualization: Three.js
• State Management: React Query
• AI Integration: Google's Gemini API
• Database: Supabase
• Routing: React Router
• Build Tool: Vite

📂 Project Structure

src/
├── components/        # Reusable UI components
├── hooks/             # Custom React hooks
├── lib/               # Utility functions and services
├── pages/             # Main application pages
│   ├── Welcome.tsx    # 3D-enhanced welcome screen
│   ├── Simulation.tsx # Main simulation interface
│   └── Results.tsx    # Performance results view
├── integrations/      # Third-party integrations
└── App.tsx            # Main application entry point

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• Thanks to the NEET PG community for feedback and suggestions
• Special thanks to the educational team for clinical expertise

Developed with passion for aspiring medical professionals.