Update app.py

app.py

@@ -21,7 +21,7 @@ class CICE_Assessment:
         self.model = genai.GenerativeModel("gemini-2.0-flash-exp")
     
     def analyze_video(self, video_path):
-        """Analyze video using the 18-point CICE 2.0 assessment"""
+        """Analyze video using the 18-point CICE 2.0 assessment with specific behavioral cues"""
         
         try:
             # Upload video to Gemini
@@ -38,89 +38,89 @@ class CICE_Assessment:
             if video_file.state.name == "FAILED":
                 raise Exception("Video processing failed")
             
-            # THE 18-POINT CICE 2.0 ASSESSMENT PROMPT
-            prompt = """Analyze this healthcare team interaction video and provide a comprehensive assessment based on the CICE 2.0 instrument's 18 interprofessional competencies.
+            # ENHANCED PROMPT WITH SPECIFIC BEHAVIORAL CUES
+            prompt = """Analyze this healthcare team interaction video and provide a comprehensive assessment based on the CICE 2.0 instrument's 18 interprofessional competencies, looking for these SPECIFIC BEHAVIORAL CUES:
 
-            For EACH of the following 18 competencies, clearly state whether it was "OBSERVED" or "NOT OBSERVED" and provide specific examples with timestamps when possible:
+            For EACH competency, clearly state whether it was "OBSERVED" or "NOT OBSERVED" based on these specific behaviors:
 
             1. IDENTIFIES FACTORS INFLUENCING HEALTH STATUS
-               - Did anyone verbalize factors affecting the patient's health (medical history, social determinants, lifestyle factors)?
-
+               LOOK FOR: Team mentions allergy bracelet, fall-related trauma, multiple injuries, or states airway/breathing/circulation concerns out loud
+               
             2. IDENTIFIES TEAM GOALS FOR THE PATIENT
-               - Were specific team goals for the patient discussed or established?
+               LOOK FOR: Team verbalizes goals like: stabilize airway, CPR/AED, give epinephrine, control bleeding, preserve tooth, prepare EMS handoff
 
             3. PRIORITIZES GOALS FOCUSED ON IMPROVING HEALTH OUTCOMES
-               - Was there clear prioritization of goals to improve patient health outcomes?
+               LOOK FOR: CPR/AED prioritized before bleeding/dental injury, EpiPen administered before addressing secondary injuries
 
-            4. VERBALIZES DISCIPLINE-SPECIFIC ROLE
-               - Did team members introduce themselves and clearly state their professional role (e.g., "I'm Dr. Smith, the attending physician")?
+            4. VERBALIZES DISCIPLINE-SPECIFIC ROLE (PRE-BRIEF)
+               LOOK FOR: Students acknowledge interprofessional communication expectations and scene safety review before scenario begins
 
             5. OFFERS TO SEEK GUIDANCE FROM COLLEAGUES
-               - Did anyone express uncertainty and offer to consult with colleagues of the same discipline when unsure?
+               LOOK FOR: Peer-to-peer checks (e.g., dental to dental: confirm tooth storage; nursing to nursing: confirm CPR quality)
 
             6. COMMUNICATES ABOUT COST-EFFECTIVE AND TIMELY CARE
-               - Was there discussion about generic medications, diagnostic utility, or efficient care delivery?
+               LOOK FOR: Team chooses readily available supplies (AED, saline, tourniquet) without delay, states need for rapid EMS transfer
 
             7. DIRECTS QUESTIONS TO OTHER HEALTH PROFESSIONALS BASED ON EXPERTISE
-               - Were questions appropriately directed to specific team members based on their expertise?
+               LOOK FOR: Asks discipline-specific expertise (e.g., "Dental—what do we do with the tooth?"), invites pharmacy/medical input on epinephrine use
 
             8. AVOIDS DISCIPLINE-SPECIFIC TERMINOLOGY
-               - Did team members avoid or explain medical jargon, acronyms, and abbreviations when speaking?
+               LOOK FOR: Uses plain language like "no pulse" instead of "asystole"
 
             9. EXPLAINS DISCIPLINE-SPECIFIC TERMINOLOGY WHEN NECESSARY
-               - When technical terms were used, were they explained professionally when clarification was needed?
+               LOOK FOR: Clarifies medical/dental terms for others when necessary
 
             10. COMMUNICATES ROLES AND RESPONSIBILITIES CLEARLY
-                - Were individual responsibilities and roles clearly articulated?
+                LOOK FOR: Announces assignments out loud: "I'll do compressions," "I'll call 911," "I'll document"
 
             11. ENGAGES IN ACTIVE LISTENING
-                - Was there evidence of active listening through verbal acknowledgments, nonverbal cues, or engaging responses?
+                LOOK FOR: Repeats back instructions ("Everyone clear for shock"), pauses to hear teammates' updates
 
             12. SOLICITS AND ACKNOWLEDGES PERSPECTIVES
