Implement Stage Center Calibration Wizard with Enhanced UI and Automatic Detection

[Copilot]

✨ Stage Center Calibration Wizard - Complete Implementation

This PR implements a comprehensive wizard for finding the center position of the microscope stage, similar to the existing ObjectiveCalibrationWizard, with significantly enhanced UI and automatic bright spot detection capabilities.

🎯 Key Features Implemented:

📋 6-Step Wizard Flow:

1. Setup & Overview - Beautiful introduction with feature cards and step preview
2. Manual Position Entry - Enhanced UI for entering known positions or using current position
3. Interactive Stage Map - Visual stage representation with click-to-move functionality
4. Automatic Detection - Configurable spiral scan for bright spot detection
5. Review Results - Comparison and validation of manual vs automatic results
6. Complete - Final summary and result application

🎨 Enhanced UI Design:

• Beautiful gradient backgrounds and modern Material-UI components
• Interactive stepper with clickable navigation between steps
• Color-coded cards for different calibration methods
• Real-time alerts and success/error messaging
• Responsive design for different screen sizes
• Professional styling consistent with existing ObjectiveCalibrationWizard

🔧 Technical Implementation:

• 3 new API endpoints for backend stage center calibration controller:
  • apiStageCenterCalibrationPerformCalibration - Execute spiral scan
  • apiStageCenterCalibrationGetStatus - Check calibration status
  • apiStageCenterCalibrationStopCalibration - Stop running calibration
• Complete Redux state management with dedicated StageCenterCalibrationSlice
• Interactive stage map visualization with SVG-based coordinate mapping
• Real-time position tracking and updates
• Configurable scan parameters (exposure time, speed, step size, brightness factor)
• Error handling and user feedback throughout the process

🗺️ Stage Map Features:

• Visual representation of stage coordinate system
• Click-to-move functionality for easy navigation
• Real-time position indicators for current, manual, and found centers
• Configurable map dimensions and zoom levels
• Grid overlay for precise positioning

🔍 Automatic Detection Features:

• Spiral scan algorithm that expands outward from start position
• Configurable parameters:
  • Start position (X, Y coordinates)
  • Exposure time (microseconds)
  • Movement speed
  • Step size for scan resolution
  • Maximum scan radius
  • Brightness detection factor
• Real-time progress tracking with ability to stop mid-scan
• Results validation and comparison with manual methods

🚀 Usage:

1. Navigate to Stage Offset Calibration in the app
2. Click the "🔍 Stage Center Wizard" button
3. Follow the 6-step guided process:
   • Review setup instructions and wizard overview
   • Enter manual position or use current position
   • Use interactive stage map for visual navigation
   • Configure and run automatic bright spot detection
   • Review and compare results from different methods
   • Apply chosen calibration and complete the process

📸 Screenshots:

The wizard's beautiful introduction step with gradient styling, feature cards, and comprehensive overview of all steps.

Enhanced manual position entry with current position display, center coordinate input, and clear instructional guidance.

🔗 Integration:

The wizard seamlessly integrates with the existing stage control system:

• Uses existing position APIs for real-time tracking
• Maintains compatibility with current stage offset calibration
• Follows the same patterns as ObjectiveCalibrationWizard
• Properly handles Redux state management
• Includes comprehensive error handling

🎁 Benefits:

• Improved User Experience: Beautiful, intuitive interface guides users through calibration
• Multiple Methods: Users can choose between manual positioning and automatic detection
• Visual Feedback: Interactive stage map provides clear spatial understanding
• Precision: Configurable parameters allow fine-tuning for different setups
• Validation: Multiple methods can be compared for accuracy verification
• Professional UI: Consistent with existing design language and enhanced aesthetics

Fixes #61.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[openuc2-gmbh]

Current observations => It works, but we need minor changes:

• we want to recycle the stage map from the Experiment controller and its behaviour when clicking anywhere to move there
• we want to display the current live stream from the camera as a small tile somewhere in the wizard at all times
• in the first view of the stage center calibration (not wizard) we want to use the joystick that is also in the liveview to move the stage and cleanup this component and make the button for the wizard more prominent

[Copilot]

Current observations => It works, but we need minor changes:

• we want to recycle the stage map from the Experiment controller and its behaviour when clicking anywhere to move there
• we want to di...

I've implemented all the requested changes in commit bcb1bfe:

✅ Recycled stage map from Experiment controller: Replaced custom StageMapVisualization with WellSelectorCanvas that has the existing click-to-move behavior

✅ Added live stream tiles: LiveStreamTile component now shows current camera feed as a small tile in all wizard steps

✅ Enhanced main view with joystick: StageOffsetCalibrationController now uses the full JoystickController component from LiveView, and the wizard button is much more prominent with enhanced styling

The wizard now provides a consistent experience using the same well-tested components throughout the application.

[openuc2-gmbh]

@Mikrodoktor @ranranking I'm done for now - please go through the document and mark todos with TODO: TEXT. Also, if we need to show additional features with videos/images, note it please (e.g. software, something from the microscope's operation, etc.). Some videos (e.g. youtube) are not yet rendered correctly as markdown doesn't allow us doing that. Later we will move that to our main documentation @ openuc2.github.io.

Thank you :-)