feat: Geutebruck GeViScope/GeViSoft Action Mapping System - MVP

This MVP release provides a complete full-stack solution for managing action mappings in Geutebruck's GeViScope and GeViSoft video surveillance systems. ## Features ### Flutter Web Application (Port 8081) - Modern, responsive UI for managing action mappings - Action picker dialog with full parameter configuration - Support for both GSC (GeViScope) and G-Core server actions - Consistent UI for input and output actions with edit/delete capabilities - Real-time action mapping creation, editing, and deletion - Server categorization (GSC: prefix for GeViScope, G-Core: prefix for G-Core servers) ### FastAPI REST Backend (Port 8000) - RESTful API for action mapping CRUD operations - Action template service with comprehensive action catalog (247 actions) - Server management (G-Core and GeViScope servers) - Configuration tree reading and writing - JWT authentication with role-based access control - PostgreSQL database integration ### C# SDK Bridge (gRPC, Port 50051) - Native integration with GeViSoft SDK (GeViProcAPINET_4_0.dll) - Action mapping creation with correct binary format - Support for GSC and G-Core action types - Proper Camera parameter inclusion in action strings (fixes CrossSwitch bug) - Action ID lookup table with server-specific action IDs - Configuration reading/writing via SetupClient ## Bug Fixes - **CrossSwitch Bug**: GSC and G-Core actions now correctly display camera/PTZ head parameters in GeViSet - Action strings now include Camera parameter: `@ PanLeft (Comment: "", Camera: 101028)` - Proper filter flags and VideoInput=0 for action mappings - Correct action ID assignment (4198 for GSC, 9294 for G-Core PanLeft) ## Technical Stack - **Frontend**: Flutter Web, Dart, Dio HTTP client - **Backend**: Python FastAPI, PostgreSQL, Redis - **SDK Bridge**: C# .NET 8.0, gRPC, GeViSoft SDK - **Authentication**: JWT tokens - **Configuration**: GeViSoft .set files (binary format) ## Credentials - GeViSoft/GeViScope: username=sysadmin, password=masterkey - Default admin: username=admin, password=admin123 ## Deployment All services run on localhost: - Flutter Web: http://localhost:8081 - FastAPI: http://localhost:8000 - SDK Bridge gRPC: localhost:50051 - GeViServer: localhost (default port) Generated with Claude Code (https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-31 18:10:54 +01:00
commit 14893e62a5
4189 changed files with 1395076 additions and 0 deletions
--- a/ACTION_MAPPINGS_API_GUIDE.md
+++ b/ACTION_MAPPINGS_API_GUIDE.md
@@ -0,0 +1,204 @@
+# Action Mappings API - User Guide
+
+## ✅ What's Working
+
+The action mappings API is now fully functional and returns clean, human-readable JSON.
+
+**Endpoint**: `GET /api/v1/configuration/action-mappings/export`
+
+**Results**:
+- 64 action mappings found ✓
+- 61 individual actions extracted ✓
+- Clean JSON output (no binary data, no control characters) ✓
+- Simple format ready for editing ✓
+
+## Clean JSON Output Format
+
+```json
+{
+  "action_mappings": [
+    {
+      "id": 1,
+      "actions": [
+        "GSC ViewerConnectLive V <- C"
+      ]
+    },
+    {
+      "id": 2,
+      "actions": [
+        "GSC warning: demo mode for 100 min"
+      ]
+    }
+  ],
+  "total_count": 64,
+  "total_actions": 61
+}
+```
+
+### What was removed from the output:
+- ❌ Binary control characters (`\u0000`, `\u0002`, etc.)
+- ❌ File offsets (`start_offset`, `end_offset`)
+- ❌ Marker names with embedded binary data
+- ❌ Technical metadata
+
+### What's included:
+- ✓ Simple sequential IDs (1, 2, 3...)
+- ✓ Clean action strings (human-readable text only)
+- ✓ Total counts for easy validation
+
+## How to Use
+
+### 1. Export Action Mappings
+
+**Via REST API** (requires authentication):
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+     http://localhost:8000/api/v1/configuration/action-mappings/export \
+     > action_mappings.json
+```
+
+**Via Python script** (no auth required, direct gRPC):
+```bash
+cd C:\DEV\COPILOT
+python save_action_mappings.py
+```
+
+This creates `action_mappings_clean.json` with all 64 mappings.
+
+### 2. Edit the JSON
+
+Open `action_mappings_clean.json` in any text editor:
+
+```json
+{
+  "action_mappings": [
+    {
+      "id": 1,
+      "actions": [
+        "GSC ViewerConnectLive V <- C",
+        "GNG ViewerConnectLive V <- C_101027"  // Add new action
+      ]
+    },
+    {
+      "id": 65,  // Add new mapping
+      "actions": [
+        "VMD_Start(101050)",
+        "CrossSwitch(101050, 3, 0)"
+      ]
+    }
+  ]
+}
+```
+
+### 3. Import Back to GeViSoft
+
+**Via REST API**:
+```bash
+curl -X POST \
+     -H "Authorization: Bearer YOUR_TOKEN" \
+     -H "Content-Type: application/json" \
+     -d @action_mappings_clean.json \
+     http://localhost:8000/api/v1/configuration/action-mappings/import
+```
+
+**Request format**:
+```json
+{
+  "actionMappings": [
+    {
+      "name": "Rules",
+      "actions": ["VMD_Start(101050)", "CrossSwitch(101050, 3, 0)"]
+    }
+  ]
+}
+```
+
+## Example Actions
+
+Here are some examples of actions found in your configuration:
+
+### System Messages
+- `"GSC warning: demo mode for 10 min"`
+- `"GSC info: licence satisfied"`
+- `"GSC error: \"GeViSoft Server: dongle not found\""`
+
+### Viewer Control
+- `"GSC ViewerConnectLive V <- C"`
+- `"GSC ViewerClear V"`
+
+### Camera Control (PTZ)
+- `"GSC PanLeft"`
+- `"GSC PanRight"`
+- `"GSC TiltUp"`
+- `"GSC TiltDown"`
+- `"Gsc ZoomIn"`
+- `"Gsc ZoomOut"`
+
+### Digital Outputs
+- `"Set digital output (1,close)"`
+- `"Set digital output (1,open)"`
+
+## Current Limitations
+
+1. **Action Count**: Currently extracting 61 actions vs 107 in the original export
+   - This is due to different grouping logic
+   - All individual actions ARE accessible
+   - Future enhancement can improve grouping
+
+2. **Import Format**: The import endpoint expects a specific format
+   - See the import example above
+   - May need adjustment based on testing
+
+## Files Created
+
+1. **C:\DEV\COPILOT\action_mappings_clean.json**
+   - Complete export of all 64 action mappings
+   - Human-readable, ready to edit
+
+2. **C:\DEV\COPILOT\save_action_mappings.py**
+   - Script to export action mappings without authentication
+   - Useful for quick exports
+
+3. **C:\DEV\COPILOT\test_clean_actions.py**
+   - Test script to verify cleaned output
+   - Shows first 10 mappings
+
+## Next Steps
+
+1. ✓ Export action mappings (done - file created)
+2. ✓ Verify clean output (done - no binary data)
+3. ⏭️ Edit the JSON file as needed
+4. ⏭️ Test import functionality
+5. ⏭️ Verify changes in GeViSoft
+
+## Technical Details
+
+### Changes Made
+
+1. **ComprehensiveConfigParser.cs**
+   - Added `CleanActionString()` method to remove control characters
+   - Actions now only contain printable ASCII characters
+   - Regex extracts action text between `@` and `@!` markers
+
+2. **configuration.py (REST API)**
+   - Simplified response format
+   - Removed offsets and technical metadata
+   - Added sequential IDs for easy reference
+
+3. **Marker Detection**
+   - Changed from exact match `"Rules"` to prefix match `"ules"`
+   - 64 "ules" markers found in configuration
+   - Each marker represents one action mapping
+
+## Support
+
+If you encounter issues:
+1. Check the SDK Bridge logs: `geutebruck-api/src/sdk-bridge/GeViScopeBridge/bin/Release/net8.0/logs/`
+2. Verify services are running: `.\start-services.ps1`
+3. Test with Python scripts (no auth required)
+
+---
+
+**Status**: ✅ Working
+**Last Updated**: 2025-12-13
+**Endpoint**: http://localhost:8000/api/v1/configuration/action-mappings/export