feat: Ajout d'un système d'historisation et d'export de données en CSV [N3WTS-5]

Back-End/Subscriptions/models.py

@@ -130,6 +130,10 @@ class Student(models.Model):
     # One-to-Many Relationship
     associated_class = models.ForeignKey('School.SchoolClass', on_delete=models.SET_NULL, null=True, blank=True, related_name='students')
 
+    # Audit fields
+    created_at = models.DateTimeField(auto_now_add=True, null=True)
+    updated_at = models.DateTimeField(auto_now=True, null=True)
+
     def __str__(self):
         return self.last_name + "_" + self.first_name
 
@@ -252,6 +256,7 @@ class RegistrationForm(models.Model):
     # One-to-One Relationship
     student = models.OneToOneField(Student, on_delete=models.CASCADE, primary_key=True)
     status = models.IntegerField(choices=RegistrationFormStatus, default=RegistrationFormStatus.RF_IDLE)
+    created_at = models.DateTimeField(auto_now_add=True, null=True)
     last_update = models.DateTimeField(auto_now=True)
     school_year = models.CharField(max_length=9, default="", blank=True)
     notes = models.CharField(max_length=200, blank=True)
@@ -578,6 +583,8 @@ class StudentCompetency(models.Model):
         default="",
         blank=True
     )
+    created_at = models.DateTimeField(auto_now_add=True, null=True)
+    updated_at = models.DateTimeField(auto_now=True, null=True)
 
     class Meta:
         unique_together = ('student', 'establishment_competency', 'period')

Back-End/Subscriptions/views/student_views.py

@@ -54,6 +54,12 @@ class StudentListView(APIView):
                 description="ID de l'établissement",
                 type=openapi.TYPE_INTEGER,
                 required=True
+            ),
+            openapi.Parameter(
+                'school_year', openapi.IN_QUERY,
+                description="Année scolaire (ex: 2025-2026)",
+                type=openapi.TYPE_STRING,
+                required=False
             )
         ]
     )
@@ -61,6 +67,7 @@ class StudentListView(APIView):
     def get(self, request):
         establishment_id = request.GET.get('establishment_id', None)
         status_filter = request.GET.get('status', None)  # Nouveau filtre optionnel
+        school_year_filter = request.GET.get('school_year', None)  # Filtre année scolaire
 
         if establishment_id is None:
             return JsonResponse({'error': 'establishment_id est requis'}, safe=False, status=status.HTTP_400_BAD_REQUEST)
@@ -70,6 +77,9 @@ class StudentListView(APIView):
         if status_filter:
             students_qs = students_qs.filter(registrationform__status=status_filter)
 
+        if school_year_filter:
+            students_qs = students_qs.filter(registrationform__school_year=school_year_filter)
+
         students_qs = students_qs.distinct()
         students_serializer = StudentByRFCreationSerializer(students_qs, many=True)
         return JsonResponse(students_serializer.data, safe=False)