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

View File

@@ -0,0 +1,120 @@
<!DOCTYPE html>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" lang="en" xml:lang="en" data-mc-search-type="Stem" data-mc-help-system-file-name="index.xml" data-mc-path-to-help-system="../" data-mc-target-type="WebHelp2" data-mc-runtime-file-type="Topic" data-mc-preload-images="false" data-mc-in-preview-mode="false" data-mc-toc-path="">
<!-- saved from url=(0014)about:internet -->
<head>
<meta charset="utf-8" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Registering a device
</title>
<link href="../Skins/Default/Stylesheets/TextEffects.css" rel="stylesheet" />
<link href="../Skins/Default/Stylesheets/Topic.css" rel="stylesheet" />
<link href="Resources/Stylesheets/Styles.css" rel="stylesheet" />
<script src="../Resources/Scripts/jquery.min.js">
</script>
<script src="../Resources/Scripts/plugins.min.js">
</script>
<script src="../Resources/Scripts/require.min.js">
</script>
<script src="../Resources/Scripts/require.config.js">
</script>
<script src="../Resources/Scripts/MadCapAll.js">
</script>
</head>
<body>
<h2 xmlns="http://www.w3.org/TR/REC-html40">Registering a device
</h2>
<p xmlns="http://www.w3.org/TR/REC-html40">After the second call of the function “GSCMediaPluginRequest” (with parameter “request” is set to
“prPluginRegisterDevices”) the plugin
DLL can register one or multiple devices. This is done by calling the global
function “SetSimpleDevice”.</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p xmlns="http://www.w3.org/TR/REC-html40">The user can create device instances of
registered devices by using GSCSetup. Actually only
one instance per device can be created. So as a workaround the plugin should register multiple devices of the same type. A
later version of GeViScope will arrange this
procedure more smooth and transparently.</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p xmlns="http://www.w3.org/TR/REC-html40">The following example (in pseudo code)
should demonstrate the registration of 16 devices of the same type:</p>
<p xmlns="http://www.w3.org/TR/REC-html40"> </p>
<p class="CODEetc" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #4169e1;">case </span>prPluginRegisterDevices:
</p>
<p class="CODEetc" style="margin-left: 25px;" xmlns="http://www.w3.org/TR/REC-html40">{
</p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #008000;">// register 16 devices to support maximal 16 IP cams</span> <![CDATA[ ]]></p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #4169e1;">for(int </span>i = 1; i
&lt;= 16; ++i)
</p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40">{
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #008000;">// plugin (device) name and serial</span> <![CDATA[ ]]></p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">wstring
PluginName(L"<span style="color: #ff0000;">VS2008CPP_IPCamJPEG"</span>);
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">wstring
PluginSerial(PluginName);
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #4169e1;">wchar_t</span> Buf[1024];
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">_itow_s(i, Buf, 1024, 10);
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">PluginSerial += L<span style="color: #ff0000;">" "</span>;
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">PluginSerial += Buf;
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">PluginSerial += L<span style="color: #ff0000;">" "</span>;
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">PluginSerial += L<span style="color: #ff0000;">" Serial"</span>;
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #008000;">// device properties</span> <![CDATA[ ]]></p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #4169e1;">const </span>DevicePropertiesEx
</p>
<p class="CODEetc" style="margin-left: 100px;" xmlns="http://www.w3.org/TR/REC-html40">localDeviceProperties(
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">1,
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">0,
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">0,
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">PluginName.c_str(),
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">PluginSerial.c_str(),
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">L<span style="color: #ff0000;">"VS2008CPP - IP-Cam-JPEG-Example"</span>,
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">GSCMediaPlugins::pcIPCameraPlugin,
</p>
<p class="CODEetc" style="margin-left: 150px;" xmlns="http://www.w3.org/TR/REC-html40">0);
</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #008000;">// register the device</span> <![CDATA[ ]]></p>
<p class="CODEetc" style="margin-left: 75px;" xmlns="http://www.w3.org/TR/REC-html40">SetSimpleDevice(pluginHandler,
MediaDataLoop, localDeviceProperties, i,<br xmlns="http://www.w3.org/TR/REC-html40" /></p>
<p class="CODEetc" style="margin-left: 200px;" xmlns="http://www.w3.org/TR/REC-html40">GetDefaultSettings(pluginHandler));
</p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40">}
</p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40">
</p>
<p class="CODEetc" style="margin-left: 50px;" xmlns="http://www.w3.org/TR/REC-html40"><span style="color: #4169e1;">break</span>;
</p>
<p class="CODEetc" style="margin-left: 25px;" xmlns="http://www.w3.org/TR/REC-html40">}
</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p xmlns="http://www.w3.org/TR/REC-html40">If the media plugin
that should be developed is an IP camera driver or an driver for a video
encoder, the property "description" of the structure "DevicePropertiesEx" should follow a special naming
convention:</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="CODEetc" xmlns="http://www.w3.org/TR/REC-html40">DevicePropertiesEx.description
= L<span style="color: #ff0000;">"#Manufacturer IPC"</span>;</p>
<p class="CODEetc" xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p xmlns="http://www.w3.org/TR/REC-html40">This ensures the consistent presentation of
this plugin like all IP camera drivers in a future
version of the GeViScope software especially in GSCSetup.
</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
</body>
</html>