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,109 @@
================================================================================
GeViScope_SDK.pdf - Pages 11 to 20
================================================================================
────────────────────────────────────────────────────────────────────────────────
Page 11
────────────────────────────────────────────────────────────────────────────────
IftheconnectionisopeninGSCVieworGSCSetup,thesettingsoftheconnectioncannot
bechanged.Closealllocalconnectionsatfirsttobeabletochangetheconnectionsettings.
Step5:configureGSCViewtobeabletoremotecontrolitby
actions
Theentry“Optionsprofile”inthesection“Profiles”showsatabcontrolwithalotofdifferent
GSCViewsettings.TobeabletoremotecontrolGSCViewtheoption“Remotecontrol”on
the“Actions”tabhastobeset.
────────────────────────────────────────────────────────────────────────────────
Page 12
────────────────────────────────────────────────────────────────────────────────
The“Viewerclientnumber”shouldbesettoaarbitraryglobalnumberthatisuniqueinthe
wholesystem.Thisglobal“Viewerclientnumber”identifiesthisspecialinstanceof
GSCViewinthewholenetwork.Thenumberisusedindifferentactionstoremotecontrol
GSCView.
Bycontrastthe“globalnumber”ofaviewerinacustomsceneidentifiesaspecialviewerin
auserdefinedscene.Detailsaboutuserdefinedsceneswillbetopicofthenextstep.
Step6:userdefinedscenes
TodefineuserdefinedscenesinGSCViewtheentry“Scenes”insection“Resources”
shouldbeselected.Byrightclickingononeofthepredefinedscenesnewuserdefined
scenescanbecreated.Forthisstepbystepexampletwonewsceneswiththenames
“MyStartScene”and“MyScene”havetobeadded.Withthebutton“Editscene”theglobal
numbersoftheviewersofthesceneandthevideochannelsthatshouldbedisplayedcanbe
set.
The“MyStartScene”shouldbebasedonthe“Matrix4x4”.Theviewersshouldhavethe
globalnumbers1001to1016.Eachviewershoulddisplaylivepicturesofavideochannelof
thelocalconnection.Thevideochannelscanbesetviadrag&dropwhileeditingthescene.
────────────────────────────────────────────────────────────────────────────────
Page 13
────────────────────────────────────────────────────────────────────────────────
The“MyScene”shouldbebasedonthe“Matrix2x2”andtheviewersshouldhavetheglobal
numbers1101to1104.Theviewersshouldnotautomaticallydisplayanyvideochannel.
Theywillbeusedbyspecialactionstodisplayvideochannels.
────────────────────────────────────────────────────────────────────────────────
Page 14
────────────────────────────────────────────────────────────────────────────────
Step7:modifytheappearanceofGSCView
TheappearanceofGSCViewcanbecontrolledbydifferentsettingsintheentry“Optionspro-
file”ofthesection“Profiles”.Forthistestscenario,GSCViewshouldappearasastupid
videowallwithoutanyusercontrolsdirectlyvisibleintheGSCViewapplicationwindow.To
achievethis,thefollowingoptionsonthe“Application”tabhavetobeset:
────────────────────────────────────────────────────────────────────────────────
Page 15
────────────────────────────────────────────────────────────────────────────────
Pleasekeepinmind,thatiftheoption“Sensitiveareaenabled”isnotsetandifall“Hide…”
optionsareset,themainmenuofGSCViewonlycanbeaccessedbypressingF10!
Step8:saveall settings
Allsettingsshouldbesavedbyselectingthemenuentry“FileSave”.
Step9:testthesystemwithGSCPLCSimulator
AfterrestartingGSCViewitshouldappearinfullmodewith16viewersdisplayinglivepic-
turesofthevideochannelsofthelocalconnection.
────────────────────────────────────────────────────────────────────────────────
Page 16
────────────────────────────────────────────────────────────────────────────────
Nowstartthesoftware“\BIN\GSCPLCSimulator.exe”totestthesystem.The
GSCPLCSimulatorservesasamonitoringtoolforallmessages(actions)andeventsthat
aretransportedinsidethecompletesystem.Furthermoreactionscanbetriggeredand
eventscanbestartedandstopped.
Afteritsstarttheconnectiontothelocalservershouldbebuildupautomaticallyandall
actiontrafficisdisplayedinalist.
────────────────────────────────────────────────────────────────────────────────
Page 17
────────────────────────────────────────────────────────────────────────────────
Withthebutton“Dialog”anactioncanbeselectedandwiththebutton“Send”thisactioncan
besendtotheGeViScopeserver.Fortestingthesystemfirstselecttheaction“VCchange
scenebyname”inthecategory“Vieweractions”todisplay“MyScene”ontheGSCView
withtheglobal“Viewerclientnumber”1000.
────────────────────────────────────────────────────────────────────────────────
Page 18
────────────────────────────────────────────────────────────────────────────────
Aftersendingtheaction,GSCViewshoulddisplayan“empty”“MyScene”.
────────────────────────────────────────────────────────────────────────────────
Page 19
────────────────────────────────────────────────────────────────────────────────
Todisplayvideochannelsintheviewersof“MyScene”theaction“Viewerconnectlive”can
beused.Theparameter“viewer”nowmeanstheglobalnumberofaviewerof“MyScene”,
e.g.1102.Theparameter“channel”shouldbesettotheglobalnumberofthevideochannel
thatshouldbedisplayed,e.g.2.
────────────────────────────────────────────────────────────────────────────────
Page 20
────────────────────────────────────────────────────────────────────────────────
Aftersendingtheaction,GSCViewdisplayslivevideoofthevideochannel2ontheupper
leftviewerinGSCView.