Add missing group YAML files and update examples documentation

Co-authored-by: Grazulex <[email protected]>

Author: Copilot

examples/README.md

@@ -222,23 +222,64 @@ php artisan flowpipe:export user-registration --format=md --output=docs/user-reg
 
 ## Step Groups
 
-The examples demonstrate three types of reusable step groups:
+The examples demonstrate multiple types of reusable step groups organized by functionality:
 
-### User Validation Group (`groups/user-validation.yaml`)
+### User-Related Groups
+
+#### User Validation Group (`groups/user-validation.yaml`)
 - Email format validation
 - Password strength checking
 - Required field validation
 - User existence checking
 - Terms acceptance validation
 
-### Order Processing Group (`groups/order-processing.yaml`)
+#### User Setup Group (`groups/user-setup.yaml`)
+- User ID generation
+- Password hashing
+- Profile creation
+- Default preferences setup
+- API key generation
+
+#### User Notifications Group (`groups/user-notifications.yaml`)
+- Welcome email sending
+- Email verification dispatch
+- Admin notifications
+- Registration event logging
+- User statistics updates
+
+### E-commerce Groups
+
+#### Order Validation Group (`groups/order-validation.yaml`)
+- Order structure validation
+- Customer information validation
+- Item and quantity validation
+- Order total verification
+- Business rules checking
+
+#### Inventory Management Group (`groups/inventory-management.yaml`)
+- Item availability checking
+- Inventory reservation
+- Shipping cost calculation
+- Inventory level updates
+- Inventory reporting
+
+#### Order Notifications Group (`groups/order-notifications.yaml`)
+- Order confirmation emails
+- SMS notifications
+- Customer account updates
+- Warehouse notifications
+- Notification event logging
+
+### General Processing Groups
+
+#### Order Processing Group (`groups/order-processing.yaml`)
 - Order data validation
 - Inventory checking and reservation
 - Payment processing
 - Order record creation
 - Confirmation generation
 
-### Notifications Group (`groups/notifications.yaml`)
+#### Notifications Group (`groups/notifications.yaml`)
 - Welcome email sending
 - Verification email dispatch
 - SMS notifications

examples/groups/inventory-management.yaml

@@ -0,0 +1,31 @@
+# Example: Inventory Management Group
+# File: groups/inventory-management.yaml
+
+group: inventory-management
+description: Manage inventory for e-commerce orders
+
+steps:
+  # Check item availability
+  - type: closure
+    action: check_item_availability
+    description: Check if all items are available in requested quantities
+    
+  # Reserve inventory items
+  - type: closure
+    action: reserve_items
+    description: Reserve items for this order
+    
+  # Calculate shipping costs
+  - type: closure
+    action: calculate_shipping
+    description: Calculate shipping costs based on items and location
+    
+  # Update inventory levels
+  - type: closure
+    action: update_inventory_levels
+    description: Update inventory levels after reservation
+    
+  # Generate inventory report
+  - type: closure
+    action: generate_inventory_report
+    description: Generate inventory status report for this order

examples/groups/order-notifications.yaml

@@ -0,0 +1,31 @@
+# Example: Order Notifications Group  
+# File: groups/order-notifications.yaml
+
+group: order-notifications
+description: Send notifications for e-commerce orders
+
+steps:
+  # Send order confirmation email
+  - type: closure
+    action: send_order_confirmation
+    description: Send order confirmation email to customer
+    
+  # Send SMS notification
+  - type: closure
+    action: send_sms_notification
+    description: Send SMS notification if customer opted in
+    
+  # Update customer account
+  - type: closure
+    action: update_customer_account
+    description: Update customer's order history
+    
+  # Notify warehouse
+  - type: closure
+    action: notify_warehouse
+    description: Notify warehouse team about new order
+    
+  # Log notification events
+  - type: closure
+    action: log_notifications
+    description: Log all notification events for auditing

examples/groups/order-validation.yaml

@@ -0,0 +1,31 @@
+# Example: Order Validation Group
+# File: groups/order-validation.yaml
+
+group: order-validation
+description: Validate e-commerce order data and requirements
+
+steps:
+  # Validate order structure
+  - type: closure
+    action: validate_order_structure
+    description: Ensure order contains required fields
+    
+  # Validate customer information
+  - type: closure
+    action: validate_customer_info
+    description: Validate customer name, email, and address
+    
+  # Validate items and quantities
+  - type: closure
+    action: validate_items
+    description: Validate item names, prices, and quantities
+    
+  # Calculate and verify total
+  - type: closure
+    action: verify_order_total
+    description: Calculate total and verify against provided total
+    
+  # Check business rules
+  - type: closure
+    action: check_business_rules
+    description: Apply business rules (minimum order, restrictions, etc.)

examples/groups/user-notifications.yaml

@@ -0,0 +1,31 @@
+# Example: User Notifications Group
+# File: groups/user-notifications.yaml
+
+group: user-notifications
+description: Send notifications for new user registration
+
+steps:
+  # Send welcome email
+  - type: closure
+    action: send_welcome_email
+    description: Send welcome email with account details
+    
+  # Send verification email  
+  - type: closure
+    action: send_verification_email
+    description: Send email verification link
+    
+  # Send admin notification
+  - type: closure
+    action: notify_admin
+    description: Notify administrators about new user registration
+    
+  # Log registration event
+  - type: closure
+    action: log_registration
+    description: Log user registration event for analytics
+    
+  # Update user stats
+  - type: closure
+    action: update_user_stats
+    description: Update application user statistics

examples/groups/user-setup.yaml

@@ -0,0 +1,31 @@
+# Example: User Setup Group
+# File: groups/user-setup.yaml
+
+group: user-setup
+description: Set up new user account and profile
+
+steps:
+  # Generate user ID
+  - type: closure
+    action: generate_user_id
+    description: Generate unique user identifier
+    
+  # Hash password
+  - type: closure
+    action: hash_password
+    description: Hash user password securely
+    
+  # Create user profile
+  - type: closure
+    action: create_user_profile
+    description: Create initial user profile with default settings
+    
+  # Set default preferences
+  - type: closure
+    action: set_default_preferences
+    description: Set default user preferences and settings
+    
+  # Generate API key
+  - type: closure
+    action: generate_api_key
+    description: Generate API key for user account