Indicate evaluations that are ignored in the calculation of the grade (#1297)

* Indicate which evaluations are ignored in the calculation

* Move ignored evaluation to expansion tile

* Revert formatting

* [BOT] Applying version.

* [BOT] Applying format.

* Changed title

* Guard with mounted check

* Move evaluation sorting to viewmodel

* [BOT] Applying format.

* Make member private

---------

Co-authored-by: clubapplets-server <1958869+clubapplets-server@users.noreply.github.com>

Author: DylanApardian

lib/l10n/intl_en.arb

@@ -455,5 +455,15 @@
         "type": "String"
       }
     }
-  }
+  },
+  
+  "ignored_evaluations_section_title": "{count,plural, =1{1 ignored grade} other{{count} ignored grades}}",
+  "@ignored_evaluations_section_title": {
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "ignored_evaluations_section_description_text": "The following elements are ignored in the final grade calculation."
 }

lib/l10n/intl_fr.arb

@@ -454,5 +454,15 @@
         "type": "String"
       }
     }
-  }
+  },
+
+  "ignored_evaluations_section_title": "{count,plural, =1{1 note ignorée} other{{count} notes ignorées}}",
+  "@ignored_evaluations_section_title": {
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "ignored_evaluations_section_description_text": "Les éléments suivants sont ignorés dans le calcul de la note finale."
 }

lib/ui/student/grades/grade_details/view_model/grades_details_viewmodel.dart

@@ -5,6 +5,7 @@ import 'package:stacked/stacked.dart';
 // Project imports:
 import 'package:notredame/data/repositories/course_repository.dart';
 import 'package:notredame/data/services/signets-api/models/course.dart';
+import 'package:notredame/data/services/signets-api/models/course_evaluation.dart';
 import 'package:notredame/data/services/signets-api/models/signets_errors.dart';
 import 'package:notredame/l10n/app_localizations.dart';
 import 'package:notredame/locator.dart';
@@ -22,6 +23,10 @@ class GradesDetailsViewModel extends FutureViewModel<Course> {
 
   GradesDetailsViewModel({required this.course, required AppIntl intl}) : _appIntl = intl;
 
+  List<CourseEvaluation> get _allEvaluations => course.summary?.evaluations ?? [];
+  List<CourseEvaluation> get ignoredEvaluations => _allEvaluations.where((e) => e.ignore).toList();
+  List<CourseEvaluation> get nonIgnoredEvaluations => _allEvaluations.where((e) => !e.ignore).toList();
+
   @override
   Future<Course> futureToRun() async {
     try {

lib/ui/student/grades/grade_details/widgets/grade_details_view.dart

@@ -1,3 +1,6 @@
+// Dart imports:
+import 'dart:math';
+
 // Flutter imports:
 import 'package:flutter/material.dart';
 
@@ -28,7 +31,11 @@ class GradesDetailsView extends StatefulWidget {
 
 class _GradesDetailsViewState extends State<GradesDetailsView> with TickerProviderStateMixin {
   late AnimationController _controller;
+  late AnimationController _ignoredEvaluationsAnimationController;
   bool _completed = false;
+  final GlobalKey _expansionTileKey = GlobalKey();
+  late Animation<double> _rotateAnimation;
+  bool _isIgnoredEvaluationsExpanded = false;
 
   @override
   void initState() {
@@ -42,6 +49,25 @@ class _GradesDetailsViewState extends State<GradesDetailsView> with TickerProvid
         });
       }
     });
+
+    _ignoredEvaluationsAnimationController = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 200),
+      value: 1.0,
+    );
+    _ignoredEvaluationsAnimationController.forward();
+
+    _rotateAnimation = Tween(
+      begin: pi,
+      end: 0.0,
+    ).animate(CurvedAnimation(parent: _ignoredEvaluationsAnimationController, curve: Curves.easeIn));
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _ignoredEvaluationsAnimationController.dispose();
+    super.dispose();
   }
 
   @override
@@ -229,12 +255,15 @@ class _GradesDetailsViewState extends State<GradesDetailsView> with TickerProvid
                 const SizedBox(height: 8.0),
                 Column(
                   children: <Widget>[
-                    for (final CourseEvaluation evaluation in model.course.summary?.evaluations ?? [])
+                    for (final CourseEvaluation evaluation in model.nonIgnoredEvaluations)
                       GradeEvaluationTile(
                         evaluation,
                         completed: _completed,
                         key: Key("GradeEvaluationTile_${evaluation.title}"),
                       ),
+                    if (model.ignoredEvaluations.isNotEmpty) ...[
+                      _buildIgnoredEvaluationsExpansionTile(model.ignoredEvaluations),
+                    ],
                     const SizedBox(height: 24),
                   ],
                 ),
@@ -314,4 +343,61 @@ class _GradesDetailsViewState extends State<GradesDetailsView> with TickerProvid
       ),
     );
   }
+
+  Widget _buildIgnoredEvaluationsExpansionTile(List<CourseEvaluation> ignoredEvaluations) {
+    return Theme(
+      data: Theme.of(context).copyWith(dividerColor: Colors.transparent),
+      child: ExpansionTile(
+        key: _expansionTileKey,
+        onExpansionChanged: (value) {
+          _isIgnoredEvaluationsExpanded = !_isIgnoredEvaluationsExpanded;
+          if (value) {
+            _ignoredEvaluationsAnimationController.reverse(from: pi);
+            _scrollToSelectedContent(expansionTileKey: _expansionTileKey);
+          } else {
+            _ignoredEvaluationsAnimationController.forward(from: 0.0);
+          }
+        },
+        trailing: AnimatedBuilder(
+          animation: _rotateAnimation,
+          builder: (BuildContext context, Widget? child) {
+            return Transform.rotate(
+              angle: _rotateAnimation.value,
+              child: const Icon(Icons.keyboard_arrow_down_sharp, color: AppPalette.etsLightRed),
+            );
+          },
+          child: const Icon(Icons.keyboard_arrow_down_sharp, color: AppPalette.etsLightRed),
+        ),
+        tilePadding: EdgeInsets.only(left: 8.0, right: 28),
+        title: Row(
+          children: [
+            Text(
+              AppIntl.of(context)!.ignored_evaluations_section_title(ignoredEvaluations.length),
+              style: Theme.of(context).textTheme.titleMedium,
+            ),
+          ],
+        ),
+        children: [
+          Padding(
+            padding: const EdgeInsets.fromLTRB(8.0, 0.0, 8.0, 8.0),
+            child: Text(AppIntl.of(context)!.ignored_evaluations_section_description_text),
+          ),
+          for (final CourseEvaluation evaluation in ignoredEvaluations)
+            GradeEvaluationTile(evaluation, completed: _completed, key: Key("GradeEvaluationTile_${evaluation.title}")),
+          const SizedBox(height: 24),
+        ],
+      ),
+    );
+  }
+
+  void _scrollToSelectedContent({required GlobalKey expansionTileKey}) {
+    final keyContext = expansionTileKey.currentContext;
+    if (keyContext != null) {
+      Future.delayed(Duration(milliseconds: 200)).then((value) {
+        if (keyContext.mounted) {
+          Scrollable.ensureVisible(keyContext, duration: Duration(milliseconds: 200));
+        }
+      });
+    }
+  }
 }

pubspec.yaml

@@ -5,7 +5,7 @@ description: The 4th generation of ÉTSMobile, the main gateway between the Éco
 # pub.dev using `pub publish`. This is preferred for private packages.
 publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 
-version: 4.60.10
+version: 4.61.10
 
 environment:
   sdk: '>=3.9.0 <4.0.0'