QUICK_TEST_GUIDE.md

🧪 Quick Test Guide - Session Isolation

✅ Automated Tests: PASSED!

All 5 automated tests passed successfully:

• ✅ Basic Isolation
• ✅ Concurrent Updates
• ✅ User Cleanup
• ✅ Chat History Simulation
• ✅ Session Statistics

---

🎯 Manual Testing Instructions (5 Minutes)

What You Need:

1. Browser 1 (e.g., Chrome)
2. Browser 2 (e.g., Chrome Incognito or Firefox)
3. Two different user accounts from your AUTH_CREDENTIALS

---

📝 Step-by-Step Test

Step 1: Open Your App in Both Browsers

Browser 1:

1. Go to: https://huggingface.co/spaces/John-jero/IDWeekAgents
2. Login with: [first username]:[password]
   Example: user1:password1

Browser 2:

1. Open Incognito/Private window
2. Go to: https://huggingface.co/spaces/John-jero/IDWeekAgents  
3. Login with: [second username]:[password]
   Example: user2:password2

---

Step 2: Test Simple Chat (Main Test)

Browser 1 (User 1):

1. Click "Simple Chat" tab
2. Type: "Hello, I'm User 1"
3. Press Enter
4. You should see bot's response
5. Type: "This is my private message"
6. Press Enter

Browser 2 (User 2):

1. Click "Simple Chat" tab
2. CHECK: You should see EMPTY chat (NO User 1 messages!)
3. Type: "Hello, I'm User 2"
4. Press Enter
5. You should see bot's response

Go back to Browser 1:

CHECK: You should ONLY see your own messages
       (NOT User 2's messages)

---

✅ Success Criteria

✅ PASS if:

• Browser 1 shows ONLY User 1's messages
• Browser 2 shows ONLY User 2's messages
• No messages mixed between users
• Both can chat simultaneously

❌ FAIL if:

• User 2 sees User 1's messages
• Messages get mixed up
• App crashes with multiple users

---

🎉 Expected Result

Browser 1 (User 1):          Browser 2 (User 2):
┌─────────────────────┐      ┌─────────────────────┐
│ User: Hello User 1  │      │ User: Hello User 2  │
│ Bot: Hi User 1!     │      │ Bot: Hi User 2!     │
│ User: Private msg   │      │                     │
│ Bot: Response...    │      │                     │
└─────────────────────┘      └─────────────────────┘
   ↑                            ↑
   Different messages!          Different messages!
   No overlap! ✅               No overlap! ✅

---

🐛 If Test Fails

Check These:

1. Are you using DIFFERENT usernames?

   • ❌ Bad: Both browsers use "user1"
   • ✅ Good: Browser 1 = "user1", Browser 2 = "user2"

2. Are you logged in?

   • You should see the app interface, not login screen

3. Is AUTH_CREDENTIALS set in HF Spaces?

   • Go to Space Settings → Repository Secrets
   • Check AUTH_CREDENTIALS exists

4. Browser console errors?

   • Press F12 to open DevTools
   • Check Console tab for errors

---

📊 What's Working vs What's Not

✅ WORKING (Implemented):

• ✅ Simple Chat isolation
• ✅ Deployed agent chat isolation
• ✅ Concurrent user access
• ✅ Thread-safe operations

⚠️ NOT YET WORKING (Needs more updates):

• ⚠️ Agent Builder per-user
• ⚠️ Patient data per-user
• ⚠️ Some other features

This is EXPECTED! We implemented the core system for chat isolation first.

---

🚀 Quick 60-Second Test

Super quick validation:

1. Open app in 2 browsers with different users
2. Both go to Simple Chat
3. User 1: type "test1"
4. User 2: type "test2"
5. Check: User 1 sees only "test1", User 2 sees only "test2"

Result:

• ✅ If isolated → Session isolation works!
• ❌ If mixed → Need to debug

---

📸 What You Should See

Login Screen (Both Browsers):

┌────────────────────────────────┐
│  🦠 ID Agents                  │
│  Beta Testing Access Portal    │
│                                │
│  Username: [___________]       │
│  Password: [___________]       │
│  [Login]                       │
└────────────────────────────────┘

After Login (Different for each user):

Browser 1:                    Browser 2:
User: user1                   User: user2
┌──────────────┐             ┌──────────────┐
│ Simple Chat  │             │ Simple Chat  │
│ Agent Builder│             │ Agent Builder│
│ Chat Panel   │             │ Chat Panel   │
└──────────────┘             └──────────────┘
   ↓                            ↓
[User1's data]              [User2's data]

---

🎓 Tips for Testing

1. Use clear usernames like "alice" and "bob" so you can easily tell who is who

2. Test systematically - one feature at a time

3. Document results - note what works and what doesn't

4. Take screenshots if you find issues

5. Check server logs in HF Spaces if something breaks

---

📞 Getting Help

If you encounter issues:

1. Run automated test again:

   python test_isolation_automated.py
   

2. Check detailed guide:

   See: TEST_SESSION_ISOLATION.md
   

3. Check implementation docs:

   See: IMPLEMENTATION_SUMMARY.md
   

---

✨ Summary

You're testing:
Whether different users have separate, isolated chat histories

Why it matters:
In your workshop, you don't want participants seeing each other's work!

Expected outcome:
✅ Each user gets their own private workspace

---

Ready to test? Start with Step 1 above! 🚀

Good luck! 🍀