wip: dynamic availability of services

docs/README.md

@@ -30,6 +30,14 @@ This directory contains comprehensive documentation for the MyEP Next Booking sy
 - Implementation details and UX improvements
 - **Status**: ✅ Implementation completed successfully
 
+#### [SERVICE_AVAILABILITY_SYSTEM.md](SERVICE_AVAILABILITY_SYSTEM.md)
+**Dynamic Service Availability System**
+- Prevents overbooking within single booking sessions
+- Real-time availability tracking across all participants
+- Dynamic service filtering based on capacity limits
+- Seamless HTMX integration for instant updates
+- **Status**: ✅ Implementation completed successfully
+
 ### Feature Implementation Guides
 
 #### [TRANSPORTATION_SERVICES_IMPLEMENTATION_PLAN.md](TRANSPORTATION_SERVICES_IMPLEMENTATION_PLAN.md)
@@ -105,6 +113,7 @@ This directory contains comprehensive documentation for the MyEP Next Booking sy
 | **Conditional Field States** | ✅ | ✅ | ✅ | ✅ |
 | **HTMX Integration** | ✅ | ✅ | ✅ | ✅ |
 | **BPN API Integration** | ✅ | ✅ | ✅ | ✅ |
+| **Dynamic Availability System** | ✅ | ✅ | ✅ | ✅ |
 | **Age-Based Constraints** | ✅ | 🔄 | ⏳ | ⏳ |
 | **Advanced Pricing** | ✅ | ⏳ | ⏳ | ⏳ |
 
@@ -136,6 +145,9 @@ $this->fieldStateConditions['advancedServices'] = [
 # config/services.yaml
 App\Form\Service\ParticipantTransportationOutboundFieldHandler:
     tags: [{ name: 'app.participant_field_handler', priority: 100 }]
+
+App\Service\ServiceAvailabilityCalculator:
+    # Automatically registered via autowiring
 ```
 
 ## 🧪 Testing Strategy
@@ -155,6 +167,9 @@ App\Form\Service\ParticipantTransportationOutboundFieldHandler:
 ./vendor/bin/phpunit tests/Service/          # Service layer
 ./vendor/bin/phpunit tests/BusProNet/        # API integration
 ./vendor/bin/phpunit tests/Form/             # Form processing
+
+# Test availability system
+bin/console debug:container ServiceAvailabilityCalculator
 ```
 
 ## 📈 Performance Considerations
@@ -170,6 +185,7 @@ App\Form\Service\ParticipantTransportationOutboundFieldHandler:
 - HTMX response times
 - BPN API communication latency
 - Database query optimization
+- Service availability calculation performance
 
 ## 🔄 Development Workflow
 
@@ -211,12 +227,14 @@ App\Form\Service\ParticipantTransportationOutboundFieldHandler:
 - **Enhanced BPN Integration**: Extended API coverage
 - **Mobile Optimization**: Responsive design improvements
 - **Analytics Integration**: User behavior tracking
+- **Cross-Session Availability**: Extend availability tracking beyond single sessions
 
 ### Technical Debt
 - **Code Coverage**: Increase test coverage to 90%+
 - **Performance Optimization**: Form rendering improvements
 - **Documentation**: API endpoint documentation
 - **Monitoring**: Enhanced logging and metrics
+- **Availability Testing**: Comprehensive test coverage for availability system
 
 ---