feat: Refonte de la checklist de préparation avec gestion des manquants et des containers

Cette mise à jour refond entièrement l'interface et la logique de la checklist de préparation d'événement. Elle introduit la notion d'équipements "manquants", une gestion visuelle des containers et de leur contenu, et une logique plus fine pour le suivi des quantités et des statuts à chaque étape.

**Features et Améliorations :**

-   **Gestion des Équipements Manquants :**
    -   Le modèle `EventEquipment` a été enrichi pour tracer si un équipement est manquant à chaque étape (`isMissingAtPreparation`, `isMissingAtLoading`, etc.).
    -   Un équipement non validé lors de la confirmation d'une étape est désormais marqué comme "manquant" pour les étapes suivantes.
    -   Les équipements qui étaient manquants à l'étape précédente sont maintenant visuellement mis en évidence avec une bordure et une icône orange, et une confirmation est demandée pour les valider.

-   **Refonte de la Checklist (UI/UX) :**
    -   **Groupement par Container :** La checklist affiche désormais les containers comme des en-têtes de groupe. Les équipements qu'ils contiennent sont listés en dessous, avec une indentation visuelle.
    -   **Validation Groupée :** Il est possible de valider tous les équipements d'un container en un seul clic sur l'en-tête du container.
    -   **Nouveau Widget `ContainerChecklistItem` :** Créé pour afficher un container et ses équipements enfants dans la checklist.
    -   **Refonte de `EquipmentChecklistItem` :** Le widget a été entièrement revu pour un design plus clair, une meilleure gestion des états (validé, manquant), et un affichage compact pour les équipements enfants.

-   **Logique de Suivi Améliorée :**
    -   **Quantités par Étape :** Le modèle `EventEquipment` et l'interface de préparation permettent maintenant de suivre les quantités réelles à chaque étape (`quantityAtPreparation`, `quantityAtLoading`, etc.), au lieu d'une seule quantité de retour.
    -   **Marquage Automatique des "Perdus" :** À l'étape finale du retour, un équipement qui était présent au départ mais qui est maintenant manquant sera automatiquement marqué avec le statut "lost" dans la base de données.
    -   **Flux de Validation :** Le processus de confirmation distingue désormais la validation de tous les équipements et la confirmation de l'état actuel (y compris les manquants).

-   **Export ICS Enrichi :**
    -   L'export ICS inclut désormais les noms résolus des utilisateurs (main d'œuvre) pour plus de clarté, en plus des détails de l'événement.
    -   Le contenu généré mentionne la version de l'application.
This commit is contained in:
ElPoyo
2026-01-15 12:05:37 +01:00
parent b30ae0f10a
commit 60d0e1c6c4
10 changed files with 885 additions and 336 deletions

View File

