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>

geutebruck_app/lib/domain/entities/action_mapping.dart

@@ -0,0 +1,92 @@
+import 'package:equatable/equatable.dart';
+import '../../data/models/action_output.dart';
+
+/// Domain entity representing an action mapping configuration
+/// Maps input actions (events) to output actions (responses)
+class ActionMapping extends Equatable {
+  final String id;
+  final String name;
+  final String? description;
+  final String inputAction;
+  final Map<String, dynamic> inputParameters;
+  final List<ActionOutput> outputActions;
+  final String? geviscopeInstanceScope;
+  final bool enabled;
+  final int executionCount;
+  final DateTime? lastExecuted;
+  final DateTime createdAt;
+  final DateTime updatedAt;
+  final String createdBy;
+
+  const ActionMapping({
+    required this.id,
+    required this.name,
+    this.description,
+    required this.inputAction,
+    this.inputParameters = const {},
+    required this.outputActions,
+    this.geviscopeInstanceScope,
+    this.enabled = true,
+    this.executionCount = 0,
+    this.lastExecuted,
+    required this.createdAt,
+    required this.updatedAt,
+    required this.createdBy,
+  });
+
+  /// Create a copy of this action mapping with some fields replaced
+  ActionMapping copyWith({
+    String? id,
+    String? name,
+    String? description,
+    String? inputAction,
+    Map<String, dynamic>? inputParameters,
+    List<ActionOutput>? outputActions,
+    String? geviscopeInstanceScope,
+    bool? enabled,
+    int? executionCount,
+    DateTime? lastExecuted,
+    DateTime? createdAt,
+    DateTime? updatedAt,
+    String? createdBy,
+  }) {
+    return ActionMapping(
+      id: id ?? this.id,
+      name: name ?? this.name,
+      description: description ?? this.description,
+      inputAction: inputAction ?? this.inputAction,
+      inputParameters: inputParameters ?? this.inputParameters,
+      outputActions: outputActions ?? this.outputActions,
+      geviscopeInstanceScope: geviscopeInstanceScope ?? this.geviscopeInstanceScope,
+      enabled: enabled ?? this.enabled,
+      executionCount: executionCount ?? this.executionCount,
+      lastExecuted: lastExecuted ?? this.lastExecuted,
+      createdAt: createdAt ?? this.createdAt,
+      updatedAt: updatedAt ?? this.updatedAt,
+      createdBy: createdBy ?? this.createdBy,
+    );
+  }
+
+  @override
+  List<Object?> get props => [
+        id,
+        name,
+        description,
+        inputAction,
+        inputParameters,
+        outputActions,
+        geviscopeInstanceScope,
+        enabled,
+        executionCount,
+        lastExecuted,
+        createdAt,
+        updatedAt,
+        createdBy,
+      ];
+
+  @override
+  String toString() {
+    return 'ActionMapping(id: $id, name: $name, inputAction: $inputAction, '
+        'outputActions: ${outputActions.length} actions, enabled: $enabled)';
+  }
+}

geutebruck_app/lib/domain/entities/server.dart

@@ -0,0 +1,64 @@
+import 'package:equatable/equatable.dart';
+
+enum ServerType { gcore, geviscope }
+
+class Server extends Equatable {
+  final String id;
+  final String alias;
+  final String host;
+  final String user;
+  final String password;
+  final bool enabled;
+  final bool deactivateEcho;
+  final bool deactivateLiveCheck;
+  final ServerType type;
+
+  const Server({
+    required this.id,
+    required this.alias,
+    required this.host,
+    required this.user,
+    required this.password,
+    required this.enabled,
+    required this.deactivateEcho,
+    required this.deactivateLiveCheck,
+    required this.type,
+  });
+
+  @override
+  List<Object?> get props => [
+        id,
+        alias,
+        host,
+        user,
+        password,
+        enabled,
+        deactivateEcho,
+        deactivateLiveCheck,
+        type,
+      ];
+
+  Server copyWith({
+    String? id,
+    String? alias,
+    String? host,
+    String? user,
+    String? password,
+    bool? enabled,
+    bool? deactivateEcho,
+    bool? deactivateLiveCheck,
+    ServerType? type,
+  }) {
+    return Server(
+      id: id ?? this.id,
+      alias: alias ?? this.alias,
+      host: host ?? this.host,
+      user: user ?? this.user,
+      password: password ?? this.password,
+      enabled: enabled ?? this.enabled,
+      deactivateEcho: deactivateEcho ?? this.deactivateEcho,
+      deactivateLiveCheck: deactivateLiveCheck ?? this.deactivateLiveCheck,
+      type: type ?? this.type,
+    );
+  }
+}

