Implement Resource and Production entities

[CoderMariusz]

…gration Tests

This commit implements STORY-01.7 (Building Sprite Component) and STORY-01.8 (Integration Test) completing BATCH 4 of EPIC-01.

New Features

BuildingComponent (STORY-01.7 - 3 SP)

• Full-featured building sprite component with tap detection
• Procedural rendering with color-coded building types (ready for sprite assets)
• Grid-to-screen position conversion using GridConfig
• Tap-to-collect resource functionality with animations
• Pulse animation on tap (ScaleEffect with easing)
• Floating text animation showing collected resources
• Performance tested with 25+ buildings at 60 FPS
• Activity indicators for active buildings

Integration Tests (STORY-01.8 - 5 SP)

• Comprehensive core gameplay loop test
• Verifies: Launch → Tap Building → Collect Resources → Upgrade Building
• Tests resource collection and inventory updates
• Tests gold deduction and level increase
• Tests production rate calculations
• Error handling tests (insufficient gold, max level)
• Performance test (<30 second completion requirement)

Game Integration

• Added 5 test buildings to main game (various types and levels)
• Real-time economy tracking in CameraInfoDisplay
• Resource collection callback system
• PlayerEconomy initialization and updates

Files Created (4)

1. lib/game/components/building_component.dart (340 lines)

   • BuildingComponent class with tap detection
   • FloatingTextComponent for visual feedback

2. integration_test/core_gameplay_loop_test.dart (432 lines)

   • 4 comprehensive test scenarios
   • Full gameplay verification

3. test/game/components/building_component_test.dart (384 lines)

   • 14 unit tests
   • Performance tests

4. BATCH_4_COMPLETION.md (detailed completion report)

Files Modified (2)

1. lib/main.dart (+132 lines)

   • PlayerEconomy initialization
   • Test building creation system
   • Resource collection callback handling
   • Economy display in UI

2. pubspec.yaml

   • Added integration_test package
   • Added flame_test package
   • Prepared asset configuration

Test Coverage

• 14 unit tests for BuildingComponent
• 4 integration tests for gameplay loop
• Performance verified with 25 buildings
• All acceptance criteria met

Performance Metrics

✅ 60 FPS with 20+ buildings
✅ Integration tests complete in <30 seconds
✅ Smooth animations and interactions
✅ Spatial culling integration

Dependencies

• Integrates with BATCH 1-2 (Domain entities, use cases)
• Integrates with BATCH 3 (Grid, Camera systems)
• Ready for sprite asset integration

Closes STORY-01.7, STORY-01.8