Login

• File: lib/views/login_page.dart

The LoginPage is a Flutter widget that serves as the authentication entry point for the HVC Mobile application. It provides multiple authentication methods including SSO login, rapid connect, QR code scanning, and biometric authentication.

Class Structure

Class Definition

class LoginPage extends StatelessWidget {
  static const String routeName = '/LoginPage';
  LoginPage({super.key});
}

Controllers

final AuthController authController = Get.find();
final ContactsController contactsController = Get.find();
final RealTimeController realTimeController = Get.find();
final MeetingsController meetingsController = Get.find();

State Variables

final TextEditingController orgCtrl = TextEditingController();
final storage = GetStorage();

Dependencies

Required Packages

• flutter/material.dart - Core Flutter UI components
• get/get.dart - State management and routing
• get_storage/get_storage.dart - Local storage
• permission_handler/permission_handler.dart - Permission management

Internal Dependencies

• auth_controller.dart - Authentication logic
• contacts_controller.dart - Contact management
• meetings_controller.dart - Meeting management
• real_time_controller.dart - Real-time communication
• hlk_helpers/ - Custom helper utilities
• shared/ - Shared constants and configurations

Authentication Methods

1. SSO Login

onTapped: () async {
  if (GetUtils.isNullOrBlank(orgCtrl.text.trim())!) {
    HlkDialog.showErrorSnackBar('Please enter Organization to proceed');
  } else {
    await authController.ssoLogin(orgCtrl.text.trim()).whenComplete(
      () async {
        await realTimeController.onInit();
        await contactsController.getMe();
      },
    );
  }
}

2. Rapid Connect

onTapped: () async {
  if (GetUtils.isNullOrBlank(orgCtrl.text.trim())!) {
    HlkDialog.showErrorSnackBar('Please enter Organization to proceed');
  } else {
    var rapidConn = await meetingsController.rapidConnect(orgCtrl.text.trim());
    if (rapidConn != null) {
      // Handle rapid connect success
    }
  }
}

3. QR Code Scanning

onTapped: () async => await validatePermission(
  Permission.camera,
  () => Get.toNamed(NewScannerPage.routeName)
)

4. Biometric Authentication

onTapped: () async {
  await authController.runBiometric().whenComplete(
    () async {
      await realTimeController.onInit();
      await contactsController.getMe();
    },
  );
}

UI Components

Organization Input Field

TextField(
  controller: orgCtrl,
  decoration: InputDecoration(
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(6.0),
      borderSide: const BorderSide(
        width: 0,
        style: BorderStyle.none,
      ),
    ),
    hintText: 'Enter Organization',
    prefixIcon: const Icon(
      Icons.business,
      color: kAppColorBlue,
    ),
    filled: true,
  ),
  maxLines: 1,
)

Action Buttons

1. Login Button

   • Primary action button
   • Triggers SSO login
   • Shows loading state

2. Rapid Connect Button

   • Secondary action button
   • Handles rapid connection flow
   • Shows loading state

3. Scan Code Button

   • Outlined button
   • Requires camera permission
   • Navigates to scanner page

4. Biometric Button

   • Conditional rendering based on isBioEnabled
   • Includes fingerprint icon
   • Shows loading state

State Management

Reactive State

Obx(() => Container(
  // UI components that react to state changes
))

Loading States

isLoading: authController.loading.value

Storage Management

if (storage.hasData(Constants.ORGANISATION))
  orgCtrl.text = storage.read(Constants.ORGANISATION) ?? '';

Layout Management

Responsive Design

OrientationBuilder(
  builder: (context, orientation) {
    isLandscape = orientation == Orientation.landscape;
    return Scaffold(
      body: isLandscape ? LandscapeLayout() : PortraitLayout()
    );
  }
)

Layout Components

1. Landscape Layout

   • Split screen design
   • Left side: Background image with logo
   • Right side: Login form

2. Portrait Layout

   • Single column design
   • Top: Background image with logo
   • Bottom: Login form

Security Features

Biometric Authentication

if (isBioEnabled && isBioTokenValid()) {
  Future.delayed(const Duration(seconds: 1), () async {
    await authController.runBiometric()
  });
}

Permission Handling

await validatePermission(
  Permission.camera,
  () => Get.toNamed(NewScannerPage.routeName)
)