auto-claude: subtask-5-2 - End-to-end verification of gRPC integration

Added comprehensive test suite and documentation for gRPC integration:
- test/api/grpc_config_test.dart: Unit tests for GrpcConfig
- test/api/grpc_client_test.dart: Unit tests for GrpcCqrsApiClient
- test/api/api_mode_config_test.dart: Unit tests for ApiModeConfig
- test/e2e/GRPC_E2E_VERIFICATION.md: Manual E2E testing guide

All 18 tests pass. Flutter analyze shows no issues.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

test/api/api_mode_config_test.dart

@@ -0,0 +1,67 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:planb_logistic/providers/providers.dart';
+
+void main() {
+  group('ApiMode', () {
+    test('has correct values', () {
+      expect(ApiMode.values.length, equals(2));
+      expect(ApiMode.values, contains(ApiMode.http));
+      expect(ApiMode.values, contains(ApiMode.grpc));
+    });
+  });
+
+  group('ApiModeConfig', () {
+    test('development config defaults to HTTP', () {
+      const config = ApiModeConfig.development;
+
+      expect(config.mode, equals(ApiMode.http));
+      expect(config.isHttp, isTrue);
+      expect(config.isGrpc, isFalse);
+      expect(config.fallbackToHttpOnError, isTrue);
+    });
+
+    test('developmentGrpc config uses gRPC', () {
+      const config = ApiModeConfig.developmentGrpc;
+
+      expect(config.mode, equals(ApiMode.grpc));
+      expect(config.isGrpc, isTrue);
+      expect(config.isHttp, isFalse);
+      expect(config.fallbackToHttpOnError, isTrue);
+    });
+
+    test('production config defaults to HTTP', () {
+      const config = ApiModeConfig.production;
+
+      expect(config.mode, equals(ApiMode.http));
+      expect(config.isHttp, isTrue);
+      expect(config.isGrpc, isFalse);
+      expect(config.fallbackToHttpOnError, isFalse);
+    });
+
+    test('productionGrpc config uses gRPC without fallback', () {
+      const config = ApiModeConfig.productionGrpc;
+
+      expect(config.mode, equals(ApiMode.grpc));
+      expect(config.isGrpc, isTrue);
+      expect(config.isHttp, isFalse);
+      expect(config.fallbackToHttpOnError, isFalse);
+    });
+
+    test('custom config can be created', () {
+      const config = ApiModeConfig(
+        mode: ApiMode.grpc,
+        fallbackToHttpOnError: false,
+      );
+
+      expect(config.mode, equals(ApiMode.grpc));
+      expect(config.isGrpc, isTrue);
+      expect(config.fallbackToHttpOnError, isFalse);
+    });
+
+    test('default fallbackToHttpOnError is true', () {
+      const config = ApiModeConfig(mode: ApiMode.grpc);
+
+      expect(config.fallbackToHttpOnError, isTrue);
+    });
+  });
+}

test/api/grpc_client_test.dart

@@ -0,0 +1,85 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:planb_logistic/api/grpc_client.dart';
+import 'package:planb_logistic/api/grpc_config.dart';
+
+void main() {
+  group('GrpcCqrsApiClient', () {
+    test('can be created with development config', () {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.development,
+        authService: null,
+      );
+
+      expect(client.config, equals(GrpcConfig.development));
+      expect(client.isConnected, isFalse);
+    });
+
+    test('can be created with production config', () {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.production,
+        authService: null,
+      );
+
+      expect(client.config, equals(GrpcConfig.production));
+      expect(client.isConnected, isFalse);
+    });
+
+    test('channel is created lazily', () {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.development,
+        authService: null,
+      );
+
+      expect(client.isConnected, isFalse);
+
+      // Access the channel to trigger lazy initialization
+      final channel = client.channel;
+
+      expect(channel, isNotNull);
+      expect(client.isConnected, isTrue);
+    });
+
+    test('delivery client is created lazily', () {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.development,
+        authService: null,
+      );
+
+      // Access delivery client (implicitly creates channel first)
+      final deliveryClient = client.deliveryClient;
+
+      expect(deliveryClient, isNotNull);
+      expect(client.isConnected, isTrue);
+    });
+
+    test('shutdown clears channel and client', () async {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.development,
+        authService: null,
+      );
+
+      // Initialize the channel
+      final _ = client.channel;
+      expect(client.isConnected, isTrue);
+
+      // Shutdown
+      await client.shutdown();
+      expect(client.isConnected, isFalse);
+    });
+
+    test('terminate clears channel and client', () async {
+      final client = GrpcCqrsApiClient(
+        config: GrpcConfig.development,
+        authService: null,
+      );
+
+      // Initialize the channel
+      final _ = client.channel;
+      expect(client.isConnected, isTrue);
+
+      // Terminate
+      await client.terminate();
+      expect(client.isConnected, isFalse);
+    });
+  });
+}

test/api/grpc_config_test.dart

@@ -0,0 +1,56 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:planb_logistic/api/grpc_config.dart';
+
+void main() {
+  group('GrpcConfig', () {
+    test('development config has correct values', () {
+      const config = GrpcConfig.development;
+
+      expect(config.host, equals('192.168.88.228'));
+      expect(config.port, equals(5011));
+      expect(config.useTls, isFalse);
+      expect(config.allowSelfSignedCertificate, isTrue);
+      expect(config.timeout, equals(const Duration(seconds: 30)));
+      expect(config.address, equals('192.168.88.228:5011'));
+    });
+
+    test('production config has correct values', () {
+      const config = GrpcConfig.production;
+
+      expect(config.host, equals('grpc-route.goutezplanb.com'));
+      expect(config.port, equals(443));
+      expect(config.useTls, isTrue);
+      expect(config.allowSelfSignedCertificate, isFalse);
+      expect(config.timeout, equals(const Duration(seconds: 30)));
+      expect(config.address, equals('grpc-route.goutezplanb.com:443'));
+    });
+
+    test('custom config can be created', () {
+      const config = GrpcConfig(
+        host: 'custom.example.com',
+        port: 9000,
+        timeout: Duration(seconds: 60),
+        useTls: true,
+        allowSelfSignedCertificate: true,
+      );
+
+      expect(config.host, equals('custom.example.com'));
+      expect(config.port, equals(9000));
+      expect(config.useTls, isTrue);
+      expect(config.allowSelfSignedCertificate, isTrue);
+      expect(config.timeout, equals(const Duration(seconds: 60)));
+      expect(config.address, equals('custom.example.com:9000'));
+    });
+
+    test('default values are correctly applied', () {
+      const config = GrpcConfig(
+        host: 'test.example.com',
+        port: 443,
+      );
+
+      expect(config.useTls, isTrue);
+      expect(config.allowSelfSignedCertificate, isFalse);
+      expect(config.timeout, equals(const Duration(seconds: 30)));
+    });
+  });
+}