Skip to main content

Employee Management

Manajemen karyawan dan role assignment

๐ŸŽฏ Overview

Employee adalah salah satu fitur utama dalam MStore Mobile yang menyediakan fungsionalitas untuk manajemen karyawan dan role assignment.

๐Ÿ“‹ Features

  • โœ… Employee CRUD
  • โœ… Role assignment
  • โœ… Permission management
  • โœ… Activity logging
  • โœ… Performance tracking
  • โœ… Shift assignment

๐Ÿ—๏ธ Architecture

BLoC Implementation

BLoC: EmployeeBloc
// Events
abstract class EmployeeEvent extends Equatable {}

class LoadEmployee extends EmployeeEvent {}
class CreateEmployee extends EmployeeEvent {}
class UpdateEmployee extends EmployeeEvent {}
class DeleteEmployee extends EmployeeEvent {}

// States
abstract class EmployeeState extends Equatable {}

class EmployeeInitial extends EmployeeState {}
class EmployeeLoading extends EmployeeState {}
class EmployeeLoaded extends EmployeeState {}
class EmployeeError extends EmployeeState {}

// BLoC
class EmployeeBloc extends Bloc<EmployeeEvent, EmployeeState> {
  final EmployeeRepository _repository;
  
  EmployeeBloc({required EmployeeRepository repository})
      : _repository = repository,
        super(EmployeeInitial()) {
    on<LoadEmployee>(_onLoad);
    on<CreateEmployee>(_onCreate);
    on<UpdateEmployee>(_onUpdate);
    on<DeleteEmployee>(_onDelete);
  }
  
  Future<void> _onLoad(
    LoadEmployee event,
    Emitter<EmployeeState> emit,
  ) async {
    emit(EmployeeLoading());
    
    final result = await _repository.getEmployees();
    
    result.fold(
      (failure) => emit(EmployeeError(failure.message)),
      (data) => emit(EmployeeLoaded(data)),
    );
  }
}

Repository Pattern

abstract class EmployeeRepository {
  Future<Either<Failure, List<Employee>>> getEmployees();
  Future<Either<Failure, Employee>> getEmployeeById(String id);
  Future<Either<Failure, Employee>> createEmployee(Employee data);
  Future<Either<Failure, Employee>> updateEmployee(String id, Employee data);
  Future<Either<Failure, void>> deleteEmployee(String id);
}

class EmployeeRepositoryImpl implements EmployeeRepository {
  final EmployeeApi _api;
  final EmployeeLocalRepository _localRepo;
  
  @override
  Future<Either<Failure, List<Employee>>> getEmployees() async {
    try {
      // Try local first (offline-first)
      final local = await _localRepo.getEmployees();
      
      // Sync with API in background
      final result = await _api.getEmployees();
      result.fold(
        (failure) => null,
        (data) => _localRepo.saveEmployees(data),
      );
      
      return Right(local.isNotEmpty ? local : result.getOrElse(() => []));
    } catch (e) {
      return Left(UnexpectedFailure(e.toString()));
    }
  }
}

๐Ÿ“ก API Integration

Endpoints

  • /api/v1/employees/*

Request/Response Examples

Get List

GET /api/v1/employees/*
Authorization: Bearer {access_token}
Response:
{
  "success": true,
  "data": [
    {
      "id": "123",
      "name": "Example",
      "created_at": "2024-10-14T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100
  }
}

๐Ÿ’พ Local Database (Isar)

Schema

  • EmployeeLocal
@collection
class EmployeeLocal {
  Id id = Isar.autoIncrement;
  
  @Index()
  String? employeeId;
  
  String? name;
  DateTime? createdAt;
  DateTime? updatedAt;
  DateTime? syncedAt;
  
  bool? isSynced;
  bool? isDeleted;
}

Queries

// Get all
final items = await isar.employeeLocals.where().findAll();

// Get by ID
final item = await isar.employeeLocals
    .filter()
    .employeeIdEqualTo(id)
    .findFirst();

// Search
final results = await isar.employeeLocals
    .filter()
    .nameContains(query, caseSensitive: false)
    .findAll();

// Get unsynced
final unsynced = await isar.employeeLocals
    .filter()
    .isSyncedEqualTo(false)
    .findAll();

๐Ÿ”„ Offline-First Strategy

Write Operations

  1. Save to local Isar immediately
  2. Show success to user
  3. Add to sync queue
  4. Background sync when online
  5. Update with server response

Read Operations

  1. Read from local Isar (fast)
  2. Show to user immediately
  3. Background fetch from API
  4. Update local cache if changed
  5. Notify UI if data updated

Conflict Resolution

  • Strategy: Last-write-wins
  • Timestamp: Server timestamp as source of truth
  • Logging: All conflicts logged for audit

๐ŸŽจ UI Components

Main Screen

class EmployeePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return BlocProvider(
      create: (context) => getIt<EmployeeBloc>()..add(LoadEmployee()),
      child: Scaffold(
        appBar: AppBar(title: Text('Employee Management')),
        body: BlocBuilder<EmployeeBloc, EmployeeState>(
          builder: (context, state) {
            if (state is EmployeeLoading) {
              return Center(child: CircularProgressIndicator());
            }
            
            if (state is EmployeeError) {
              return ErrorWidget(message: state.message);
            }
            
            if (state is EmployeeLoaded) {
              return EmployeeListView(items: state.items);
            }
            
            return SizedBox.shrink();
          },
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () => _navigateToCreate(context),
          child: Icon(Icons.add),
        ),
      ),
    );
  }
}

๐Ÿงช Testing

Unit Tests

void main() {
  group('EmployeeBloc', () {
    late EmployeeBloc bloc;
    late MockEmployeeRepository mockRepository;

    setUp(() {
      mockRepository = MockEmployeeRepository();
      bloc = EmployeeBloc(repository: mockRepository);
    });

    tearDown(() {
      bloc.close();
    });

    test('initial state is EmployeeInitial', () {
      expect(bloc.state, equals(EmployeeInitial()));
    });

    blocTest<EmployeeBloc, EmployeeState>(
      'emits [Loading, Loaded] when Load succeeds',
      build: () {
        when(() => mockRepository.getEmployees()).thenAnswer(
          (_) async => Right([Employee(id: '1', name: 'Test')]),
        );
        return bloc;
      },
      act: (bloc) => bloc.add(LoadEmployee()),
      expect: () => [
        EmployeeLoading(),
        isA<EmployeeLoaded>(),
      ],
    );
  });
}

๐Ÿ“Š Performance Considerations

  • Lazy Loading: Load data on demand
  • Pagination: Implement pagination for large datasets
  • Caching: Cache frequently accessed data
  • Indexing: Use Isar indexes for fast queries
  • Background Sync: Sync in background to avoid blocking UI

๐Ÿ” Security

  • Authorization: Check user permissions before operations
  • Data Encryption: Sensitive data encrypted in Isar
  • Input Validation: Validate all user inputs
  • Audit Trail: Log all operations for audit

๐Ÿ“ฑ Platform-Specific

iOS

  • Use Cupertino widgets
  • Follow iOS HIG
  • Handle safe area insets

Android

  • Use Material widgets
  • Follow Material Design
  • Handle back button

Last Updated: October 14, 2024
Status: โœ… Production Ready