14893e62a5
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>
164 lines
4.1 KiB
Plaintext
164 lines
4.1 KiB
Plaintext
@startuml Deployment Architecture
|
|
!theme plain
|
|
skinparam backgroundColor #FEFEFE
|
|
|
|
title Geutebruck API - Deployment Architecture
|
|
|
|
node "Windows Server" {
|
|
|
|
node "GeViServer Process\nPID: 45612" as geviserver {
|
|
artifact "GeViServer.exe console" as gvexe
|
|
|
|
folder "C:\\GEVISOFT" {
|
|
file "TestMKS.set\n(13 servers, 64 mappings)" as config
|
|
file "GeViServer.exe" as exe
|
|
file "GeViProcAPINET_4_0.dll" as sdk
|
|
}
|
|
|
|
port "7700" as p7700
|
|
port "7701" as p7701
|
|
port "7702" as p7702
|
|
port "7703" as p7703
|
|
}
|
|
|
|
node "C# SDK Bridge Process\nPID: 48052" as sdkbridge {
|
|
artifact "GeViScopeBridge.exe" as bridge
|
|
|
|
folder "Release Build" {
|
|
file "GeViScopeBridge.exe\n(.NET 8.0)" as bridgeexe
|
|
file "GeViScope SDK DLLs" as sdkdlls
|
|
file "gRPC binaries" as grpclibs
|
|
}
|
|
|
|
component "Configuration Service" as configsvc
|
|
component "Camera Service" as camsvc
|
|
component "Monitor Service" as monsvc
|
|
component "CrossSwitch Service" as crosssvc
|
|
|
|
port "50051" as p50051
|
|
}
|
|
|
|
node "Python API Process\nPID: 46212" as pythonapi {
|
|
artifact "uvicorn main:app" as uvicorn
|
|
|
|
folder ".venv" {
|
|
file "Python 3.12" as python
|
|
file "FastAPI" as fastapi
|
|
file "grpcio" as grpc
|
|
file "uvicorn" as uv
|
|
}
|
|
|
|
component "REST Endpoints" as rest
|
|
component "Configuration Router" as configrouter
|
|
component "gRPC Client" as grpcclient
|
|
|
|
port "8000" as p8000
|
|
}
|
|
|
|
folder "PowerShell Scripts" {
|
|
file "start-services.ps1" as start
|
|
file "stop-services.ps1" as stop
|
|
file "restart-services.ps1" as restart
|
|
file "status-services.ps1" as status
|
|
}
|
|
|
|
}
|
|
|
|
cloud "Network" {
|
|
actor "Web Client" as web
|
|
actor "Mobile App" as mobile
|
|
actor "GeViSet" as geviset
|
|
}
|
|
|
|
' Service Management
|
|
start ..> geviserver : 1. Start with\n"console" arg\nWait for port 7700
|
|
start ..> sdkbridge : 2. Start SDK Bridge\nWait for port 50051
|
|
start ..> pythonapi : 3. Start uvicorn\nWait for port 8000
|
|
|
|
stop ..> pythonapi : 1. Stop uvicorn
|
|
stop ..> sdkbridge : 2. Stop bridge
|
|
stop ..> geviserver : 3. Stop server
|
|
|
|
status ..> geviserver : Check PID,\nports 7700-7703
|
|
status ..> sdkbridge : Check PID,\nport 50051
|
|
status ..> pythonapi : Check PID, port 8000,\nHTTP health check
|
|
|
|
' Port Connections
|
|
web --> p8000 : HTTP/REST
|
|
mobile --> p8000 : HTTP/REST
|
|
geviset -.-> p7702 : SetupClient\n(blocked when\nAPI runs)
|
|
|
|
p8000 --> rest
|
|
rest --> configrouter
|
|
configrouter --> grpcclient
|
|
|
|
grpcclient --> p50051 : gRPC
|
|
|
|
p50051 --> configsvc
|
|
p50051 --> camsvc
|
|
p50051 --> monsvc
|
|
p50051 --> crosssvc
|
|
|
|
configsvc --> p7702 : SetupClient\nprotocol
|
|
camsvc --> p7700 : SDK API
|
|
monsvc --> p7700 : SDK API
|
|
crosssvc --> p7700 : SDK API
|
|
|
|
p7700 --> gvexe
|
|
p7701 --> gvexe
|
|
p7702 --> gvexe
|
|
p7703 --> gvexe
|
|
|
|
gvexe --> config : Read/Write
|
|
|
|
note right of start
|
|
**Startup Order:**
|
|
1. GeViServer (15-60s wait for port 7700)
|
|
2. SDK Bridge (10-30s wait for port 50051)
|
|
3. Python API (5-20s wait for port 8000)
|
|
|
|
Each step waits for port to be listening
|
|
before proceeding to next service.
|
|
end note
|
|
|
|
note right of geviserver
|
|
**GeViServer:**
|
|
• Started with "console" argument
|
|
• Loads TestMKS.set on startup
|
|
• Listens on ports 7700-7703
|
|
• Manages cameras, monitors, events
|
|
• Stores configuration in binary .set format
|
|
end note
|
|
|
|
note right of sdkbridge
|
|
**SDK Bridge:**
|
|
• .NET 8.0 application
|
|
• Wraps GeViScope SDK (C++ DLL)
|
|
• Exposes gRPC services
|
|
• Handles SetupClient protocol
|
|
• Parses/writes binary .set files
|
|
end note
|
|
|
|
note right of pythonapi
|
|
**Python API:**
|
|
• FastAPI framework
|
|
• Swagger UI at /docs
|
|
• Authentication & authorization
|
|
• Configuration management ✅
|
|
• Camera/monitor control
|
|
• Health checks
|
|
end note
|
|
|
|
note bottom of config
|
|
**Configuration File:**
|
|
• Binary format (.set)
|
|
• Hierarchical folder structure
|
|
• Contains:
|
|
- 13 G-Core servers
|
|
- 64 action mappings
|
|
- System settings
|
|
- User accounts
|
|
end note
|
|
|
|
@enduml
|