novafarma/docs/INTEGRATION_TEST_PLAN.md

🧪 INTEGRATION TEST PLAN - PART 1

Date: 15.12.2025
Duration: 30 minutes
Goal: Test all existing systems (water, puddles, ripples, save/load, crafting)

---

🎯 TASK 1.1: Crafting System Integration ✅

Status: ALREADY INTEGRATED!

• ✅ CraftingSystem.js loaded in index.html (line 187)
• ✅ CraftingUI.js loaded in index.html (line 188)
• ✅ Crafting system initialized in GameScene.create() (line 493-506)
• ✅ Update call already exists in GameScene.update() (line 1541)
• ✅ C key bound to toggle crafting UI (line 501-505)

Conclusion: Crafting system fully integrated! ✅

---

🧪 TASK 1.2: System Testing Checklist

Test 1: Water Visuals (Smooth Animation)

Steps:

1. Launch game (npx electron .)
2. Navigate to area with water tiles
3. Observe water animation

Expected:

• ✅ Water tiles should animate smoothly (flowing effect)
• ✅ No glitches or jittering
• ✅ Smooth transitions between frames

Result: ⬜ PENDING

Test 2: Puddles System (R → Rain → Puddles)

Steps:

1. Press R key to toggle rain
2. Wait 5-10 seconds
3. Observe puddles forming on grass/dirt tiles

Expected:

• ✅ Rain particles fall from sky
• ✅ Puddles appear on grass/dirt (NOT water!)
• ✅ Puddles fade in smoothly (opacity 0 → 0.35)
• ✅ Max 15 puddles at once (oldest removed)
• ✅ Puddles disappear after 30 seconds

Result: ⬜ PENDING

Test 3: Ripples on Water (Rain Impact)

Steps:

1. Keep rain active (R key)
2. Navigate to water tiles
3. Observe ripples when rain hits water

Expected:

• ✅ Ripples appear on water tiles (white circles)
• ✅ Ripples expand outward (concentric circles)
• ✅ Ripples fade out smoothly
• ✅ Visual "splash" effect on impact

Result: ⬜ PENDING

Test 4: Save Game (F5)

Steps:

1. Move player to a specific location (e.g., x=60, y=60)
2. Add some items to inventory (wood, stone)
3. Press F5 to save
4. Close game

Expected:

• ✅ Console message: "💾 Game saved!"
• ✅ No errors in console
• ✅ Save file created in localStorage

Result: ⬜ PENDING

Test 5: Load Game (F9)

Steps:

1. Relaunch game
2. Press F9 to load save
3. Check player position and inventory

Expected:

• ✅ Player spawns at saved location
• ✅ Inventory restored correctly
• ✅ All game state restored (day/night, weather, etc.)
• ✅ Console message: "📂 Game loaded!"

Result: ⬜ PENDING

Test 6: Crafting UI (C key)

Steps:

1. Press C key to open crafting menu
2. Check available recipes
3. Try crafting an item (if resources available)
4. Press C again to close

Expected:

• ✅ Crafting menu opens smoothly
• ✅ Recipes displayed correctly
• ✅ Can select recipe
• ✅ Crafting progress bar shows
• ✅ Item added to inventory on completion
• ✅ Menu closes on C key

Result: ⬜ PENDING

Test 7: All 10 Recipes Visible

Steps:

1. Open crafting menu (C key)
2. Count visible recipes
3. Check if categories work

Expected:

• ✅ At least 10 recipes visible
• ✅ Each recipe shows name, ingredients, result
• ✅ Locked/unlocked status clear
• ✅ Categories filter correctly

Result: ⬜ PENDING

Test 8: Console Errors Check

Steps:

1. Open DevTools console (F12)
2. Perform all above tests
3. Check for errors

Expected:

• ✅ NO red errors in console
• ✅ Only warnings or info messages
• ✅ Clean execution

Result: ⬜ PENDING

Test 9: FPS Performance

Steps:

1. Press F3 to show performance monitor
2. Run around map, enable rain, open crafting
3. Monitor FPS

Expected:

• ✅ FPS stays above 50 (ideally 60)
• ✅ No major frame drops
• ✅ Smooth gameplay

Result: ⬜ PENDING

Test 10: Resource Display

Steps:

1. Check top-right UI for resource counts
2. Add/remove items
3. Verify counts update

Expected:

• ✅ Wood, Stone, Iron counts visible
• ✅ Counts update in real-time
• ✅ Animated +/- effects work

Result: ⬜ PENDING

---

📋 SUMMARY

Total Tests: 10
Passed: ⬜ / 10
Failed: ⬜ / 10
Skipped: ⬜ / 10

Critical Bugs Found: ⬜
Minor Issues Found: ⬜

---

🛠️ NEXT STEPS

After testing:

1. ✅ If all tests pass → Proceed to PART 2: TILED IMPLEMENTATION
2. ⚠️ If tests fail → Fix critical bugs, retest
3. 📝 Document any issues in separate bug report

---

Testing Start Time: _____________
Testing End Time: _____________
Tester: _____________
Notes: