feat: Ajout de la configuration des tarifs de l'école [#18]

Back-End/Subscriptions/util.py

@@ -16,52 +16,95 @@ from enum import Enum
 import random
 import string
 from rest_framework.parsers import JSONParser
+import pymupdf
 
 def recupereListeFichesInscription():
+    """
+    Retourne la liste complète des fiches d’inscription.
+    """
     context = {
         "ficheInscriptions_list": bdd.getAllObjects(RegistrationForm),
     }
     return context
 
 def recupereListeFichesInscriptionEnAttenteSEPA():
-
+    """
+    Retourne les fiches d’inscription avec paiement SEPA en attente.
+    """
     ficheInscriptionsSEPA_list = RegistrationForm.objects.filter(modePaiement="Prélèvement SEPA").filter(etat=RegistrationForm.RegistrationFormStatus['SEPA_ENVOYE'])
     return ficheInscriptionsSEPA_list
 
 def _now():
+    """
+    Retourne la date et l’heure en cours, avec fuseau.
+    """
     return datetime.now(ZoneInfo(settings.TZ_APPLI))
 
 def convertToStr(dateValue, dateFormat):
+    """
+    Convertit un objet datetime en chaîne selon un format donné.
+    """
     return dateValue.strftime(dateFormat)
 
 def convertToDate(date_time):
+    """
+    Convertit une chaîne en objet datetime selon le format '%d-%m-%Y %H:%M'.
+    """
     format = '%d-%m-%Y %H:%M'
     datetime_str = datetime.strptime(date_time, format)
 
     return datetime_str
 
 def convertTelephone(telephoneValue, separator='-'):
+    """
+    Reformate un numéro de téléphone en y insérant un séparateur donné.
+    """
     return f"{telephoneValue[:2]}{separator}{telephoneValue[2:4]}{separator}{telephoneValue[4:6]}{separator}{telephoneValue[6:8]}{separator}{telephoneValue[8:10]}"
 
 def genereRandomCode(length):
+    """
+    Génère un code aléatoire de longueur spécifiée.
+    """
     return ''.join(random.choice(string.ascii_letters) for i in range(length))
 
 def calculeDatePeremption(_start, nbDays):
+    """
+    Calcule la date de fin à partir d’un point de départ et d’un nombre de jours.
+    """
     return convertToStr(_start + timedelta(days=nbDays), settings.DATE_FORMAT)
 
 # Fonction permettant de retourner la valeur du QueryDict
 # QueryDict [ index ] -> Dernière valeur d'une liste
 # dict (QueryDict [ index ]) -> Toutes les valeurs de la liste
 def _(liste):
+    """
+    Retourne la première valeur d’une liste extraite d’un QueryDict.
+    """
     return liste[0]
 
 def getArgFromRequest(_argument, _request):
+    """
+    Extrait la valeur d’un argument depuis la requête (JSON).
+    """
     resultat = None
     data=JSONParser().parse(_request)
     resultat = data[_argument]
     return resultat
 
-def rfToPDF(registerForm):
+def merge_files_pdf(filenames, output_filename):
+    """
+    Insère plusieurs fichiers PDF dans un seul document de sortie.
+    """
+    merger = pymupdf.open()
+    for filename in filenames:
+        merger.insert_file(filename)
+    merger.save(output_filename)
+    merger.close()
+
+def rfToPDF(registerForm,filename):
+    """
+    Génère le PDF d’un dossier d’inscription et l’associe au RegistrationForm.
+    """
     # Ajout du fichier d'inscriptions
     data = {
         'pdf_title': "Dossier d'inscription de %s"%registerForm.student.first_name,
@@ -69,14 +112,12 @@ def rfToPDF(registerForm):
         'signatureTime': convertToStr(_now(), '%H:%M'),
         'student':registerForm.student,
     }
-
+    PDFFileName = filename
     pdf = renderers.render_to_pdf('pdfs/dossier_inscription.html', data)
-
-    PDFFileName = "Dossier_Inscription_%s_%s.pdf"%(registerForm.student.last_name, registerForm.student.first_name)
-    pathFichier = Path(settings.DOCUMENT_DIR + "/" + PDFFileName)
+    pathFichier = Path(filename)
     if os.path.exists(str(pathFichier)):
         print(f'File exists : {str(pathFichier)}')
         os.remove(str(pathFichier))
-
     receipt_file = BytesIO(pdf.content)
-    registerForm.fichierInscription = File(receipt_file, PDFFileName)
+    registerForm.fichierInscription = File(receipt_file, PDFFileName)
+    registerForm.fichierInscription.save()