Files
afterwork/lib/data/providers/friends_provider.dart
2024-11-17 23:00:18 +00:00

175 lines
7.0 KiB
Dart

import 'package:flutter/material.dart';
import 'package:logger/logger.dart';
import '../../domain/entities/friend.dart';
import '../../data/repositories/friends_repository_impl.dart';
/// [FriendsProvider] est un `ChangeNotifier` qui gère la logique de gestion des amis.
/// Il interagit avec le [FriendsRepositoryImpl] pour effectuer des appels API et gérer
/// la liste des amis de l'utilisateur, avec une gestion avancée de la pagination,
/// du statut des amis et de la gestion des erreurs.
class FriendsProvider with ChangeNotifier {
final FriendsRepositoryImpl friendsRepository;
final Logger _logger = Logger(); // Utilisation du logger pour une traçabilité complète des actions.
// Liste des amis
List<Friend> _friendsList = [];
bool _isLoading = false; // Indicateur de chargement
bool _hasMore = true; // Indicateur de pagination
int _currentPage = 0; // Numéro de la page actuelle pour la pagination
final int _friendsPerPage = 10; // Nombre d'amis à récupérer par page
/// Constructeur de [FriendsProvider] qui nécessite l'instance d'un [FriendsRepositoryImpl].
FriendsProvider({required this.friendsRepository});
// Getters pour accéder à l'état actuel des données
bool get isLoading => _isLoading;
bool get hasMore => _hasMore;
List<Friend> get friendsList => _friendsList;
/// Récupère la liste des amis pour un utilisateur donné avec pagination.
///
/// [userId] : L'identifiant unique de l'utilisateur connecté.
/// [loadMore] : Si vrai, charge plus d'amis, sinon recharge la liste depuis le début.
///
/// Cette méthode gère :
/// - La pagination de la liste d'amis.
/// - L'exclusion de l'utilisateur lui-même.
/// - Les erreurs et les logs pour une traçabilité complète.
Future<void> fetchFriends(String userId, {bool loadMore = false}) async {
if (_isLoading) {
_logger.w('[LOG] Une opération de chargement est déjà en cours. Annulation de la nouvelle requête.');
return;
}
_isLoading = true;
notifyListeners();
_logger.i('[LOG] Début du chargement des amis pour l\'utilisateur $userId.');
// Réinitialisation de la pagination si ce n'est pas un chargement supplémentaire
if (!loadMore) {
_friendsList = [];
_currentPage = 0;
_hasMore = true;
_logger.i('[LOG] Réinitialisation de la pagination et de la liste des amis.');
}
try {
_logger.i('[LOG] Chargement de la page $_currentPage des amis pour l\'utilisateur $userId.');
final newFriends = await friendsRepository.fetchFriends(userId, _currentPage, _friendsPerPage);
// Gestion de l'absence de nouveaux amis
if (newFriends.isEmpty) {
_hasMore = false;
_logger.i('[LOG] Plus d\'amis à charger.');
} else {
// Ajout des amis à la liste, en excluant l'utilisateur connecté
for (var friend in newFriends) {
if (friend.friendId != userId) {
_friendsList.add(friend);
_logger.i("[LOG] Ami ajouté : ID = ${friend.friendId}, Nom = ${friend.friendFirstName} ${friend.friendLastName}");
} else {
_logger.w("[WARN] L'utilisateur connecté est exclu de la liste des amis : ${friend.friendId}");
}
}
_currentPage++;
_logger.i('[LOG] Préparation de la page suivante : $_currentPage');
}
} catch (e) {
_logger.e('[ERROR] Erreur lors du chargement des amis : $e');
} finally {
_isLoading = false;
_logger.i('[LOG] Fin du chargement des amis.');
notifyListeners();
}
}
/// Supprime un ami de la liste locale et de l'API.
///
/// [friendId] : Identifiant unique de l'ami à supprimer.
///
/// Cette méthode :
/// - Loggue chaque étape.
/// - Enlève l'ami de la liste locale.
Future<void> removeFriend(String friendId) async {
try {
_logger.i('[LOG] Suppression de l\'ami avec l\'ID : $friendId');
await friendsRepository.removeFriend(friendId); // Appel API pour supprimer l'ami
_friendsList.removeWhere((friend) => friend.friendId == friendId); // Suppression locale
_logger.i('[LOG] Ami supprimé localement avec succès : $friendId');
} catch (e) {
_logger.e('[ERROR] Erreur lors de la suppression de l\'ami : $e');
} finally {
notifyListeners();
}
}
/// Récupère les détails d'un ami via l'API.
///
/// [userId] : Identifiant de l'utilisateur connecté.
/// [friendId] : Identifiant de l'ami dont on souhaite récupérer les détails.
///
/// Retourne un `Future<Friend?>` contenant les détails de l'ami ou `null` en cas d'erreur.
Future<Friend?> fetchFriendDetails(String userId, String friendId) async {
try {
_logger.i('[LOG] Récupération des détails de l\'ami avec l\'ID : $friendId');
final friendDetails = await friendsRepository.getFriendDetails(friendId, userId);
if (friendDetails != null) {
_logger.i('[LOG] Détails de l\'ami récupérés avec succès : ${friendDetails.friendId}');
} else {
_logger.w('[WARN] Détails de l\'ami introuvables pour l\'ID : $friendId');
}
return friendDetails;
} catch (e) {
_logger.e('[ERROR] Erreur lors de la récupération des détails de l\'ami : $e');
return null;
}
}
/// Convertit un statut sous forme de chaîne en [FriendStatus].
///
/// [status] : Le statut sous forme de chaîne (par exemple, 'pending', 'accepted').
///
/// Retourne un [FriendStatus] correspondant, ou `FriendStatus.unknown` si non reconnu.
FriendStatus _convertToFriendStatus(String status) {
switch (status.toLowerCase()) {
case 'pending':
return FriendStatus.pending;
case 'accepted':
return FriendStatus.accepted;
case 'blocked':
return FriendStatus.blocked;
default:
return FriendStatus.unknown;
}
}
/// Met à jour le statut d'un ami (ex. accepter, bloquer).
///
/// [friendId] : Identifiant de l'ami dont on souhaite mettre à jour le statut.
/// [status] : Nouveau statut sous forme de chaîne de caractères.
///
/// Loggue l'action, met à jour le statut en local et appelle l'API pour mettre à jour le statut.
Future<void> updateFriendStatus(String friendId, String status) async {
try {
_logger.i('[LOG] Mise à jour du statut de l\'ami avec l\'ID : $friendId');
// Conversion du statut sous forme de chaîne en statut spécifique
final friendStatus = _convertToFriendStatus(status);
await friendsRepository.updateFriendStatus(friendId, status); // Mise à jour dans l'API
// Mise à jour locale de la liste des amis avec le nouveau statut
final friendIndex = _friendsList.indexWhere((friend) => friend.friendId == friendId);
if (friendIndex != -1) {
_friendsList[friendIndex] = _friendsList[friendIndex].copyWith(status: friendStatus);
_logger.i('[LOG] Statut de l\'ami mis à jour localement pour l\'ID : $friendId');
}
} catch (e) {
_logger.e('[ERROR] Erreur lors de la mise à jour du statut de l\'ami : $e');
} finally {
notifyListeners();
}
}
}