Files
geutebruck/geutebruck_app/QUICK_START.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

1.5 KiB

Quick Start - Offline-First Architecture

TL;DR - Run These 3 Commands

cd C:\DEV\COPILOT\geutebruck_app

# 1. Install dependencies
flutter pub get

# 2. Generate Hive adapters
flutter packages pub run build_runner build --delete-conflicting-outputs

# 3. Run with hot reload
.\dev-run.bat

Then:

  1. Open browser to http://localhost:8081
  2. Login
  3. Go to Servers
  4. Click download button (⬇️) to load initial data
  5. Create/edit servers - they save instantly!
  6. Click sync button (🔄) to push changes to server

What Changed?

All server operations are now INSTANT (no waiting for API) Works offline (create/edit servers without internet) Explicit sync (changes pushed to server only when you click sync button) Hot reload (press r in terminal for instant code updates) Windows desktop ready (same code works on Windows)

Sync Button

Red badge shows unsaved changes:

  • 🔄 (no badge) = No changes to sync
  • 🔄 🔴3 (red badge) = 3 unsaved changes

Click to sync all changes to GeViServer.

Download Button

⬇️ button fetches latest data from server (preserves your local changes).

Hot Reload

While dev-run.bat is running:

  • Press r = Hot reload (instant update)
  • Press R = Hot restart (full restart)
  • Press q = Quit

Save a .dart file and press r - changes appear instantly!

Documentation

  • IMPLEMENTATION_SUMMARY.md - What was implemented
  • OFFLINE_FIRST_SETUP.md - Architecture details and troubleshooting

Enjoy the speed! 🚀