Merge branch '312-feature-integrate-google-maps-places-autocomplete-for-hub-address-validation' into fix_staff_app_bugs

apps/mobile/packages/domain/lib/krow_domain.dart

@@ -87,6 +87,11 @@ export 'src/adapters/clock_in/clock_in_adapter.dart';
 export 'src/entities/availability/availability_slot.dart';
 export 'src/entities/availability/day_availability.dart';
 
+// Coverage
+export 'src/entities/coverage_domain/coverage_shift.dart';
+export 'src/entities/coverage_domain/coverage_worker.dart';
+export 'src/entities/coverage_domain/coverage_stats.dart';
+
 // Adapters
 export 'src/adapters/profile/emergency_contact_adapter.dart';
 export 'src/adapters/profile/experience_adapter.dart';

apps/mobile/packages/domain/lib/src/adapters/shifts/shift_adapter.dart

@@ -1,10 +1,59 @@
+import 'package:intl/intl.dart';
 import '../../entities/shifts/shift.dart';
 
 /// Adapter for Shift related data.
 class ShiftAdapter {
-  
-  // Note: Conversion logic will likely live in RepoImpl or here if we pass raw objects.
-  // Given we are dealing with generated types that aren't exported by domain, 
-  // we might put the logic in Repo or make this accept dynamic/Map if strictly required.
-  // For now, placeholders or simple status helpers.
+  /// Maps application data to a Shift entity.
+  /// 
+  /// This method handles the common mapping logic used across different
+  /// repositories when converting application data from Data Connect to
+  /// domain Shift entities.
+  static Shift fromApplicationData({
+    required String shiftId,
+    required String roleId,
+    required String roleName,
+    required String businessName,
+    String? companyLogoUrl,
+    required double costPerHour,
+    String? shiftLocation,
+    required String teamHubName,
+    DateTime? shiftDate,
+    DateTime? startTime,
+    DateTime? endTime,
+    DateTime? createdAt,
+    required String status,
+    String? description,
+    int? durationDays,
+    required int count,
+    int? assigned,
+    String? eventName,
+    bool hasApplied = false,
+  }) {
+    final String orderName = (eventName ?? '').trim().isNotEmpty
+        ? eventName!
+        : businessName;
+    final String title = '$roleName - $orderName';
+
+    return Shift(
+      id: shiftId,
+      roleId: roleId,
+      title: title,
+      clientName: businessName,
+      logoUrl: companyLogoUrl,
+      hourlyRate: costPerHour,
+      location: shiftLocation ?? '',
+      locationAddress: teamHubName,
+      date: shiftDate?.toIso8601String() ?? '',
+      startTime: startTime != null ? DateFormat('HH:mm').format(startTime) : '',
+      endTime: endTime != null ? DateFormat('HH:mm').format(endTime) : '',
+      createdDate: createdAt?.toIso8601String() ?? '',
+      status: status,
+      description: description,
+      durationDays: durationDays,
+      requiredSlots: count,
+      filledSlots: assigned ?? 0,
+      hasApplied: hasApplied,
+    );
+  }
 }
+

apps/mobile/packages/domain/lib/src/entities/coverage_domain/coverage_shift.dart

@@ -0,0 +1,57 @@
+import 'package:equatable/equatable.dart';
+import 'coverage_worker.dart';
+
+/// Domain entity representing a shift in the coverage view.
+///
+/// This is a feature-specific domain entity that encapsulates shift information
+/// including scheduling details and assigned workers.
+class CoverageShift extends Equatable {
+  /// Creates a [CoverageShift].
+  const CoverageShift({
+    required this.id,
+    required this.title,
+    required this.location,
+    required this.startTime,
+    required this.workersNeeded,
+    required this.date,
+    required this.workers,
+  });
+
+  /// The unique identifier for the shift.
+  final String id;
+
+  /// The title or role of the shift.
+  final String title;
+
+  /// The location where the shift takes place.
+  final String location;
+
+  /// The start time of the shift (e.g., "16:00").
+  final String startTime;
+
+  /// The number of workers needed for this shift.
+  final int workersNeeded;
+
+  /// The date of the shift.
+  final DateTime date;
+
+  /// The list of workers assigned to this shift.
+  final List<CoverageWorker> workers;
+
+  /// Calculates the coverage percentage for this shift.
+  int get coveragePercent {
+    if (workersNeeded == 0) return 0;
+    return ((workers.length / workersNeeded) * 100).round();
+  }
+
+  @override
+  List<Object?> get props => <Object?>[
+        id,
+        title,
+        location,
+        startTime,
+        workersNeeded,
+        date,
+        workers,
+      ];
+}

apps/mobile/packages/domain/lib/src/entities/coverage_domain/coverage_stats.dart

@@ -0,0 +1,45 @@
+import 'package:equatable/equatable.dart';
+
+/// Domain entity representing coverage statistics.
+///
+/// Aggregates coverage metrics for a specific date.
+class CoverageStats extends Equatable {
+  /// Creates a [CoverageStats].
+  const CoverageStats({
+    required this.totalNeeded,
+    required this.totalConfirmed,
+    required this.checkedIn,
+    required this.enRoute,
+    required this.late,
+  });
+
+  /// The total number of workers needed.
+  final int totalNeeded;
+
+  /// The total number of confirmed workers.
+  final int totalConfirmed;
+
+  /// The number of workers who have checked in.
+  final int checkedIn;
+
+  /// The number of workers en route.
+  final int enRoute;
+
+  /// The number of late workers.
+  final int late;
+
+  /// Calculates the overall coverage percentage.
+  int get coveragePercent {
+    if (totalNeeded == 0) return 0;
+    return ((totalConfirmed / totalNeeded) * 100).round();
+  }
+
+  @override
+  List<Object?> get props => <Object?>[
+        totalNeeded,
+        totalConfirmed,
+        checkedIn,
+        enRoute,
+        late,
+      ];
+}

apps/mobile/packages/domain/lib/src/entities/coverage_domain/coverage_worker.dart

@@ -0,0 +1,55 @@
+import 'package:equatable/equatable.dart';
+
+/// Worker status enum matching ApplicationStatus from Data Connect.
+enum CoverageWorkerStatus {
+  /// Application is pending approval.
+  pending,
+
+  /// Application has been accepted.
+  accepted,
+
+  /// Application has been rejected.
+  rejected,
+
+  /// Worker has confirmed attendance.
+  confirmed,
+
+  /// Worker has checked in.
+  checkedIn,
+
+  /// Worker has checked out.
+  checkedOut,
+
+  /// Worker is late.
+  late,
+
+  /// Worker did not show up.
+  noShow,
+
+  /// Shift is completed.
+  completed,
+}
+
+/// Domain entity representing a worker in the coverage view.
+///
+/// This entity tracks worker status including check-in information.
+class CoverageWorker extends Equatable {
+  /// Creates a [CoverageWorker].
+  const CoverageWorker({
+    required this.name,
+    required this.status,
+    this.checkInTime,
+  });
+
+  /// The name of the worker.
+  final String name;
+
+  /// The status of the worker.
+  final CoverageWorkerStatus status;
+
+  /// The time the worker checked in, if applicable.
+  final String? checkInTime;
+
+  @override
+  List<Object?> get props => <Object?>[name, status, checkInTime];
+}