geutebruck_app/lib/domain/entities/user.dart

@@ -0,0 +1,18 @@
+import 'package:equatable/equatable.dart';
+
+class User extends Equatable {
+  final String username;
+  final String role;
+  final String accessToken;
+  final String refreshToken;
+
+  const User({
+    required this.username,
+    required this.role,
+    required this.accessToken,
+    required this.refreshToken,
+  });
+
+  @override
+  List<Object?> get props => [username, role, accessToken, refreshToken];
+}

geutebruck_app/lib/domain/repositories/action_mapping_repository.dart

@@ -0,0 +1,35 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../data/services/sync_service.dart';
+import '../entities/action_mapping.dart';
+
+/// Repository interface for action mapping operations
+/// Defines the contract for data operations with functional error handling
+abstract class ActionMappingRepository {
+  /// Get all action mappings from local storage
+  Future<Either<Failure, List<ActionMapping>>> getAllActionMappings();
+
+  /// Get a specific action mapping by ID
+  Future<Either<Failure, ActionMapping>> getActionMappingById(String id);
+
+  /// Create a new action mapping (saved locally, marked as dirty)
+  Future<Either<Failure, void>> createActionMapping(ActionMapping mapping);
+
+  /// Update an existing action mapping (saved locally, marked as dirty)
+  Future<Either<Failure, void>> updateActionMapping(ActionMapping mapping);
+
+  /// Delete an action mapping (soft delete, marked as dirty)
+  Future<Either<Failure, void>> deleteActionMapping(String id);
+
+  /// Search action mappings by name or description
+  Future<Either<Failure, List<ActionMapping>>> searchActionMappings(String query);
+
+  /// Sync dirty (unsaved) action mappings to the server
+  Future<Either<Failure, SyncResult>> syncToServer();
+
+  /// Download latest action mappings from server and replace local data
+  Future<Either<Failure, int>> downloadFromServer();
+
+  /// Get count of dirty (unsaved) action mappings
+  Future<Either<Failure, int>> getDirtyCount();
+}

geutebruck_app/lib/domain/repositories/auth_repository.dart

@@ -0,0 +1,10 @@
+import 'package:dartz/dartz.dart';
+import '../entities/user.dart';
+import '../../core/errors/failures.dart';
+
+abstract class AuthRepository {
+  Future<Either<Failure, User>> login(String username, String password);
+  Future<Either<Failure, void>> logout();
+  Future<Either<Failure, User>> refreshToken();
+  Future<Either<Failure, User?>> getCurrentUser();
+}

geutebruck_app/lib/domain/repositories/server_repository.dart

@@ -0,0 +1,22 @@
+import 'package:dartz/dartz.dart';
+import '../entities/server.dart';
+import '../../core/errors/failures.dart';
+import '../../data/services/sync_service.dart';
+
+abstract class ServerRepository {
+  // Local-first operations (read from local storage)
+  Future<Either<Failure, List<Server>>> getAllServers();
+  Future<Either<Failure, List<Server>>> getGCoreServers();
+  Future<Either<Failure, List<Server>>> getGeViScopeServers();
+  Future<Either<Failure, Server>> getServerById(String id, ServerType type);
+
+  // Local-first CRUD (writes to local storage, marks as dirty)
+  Future<Either<Failure, void>> createServer(Server server);
+  Future<Either<Failure, void>> updateServer(Server server);
+  Future<Either<Failure, void>> deleteServer(String id, ServerType type);
+
+  // Sync operations
+  Future<Either<Failure, SyncResult>> syncToServer();
+  Future<Either<Failure, int>> downloadFromServer();
+  Future<Either<Failure, int>> getDirtyCount();
+}

geutebruck_app/lib/domain/use_cases/auth/login.dart

@@ -0,0 +1,14 @@
+import 'package:dartz/dartz.dart';
+import '../../entities/user.dart';
+import '../../repositories/auth_repository.dart';
+import '../../../core/errors/failures.dart';
+
+class Login {
+  final AuthRepository repository;
+
+  Login(this.repository);
+
+  Future<Either<Failure, User>> call(String username, String password) async {
+    return await repository.login(username, password);
+  }
+}

geutebruck_app/lib/domain/use_cases/servers/get_servers.dart

@@ -0,0 +1,14 @@
+import 'package:dartz/dartz.dart';
+import '../../entities/server.dart';
+import '../../repositories/server_repository.dart';
+import '../../../core/errors/failures.dart';
+
+class GetServers {
+  final ServerRepository repository;
+
+  GetServers(this.repository);
+
+  Future<Either<Failure, List<Server>>> call() async {
+    return await repository.getAllServers();
+  }
+}