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>
This commit is contained in:
Administrator
2025-12-31 18:10:54 +01:00
commit 14893e62a5
4189 changed files with 1395076 additions and 0 deletions

88
test_api_structured.py Normal file
View File

@@ -0,0 +1,88 @@
#!/usr/bin/env python3
"""Test the REST API structured action mappings endpoint"""
import requests
import json
# API configuration
API_URL = "http://localhost:8000"
USERNAME = "admin"
PASSWORD = "admin123"
def main():
print("Testing structured action mappings REST API...")
print("="*70)
# Get authentication token
print("\n1. Authenticating...")
auth_response = requests.post(
f"{API_URL}/api/v1/auth/login",
json={"username": USERNAME, "password": PASSWORD}
)
if auth_response.status_code != 200:
print(f"Authentication failed: {auth_response.status_code}")
print(auth_response.text)
return False
token = auth_response.json()["access_token"]
print(f" ✓ Authenticated as {USERNAME}")
# Get action mappings
print("\n2. Fetching action mappings...")
headers = {"Authorization": f"Bearer {token}"}
mappings_response = requests.get(
f"{API_URL}/api/v1/configuration/action-mappings/export",
headers=headers
)
if mappings_response.status_code != 200:
print(f"Failed to get mappings: {mappings_response.status_code}")
print(mappings_response.text)
return False
data = mappings_response.json()
print(f" ✓ Retrieved {data['total_mappings']} mappings")
print(f"{data['mappings_with_parameters']} mappings have parameters")
# Show some examples
print("\n3. Example mappings:")
print("-"*70)
# Show a simple mapping
simple_mappings = [m for m in data['mappings'] if len(m['output_actions']) > 0
and all(len(a['parameters']) == 0 for a in m['output_actions'])]
if simple_mappings:
mapping = simple_mappings[0]
print(f"\n Simple mapping (offset {mapping['offset']}):")
for action in mapping['output_actions'][:2]:
print(f"{action['action']}")
if action['parameters']:
print(f" Parameters: {action['parameters']}")
# Show a complex mapping with parameters
complex_mappings = [m for m in data['mappings'] if len(m['output_actions']) > 0
and any(len(a['parameters']) > 0 for a in m['output_actions'])]
if complex_mappings:
print(f"\n Complex mapping with parameters ({len(complex_mappings)} total):")
mapping = complex_mappings[0]
print(f" Offset: {mapping['offset']}")
for i, action in enumerate(mapping['output_actions'][:2], 1):
print(f"\n Action {i}: {action['action']}")
if action['parameters']:
print(f" Parameters:")
for key, value in action['parameters'].items():
print(f"{key}: {value}")
# Save full output to file
print("\n4. Saving complete output...")
output_file = "structured_action_mappings_api.json"
with open(output_file, 'w', encoding='utf-8') as f:
json.dump(data, f, indent=2, ensure_ascii=False)
print(f" ✓ Saved to {output_file}")
print("\n" + "="*70)
print("✓ Test completed successfully!")
return True
if __name__ == '__main__':
main()