@@ -9,8 +9,8 @@ import 'package:em2rp/providers/event_provider.dart';
import 'package:em2rp/providers/local_user_provider.dart';
import 'package:em2rp/services/data_service.dart';
import 'package:em2rp/services/api_service.dart';
import 'package:em2rp/services/api_service.dart';
import 'package:em2rp/views/widgets/equipment/equipment_checklist_item.dart' show EquipmentChecklistItem, ChecklistStep;
import 'package:em2rp/views/widgets/equipment/container_checklist_item.dart';
import 'package:em2rp/utils/debug_log.dart';
import 'package:em2rp/views/widgets/equipment/missing_equipment_dialog.dart';
import 'package:em2rp/utils/colors.dart';
@@ -47,6 +47,13 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
// État local des validations (non sauvegardé jusqu'à la validation finale)
Map<String, bool> _localValidationState = {};
// NOUVEAU : Gestion des quantités par étape
Map<String, int> _quantitiesAtPreparation = {};
Map<String, int> _quantitiesAtLoading = {};
Map<String, int> _quantitiesAtUnloading = {};
Map<String, int> _quantitiesAtReturn = {};
bool _isLoading = true;
bool _isValidating = false;
bool _showSuccessAnimation = false;
@@ -184,7 +191,7 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
if ((_currentStep == PreparationStep.return_ ||
_currentStep == PreparationStep.unloadingReturn) &&
equipmentItem.hasQuantity) {
_returnedQuantities[eq.equipmentId] = eq.returnedQuantity ?? eq.quantity;
_returnedQuantities[eq.equipmentId] = eq.quantityAtReturn ?? eq.quantity;
}
}
@@ -211,48 +218,114 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
}
/// Basculer l'état de validation d'un équipement (état local uniquement)
void _toggleEquipmentValidation(String equipmentId) {
Future<void> _toggleEquipmentValidation(String equipmentId) async {
final currentState = _localValidationState[equipmentId] ?? false;
// Si on veut valider (passer de false à true) et que c'était manquant avant
if (!currentState && _wasMissingAtPreviousStep(equipmentId)) {
final confirmed = await _confirmValidationIfWasMissingBefore(equipmentId);
if (!confirmed) {
return; // Annulation, ne rien faire
}
}
setState(() {
_localValidationState[equipmentId] = !(_localValidationState[equipmentId] ?? false);
_localValidationState[equipmentId] = !currentState;
});
}
Future<void> _validateAll() async {
/// Marquer TOUT comme validé et enregistrer (bouton "Tout confirmer")
Future<void> _validateAllAndConfirm() async {
// Marquer tout comme validé localement
setState(() {
for (var eq in _currentEvent.assignedEquipment) {
_localValidationState[eq.equipmentId] = true;
}
});
// Puis enregistrer
await _confirmCurrentState();
}
/// Enregistrer l'état actuel TEL QUEL (cochés = validés, non cochés = manquants)
Future<void> _confirmCurrentState() async {
setState(() => _isValidating = true);
try {
// Si "tout valider" est cliqué, marquer tout comme validé localement
for (var equipmentId in _localValidationState.keys) {
_localValidationState[equipmentId] = true;
// Déterminer les manquants = équipements NON validés
final Map<String, bool> missingAtThisStep = {};
for (var eq in _currentEvent.assignedEquipment) {
final isValidated = _localValidationState[eq.equipmentId] ?? false;
missingAtThisStep[eq.equipmentId] = !isValidated; // Manquant si pas validé
}
// Préparer la liste des équipements avec leur nouvel état
final updatedEquipment = _currentEvent.assignedEquipment.map((eq) {
final isValidated = _localValidationState[eq.equipmentId] ?? false;
final isMissing = missingAtThisStep[eq.equipmentId] ?? false;
// Récupérer les quantités selon l'étape
final qtyAtPrep = _quantitiesAtPreparation[eq.equipmentId];
final qtyAtLoad = _quantitiesAtLoading[eq.equipmentId];
final qtyAtUnload = _quantitiesAtUnloading[eq.equipmentId];
final qtyAtRet = _quantitiesAtReturn[eq.equipmentId];
switch (_currentStep) {
case PreparationStep.preparation:
if (_loadSimultaneously) {
return eq.copyWith(isPrepared: isValidated, isLoaded: isValidated);
return eq.copyWith(
isPrepared: isValidated,
isLoaded: isValidated,
isMissingAtPreparation: isMissing,
isMissingAtLoading: isMissing, // Propager
quantityAtPreparation: qtyAtPrep,
quantityAtLoading: qtyAtPrep, // Même quantité
);
}
return eq.copyWith(isPrepared: isValidated);
return eq.copyWith(
isPrepared: isValidated,
isMissingAtPreparation: isMissing,
quantityAtPreparation: qtyAtPrep,
);
case PreparationStep.loadingOutbound:
return eq.copyWith(isLoaded: isValidated);
return eq.copyWith(
isLoaded: isValidated,
isMissingAtLoading: isMissing,
quantityAtLoading: qtyAtLoad,
);
case PreparationStep.unloadingReturn:
if (_loadSimultaneously) {
final returnedQty = _returnedQuantities[eq.equipmentId] ?? eq.quantity;
return eq.copyWith(isUnloaded: isValidated, isReturned: isValidated, returnedQuantity: returnedQty);
return eq.copyWith(
isUnloaded: isValidated,
isReturned: isValidated,
isMissingAtUnloading: isMissing,
isMissingAtReturn: isMissing, // Propager
quantityAtUnloading: qtyAtUnload,
quantityAtReturn: qtyAtRet ?? qtyAtUnload,
);
}
return eq.copyWith(isUnloaded: isValidated);
return eq.copyWith(
isUnloaded: isValidated,
isMissingAtUnloading: isMissing,
quantityAtUnloading: qtyAtUnload,
);
case PreparationStep.return_:
final returnedQty = _returnedQuantities[eq.equipmentId] ?? eq.quantity;
return eq.copyWith(isReturned: isValidated, returnedQuantity: returnedQty);
return eq.copyWith(
isReturned: isValidated,
isMissingAtReturn: isMissing,
quantityAtReturn: qtyAtRet,
);
}
}).toList();
// Si on est à la dernière étape (retour), vérifier les équipements LOST
if (_currentStep == PreparationStep.return_) {
await _checkAndMarkLostEquipment(updatedEquipment);
}
// Mettre à jour Firestore selon l'étape
final updateData = <String, dynamic>{
'assignedEquipment': updatedEquipment.map((e) => e.toMap()).toList(),
@@ -362,11 +435,11 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
}
// Gérer les stocks pour les consommables
if (equipmentData.hasQuantity && eq.isReturned && eq.returnedQuantity != null) {
if (equipmentData.hasQuantity && eq.isReturned && eq.quantityAtReturn != null) {
final currentAvailable = equipmentData.availableQuantity ?? 0;
await _dataService.updateEquipmentStatusOnly(
equipmentId: eq.equipmentId,
availableQuantity: currentAvailable + eq.returnedQuantity!,
availableQuantity: currentAvailable + eq.quantityAtReturn!,
);
}
} catch (e) {
@@ -463,7 +536,7 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
if (missingEquipmentIds.isEmpty) {
// Tout est validé, confirmer directement
await _validateAll();
await _confirmCurrentState();
} else {
// Afficher le dialog des manquants
final missingEquipmentModels = missingEquipmentIds
@@ -486,8 +559,8 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
);
if (action == 'confirm_anyway') {
// Confirmer malgré les manquants
await _validateAll();
// Confirmer malgré les manquants (enregistrer l'état actuel TEL QUEL)
await _confirmCurrentState();
} else if (action == 'mark_as_validated') {
// Marquer les manquants comme validés localement
for (var equipmentId in missingEquipmentIds) {
@@ -495,12 +568,137 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
}
setState(() {});
// Puis confirmer
await _validateAll();
await _confirmCurrentState();
}
// Si 'return_to_list', ne rien faire
}
}
/// Valider tous les enfants d'un container
void _validateAllContainerChildren(String containerId) {
final container = _containerCache[containerId];
if (container == null) return;
setState(() {
for (final equipmentId in container.equipmentIds) {
if (_equipmentCache.containsKey(equipmentId)) {
_localValidationState[equipmentId] = true;
}
}
});
}
/// Mettre à jour la quantité d'un équipement à l'étape actuelle
void _updateEquipmentQuantity(String equipmentId, int newQuantity) {
setState(() {
switch (_currentStep) {
case PreparationStep.preparation:
_quantitiesAtPreparation[equipmentId] = newQuantity;
break;
case PreparationStep.loadingOutbound:
_quantitiesAtLoading[equipmentId] = newQuantity;
break;
case PreparationStep.unloadingReturn:
_quantitiesAtUnloading[equipmentId] = newQuantity;
break;
case PreparationStep.return_:
_quantitiesAtReturn[equipmentId] = newQuantity;
break;
}
});
}
/// Vérifier si un équipement était manquant à l'étape précédente
bool _wasMissingAtPreviousStep(String equipmentId) {
final eq = _currentEvent.assignedEquipment.firstWhere(
(e) => e.equipmentId == equipmentId,
orElse: () => EventEquipment(equipmentId: equipmentId),
);
switch (_currentStep) {
case PreparationStep.preparation:
return false; // Pas d'étape avant
case PreparationStep.loadingOutbound:
return eq.isMissingAtPreparation;
case PreparationStep.unloadingReturn:
return eq.isMissingAtLoading;
case PreparationStep.return_:
return eq.isMissingAtUnloading;
}
}
/// Afficher pop-up de confirmation si l'équipement était manquant avant
Future<bool> _confirmValidationIfWasMissingBefore(String equipmentId) async {
if (!_wasMissingAtPreviousStep(equipmentId)) {
return true; // Pas de problème, continuer
}
final equipment = _equipmentCache[equipmentId];
final result = await showDialog<bool>(
context: context,
builder: (context) => AlertDialog(
title: const Row(
children: [
Icon(Icons.warning_amber, color: Colors.orange),
SizedBox(width: 8),
Text('Confirmation'),
],
),
content: Text(
'L\'équipement "${equipment?.name ?? equipmentId}" était manquant à l\'étape précédente.\n\n'
'Êtes-vous sûr de le marquer comme présent maintenant ?',
),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(false),
child: const Text('Annuler'),
),
ElevatedButton(
onPressed: () => Navigator.of(context).pop(true),
style: ElevatedButton.styleFrom(
backgroundColor: Colors.orange,
),
child: const Text('Confirmer'),
),
],
),
);
return result ?? false;
}
/// Vérifier et marquer les équipements LOST (logique intelligente)
Future<void> _checkAndMarkLostEquipment(List<EventEquipment> updatedEquipment) async {
for (final eq in updatedEquipment) {
final isMissingNow = eq.isMissingAtReturn;
if (isMissingNow) {
// Vérifier si c'était manquant dès la préparation (étape 0)
final wasMissingAtPreparation = eq.isMissingAtPreparation;
if (!wasMissingAtPreparation) {
// Était présent au départ mais manquant maintenant = LOST
try {
await _dataService.updateEquipmentStatusOnly(
equipmentId: eq.equipmentId,
status: EquipmentStatus.lost.toString(),
);
DebugLog.info('[EventPreparationPage] Équipement ${eq.equipmentId} marqué comme LOST');
// TODO: Créer une alerte "Équipement perdu"
// await _createLostEquipmentAlert(eq.equipmentId);
} catch (e) {
DebugLog.error('[EventPreparationPage] Erreur marquage LOST ${eq.equipmentId}', e);
}
} else {
// Manquant dès le début = PAS lost, juste manquant
DebugLog.info('[EventPreparationPage] Équipement ${eq.equipmentId} manquant depuis le début (pas LOST)');
}
}
}
}
@override
Widget build(BuildContext context) {
final allValidated = _isStepCompleted();
@@ -579,7 +777,7 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
const SizedBox(height: 8),
ElevatedButton.icon(
onPressed: allValidated ? null : _validateAll,
onPressed: allValidated ? null : _validateAllAndConfirm,
icon: const Icon(Icons.check_circle_outline),
label: Text(
allValidated
@@ -595,32 +793,9 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
),
),
Expanded(
child: ListView.builder(
child: ListView(
padding: const EdgeInsets.all(16),
itemCount: _currentEvent.assignedEquipment.length,
itemBuilder: (context, index) {
final eventEquipment = _currentEvent.assignedEquipment[index];
final equipment = _equipmentCache[eventEquipment.equipmentId];
if (equipment == null) {
return const SizedBox.shrink();
}
return EquipmentChecklistItem(
equipment: equipment,
eventEquipment: eventEquipment,
step: _getChecklistStep(),
isValidated: _localValidationState[equipment.id] ?? false,
onToggle: () => _toggleEquipmentValidation(equipment.id),
onReturnedQuantityChanged: _currentStep == PreparationStep.return_ && equipment.hasQuantity
? (qty) {
setState(() {
_returnedQuantities[equipment.id] = qty;
});
}
: null,
);
},
children: _buildChecklistItems(),
),
),
],
@@ -686,5 +861,92 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
),
);
}
/// Construit la liste des items de checklist en groupant par containers
List<Widget> _buildChecklistItems() {
final List<Widget> items = [];
// Set pour tracker les équipements déjà affichés dans un container
final Set<String> equipmentIdsInContainers = {};
// Map des EventEquipment par ID pour accès rapide
final Map<String, EventEquipment> eventEquipmentsMap = {
for (var eq in _currentEvent.assignedEquipment) eq.equipmentId: eq,
};
// 1. Afficher les containers avec leurs enfants
for (final containerId in _currentEvent.assignedContainers) {
final container = _containerCache[containerId];
if (container == null) continue;
// Récupérer les équipements enfants de ce container
final List<EquipmentModel> childEquipments = [];
for (final equipmentId in container.equipmentIds) {
final equipment = _equipmentCache[equipmentId];
if (equipment != null && eventEquipmentsMap.containsKey(equipmentId)) {
childEquipments.add(equipment);
equipmentIdsInContainers.add(equipmentId);
}
}
if (childEquipments.isEmpty) continue;
// Vérifier si tous les enfants sont validés
final allChildrenValidated = childEquipments.every(
(eq) => _localValidationState[eq.id] ?? false,
);
// Map des états de validation des enfants
final Map<String, bool> childValidationStates = {
for (var eq in childEquipments) eq.id: _localValidationState[eq.id] ?? false,
};
// Map des enfants manquants à l'étape précédente
final Map<String, bool> wasMissingBeforeMap = {
for (var eq in childEquipments) eq.id: _wasMissingAtPreviousStep(eq.id),
};
items.add(
ContainerChecklistItem(
container: container,
childEquipments: childEquipments,
eventEquipmentsMap: eventEquipmentsMap,
step: _getChecklistStep(),
isValidated: allChildrenValidated,
childValidationStates: childValidationStates,
onToggleContainer: () => _validateAllContainerChildren(containerId),
onToggleChild: (equipmentId) => _toggleEquipmentValidation(equipmentId),
onQuantityChanged: (equipmentId, qty) => _updateEquipmentQuantity(equipmentId, qty),
wasMissingBeforeMap: wasMissingBeforeMap,
),
);
}
// 2. Afficher les équipements standalone (pas dans un container)
for (final eventEquipment in _currentEvent.assignedEquipment) {
// Skip si déjà affiché dans un container
if (equipmentIdsInContainers.contains(eventEquipment.equipmentId)) {
continue;
}
final equipment = _equipmentCache[eventEquipment.equipmentId];
if (equipment == null) continue;
items.add(
EquipmentChecklistItem(
equipment: equipment,
eventEquipment: eventEquipment,
step: _getChecklistStep(),
isValidated: _localValidationState[equipment.id] ?? false,
onToggle: () => _toggleEquipmentValidation(equipment.id),
onQuantityChanged: (qty) => _updateEquipmentQuantity(equipment.id, qty),
isChild: false, // Équipement standalone (pas indenté)
wasMissingBefore: _wasMissingAtPreviousStep(equipment.id),
),
);
}
return items;
}
}