Phase 2 complete

TESTING_PHASE2.md

@@ -0,0 +1,155 @@
+# Phase 2 Testing Guide
+
+## 🎯 Quick Testing Steps
+
+### 1. Start the Application
+```bash
+# Terminal 1 - Backend
+cd /home/aodhan/projects/apps/storyteller
+python -m uvicorn main:app --reload --port 8000
+
+# Terminal 2 - Frontend
+cd frontend
+npm start
+```
+
+### 2. Test Character Creation Wizard
+
+1. **Open browser:** http://localhost:3000
+2. **Enter Session ID:** Type any session ID (e.g., "test-session-123")
+3. **Click "✨ Create Character (Wizard)"**
+4. **Step through wizard:**
+   - Step 1: Enter name, select gender
+   - Step 2: Add description and background
+   - Step 3: Choose race and class (click cards)
+   - Step 4: Select personality type
+   - Step 5: Choose AI model
+   - Step 6: Review and create
+
+### 3. Test Character Profile Display
+
+1. After creating character, check:
+   - Profile badges appear (Race, Class, Personality)
+   - Character info shows all details
+   - Export button is visible
+
+### 4. Test Export
+
+1. Click "📥 Export" button in character view
+2. JSON file should download
+3. Open JSON to verify all profile data is present
+
+### 5. Test Import
+
+1. Create a new session or use existing
+2. Click "✨ Create Character (Wizard)"
+3. In Step 1, click "📥 Import from JSON"
+4. Select previously exported character
+5. Verify all fields are populated
+6. Complete wizard to create
+
+### 6. Test Profile-Based LLM Prompts
+
+1. Send a message as the character
+2. Check backend logs for generated system prompt
+3. Should include race, class, and personality traits
+
+### 7. Test Backward Compatibility
+
+1. Click "↓ Quick Create" toggle
+2. Fill in simple form (legacy mode)
+3. Create character without profile
+4. Character should work normally
+
+## ✅ Expected Behavior
+
+### Wizard
+- [x] Smooth step navigation
+- [x] Visual progress indicator
+- [x] Selection cards highlight when clicked
+- [x] Form validation (name required, description required)
+- [x] Import populates all fields
+- [x] Review shows complete summary
+
+### Profile Display
+- [x] Badges show race, class, personality
+- [x] Character info section displays properly
+- [x] Export button functional
+
+### Export/Import
+- [x] Export downloads valid JSON
+- [x] JSON includes version, timestamp, character data
+- [x] Import reads JSON correctly
+- [x] Imported character gets new ID
+
+### LLM Integration
+- [x] System prompts include profile traits
+- [x] Legacy characters still work
+- [x] Profile-based prompts are coherent
+
+## 🐛 Known Issues
+
+### Fixed
+- ✅ Syntax error with escaped quotes in docstring (fixed)
+
+### To Monitor
+- Webpack deprecation warnings (harmless, won't affect functionality)
+- Frontend hot reload may require manual refresh
+
+## 🎮 Demo Session Test
+
+Try the pre-configured demo:
+1. Click "🏹 Play as Willow (Elf Ranger)"
+2. Willow should have legacy profile (no structured profile)
+3. Create new character with wizard
+4. Compare the two in gameplay
+
+## 📊 Profile Options to Test
+
+### Races
+- [ ] Human
+- [ ] Elf
+- [ ] Dwarf
+- [ ] Orc
+- [ ] Halfling
+
+### Classes
+- [ ] Warrior
+- [ ] Wizard
+- [ ] Cleric
+- [ ] Archer
+- [ ] Rogue
+
+### Personalities
+- [ ] Friendly
+- [ ] Serious
+- [ ] Doubtful
+- [ ] Measured
+
+### Combinations to Try
+- Elf Wizard (Measured) - Classic magic user
+- Dwarf Warrior (Serious) - Traditional tank
+- Halfling Rogue (Friendly) - Lovable trickster
+- Orc Cleric (Doubtful) - Interesting contrast
+- Human Archer (Measured) - Balanced ranger
+
+## 🔍 What to Check in Backend Logs
+
+When character sends message, look for system prompt like:
+```
+You are [Name], a [gender] [race] [class]. [Description] 
+[Race traits] [Class traits] [Personality traits] 
+Background: [background if provided]
+```
+
+## 📝 Feedback to Provide
+
+- UI/UX impressions
+- Any bugs or errors
+- Performance issues
+- Suggested improvements
+- Missing features
+
+---
+
+**Ready to test!** Start both servers and follow the steps above.