geutebruck/HOW_TO_TEST_NEW_FEATURES.md

How to Test the New Action Picker Features

Prerequisites

✅ API server is running on http://100.81.138.77:8000 ✅ All new files are in place

Steps to See the New Features

1. Stop the Running App

If the Flutter app is currently running, stop it completely:

• VS Code: Press the stop button (red square) or Shift+F5
• Android Studio: Click Stop (red square) in the toolbar

2. Rebuild and Run

Start the app fresh to pick up the new code:

• VS Code: Press F5 or click Run > Start Debugging
• Android Studio: Click Run (green triangle) or Shift+F10

IMPORTANT: Hot reload (⚡) won't work for these changes - you need a full restart!

3. Navigate to Action Mappings

1. Login with your credentials
2. Open the menu (≡)
3. Click "Action Mappings"
4. Click "Add Action Mapping" or edit an existing one

4. Test the New Action Picker

Adding an Output Action:

1. In the form, scroll to "Output Actions" section
2. Click the "Add Output Action" button
3. You should see a NEW dialog (800x600px) with:
   • Left side: Category dropdown + Action list
   • Right side: Parameters section

Using the Action Picker:

1. Select a category (e.g., "Camera Control")
2. Click an action from the list (e.g., "PanStop")
3. Enable parameters by checking boxes
4. Fill in parameter values
5. Enter a caption
6. Click "Ok"
7. The action should appear in the form with all parameters

Editing an Action:

1. Click the edit button (✎) on any output action card
2. The action picker should open with existing values
3. Modify and click "Ok"

Reordering Actions:

1. Add 2+ output actions
2. Use the ▲ ▼ buttons to reorder them

5. What You Should See

Before (Old UI):

• Dropdown with 29 hardcoded actions
• Manual parameter editing dialogs
• No reordering

After (New UI):

• "Add Output Action" button
• Action picker dialog with categories
• 45 actions across 10 categories
• Dynamic parameter fields with checkboxes
• Action descriptions shown
• Up/Down buttons to reorder

Troubleshooting

Issue: Still seeing the old UI with dropdown

Solution: You didn't do a full rebuild

• Stop the app completely
• Close all running processes
• Run from IDE again (not hot reload!)

Issue: "Failed to load action templates"

Check:

1. API server is running: http://100.81.138.77:8000
2. You're logged in
3. Check browser/app logs for errors

Test the API endpoints manually:

# Get token
curl -X POST http://100.81.138.77:8000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

# Test categories endpoint
curl http://100.81.138.77:8000/api/v1/configuration/action-categories \
  -H "Authorization: Bearer YOUR_TOKEN"

# Test action types endpoint
curl http://100.81.138.77:8000/api/v1/configuration/action-types \
  -H "Authorization: Bearer YOUR_TOKEN"

Issue: Build errors / Red squiggles

Check these files exist:

• ✅ lib/data/models/action_template.dart
• ✅ lib/data/services/action_template_service.dart
• ✅ lib/presentation/widgets/action_picker_dialog.dart

Run in terminal:

cd C:\DEV\COPILOT\geutebruck_app
flutter clean
flutter pub get
flutter run

Issue: "ApiConstants.baseUrl not found"

The file exists at lib/core/constants/api_constants.dart Make sure imports are correct in action_template_service.dart

Files Changed

New Files (3):

1. lib/data/models/action_template.dart
2. lib/data/services/action_template_service.dart
3. lib/presentation/widgets/action_picker_dialog.dart

Modified Files (1): 4. lib/presentation/screens/action_mappings/action_mapping_form_screen.dart

Backend Endpoints

These should all be working:

• ✅ GET /api/v1/configuration/action-categories
• ✅ GET /api/v1/configuration/action-types
• ✅ GET /api/v1/configuration/action-types/{name}

Expected Behavior

Creating a New Action Mapping:

1. Fill name, description, input action
2. Click "Add Output Action"
3. NEW DIALOG APPEARS ← This is the key change!
4. Select category "Camera Control"
5. Select action "PanStop"
6. Check "GCoreServer" parameter
7. Enter value "gscope-cdu-3"
8. Check "PTZ head" parameter
9. Enter value "101027"
10. Enter caption "Stop Pan Camera 1"
11. Click "Ok"
12. Action appears in form with 2 parameters shown
13. Click "Create Action Mapping"

Editing Existing Action:

1. Open existing mapping
2. Click edit button (✎) on output action
3. NEW DIALOG APPEARS with existing values
4. Modify parameters
5. Click "Ok"
6. Click "Update Action Mapping"

Still Not Working?

Send me:

1. Screenshot of what you see
2. Any error messages from console/logs
3. What step you're at in the process

The dialog MUST appear when you click "Add Output Action" - if you don't see it, the app hasn't picked up the new code yet.