Files
geutebruck/SOURCES/CODEX/README.md
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

25 lines
1.9 KiB
Markdown

# GeViScope & GeViSoft SDK Markdown Archive
This folder now contains Markdown-friendly extracts of the original SDK documentation so it can be chunked or consumed by language models without needing to parse PDF/HTML files. Every `.md` file begins with a short provenance note and then preserves the page order from the source.
## Available documents
### GeViScope
- `GeViScope/GeViScope_SDK.md` — main SDK guide converted from `GeViScope_SDK.pdf`.
- `GeViScope/GeviScope_SDK_html.md` — HTML dump of `GeviScope_SDK.htm` via `w3m -dump`; useful if you prefer the help version of the guide.
- `GeViScope/Additional documentation/GscActionsOverview_EN.md` — conceptual overview of GSC actions.
- `GeViScope/Additional documentation/GscActionsReference_EN.md` — reference for every action and parameter.
- `GeViScope/Additional documentation/Installation_GscStreamer_en.md` — installation instructions for the streamer component.
- `GeViScope/Additional documentation/TACI - Telnet Action Command Interface.md` — Telnet command reference for the TACI interface.
### GeViSoft
- `GeViSoft/GeViSoft_SDK_Documentation.md` — developer guide converted from `GeViSoft_SDK_Documentation.pdf`.
## Working with the Markdown files
- The text was produced with `pdftotext -layout` (and `w3m -dump` for HTML) to preserve columns and tables; expect monospace formatting for diagrams/tables.
- Because the PDFs were flattened to text, embedded images are not available. Keep the original PDFs nearby if you need diagrams.
- Chunking for LLMs generally works best by splitting on headings (lines that start with `#`, `##`, etc.) or large blank-line gaps.
## To-do / limitations
- The `.chm` help files and the full `GeViScopeSDK_HTML5` site remain in their original formats. Converting them requires CHM/HTML tooling (e.g., `chmextract` + `pandoc`). Let me know if you want those processed as well.