-                - Did team members actively ask for and acknowledge input from other team members?
+                LOOK FOR: Leader asks "Anything else we need to address?", responds to peer input respectfully
 
             13. RECOGNIZES APPROPRIATE CONTRIBUTIONS
-                - Was there verbal or nonverbal recognition when team members made valuable contributions to patient care?
+                LOOK FOR: Affirms correct actions verbally ("Good catch on allergy bracelet"), non-verbal acknowledgment (nodding, thumbs up)
 
             14. RESPECTFUL OF OTHER TEAM MEMBERS
-                - Was professionalism maintained? Were team members' expertise and lived experiences recognized?
+                LOOK FOR: Listens without interrupting, values input across professions
 
             15. COLLABORATIVELY WORKS THROUGH INTERPROFESSIONAL CONFLICTS
-                - If disagreements occurred, were they handled professionally and collaboratively?
+                LOOK FOR: Negotiates intervention priorities (airway vs. bleeding) respectfully
 
-            16. REFLECTS ON STRENGTHS OF TEAM INTERACTIONS
-                - Did anyone comment on what went well in the team interaction?
+            16. REFLECTS ON STRENGTHS OF TEAM INTERACTIONS (POST-BRIEF)
+                LOOK FOR: Notes strong teamwork, communication, or role clarity after the scenario
 
-            17. REFLECTS ON CHALLENGES OF TEAM INTERACTIONS
-                - Were difficulties or areas for improvement explicitly discussed?
+            17. REFLECTS ON CHALLENGES OF TEAM INTERACTIONS (POST-BRIEF)
+                LOOK FOR: Identifies confusion, delays, or role overlap in debriefing
 
-            18. IDENTIFIES HOW TO IMPROVE TEAM EFFECTIVENESS
-                - Were specific suggestions made for improving future team collaboration?
+            18. IDENTIFIES HOW TO IMPROVE TEAM EFFECTIVENESS (POST-BRIEF)
+                LOOK FOR: Suggests faster role assignment, consistent closed-loop communication, earlier epi use
 
             STRUCTURE YOUR RESPONSE AS FOLLOWS:
 
             ## OVERALL ASSESSMENT
-            Provide a brief overview of the team interaction quality and professionalism.
+            Brief overview of the team interaction quality.
 
             ## DETAILED COMPETENCY EVALUATION
             For each of the 18 competencies, format as:
 
             Competency [number]: [name]
             Status: [OBSERVED/NOT OBSERVED]
