Files
Administrator 14893e62a5 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

263 lines
14 KiB
HTML

<!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="GeViScope SDK|Action documentation">
<!-- saved from url=(0014)about:internet -->
<head>
<meta charset="utf-8" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Logistic</title>
<link href="../Resources/TableStyles/TABLE.css" rel="stylesheet" />
<style>
body
{
font-family: Arial, Helvetica, sans-serif;
font-size: 10pt;
}
</style>
<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>
<div class="MCBreadcrumbsBox_0"><span class="MCBreadcrumbsPrefix">| </span><a class="MCBreadcrumbsLink" href="../Titel.htm">GeViScope SDK</a><span class="MCBreadcrumbsDivider"> &gt; </span><a class="MCBreadcrumbsLink" href="../300_Action documentation.htm">Action documentation</a><span class="MCBreadcrumbsDivider"> &gt; </span><span class="MCBreadcrumbs">Logistic</span>
</div>
<h1>Logistic</h1>
<p>Logistic actions are used in the logistic environment where meta data, e.g. barcodes, is used to start recording events. Later, a research on the barcodes is done to show the scanning operation in the recorded images.
To speed up the search, a CRC32 checksum is used as a hash and serves as a foreign key of the event startd. The foreign key is indexed in the event table an can therefore be found much faster than a lookup on the string itself.
Additional parameters are used to notify positioning information since the assignment of scanning and recording camera is often done according to the position of the scanner. </p>
<h2><a name="Log"></a>Log barcode data</h2>
<p>Action name:<i>LogBarcodeData(Barcode, Hash, Scanner, AreaID, AreaName, Channel, TimeStamp)</i></p>
<p>Action category: notification</p>
<p>Logistic barcode data .</p>
<table border="1" style="caption-side: top;mc-table-style: url('../Resources/TableStyles/TABLE.css');" class="TableStyle-Rows" cellspacing="0">
<col class="Column-Column1" />
<col class="Column-Column1" />
<col class="Column-Column1" />
<thead>
<tr class="Head-Header1">
<th class="HeadE-Column1-Header1" colspan="2">Parameter</th>
<th class="HeadD-Column1-Header1">Function</th>
</tr>
</thead>
<tbody>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">barcode</td>
<td class="BodyE-Column1-Body1"><i>Barcode</i>
</td>
<td class="BodyD-Column1-Body1">Barcode.</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">hash value</td>
<td class="BodyE-Column1-Body2"><i>Hash</i>
</td>
<td class="BodyD-Column1-Body2">Hash value of barcode (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">scanner name</td>
<td class="BodyE-Column1-Body1"><i>Scanner</i>
</td>
<td class="BodyD-Column1-Body1">Scanner name or IP Address (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">area number</td>
<td class="BodyE-Column1-Body2"><i>AreaID</i>
</td>
<td class="BodyD-Column1-Body2">Global number of area for event mapping (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">area name</td>
<td class="BodyE-Column1-Body1"><i>AreaName</i>
</td>
<td class="BodyD-Column1-Body1">Area name (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">channel</td>
<td class="BodyE-Column1-Body2"><i>Channel</i>
</td>
<td class="BodyD-Column1-Body2">Global number of a media channel for mapping (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyB-Column1-Body1">time stamp</td>
<td class="BodyB-Column1-Body1"><i>TimeStamp</i>
</td>
<td class="BodyA-Column1-Body1">Time stamp (Optional)</td>
</tr>
</tbody>
</table>
<h2><a name="Log2"></a>Log barcode data LPS</h2>
<p>Action name:<i>LogBarcodeDataLPS(Barcode, Hash, Scanner, AreaID, AreaName, Channel, TimeStamp, X, Y, Z, LpsTagID, LpsStatus, LpsCellID, LpsAreaID, UserParam)</i></p>
<p>Action category: notification</p>
<p>Logistic barcode data including positioning and area information.</p>
<table border="1" style="caption-side: top;mc-table-style: url('../Resources/TableStyles/TABLE.css');" class="TableStyle-Rows" cellspacing="0">
<col class="Column-Column1" />
<col class="Column-Column1" />
<col class="Column-Column1" />
<thead>
<tr class="Head-Header1">
<th class="HeadE-Column1-Header1" colspan="2">Parameter</th>
<th class="HeadD-Column1-Header1">Function</th>
</tr>
</thead>
<tbody>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">barcode</td>
<td class="BodyE-Column1-Body1"><i>Barcode</i>
</td>
<td class="BodyD-Column1-Body1">Barcode.</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">hash value</td>
<td class="BodyE-Column1-Body2"><i>Hash</i>
</td>
<td class="BodyD-Column1-Body2">Hash value of the barcode (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">scanner name</td>
<td class="BodyE-Column1-Body1"><i>Scanner</i>
</td>
<td class="BodyD-Column1-Body1">Scanner name or IP Address (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">area number</td>
<td class="BodyE-Column1-Body2"><i>AreaID</i>
</td>
<td class="BodyD-Column1-Body2">Global number of area for event mapping (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">area name</td>
<td class="BodyE-Column1-Body1"><i>AreaName</i>
</td>
<td class="BodyD-Column1-Body1">Area name. (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">channel</td>
<td class="BodyE-Column1-Body2"><i>Channel</i>
</td>
<td class="BodyD-Column1-Body2">Global number of a media channel for mapping (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">time stamp</td>
<td class="BodyE-Column1-Body1"><i>TimeStamp</i>
</td>
<td class="BodyD-Column1-Body1">Time stamp (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">X coordinate</td>
<td class="BodyE-Column1-Body2"><i>X</i>
</td>
<td class="BodyD-Column1-Body2">X coordinate of the position query (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">Y coordinate</td>
<td class="BodyE-Column1-Body1"><i>Y</i>
</td>
<td class="BodyD-Column1-Body1">Y coordinate of the position query (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">Z coordinate</td>
<td class="BodyE-Column1-Body2"><i>Z</i>
</td>
<td class="BodyD-Column1-Body2">Z coordinate of the position query (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">LPS tag ID</td>
<td class="BodyE-Column1-Body1"><i>LpsTagID</i>
</td>
<td class="BodyD-Column1-Body1">Tag ID of the positioning system (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">LPS status</td>
<td class="BodyE-Column1-Body2"><i>LpsStatus</i>
</td>
<td class="BodyD-Column1-Body2">LPS status of the position query(Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">LPS cell ID</td>
<td class="BodyE-Column1-Body1"><i>LpsCellID</i>
</td>
<td class="BodyD-Column1-Body1">Cell ID of the positioning system (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">LPS area ID</td>
<td class="BodyE-Column1-Body2"><i>LpsAreaID</i>
</td>
<td class="BodyD-Column1-Body2">Area ID of the positioning system (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyB-Column1-Body1">User param</td>
<td class="BodyB-Column1-Body1"><i>UserParam</i>
</td>
<td class="BodyA-Column1-Body1">User param for internal use (Optional)</td>
</tr>
</tbody>
</table>
<h2><a name="Log3"></a>Log NPR recognition</h2>
<p>Action name:<i>LogNPRRecognition(PlateNo, Hash, Country, Channel, TimeStamp, Restriction, Category)</i></p>
<p>Action category: logical</p>
<p>Log NPR recognition.</p>
<table border="1" style="caption-side: top;mc-table-style: url('../Resources/TableStyles/TABLE.css');" class="TableStyle-Rows" cellspacing="0">
<col class="Column-Column1" />
<col class="Column-Column1" />
<col class="Column-Column1" />
<thead>
<tr class="Head-Header1">
<th class="HeadE-Column1-Header1" colspan="2">Parameter</th>
<th class="HeadD-Column1-Header1">Function</th>
</tr>
</thead>
<tbody>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">plate no.</td>
<td class="BodyE-Column1-Body1"><i>PlateNo</i>
</td>
<td class="BodyD-Column1-Body1">Recognized plate no.</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">hash value</td>
<td class="BodyE-Column1-Body2"><i>Hash</i>
</td>
<td class="BodyD-Column1-Body2">Hash value of the recognized plate no. (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">country</td>
<td class="BodyE-Column1-Body1"><i>Country</i>
</td>
<td class="BodyD-Column1-Body1">Country (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">channel</td>
<td class="BodyE-Column1-Body2"><i>Channel</i>
</td>
<td class="BodyD-Column1-Body2">Channel (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyE-Column1-Body1">time stamp</td>
<td class="BodyE-Column1-Body1"><i>TimeStamp</i>
</td>
<td class="BodyD-Column1-Body1">Time stamp (Optional)</td>
</tr>
<tr class="Body-Body2">
<td class="BodyE-Column1-Body2">restriction</td>
<td class="BodyE-Column1-Body2"><i>Restriction</i>
</td>
<td class="BodyD-Column1-Body2">Restriction of recognized number (Optional)</td>
</tr>
<tr class="Body-Body1">
<td class="BodyB-Column1-Body1">category</td>
<td class="BodyB-Column1-Body1"><i>Category</i>
</td>
<td class="BodyA-Column1-Body1">Category of recognized number (Optional)</td>
</tr>
</tbody>
</table>
</body>
</html>