Refine public documentation and code comments

app/Controllers/AnimalMedicalActions.php

@@ -248,7 +248,7 @@ trait AnimalMedicalActions
         }
         $vetName = $vetContact['name'] ?? null;
 
-        // 1️⃣ Insertion note médicale
+        // Enregistre la note médicale avant ses éventuelles pièces jointes.
         $stmt = $db->prepare('
         INSERT INTO medical_notes
         (animal_id, kind, reason, symptoms, exam, diagnosis, plan, temperature_c, weight_kg, clinic_id, vet_name, clinic_contact_id, vet_contact_id, created_by, created_at)
@@ -274,7 +274,7 @@ trait AnimalMedicalActions
             ':created' => self::now(),
         ]);
 
-        // 👉 RÉCUPÉRATION ID NOTE
+        // Identifiant utilisé pour rattacher les photos à la note.
         $medicalNoteId = $db->lastInsertId();
         if ((int) ($_POST['tariff_id'] ?? 0) > 0) {
             PricingService::record(
@@ -287,9 +287,7 @@ trait AnimalMedicalActions
             );
         }
 
-        // ==========================
-        // 2️⃣ Upload photos médicales
-        // ==========================
+        // Enregistre les photos médicales associées.
 
         if (!empty($_FILES['medical_photos']['name'][0])) {
             $uploadDir = PrivateMediaService::medicalDir($animalId);
@@ -337,7 +335,7 @@ trait AnimalMedicalActions
             }
         }
 
-        // 3️⃣ Poids → measurements (graph)
+        // Ajoute le poids aux mesures utilisées par le graphique.
         if ($weight !== '' && is_numeric($weight)) {
             $db->prepare(
                 "
@@ -352,10 +350,10 @@ trait AnimalMedicalActions
             ]);
         }
 
-        // 4️⃣ Historique
+        // Ajoute l'intervention à l'historique de l'animal.
         self::logHistory($animalId, 'medical', 'Note médicale ajoutée', $reason ?: null);
 
-        // 5️⃣ Touch animal
+        // Actualise la date de modification de la fiche.
         if ($markSterilized) {
             $db->prepare(
                 "UPDATE animals SET sterilized=1,sterilization_status='yes',sterilization_date=COALESCE(sterilization_date,date(:date)),sterilization_vet_contact_id=COALESCE(:vet,sterilization_vet_contact_id),sterilization_clinic_contact_id=COALESCE(:clinic,sterilization_clinic_contact_id) WHERE id=:id",