update
This commit is contained in:
62
lib/features/home/domain/usecases/get_member_card.dart
Normal file
62
lib/features/home/domain/usecases/get_member_card.dart
Normal file
@@ -0,0 +1,62 @@
|
||||
/// Use Case: Get Member Card
|
||||
///
|
||||
/// Retrieves the current user's member card information.
|
||||
/// This use case encapsulates the business logic for fetching member card data.
|
||||
///
|
||||
/// Follows the Single Responsibility Principle - one use case, one operation.
|
||||
library;
|
||||
|
||||
import 'package:worker/features/home/domain/entities/member_card.dart';
|
||||
import 'package:worker/features/home/domain/repositories/home_repository.dart';
|
||||
|
||||
/// Get Member Card Use Case
|
||||
///
|
||||
/// Fetches the current authenticated user's member card.
|
||||
///
|
||||
/// Usage:
|
||||
/// ```dart
|
||||
/// final memberCard = await getMemberCard();
|
||||
/// ```
|
||||
///
|
||||
/// This use case:
|
||||
/// - Retrieves member card from repository (which handles caching)
|
||||
/// - Can add business logic if needed (e.g., validation, transformation)
|
||||
/// - Returns MemberCard entity
|
||||
class GetMemberCard {
|
||||
/// Home repository instance
|
||||
final HomeRepository repository;
|
||||
|
||||
/// Constructor
|
||||
const GetMemberCard(this.repository);
|
||||
|
||||
/// Execute the use case
|
||||
///
|
||||
/// Returns [MemberCard] with user's membership information.
|
||||
///
|
||||
/// Throws:
|
||||
/// - [UnauthorizedException] if user not authenticated
|
||||
/// - [NetworkException] if network error occurs
|
||||
/// - [CacheException] if local data corrupted
|
||||
Future<MemberCard> call() async {
|
||||
// TODO: Add business logic here if needed
|
||||
// For example:
|
||||
// - Validate user authentication
|
||||
// - Check if card is expired and handle accordingly
|
||||
// - Transform data if needed
|
||||
// - Log analytics events
|
||||
|
||||
return await repository.getMemberCard();
|
||||
}
|
||||
|
||||
/// Execute with force refresh
|
||||
///
|
||||
/// Forces a refresh from the server instead of using cached data.
|
||||
///
|
||||
/// Use this when:
|
||||
/// - User explicitly pulls to refresh
|
||||
/// - Cached data is known to be stale
|
||||
/// - After points redemption or other updates
|
||||
Future<MemberCard> refresh() async {
|
||||
return await repository.refreshMemberCard();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user