From 16fc9ba90a63eef6ba86a960ffdcd38a6dcee579 Mon Sep 17 00:00:00 2001
From: yashwin-foxy <yashwin524@gmail.com>
Date: Tue, 26 Aug 2025 19:53:14 +0530
Subject: [PATCH] readme updated

---
 README.md | 93 ++++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 75 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 3b5acb8..e846b23 100644
--- a/README.md
+++ b/README.md
@@ -27,8 +27,8 @@
 NeoScan Physician App is a **mobile application** that helps doctors (physicians) work with **AI-powered medical imaging**. Think of it as a smart assistant that:
 
 - **Shows AI predictions** about what might be wrong in medical scans
-- **Lets doctors review** these AI suggestions and provide feedback
-- **Helps improve AI accuracy** over time through expert medical input
+- **Lets doctors review** these AI suggestions alongside radiologist feedback
+- **Provides clinical insights** by reviewing radiologist validation and notes
 - **Manages patient cases** and medical imaging files (DICOM images)
 
 ### 🎯 Who is this for?
@@ -47,8 +47,8 @@ NeoScan Physician App is a **mobile application** that helps doctors (physicians
 - **Profile Management**: Update personal  information
 
 ### 📊 **Dashboard Overview**
-- **Statistics**: View total predictions, patients, and feedback rates
-- **Performance Metrics**: Track AI confidence scores and accuracy
+- **Statistics**: View total predictions, patients, and radiologist feedback rates
+- **Performance Metrics**: Track AI confidence scores and accuracy based on radiologist validation
 - **Quick Actions**: Access common tasks and recent cases
 
 ### 👥 **Patient Management**
@@ -62,7 +62,8 @@ NeoScan Physician App is a **mobile application** that helps doctors (physicians
 - **Finding Categories**: Stroke detection, hemorrhage analysis, anatomical findings
 - **Severity Classification**: High/Medium/Low risk stratification
 - **Finding Localization**: Precise visualization of pathological findings
-- **Image Controls**: Zoom, frame view with slider.
+- **Image Controls**: Zoom, frame view with slider
+- **Radiologist Feedback**: View feedback and validation already provided by radiologists for each prediction
 
 ### ⚙️ **Settings & Preferences**
 - **App Configuration**: Customize notification and display settings
@@ -76,7 +77,7 @@ NeoScan Physician App is a **mobile application** that helps doctors (physicians
 ### 🔄 **User Journey Flow**
 
 ```
-1. Login → 2. Dashboard → 3. Patient List → 4. Case Review → 5. AI Analysis → 6. Feedback
+1. Login → 2. Dashboard → 3. Patient List → 4. Case Review → 5. AI Analysis → 6. Review Radiologist Feedback
 ```
 
 **Step-by-Step Process:**
@@ -85,7 +86,7 @@ NeoScan Physician App is a **mobile application** that helps doctors (physicians
 3. **Patient List**: Browse and search for specific patients
 4. **Case Review**: Open patient details and view medical information
 5. **AI Analysis**: Review AI predictions alongside medical images
-6. **Feedback**: Provide clinical validation and notes
+6. **Review Radiologist Feedback**: View and analyze feedback already provided by radiologists
 
 ### 🔐 **User Onboarding Flow**
 
@@ -108,25 +109,81 @@ The app supports two ways for physicians to join:
 4. Upload ID Proof → Complete verification
 5. Reset Password → Access Dashboard
 
+### 🔄 **Physician Signup Flow Diagrams**
+
+#### **Flow A: Self-Registration (via App)**
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Start App     │───▶│  Enter Email    │───▶│ Email Exists?   │───▶│ Already         │
+│   Signup        │    │   Address       │    │                 │    │ Registered      │
+└─────────────────┘    └─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                         │
+                                                         ▼
+                                                ┌─────────────────┐    ┌─────────────────┐     ┌─────────────────┐
+                                                │  Create         │───▶│  Enter Personal │───>│  Upload ID      │
+                                                │  Password       │    │  Information    │     │  Proof          │
+                                                └─────────────────┘    └─────────────────┘     └─────────────────┘
+                                                                                                        │
+                                                                                                        ▼
+                                                ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+                                                │  Select         │───▶│  Wait for Admin │───▶│  Admin          │
+                                                │  Hospital       │    │  Approval       │    │  Approves       │
+                                                └─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                                                                        │
+                                                                                                        ▼
+                                                ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+                                                │  Login &        │───▶│  Reset          │───▶│  Access         │
+                                                │  Reset Password │    │  Password       │    │  Dashboard      │
+                                                └─────────────────┘    └─────────────────┘    └─────────────────┘
+```
+
+#### **Flow B: Admin-Created Physician**
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Admin         │───▶│  Admin Creates  │───▶│  Credentials    │───▶│  Physician      │
+│   Dashboard     │    │  Physician      │    │  Sent to Email  │    │  Receives       │
+│                 │    │  Account        │    │                 │    │  Email          │
+└─────────────────┘    └─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                                                │
+                                                                                ▼
+                                                ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+                                                │  Physician      │───▶│  Upload ID      │───▶│  Complete       │
+                                                │  Logs In        │    │  Proof          │    │  Verification   │
+                                                │  with Received  │    │                 │    │                 │
+                                                │  Credentials    │    │                 │    │                 │
+                                                └─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                                                                        │
+                                                                                                        ▼
+                                                ┌─────────────────┐    ┌─────────────────┐
+                                                │  Reset          │───▶│  Access         │
+                                                │  Password       │    │  Dashboard      │
+                                                └─────────────────┘    └─────────────────┘
+```
+
+**Key Differences:**
+- **Self-Registration**: Physician initiates the process, waits for admin approval
+- **Admin-Created**: Admin initiates the process, physician receives ready-to-use credentials
+- **Both flows** require ID proof upload and password reset for security
+
 ### 📊 **Case Review Workflow**
 1. **Select Case**: Choose from patient queue or search
 2. **View DICOM**: Access medical imaging files
 3. **Review AI**: Analyze AI predictions and confidence scores
-4. **Provide Feedback**: Submit validation (Agree/Partially Agree/Disagree)
-5. **Add Notes**: Optional clinical observations
-6. **Complete Review**: Case marked as reviewed
+4. **Review Radiologist Feedback**: View validation and clinical notes from radiologists
+5. **Analyze Clinical Insights**: Study radiologist's observations and findings
+6. **Complete Review**: Case marked as reviewed with radiologist feedback analyzed
 
 ### 📊 **Data Flow**
 ```
-User Action → App Request → AI Analysis → Results Display → Feedback Collection → AI Learning
+User Action → App Request → AI Analysis → Results Display → Radiologist Feedback Review → Clinical Insights
 ```
 
-### 📝 **Advanced Feedback System**
-- **Binary Validation**: Positive (✅) or Negative (❌) feedback
-- **Clinical Notes**: Detailed observations and suggestions
-- **Performance Improvement**: Feedback data enhances AI accuracy
-- **Quality Metrics**: Continuous validation performance tracking
-- **Finding Validation**: Validate specific findings like hemorrhage types, midline shift, etc.
+### 📝 **Radiologist Feedback Review System**
+- **View Radiologist Feedback**: Access feedback already provided by radiologists for each prediction
+- **Clinical Validation Review**: Review radiologist's validation (Positive/Negative/Partially Agree)
+- **Clinical Notes Review**: Read detailed observations and suggestions from radiologists
+- **Performance Tracking**: Monitor AI accuracy improvements based on radiologist feedback
+- **Finding Validation Review**: Review radiologist's validation of specific findings like hemorrhage types, midline shift, etc.
 
 ---
 
@@ -163,7 +220,7 @@ User Action → App Request → AI Analysis → Results Display → Feedback Col
 ### **Step 1: Get the Project (2 minutes)**
 ```bash
 # Download the project
-git clone <repository-url>
+git clone <https://git.tech4biz.wiki/Tech4Biz-Services/NewScan-Physician-Mobile>
 cd NeoScan_Physician
 
 # Check if everything downloaded correctly