maestra testcases

2026-02-25 22:06:22 +05:30
parent b85a83b446
commit 165fe5b66b
14 changed files with 363 additions and 6 deletions
--- a/apps/mobile/apps/client/lib/main.dart
+++ b/apps/mobile/apps/client/lib/main.dart
@@ -1,3 +1,5 @@
+import 'dart:io' show Platform;
+
 import 'package:client_authentication/client_authentication.dart'
    as client_authentication;
 import 'package:client_create_order/client_create_order.dart'
@@ -10,6 +12,7 @@ import 'package:design_system/design_system.dart';
 import 'package:firebase_core/firebase_core.dart';
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
+import 'package:marionette_flutter/marionette_flutter.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_modular/flutter_modular.dart';
@@ -20,7 +23,23 @@ import 'firebase_options.dart';
 import 'src/widgets/session_listener.dart';

 void main() async {
-  WidgetsFlutterBinding.ensureInitialized();
+  final bool isFlutterTest =
+      !kIsWeb ? Platform.environment.containsKey('FLUTTER_TEST') : false;
+  if (kDebugMode && !isFlutterTest) {
+    MarionetteBinding.ensureInitialized(
+      MarionetteConfiguration(
+        isInteractiveWidget: (Type type) =>
+            type == UiButton || type == UiTextField,
+        extractText: (Widget widget) {
+          if (widget is UiTextField) return widget.label;
+          if (widget is UiButton) return widget.text;
+          return null;
+        },
+      ),
+    );
+  } else {
+    WidgetsFlutterBinding.ensureInitialized();
+  }
  await Firebase.initializeApp(
    options: kIsWeb ? DefaultFirebaseOptions.currentPlatform : null,
  );
--- a/apps/mobile/apps/client/maestro/README.md
+++ b/apps/mobile/apps/client/maestro/README.md
@@ -0,0 +1,42 @@
+# Maestro Integration Tests — Client App
+
+Login and signup flows for the KROW Client app.  
+See [docs/research/flutter-testing-tools.md](/docs/research/flutter-testing-tools.md) for the evaluation report.  
+**Full run instructions:** [docs/research/maestro-test-run-instructions.md](/docs/research/maestro-test-run-instructions.md)
+
+## Prerequisites
+
+- [Maestro CLI](https://maestro.dev/docs/getting-started/installation) installed
+- Client app built and installed on device/emulator:
+  ```bash
+  cd apps/mobile && flutter build apk
+  adb install build/app/outputs/flutter-apk/app-debug.apk
+  ```
+
+## Credentials
+
+| Flow | Credentials |
+|------|-------------|
+| **Client login** | legendary@krowd.com / Demo2026! |
+| **Staff login** | 5557654321 / OTP 123456 |
+| **Client signup** | Env vars: `MAESTRO_CLIENT_EMAIL`, `MAESTRO_CLIENT_PASSWORD`, `MAESTRO_CLIENT_COMPANY` |
+| **Staff signup** | Env var: `MAESTRO_STAFF_SIGNUP_PHONE` (must be new Firebase test phone) |
+
+## Run
+
+From the project root:
+
+```bash
+# Login
+maestro test apps/mobile/apps/client/maestro/login.yaml
+
+# Signup
+maestro test apps/mobile/apps/client/maestro/signup.yaml
+```
+
+## Flows
+
+| File       | Flow        | Description                                |
+|------------|-------------|--------------------------------------------|
+| login.yaml | Client Login| Get Started → Sign In → Home               |
+| signup.yaml| Client Signup| Get Started → Create Account → Home        |
--- a/apps/mobile/apps/client/maestro/login.yaml
+++ b/apps/mobile/apps/client/maestro/login.yaml
@@ -0,0 +1,18 @@
+# Client App - Login Flow
+# Prerequisites: App built and installed (debug or release)
+# Run: maestro test apps/mobile/apps/client/maestro/login.yaml
+# Test credentials: legendary@krowd.com / Demo2026!
+# Note: Auth uses Firebase/Data Connect
+
+appId: com.krowwithus.client
+---
+- launchApp
+- assertVisible: "Sign In"
+- tapOn: "Sign In"
+- assertVisible: "Email"
+- tapOn: "Email"
+- inputText: "legendary@krowd.com"
+- tapOn: "Password"
+- inputText: "Demo2026!"
+- tapOn: "Sign In"
+- assertVisible: "Home"
--- a/apps/mobile/apps/client/maestro/signup.yaml
+++ b/apps/mobile/apps/client/maestro/signup.yaml
@@ -0,0 +1,23 @@
+# Client App - Sign Up Flow
+# Prerequisites: App built and installed
+# Run: maestro test apps/mobile/apps/client/maestro/signup.yaml
+# Use NEW credentials for signup (creates new account)
+# Env: MAESTRO_CLIENT_EMAIL, MAESTRO_CLIENT_PASSWORD, MAESTRO_CLIENT_COMPANY
+
+appId: com.krowwithus.client
+---
+- launchApp
+- assertVisible: "Create Account"
+- tapOn: "Create Account"
+- assertVisible: "Company"
+- tapOn: "Company"
+- inputText: "${MAESTRO_CLIENT_COMPANY}"
+- tapOn: "Email"
+- inputText: "${MAESTRO_CLIENT_EMAIL}"
+- tapOn: "Password"
+- inputText: "${MAESTRO_CLIENT_PASSWORD}"
+- tapOn:
+    text: "Confirm Password"
+- inputText: "${MAESTRO_CLIENT_PASSWORD}"
+- tapOn: "Create Account"
+- assertVisible: "Home"
--- a/apps/mobile/apps/client/pubspec.yaml
+++ b/apps/mobile/apps/client/pubspec.yaml
@@ -42,6 +42,7 @@ dependencies:
    sdk: flutter
  firebase_core: ^4.4.0
  krow_data_connect: ^0.0.1
+  marionette_flutter: ^0.3.0

 dev_dependencies:
  flutter_test:
--- a/apps/mobile/apps/staff/lib/main.dart
+++ b/apps/mobile/apps/staff/lib/main.dart
@@ -1,7 +1,11 @@
+import 'dart:io' show Platform;
+
 import 'package:core_localization/core_localization.dart' as core_localization;
 import 'package:design_system/design_system.dart';
 import 'package:firebase_core/firebase_core.dart';
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
+import 'package:marionette_flutter/marionette_flutter.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_modular/flutter_modular.dart';
@@ -15,7 +19,23 @@ import 'package:krow_core/core.dart';
 import 'src/widgets/session_listener.dart';

 void main() async {
-  WidgetsFlutterBinding.ensureInitialized();
+  final bool isFlutterTest =
+      !kIsWeb ? Platform.environment.containsKey('FLUTTER_TEST') : false;
+  if (kDebugMode && !isFlutterTest) {
+    MarionetteBinding.ensureInitialized(
+      MarionetteConfiguration(
+        isInteractiveWidget: (Type type) =>
+            type == UiButton || type == UiTextField,
+        extractText: (Widget widget) {
+          if (widget is UiTextField) return widget.label;
+          if (widget is UiButton) return widget.text;
+          return null;
+        },
+      ),
+    );
+  } else {
+    WidgetsFlutterBinding.ensureInitialized();
+  }
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);

  // Register global BLoC observer for centralized error logging
--- a/apps/mobile/apps/staff/maestro/README.md
+++ b/apps/mobile/apps/staff/maestro/README.md
@@ -0,0 +1,41 @@
+# Maestro Integration Tests — Staff App
+
+Login and signup flows for the KROW Staff app.  
+See [docs/research/flutter-testing-tools.md](/docs/research/flutter-testing-tools.md) for the evaluation report.  
+**Full run instructions:** [docs/research/maestro-test-run-instructions.md](/docs/research/maestro-test-run-instructions.md)
+
+## Prerequisites
+
+- [Maestro CLI](https://maestro.dev/docs/getting-started/installation) installed
+- Staff app built and installed
+- **Firebase test phone** in Firebase Console (Auth > Sign-in method > Phone):
+  - Login: +1 555-765-4321 / OTP 123456
+  - Signup: add a different test number for new accounts
+
+## Credentials
+
+| Flow | Credentials |
+|------|-------------|
+| **Client login** | legendary@krowd.com / Demo2026! |
+| **Staff login** | 5557654321 / OTP 123456 |
+| **Client signup** | Env vars: `MAESTRO_CLIENT_EMAIL`, `MAESTRO_CLIENT_PASSWORD`, `MAESTRO_CLIENT_COMPANY` |
+| **Staff signup** | Env var: `MAESTRO_STAFF_SIGNUP_PHONE` (must be new Firebase test phone) |
+
+## Run
+
+From the project root:
+
+```bash
+# Login
+maestro test apps/mobile/apps/staff/maestro/login.yaml
+
+# Signup
+maestro test apps/mobile/apps/staff/maestro/signup.yaml
+```
+
+## Flows
+
+| File       | Flow       | Description                         |
+|------------|------------|-------------------------------------|
+| login.yaml | Staff Login| Get Started → Log In → Phone → OTP → Home |
+| signup.yaml| Staff Signup| Get Started → Sign Up → Phone → OTP → Profile Setup |
--- a/apps/mobile/apps/staff/maestro/login.yaml
+++ b/apps/mobile/apps/staff/maestro/login.yaml
@@ -0,0 +1,18 @@
+# Staff App - Login Flow (Phone + OTP)
+# Prerequisites: App built and installed; Firebase test phone configured
+# Firebase test phone: +1 555-765-4321 / OTP 123456
+# Run: maestro test apps/mobile/apps/staff/maestro/login.yaml
+
+appId: com.krowwithus.staff
+---
+- launchApp
+- assertVisible: "Log In"
+- tapOn: "Log In"
+- assertVisible: "Send Code"
+- inputText: "5557654321"
+- tapOn: "Send Code"
+# Wait for OTP screen
+- assertVisible: "Continue"
+- inputText: "123456"
+- tapOn: "Continue"
+# On success: staff main. Adjust final assertion to match staff home screen.
--- a/apps/mobile/apps/staff/maestro/signup.yaml
+++ b/apps/mobile/apps/staff/maestro/signup.yaml
@@ -0,0 +1,18 @@
+# Staff App - Sign Up Flow (Phone + OTP)
+# Prerequisites: App built and installed; Firebase test phone for NEW number
+# Use a NEW phone number for signup (creates new account)
+# Firebase: add test phone in Auth > Phone; e.g. +1 555-555-0000 / 123456
+# Run: maestro test apps/mobile/apps/staff/maestro/signup.yaml
+
+appId: com.krowwithus.staff
+---
+- launchApp
+- assertVisible: "Sign Up"
+- tapOn: "Sign Up"
+- assertVisible: "Send Code"
+- inputText: "${MAESTRO_STAFF_SIGNUP_PHONE}"
+- tapOn: "Send Code"
+- assertVisible: "Continue"
+- inputText: "123456"
+- tapOn: "Continue"
+# On success: Profile Setup. Adjust assertion to match destination.
--- a/apps/mobile/apps/staff/pubspec.yaml
+++ b/apps/mobile/apps/staff/pubspec.yaml
@@ -30,6 +30,7 @@ dependencies:
    path: ../../packages/core
  krow_data_connect:
    path: ../../packages/data_connect
+  marionette_flutter: ^0.3.0
  cupertino_icons: ^1.0.8
  flutter_modular: ^6.3.0
  firebase_core: ^4.4.0
--- a/apps/mobile/pubspec.lock
+++ b/apps/mobile/pubspec.lock
@@ -813,6 +813,14 @@ packages:
      url: "https://pub.dev"
    source: hosted
    version: "0.257.0"
+  marionette_flutter:
+    dependency: transitive
+    description:
+      name: marionette_flutter
+      sha256: "0077073f62a8031879a91be41aa91629f741a7f1348b18feacd53443dae3819f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.3.0"
  matcher:
    dependency: transitive
    description: