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

162
test_grpc_mapping.py Normal file
View File

@@ -0,0 +1,162 @@
"""
Test script for creating action mapping directly via gRPC (SDK Bridge)
This bypasses the REST API and authentication layer
"""
import grpc
import sys
sys.path.append(r'C:\DEV\COPILOT\geutebruck-api\src\api')
from protos import configuration_pb2
from protos import configuration_pb2_grpc
def test_create_mapping_grpc():
"""Test creating mapping via gRPC"""
print("=" * 70)
print("TESTING ACTION MAPPING CREATION VIA GRPC")
print("=" * 70)
# Connect to gRPC service
channel = grpc.insecure_channel('localhost:50051')
stub = configuration_pb2_grpc.ConfigurationServiceStub(channel)
# Step 1: Get current mappings count
print("\n1. Getting current action mappings count...")
try:
list_request = configuration_pb2.ReadActionMappingsRequest()
list_response = stub.ReadActionMappings(list_request)
initial_count = len(list_response.mappings)
print(f" Initial mapping count: {initial_count}")
print(f"\n Current mappings:")
for i, mapping in enumerate(list_response.mappings[:5]): # Show first 5
try:
print(f" [{i+1}] {mapping.name}")
except UnicodeEncodeError:
print(f" [{i+1}] <mapping with special characters>")
if len(list_response.mappings) > 5:
print(f" ... and {len(list_response.mappings) - 5} more")
except grpc.RpcError as e:
print(f" ERROR: {e.code()}: {e.details()}")
return False
# Step 2: Create new mapping
print("\n2. Creating new action mapping via gRPC...")
# Create action definitions with parameters
param1_1 = configuration_pb2.ActionParameter(name="PreAlarm", value="10")
param1_2 = configuration_pb2.ActionParameter(name="Alarm", value="60")
output_action1 = configuration_pb2.ActionDefinition(
action="GCoreDataBase",
parameters=[param1_1, param1_2]
)
param2_1 = configuration_pb2.ActionParameter(name="Receiver", value="test@example.com")
param2_2 = configuration_pb2.ActionParameter(name="Subject", value="Test Alert from gRPC")
output_action2 = configuration_pb2.ActionDefinition(
action="GscMail",
parameters=[param2_1, param2_2]
)
new_mapping = configuration_pb2.ActionMappingInput(
name="GRPC_TEST_FOLDER_TREE_MAPPING",
output_actions=[output_action1, output_action2]
)
create_request = configuration_pb2.CreateActionMappingRequest(
mapping=new_mapping
)
print(f" Mapping name: {new_mapping.name}")
print(f" Output actions: {len(new_mapping.output_actions)}")
for i, action_def in enumerate(new_mapping.output_actions):
print(f" [{i+1}] {action_def.action} ({len(action_def.parameters)} params)")
try:
create_response = stub.CreateActionMapping(create_request)
print(f"\n gRPC Response:")
print(f" Success: {create_response.success}")
print(f" Message: {create_response.message}")
if not create_response.success:
print(" ERROR: CreateActionMapping returned success=False")
return False
except grpc.RpcError as e:
print(f" ERROR: {e.code()}: {e.details()}")
return False
# Step 3: Verify persistence
print("\n3. Verifying persistence by reading back...")
try:
verify_request = configuration_pb2.ReadActionMappingsRequest()
verify_response = stub.ReadActionMappings(verify_request)
final_count = len(verify_response.mappings)
print(f" Initial count: {initial_count}")
print(f" Final count: {final_count}")
if final_count == initial_count + 1:
print(" [SUCCESS] Mapping count increased by 1 - SUCCESS!")
else:
print(f" [FAIL] Mapping count did NOT increase! Expected {initial_count + 1}, got {final_count}")
print(" THIS WAS THE CRITICAL BUG IN PREVIOUS IMPLEMENTATION!")
return False
except grpc.RpcError as e:
print(f" ERROR: {e.code()}: {e.details()}")
return False
# Step 4: Find the new mapping
print("\n4. Searching for new mapping in list...")
print(f" Showing last 5 mappings (most recent):")
for i, mapping in enumerate(verify_response.mappings[-5:]):
idx = len(verify_response.mappings) - 5 + i + 1
try:
print(f" [{idx}] {mapping.name[:50]}")
except (UnicodeEncodeError, UnicodeDecodeError):
print(f" [{idx}] <special characters>")
found = False
for mapping in verify_response.mappings:
try:
if mapping.name == "GRPC_TEST_FOLDER_TREE_MAPPING":
found = True
print(f"\n [SUCCESS] Found new mapping!")
print(f" Name: {mapping.name}")
print(f" Output actions: {len(mapping.output_actions)}")
for i, action in enumerate(mapping.output_actions):
print(f" [{i+1}] {action.action}")
break
except (UnicodeEncodeError, UnicodeDecodeError):
continue
if not found:
print(" [FAIL] New mapping NOT found in list!")
return False
print("\n" + "=" * 70)
print("SUCCESS! ALL TESTS PASSED!")
print("=" * 70)
print("\nThe folder tree implementation is working correctly:")
print(" ✓ Configuration parsed completely")
print(" ✓ New mapping added to tree")
print(" ✓ Binary serialization successful")
print(" ✓ GeViServer accepted changes")
print(" ✓ Mapping persisted across read-back")
print("=" * 70)
return True
if __name__ == "__main__":
try:
success = test_create_mapping_grpc()
exit(0 if success else 1)
except Exception as e:
print(f"\nEXCEPTION: {e}")
import traceback
traceback.print_exc()
exit(1)