¶ User Flow Documentation
This document describes the complete user journey through the CityU Vet Sim application, from initial registration to receiving personalized feedback based on personality assessment and simulation performance.
¶ Table of Contents
- Overview
- Complete User Journey
- Personality-Driven Experience
- Simulation Flow
- Evaluation and Feedback
- Flow Diagram
¶ Overview
The CityU Vet Sim application provides a personalized learning experience for veterinary students to practice communication skills. The system uses a two-factor approach to deliver tailored feedback:
- Personality Assessment: A comprehensive questionnaire that determines the student's communication style and preferences
- Simulation Performance: Real-time analysis of the student's interactions with AI-powered pet owners during practice consultations
These factors work together to provide highly personalized, actionable feedback that helps students improve their communication skills in a way that aligns with their natural communication style.
¶ Complete User Journey
¶ Phase 1: Registration and Onboarding
¶ Step 1: Account Creation
Entry Point: Landing Page (/)
- User visits the application landing page
- User clicks "Sign Up" or navigates to
/sign-up - User provides:
- Email address
- Password
- Name
- Account is created and user is automatically logged in
- Redirect: User is redirected to
/homeor/dashboard
Key Point: At this stage, the user has no personality profile yet.
¶ Step 2: Personality Test Completion
Entry Point: Level Selection (/home) or Dashboard (/dashboard)
Requirement: Before accessing simulation features, users must complete the personality test.
- User attempts to access level selection or dashboard
- System checks for personality profile in database
- If no personality profile exists:
- User is automatically redirected to
/personality-test - A message may indicate that personality test completion is required
- User is automatically redirected to
Personality Test Flow (/personality-test):
-
Introduction Steps:
- Logo and welcome screen
- Video introductions explaining the test purpose
- Educational content about communication styles
-
Dichotomy Explanations:
- Inner vs. Outer World (I/O): How users recharge and gain energy
- Structure vs. Flow (S/F): Preference for planning vs. spontaneity
- Experience vs. Envisioning (X/V): Focus on details vs. big picture
- Logic vs. Emotion (L/E): Rational analysis vs. emotional consideration
- Each dichotomy includes:
- Video explanations
- Interactive circles with detailed information
- Examples relevant to veterinary communication
-
Quiz Sections:
- Multiple quiz categories (typically 4 categories)
- Questions with randomized option order (to prevent bias)
- Progress tracking (e.g., "Section 1 of 4")
- All questions must be answered to proceed
-
Results Processing:
- System calculates personality type from answers
- Converts MBTI-style results to custom four-letter code:
[IO][SF][XV][LE] - Example:
ISXL= Inner, Structure, Experience, Logic
-
Results Display:
- Personalized communication style description
- Title (e.g., "ISXL, the Specialist/Artisan/Technician")
- Detailed explanation of how personality applies to consultations
- Suggestions for enhancing communication
- Real-life scenario examples
-
Personality Profile Saved:
- Four-letter code saved to user's database record
- Used for all future evaluations and feedback
- Can be updated by retaking the test
Alternative: Users can skip the questionnaire, which applies a default personality (ISXL) and allows immediate access to simulations.
Redirect: After completion, user is redirected to /home (level selection).
¶ Phase 2: Skill Selection and Preparation
¶ Step 3: Level Selection
Entry Point: /home
- User sees available skill levels:
- Level 1: Basic communication skills
- Level 2: Advanced communication skills
- Level 3: Complex case scenarios
- User selects a level
- Redirect: User is taken to
/dashboardwith the selected level
¶ Step 4: Skill Selection
Entry Point: /dashboard?level={number}
- Dashboard displays:
- Level information and description
- Progress tracking (completed cases, mastered skills)
- Available skills for the selected level
- Each skill card shows:
- Skill title and description
- Number of available cases
- Completion status
- User clicks on a skill card
- Redirect: User is taken to
/introductionfor the selected skill
¶ Step 5: Skill Introduction
Entry Point: /introduction
Purpose: Educational preparation before practicing the skill.
-
Overview Page (Page 0):
- Duration and case count information
- "Why is this skill important?"
- "What will you learn?"
- "Why does it matter in practice?"
- Practical tips
-
Goal Pages (Pages 1+):
- Instructional videos demonstrating the skill
- "Why this works" explanations
- Step-by-step guidance
- Pagination with progress indicators
-
User navigates through pages:
- Can go forward/backward
- Can skip to case selection
- On last page, clicks "Select Cases"
-
Redirect: User is taken to
/case-selection
¶ Step 6: Case Selection
Entry Point: /case-selection
-
User sees all available cases for the selected skill
-
Each case card displays:
- Case title
- Pet information (name, breed, age)
- Owner name
- Chief complaint
- Additional case information
- Completion status (if previously attempted)
-
User selects a case scenario
-
Redirect: User is taken to
/simulationwith the selected case
¶ Phase 3: Simulation Practice
¶ Step 7: Simulation Session
Entry Point: /simulation
This is the core practice experience where personality and performance are tracked.
Initial Setup:
-
Page loads with:
- Case scenario details in sidebar
- Skill aims and practical tips
- Empty chat window
- Notes section (loads any previously saved notes)
- Timer (starts at 00:00)
-
System prepares:
- Custom AI prompt generated based on:
- Selected skill ID
- Case details (owner, pet, complaint, context)
- Specific communication skill being practiced
- Voice selection based on case gender (male/female)
- ElevenLabs agent configured with custom prompt
- Custom AI prompt generated based on:
Conversation Flow:
-
User Initiates Conversation:
- User clicks "Start Conversation"
- Browser requests microphone permission
- WebRTC connection established with ElevenLabs
- Timer starts automatically
-
Real-Time Voice Interaction:
- User speaks into microphone
- Speech is captured and sent to ElevenLabs
- ElevenLabs processes speech (speech-to-text)
- AI pet owner responds based on:
- Custom prompt (persona, behavior, skill-specific instructions)
- Conversation history
- Case context
- AI response is synthesized to speech (text-to-speech)
- Both user and AI messages appear in chat window
-
During Conversation:
- User can:
- Continue speaking naturally
- Take notes (auto-saves after 1 second)
- View case information in sidebar
- Reference skill aims and tips
- System tracks:
- All conversation messages (role: "user" or "assistant")
- Message timestamps
- Conversation duration
- User can:
-
Ending Conversation:
- User clicks "End Conversation"
- Timer stops
- Conversation state is preserved
- User can restart conversation or end simulation
-
Ending Simulation:
- User clicks "End Simulation & View Results"
- System:
- Locks the conversation (prevents further editing)
- Marks case as completed in progress tracking
- Saves notes to database
- Prepares conversation data for evaluation
-
Redirect: User is taken to
/results
¶ Phase 4: Evaluation and Feedback
¶ Step 8: Results and Feedback
Entry Point: /results
This is where personality and performance combine to generate personalized feedback.
Page Load:
-
System displays:
- Left Panel: Conversation transcript
- Full conversation history
- User messages labeled as "You"
- AI messages labeled with pet owner's name
- Scrollable view
- Left Panel: Conversation transcript
-
Right Panel: Feedback generation (automatic)
- Loading state while generating feedback
- Error handling with retry option
Feedback Generation Process:
-
Data Collection:
- Locked conversation messages (filtered for meaningful content)
- Selected skill ID
- Case ID
- User's personality profile from database
-
Evaluation Prompt Construction:
The system builds a comprehensive evaluation prompt that includes:-
Case Context:
- Case scenario description
- Owner information
- Pet details
- Chief complaint
- Additional case information
-
Skill Objectives:
- Specific communication skill aims
- Learning objectives for the skill
- Expected behaviors
-
Personality Context:
- User's four-letter personality code
- Personality dimensions explanation:
- Inner-Outer World (I or O)
- Structure or Flow (S or F)
- Experience or Envisioning (X or V)
- Logic or Emotion (L or E)
- How personality influences communication style
-
Evaluation Criteria:
- Identify strengths in the student's approach
- Suggest specific areas for improvement
- Consider personality traits in feedback
- Keep feedback concise, constructive, and encouraging
- Engage in dialogue format with the student
-
-
AI Evaluation:
- Conversation transcript is formatted:
- User messages → "Student: {content}"
- AI messages → "Client: {content}"
- Prompt sent to OpenAI GPT-5-mini model
- Model generates personalized feedback considering:
- Performance factors:
- How well student demonstrated skill objectives
- Quality of questions asked
- Empathy and rapport building
- Clarity of explanations
- Active listening
- Personality factors:
- Feedback tailored to communication style
- Suggestions that align with personality strengths
- Areas for growth that respect personality preferences
- Examples relevant to personality type
- Performance factors:
- Conversation transcript is formatted:
-
Feedback Display:
- Generated feedback rendered as markdown
- Formatted for readability
- Includes:
- Strengths identified
- Specific improvement suggestions
- Personality-aware recommendations
- Encouraging tone
User Actions:
-
Review Feedback:
- Read personalized evaluation
- Review conversation transcript
- Reflect on performance
-
Next Steps:
- Retry This Case: Practice the same case again
- Clears conversation
- Returns to
/simulation
- Select Another Case: Try a different case for the same skill
- Returns to
/case-selection
- Returns to
- Back to Dashboard: Continue with other skills
- Returns to
/dashboard
- Returns to
- Retry This Case: Practice the same case again
¶ Personality-Driven Experience
¶ How Personality Influences the Experience
¶ 1. During Simulation
While the personality profile doesn't directly change the AI pet owner's behavior, it influences:
- Prompt Generation: The system generates prompts that create realistic scenarios, but the AI responds based on the case and skill requirements
- User Experience: The interface and guidance can be adapted based on personality (future enhancement)
¶ 2. During Evaluation
Personality has a significant impact on feedback generation:
Example Scenarios:
-
ISXL (Inner, Structure, Experience, Logic):
- Feedback might emphasize:
- "Your logical, structured approach to explaining procedures is excellent"
- "Consider adapting your communication style for clients who need more emotional reassurance"
- "Your ability to simplify complex information aligns well with your personality"
- Feedback might emphasize:
-
OFVE (Outer, Flow, Envisioning, Emotion):
- Feedback might emphasize:
- "Your empathetic and engaging communication style helps clients feel comfortable"
- "Balance your enthusiasm with structured guidance for complex treatment plans"
- "Your ability to connect emotionally is a strength; ensure you also provide clear, factual information"
- Feedback might emphasize:
Personality-Aware Suggestions:
The evaluation system provides suggestions that:
- Respect the user's natural communication style
- Build on existing strengths
- Guide development in areas that may not come naturally
- Avoid suggesting changes that conflict with core personality traits
¶ Simulation Flow
¶ Detailed Simulation Interaction
┌─────────────────────────────────────────────────────────┐
│ SIMULATION PAGE │
├─────────────────────────────────────────────────────────┤
│ │
│ [Chat Window] [Sidebar] │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ │ │ Case Info │ │
│ │ Messages │ │ Skill Aims │ │
│ │ │ │ Timer │ │
│ │ │ │ Notes │ │
│ └─────────────┘ └─────────────┘ │
│ │
│ [Start Conversation Button] │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ CONVERSATION ACTIVE │
├─────────────────────────────────────────────────────────┤
│ │
│ User speaks → ElevenLabs → AI processes → │
│ AI responds (voice + text) → Displayed in chat │
│ │
│ Timer: Running │
│ Notes: Auto-saving │
│ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ END SIMULATION & VIEW RESULTS │
├─────────────────────────────────────────────────────────┤
│ │
│ • Conversation locked │
│ • Case marked complete │
│ • Notes saved │
│ • Redirect to /results │
│ │
└─────────────────────────────────────────────────────────┘
¶ Evaluation and Feedback
¶ Feedback Generation Flow
┌─────────────────────────────────────────────────────────┐
│ RESULTS PAGE LOADED │
├─────────────────────────────────────────────────────────┤
│ │
│ 1. Display conversation transcript │
│ 2. Trigger feedback generation │
│ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ COLLECT EVALUATION DATA │
├─────────────────────────────────────────────────────────┤
│ │
│ • Conversation messages (user + AI) │
│ • Skill ID │
│ • Case ID │
│ • User personality profile (from database) │
│ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ BUILD EVALUATION PROMPT │
├─────────────────────────────────────────────────────────┤
│ │
│ System Prompt Includes: │
│ • Case scenario and details │
│ • Skill objectives and aims │
│ • User's personality code (e.g., ISXL) │
│ • Personality dimensions explanation │
│ • Evaluation criteria │
│ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ GENERATE FEEDBACK (OpenAI) │
├─────────────────────────────────────────────────────────┤
│ │
│ Input: │
│ • System prompt (with personality context) │
│ • Conversation transcript │
│ │
│ Output: │
│ • Personalized feedback │
│ • Strengths identified │
│ • Improvement suggestions │
│ • Personality-aware recommendations │
│ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ DISPLAY FEEDBACK │
├─────────────────────────────────────────────────────────┤
│ │
│ • Rendered as markdown │
│ • Formatted for readability │
│ • User can review and take action │
│ │
└─────────────────────────────────────────────────────────┘
¶ Flow Diagram
¶ Complete User Journey
¶ Key Features of the User Flow
¶ 1. Mandatory Personality Assessment
- Users cannot access simulation features without completing the personality test
- Ensures all feedback is personalized from the start
- Can be retaken at any time to update profile
¶ 2. Progressive Skill Building
- Skills organized by levels (1, 2, 3)
- Each skill has multiple cases for practice
- Introduction pages provide educational context
- Progress tracking encourages completion
¶ 3. Realistic Practice Environment
- Voice-based conversations (not just text)
- AI pet owner behaves realistically based on case and skill
- Timer tracks session duration
- Notes can be taken during practice
¶ 4. Dual-Factor Feedback
- Performance Analysis: Based on actual conversation
- Personality Integration: Tailored to communication style
- Combined to provide actionable, relevant suggestions
¶ 5. Continuous Learning
- Users can retry cases to improve
- Progress is tracked across all skills and cases
- Notes persist for future reference
- Feedback helps identify areas for growth
¶ Summary
The CityU Vet Sim user flow is designed to provide a personalized learning experience:
- Registration → Account creation
- Personality Test → Communication style assessment (required)
- Skill Selection → Choose level and specific skill
- Preparation → Review introduction and instructional content
- Practice → Voice-based simulation with AI pet owner
- Evaluation → Personalized feedback combining personality and performance
- Improvement → Retry cases or move to new challenges