-            Evidence: [Specific examples from the video, or explanation of why it wasn't observed]
+            Evidence: [Specific behavioral cue observed or explanation of absence]
 
             ## STRENGTHS
-            List 3-5 key strengths observed in the team interaction
+            Top 3-5 key strengths with specific examples
 
             ## AREAS FOR IMPROVEMENT
-            List 3-5 specific areas where the team could improve
+            Top 3-5 areas needing work with specific suggestions
 
-            ## RECOMMENDATIONS
-            Provide 3-5 actionable recommendations for enhancing team collaboration and patient care
+            ## AUDIO SUMMARY
+            [Create a 60-second summary focusing on: overall performance level, top 3 strengths, top 3 areas for improvement, and 2 key recommendations]
 
             ## FINAL SCORE
             Competencies Observed: X/18
-            Overall Performance Level: [Exemplary/Proficient/Developing/Needs Improvement]"""
+            Overall Performance Level: [Exemplary (85-100%)/Proficient (70-84%)/Developing (50-69%)/Needs Improvement (0-49%)]"""
             
             response = self.model.generate_content([video_file, prompt])
             return response.text
@@ -129,16 +129,33 @@ class CICE_Assessment:
             return f"Error during analysis: {str(e)}"
     
     def generate_audio_feedback(self, text):
-        """Convert assessment text to audio feedback"""
+        """Generate a concise 1-minute audio feedback summary"""
+        
+        # Extract the audio summary section from the assessment
+        audio_summary_match = re.search(r'## AUDIO SUMMARY\s*(.*?)(?=##|\Z)', text, re.DOTALL)
+        
+        if audio_summary_match:
+            summary_text = audio_summary_match.group(1).strip()
+        else:
+            # Fallback: Create a brief summary from the assessment
+            summary_text = self.create_brief_summary(text)
         
         # Clean text for speech
-        clean_text = re.sub(r'[#*_\[\]()]', ' ', text)
+        clean_text = re.sub(r'[#*_\[\]()]', ' ', summary_text)
         clean_text = re.sub(r'\s+', ' ', clean_text)
         clean_text = re.sub(r'[-•·]\s+', '', clean_text)
         
+        # Add introduction and conclusion for better audio experience
+        audio_script = f"""CICE Healthcare Team Assessment Summary.
+        
+        {clean_text}
+        
+        Please refer to the detailed written report for complete competency evaluation and specific recommendations.
+        End of audio summary."""
+        
         # Generate audio with gTTS
         try:
-            tts = gTTS(text=clean_text, lang='en', slow=False)
+            tts = gTTS(text=audio_script, lang='en', slow=False, tld='com')
             
             # Save to temporary file
             with tempfile.NamedTemporaryFile(delete=False, suffix='.mp3') as tmp_file:
@@ -150,6 +167,40 @@ class CICE_Assessment:
             print(f"⚠️ Audio generation failed: {str(e)}")
             return None
     
+    def create_brief_summary(self, text):
+        """Create a brief summary if AUDIO SUMMARY section is not found"""
+        
+        # Parse scores
+        observed_count = text.lower().count("observed") - text.lower().count("not observed")
+        total = 18
+        percentage = (observed_count / total) * 100
+        
+        # Determine performance level
+        if percentage >= 85:
+            level = "Exemplary"
+        elif percentage >= 70:
+            level = "Proficient"
+        elif percentage >= 50:
+            level = "Developing"
+        else:
+            level = "Needs Improvement"
+        
+        # Extract strengths and improvements if possible
+        strengths = "Strong team communication and role clarity observed"
+        improvements = "Consider enhancing active listening and conflict resolution skills"
+        
+        summary = f"""The team demonstrated {level} performance with {observed_count} out of {total} competencies observed, 
+        achieving {percentage:.0f} percent overall. 
+        
+        Key strengths included {strengths}.
+        
+        Areas for improvement include {improvements}.
+        
+        The team should focus on pre-briefing protocols and post-scenario debriefing to enhance future performance.
+        Emphasis should be placed on clear role assignment and closed-loop communication during critical interventions."""
+        
+        return summary
+    
     def parse_assessment_scores(self, assessment_text):
         """Parse assessment text to extract scores"""
         
@@ -268,14 +319,14 @@ def process_video(video):
         
         progress_messages.append("✅ Analysis complete!")
         
-        # Generate audio feedback
-        progress_messages.append("🔊 Generating audio feedback...")
+        # Generate 1-minute audio feedback
+        progress_messages.append("🔊 Generating 1-minute audio summary...")
         audio_path = assessor.generate_audio_feedback(assessment_result)
         
         # Parse scores for visual summary
         observed, total, percentage, level, color = assessor.parse_assessment_scores(assessment_result)
         
-        # Create visual summary HTML
+        # Create enhanced visual summary HTML with behavioral cues
         summary_html = f"""
         <div style="max-width:800px; margin:20px auto; padding:30px; border-radius:15px; box-shadow:0 4px 6px rgba(0,0,0,0.1);">
             <h2 style="text-align:center; color:#1f2937;">CICE 2.0 Assessment Summary</h2>
@@ -296,27 +347,42 @@ def process_video(video):
             </div>
             
             <div style="margin-top:30px;">
-                <h3>📋 CICE 2.0 Competency Areas:</h3>
-                <ol style="line-height:1.8; color:#374151;">
-                    <li>Health Status Factors</li>
-                    <li>Team Goals Identification</li>
-                    <li>Goal Prioritization</li>
-                    <li>Role Verbalization</li>
-                    <li>Seeking Guidance</li>
-                    <li>Cost-Effective Communication</li>
-                    <li>Expertise-Based Questions</li>
-                    <li>Avoiding Jargon</li>
-                    <li>Explaining Terminology</li>
-                    <li>Clear Role Communication</li>
-                    <li>Active Listening</li>
-                    <li>Soliciting Perspectives</li>
-                    <li>Recognizing Contributions</li>
-                    <li>Team Respect</li>
-                    <li>Conflict Resolution</li>
-                    <li>Strength Reflection</li>
-                    <li>Challenge Reflection</li>
-                    <li>Improvement Identification</li>
-                </ol>
+                <h3>🎯 Key Behavioral Indicators Assessed:</h3>
+                <div style="background:#f3f4f6; padding:15px; border-radius:10px; margin:15px 0;">
+                    <h4 style="color:#059669; margin-top:0;">✅ Critical Actions</h4>
+                    <ul style="line-height:1.6; color:#374151;">
+                        <li>CPR/AED prioritization</li>
+                        <li>Epinephrine administration timing</li>
+                        <li>Clear role assignments ("I'll do compressions")</li>
+                        <li>Closed-loop communication</li>
+                    </ul>
+                </div>
+                
+                <div style="background:#f3f4f6; padding:15px; border-radius:10px; margin:15px 0;">
+                    <h4 style="color:#0891b2; margin-top:0;">🗣️ Communication Markers</h4>
+                    <ul style="line-height:1.6; color:#374151;">
+                        <li>Plain language use (avoiding medical jargon)</li>
+                        <li>Active listening (repeating back instructions)</li>
+                        <li>Soliciting input ("Anything else we need?")</li>
+                        <li>Recognizing contributions ("Good catch!")</li>
+                    </ul>
+                </div>
+                
+                <div style="background:#f3f4f6; padding:15px; border-radius:10px; margin:15px 0;">
+                    <h4 style="color:#7c3aed; margin-top:0;">🔄 Team Dynamics</h4>
+                    <ul style="line-height:1.6; color:#374151;">
+                        <li>Pre-brief safety review</li>
+                        <li>Peer-to-peer verification</li>
+                        <li>Respectful conflict resolution</li>
+                        <li>Post-brief reflection on strengths/challenges</li>
+                    </ul>
+                </div>
+            </div>
+            
+            <div style="margin-top:20px; padding:15px; background:#fef3c7; border-radius:10px;">
+                <p style="text-align:center; color:#92400e; margin:0;">
+                    <strong>🔊 Listen to the 1-minute audio summary for key findings and recommendations</strong>
+                </p>
             </div>
         </div>
         """
@@ -344,13 +410,13 @@ def create_interface():
         gr.Markdown("""
         # 🏥 CICE 2.0 Healthcare Team Assessment Tool
         
-        **Analyze healthcare team interactions using the 18-point CICE 2.0 interprofessional competency framework**
+        **Analyze healthcare team interactions using specific behavioral cues from the 18-point CICE 2.0 framework**
         
-        This tool evaluates healthcare team communication and collaboration based on:
-        - Patient-centered care planning
-        - Role clarity and communication
-        - Team dynamics and respect
-        - Reflective practice
+        This tool evaluates critical team behaviors including:
+        - Emergency response prioritization (CPR/AED, epinephrine)
+        - Clear role communication and closed-loop verification
+        - Active listening and respectful team dynamics
+        - Pre-brief and post-brief reflection practices
         
         ---
         """)
@@ -381,11 +447,16 @@ def create_interface():
                 1. **Upload** a pre-recorded video or **Record** using your webcam
                 2. Click **Analyze Video** to start the assessment
                 3. Wait for the AI to process (1-2 minutes)
-                4. Review the detailed assessment and listen to audio feedback
+                4. Listen to the **1-minute audio summary** for quick insights
+                5. Review the detailed written assessment for complete evaluation
                 
-                **Note:** Videos are automatically optimized for faster processing:
-                - Webcam recording: 640x360
-                - Uploaded videos > 10MB will be compressed
+                **Key Behaviors Assessed:**
+                - Allergy/medical history identification
+                - CPR/AED prioritization
+                - Clear role assignments
+                - Plain language communication
+                - Active listening behaviors
+                - Team respect and conflict resolution
                 """)
             
             with gr.Column(scale=2):
@@ -394,21 +465,21 @@ def create_interface():
                 # Visual summary
                 summary_output = gr.HTML(label="Visual Summary")
                 
+                # Audio feedback - now prominently featured
+                audio_output = gr.Audio(
+                    label="🔊 1-Minute Audio Summary (Listen First!)",
+                    type="filepath",
+                    interactive=False
+                )
+                
                 # Detailed assessment
                 assessment_output = gr.Textbox(
-                    label="Detailed CICE 2.0 Assessment",
+                    label="Detailed CICE 2.0 Assessment (Full Report)",
                     lines=20,
                     max_lines=30,
                     interactive=False
                 )
                 
-                # Audio feedback
-                audio_output = gr.Audio(
-                    label="🔊 Audio Feedback (Downloadable)",
-                    type="filepath",
-                    interactive=False
-                )
-                
                 # Download report
                 report_file = gr.File(
                     label="📥 Download Full Report",
@@ -418,11 +489,15 @@ def create_interface():
         # Footer
         gr.Markdown("""
         ---
-        ### About CICE 2.0
-        The Creighton Interprofessional Collaborative Evaluation (CICE) instrument assesses 18 key competencies 
-        for effective healthcare team collaboration, including communication, role clarity, and patient-centered care.
-        
-        **Note:** Ensure your video clearly captures team interactions and audio for accurate assessment.
+        ### About This Assessment
+        This tool uses AI to identify specific behavioral markers that indicate effective interprofessional collaboration 
+        in healthcare settings. The assessment focuses on observable actions such as:
+        - Verbal role assignments ("I'll do compressions")
+        - Recognition phrases ("Good catch on the allergy bracelet")
+        - Plain language use instead of medical jargon
+        - Pre-brief and post-brief team discussions
+        
+        **Note:** Ensure clear audio capture of team communications for accurate assessment.
         """)
         
         # Connect the analyze button
@@ -442,4 +517,4 @@ if __name__ == "__main__":
         debug=True,
         server_name="0.0.0.0",
         server_port=7860
-    )
+    )